FORM.DETAIL

Use FORM.DETAIL to:

FORM.DETAIL consists of detail variations that you define. You can create up to 99 variations, and each variation can correspond to conditions entered on FORM.CONDITIONS. Unless each condition is mutually exclusive, different detail variations can be displayed for the same data row.

FORM.DETAIL does not affect charts.

FORM.DETAIL                                                 A   VAR   1 of  1
 
 B Include Column Headings with Detail Heading? ===> YES
 C LINE D ALIGN E DETAIL HEADING TEXT
 ----    ------   ----+----1----+----2----+----3----+----4----+----5----+
 1       LEFT
 2       LEFT
         *** END ***
 
 F New Page for Detail Block? ===> NO    G Repeat Detail Heading?   ===> NO
 H Keep Block on Page?        ===> NO    I Blank Lines After Block  ===> 0
 J Put Tabular Data at Line (Enter 1-999 or NONE) ===> 1
 K LINE L ALIGN M DETAIL BLOCK TEXT
 ----    ------   ----+----1----+----2----+----3----+----4----+----5----+
 1       LEFT
 2       LEFT
 
         *** END ***
 N Select Panel Variation? ===> YES
 
 1=Help        2=Check     3=End     4=Show        5=Chart       6=Query
 7=Backward    8=Forward   9=       10=Insert     11=Delete     12=Report
 OK, FORM.DETAIL is displayed.
 COMMAND ===>                                            SCROLL ===> PAGE
 
 A  VAR 1 of 1
The first number represents the current panel variation, and the second represents the total number of variation panels (maximum is 99). The default form displays VAR 1 of 1.

You can create a new detail variation by entering a value one greater than the total number of variation panels over the current panel variation value. New panels must be added sequentially.

You can navigate to existing panel variations by entering the identifying value over the current panel variation value. You can also display different panel variations by entering the NEXT and PREVIOUS commands on the command line. (See NEXT and PREVIOUS for more information.)

Sections  B  through  E  specify text to be followed in a report by column headings specified on FORM.COLUMNS.

 B  Include column headings with detail heading?
YES
Column headings become part of the detail headings. The resulting detail heading is repeated whenever requested on BREAK panels or in  G Repeat Detail Heading? (page***).
NO
Column headings are suppressed.
 C  LINE
Identify lines of detail heading text and their relative positions. Any number of lines can be specified. The line numbers can be any number from 1 through 999 or blank.

If you use the same LINE value for more than one line, those lines are joined according to the ALIGN value for the additional line or lines. Lines with the same LINE value overlay each other if they are longer than the report width, or if their ALIGN values conflict.

 D  ALIGN
Specify where each line of detail heading text is to be placed horizontally in the report. You can place the lines anywhere within the width of the report.
Left
Left-justifies the detail heading text.
Right
Right-justifies the detail heading text.
Center
Centers the detail heading text.
n
Begins the detail heading text in the nth position of the line. n can be any number from 1 through 999999.
Append
If APPEND is used for a line of text that is not appended to another line, the line of text is left-justified.

The previous line of text and the appended line of text must have the same LINE value if they are to be placed on the same line. If the report is not wide enough to accommodate the appended line of text, some of the text might be truncated.

 E  DETAIL HEADING TEXT
Specify the detail heading text. You can add up to 999 lines of text using the INSERT command. Each line of text can be up to 55 characters long. You can add text to the line by using APPEND as the ALIGN value, or by specifying a specific horizontal position.

If your installation supports DBCS data, see Names with double-byte characters.

Detail heading text always precedes column headings in a report. Detail headings consist of detail heading text, column headings, or both. Unless omitted, detail heading text and column headings constitute detail headings.

By default, a detail heading can extend from the left margin to the right margin of the report. Any text that extends beyond the right margin is not displayed or printed. You can alter the width by changing the report text width on the FORM.OPTIONS panel. If you do not explicitly specify a width, the right margin is determined by the width of the tabular data.

When printing a report, all the detail headings selected for the current row of data when the page heading is formatted are printed. If the number of lines for the detail heading exceed the number of available lines on the page, the excess detail heading lines are lost.

Detail headings can contain the following variable values:

Global variables
Use SET GLOBAL to set variables for use in detail heading text. See SET GLOBAL for details about this command.
&n
The value in the nth column on the form used for this report. For example, this detail heading:
ID NUMBER:  &1   EMPLOYEE NAME:  &2
Can produce the following heading in a report:
ID NUMBER:  50    EMPLOYEE NAME:  HANES

The &n value is the value of column n from the current row at the start of the new page. Detail headings for unconditionally selected variations are shown at the top of each screen in displayed reports. However, the value for &n appears only on the first screen of a displayed report. If you want to display the report online with page breaks, issue the DPRE command. See DPRE for more information on this command.

With this special syntax, the width of the substitution value is determined by the width specified by the associated column on the FORM.COLUMNS or FORM.MAIN panel.

&ROW
The number of the current data row when the detail heading is formatted.

&DATE
The date the print command was executed (in printed reports) or the current date (in displayed reports)
&TIME
The time the print command was executed (in printed reports) or the current time (in displayed reports)
&PAGE
The current page number

For descriptions of &DATE, &TIME, and &PAGE, see page*** under BREAK1 HEADING TEXT.

Sections  F  through  M  specify report data that can be repeated in a report for each data row. This data, called a detail block, is the tabular data (if selected) and text associated with a single data line or a single detail line (for example, a row from a table).

 F  New page for detail block?
Specify whether to start each occurrence of the detail block on a new page in a printed report. A new page is started if the report is not already at the top of the page.
 G  Repeat detail heading?
