Adobe 38043740 - ColdFusion Standard - Mac Development Manual page 1026

DEVELOPING COLDFUSION 9 APPLICATIONS
Working with Documents, Charts, and Reports
Defining, modifying, and using fields and input parameters
The Report Builder supports variable data through query fields, input parameters, and calculated fields, as follows:
Maps to columns in the database result set associated with the report. You define one query field for each
Query field
column in the associated database query.
Analyzes or sums multiple detail rows in a report. ColdFusion dynamically generates calculated field
Calculated field
values at report-generation time, optionally recalculating the value with each new report, page, column, or group.
Specifies data fields that you pass to the report at run time through the
Input parameter
a main report to a subreport. You can place input parameters directly on a report band or you can use them as input
to a calculated field.
Define a query field
Choose Window > Fields and Parameters.
1
2 Click Query Fields.
Click the plus sign (+) at the upper edge of the tab.
3
Type a value for the name field. This value must match a column name in the corresponding cfquery statement and
4
cannot contain a period.
Type a default label.
5
6 Specify the data type of the corresponding database column, as follows:
Object
Boolean
Byte
Date
Time Stamp
Click OK.
7
Note: The Query Builder defines query fields automatically for all database columns in the result set (this action does not
apply to the Advanced Query Builder). Also, if you run the Query Builder as part of the Report Creation Wizard, the
wizard places query fields on the report.
Define a calculated field
1 Choose Window > Fields and Parameters.
Click Calculated Fields.
2
3 Click the plus sign (+) at the upper edge of the tab.
4 Specify a name, default label text, and data type. Data type options are the same as for query fields.
Specify calculation options:
5
Specifies the type of calculation that ColdFusion performs. Valid values are: Average, Count,
Calculation
DistinctCount, First, Highest, Lowest, Nothing, Standard Deviation, Sum, System, and Variance. If you specify
Nothing, you typically use the Perform Calculation On field to specify a dynamic expression. Except for Nothing
(for which you use the Perform Calculation On field) and System (for which you write a customized scriptlet class),
you use these calculations for group, page, and report totals.
Specifies a field or expression. Click the ... button to display the Expression Builder.
Perform Calculation On
Time
Double
Float
Integer
BLOB
Last updated 1/20/2012
tag or from
cfreportparam
Long
Short
Big Decimal
String
CLOB
1021