Specify whether to repeat the detail heading before each occurrence of the detail block text. The detail heading includes any detail heading text specified on the FORM.DETAIL panel, followed by column headings (if not suppressed) listed on the FORM.COLUMNS panel.
NO
The detail heading is formatted at the beginning of each screen for online reports or each page for printed reports.
YES
The detail heading is formatted before each occurrence of detail block text.
 H  Keep block on page?
Specify whether to keep each detail block text together on one page of your printed report.
NO
Detail blocks can be split across two or more pages of your printed report.
YES
You can prevent detail blocks from being split across pages. If a detail block is too long to be printed on one page, it is started on a new page.
 I  Blank lines after block
Specify how many blank lines after detail block text.

The detail spacing option on the FORM.OPTIONS panel also affects the number of blank lines after detail block text.

 J  Put tabular data at line (Enter 1-999 or NONE)
Specify whether to generate the tabular data (in the tabular format specified on FORM.COLUMNS or FORM.MAIN) and where this tabular data should be placed. The number corresponds to the number of the detail block text line on which the tabular data should be placed. NONE (or N) indicates not to format the tabular data. NONE does not affect break text or aggregation values.

This option can be used to mix text with tabular data. When a number is specified, tabular data overlays or combines with any detail block text on the same line.

If NONE is specified, tabular data is not formatted, but the column values can be included in the detail block text by using column substitution values.

 K  LINE
Identify the lines of detail block text and specify their relative positions. Any number of tabular data lines can be specified. You can specify any number from 1 through 999 or a blank. See  C  LINE on page*** for additional information.
 L  ALIGN
Specify where each line of detail block text is to be placed horizontally in the report. You can place the lines anywhere within the width of the report. Valid values are LEFT, RIGHT, CENTER, APPEND, or any number from 1 through 999,999.

The ALIGN values do not affect the horizontal placement of tabular data. To change the placement of tabular data, modify the column widths or indents on FORM.COLUMNS or FORM.MAIN. See  D  ALIGN on page*** for additional information.

 M  DETAIL BLOCK TEXT
Specify the detail block text. You can add up to 999 lines of detail block text using the INSERT command. Each line of text can be up to 55 characters long. You can add text to the line by using APPEND as the ALIGN value, or by specifying a specific horizontal position.

If your installation supports DBCS data, see Names with double-byte characters.

By default, detail block text extends from the left margin to the right margin of the report. Any text that extends beyond the right margin is not displayed or printed. You can alter the width by changing the report text width on the FORM.OPTIONS panel. If you do not specify a width, the right margin is determined by the width of the tabular data.

Detail block text can contain literal text along with the following variable values:

Global variables
Use SET GLOBAL to set variables for use in detail block text. See SET GLOBAL for details about this command.
&n
The value in the nth column on the form used for this report. For example, this detail block text:
DEPARTMENT:  &3   EMPLOYEE NAME:  &2
Could produce the following line in a report:
DEPARTMENT:  20    EMPLOYEE NAME:  SANDERS
&COUNT
The number of rows displayed or printed since the last break. This value is a running count and increases from data row to data row.
&ROW
The number of the data row for the detail block is printed or displayed in your report.

In detail block text with a group summary report, the number of the data row for the last row in the group is printed.

&CALCid
Calculated value
&DATE
The current date
&TIME
The current time
&PAGE
The current page number

For a description of &CALCid, see FORM.CALC.

For descriptions of &DATE, &TIME, and &PAGE, see page*** under BREAK1 HEADING TEXT.

&an
n is a valid column number, and a is one of the following QMF aggregation functions: AVG, COUNT, CPCT, CSUM, FIRST, LAST, MAX, MIN, PCT, STDEV, SUM, TCPCT, TPCT. The values of the aggregations are based on running values within the current break level.

In detail block text, the values for aggregations are based on the data values since the last break through the current row. Calculated values such as AVG and STDEV also are based on data values since the last break. For example, &AVG6 is the sum of column six (through the current row) divided by COUNT.

At the detail level, &SUM and &CSUM produce the same result. &SUM6 and &CSUM6 in the detail block text each produces the total value of column 6 through the current row.

If you use an aggregation variable with percent (PCT, TPCT, or TCPCT) in detail block text, and if you associate it with a column that has a D edit code, QMF formats the percent value in the detail block text as if it had an L edit code. Likewise, if you use the aggregation variable standard deviation in detail block text and associate it with a column that has a P or a D edit code, QMF formats the standard deviation in the detail block text as if it had an L edit code.

For more information, see the L code under Edit Codes for Numeric Data and Variables Used in Forms.

 N  Select panel variation
Specify when to select a panel variation. You must enter one of the following allowable values--blanks are not allowed:
YES
Always selected for formatting in the report. It is the default when the variation number is 1.
NO
Never selected for formatting. It is the default when the variation number is from 2 through 99. This value can be used to temporarily inhibit the formatting of a variation in a report.

The following two choices allow you to selectively format your report. You can associate an entire panel of detail text and formatting options with a specific condition on the FORM.CONDITIONS panel (conditional formatting), or a specific data column that corresponds to a branch of tree data.

C1-C999
Can be selected to identify a condition on FORM.CONDITIONS. If the condition is true, the associated FORM.DETAIL variation is formatted.
E1-E999
Can be selected for formatting when data exists for the indicated column. The column is identified by the number following E. This number corresponds to the NUM value for a column on FORM.MAIN or FORM.COLUMNS.
[ Previous Page | Next Page | Contents | Index ]