Adobe COLDFUSION 9 Manual page 1024

DEVELOPING COLDFUSION 9 APPLICATIONS
Working with Documents, Charts, and Reports
Font availability on the server computer and the client computer
ColdFusion has different requirements for rendering the fonts in a report, depending on where the fonts are located.
For all formats, the fonts used in a report must reside on the computer that runs ColdFusion.
Server computer
ColdFusion requires these fonts to render the report accurately. ColdFusion automatically locates Acrobat built-in
fonts and fonts stored in typical font locations (such as the Windows\fonts directory). However, if your server has
additional fonts installed in nonstandard locations, register them with the ColdFusion Administrator so that the
and
cfdocument cfreport
If your PDF report does not embed fonts, the fonts reside on the client computer to ensure consistent
Client computer
report display.
Mapping logical fonts to physical fonts
If you are using Java logical fonts, such as serif, sans serif, or monospaced, ColdFusion maps these fonts to physical
fonts by using specifications in the cf_root/lib/cffont.properties file. (On the multiserver or J2EE configuration, this file
is in the cf_webapp_root/WEB-INF/cfusion/lib directory). You can modify these mappings, if necessary. Also, if you
are using an operating system whose locale is not English, you can create a locale-specific mapping file by appending
.java-locale-code to the filename. If ColdFusion detects that it is running on a non-English locale, it first checks for a
cffont.properties.java-locale-code file. For example, on a computer that uses the Chinese locale, name the file
cffont.properties.cn. For more information on Java locale codes, see the Sun website.
The ColdFusion install includes a cffont.properties.ja file for the Japanese locale.
This discussion applies to both the
online Help.
Common reporting tasks and techniques
With Report Builder, you can include data in reports in a variety of formats, and perform calculations on the
information. For more information, including troubleshooting tips, see Report Builder online Help.
Grouping and group breaks
You can add clarity to a report's organization by grouping the information. You can define separate headings for each
new group and also display group-specific summary information, such as subtotals at the end of each group's area of
the report. For example, you could create a report that displays departments, employees, and their salaries. Grouping
the data by department lets users quickly understand department salary characteristics. When the department ID
changes, the ColdFusion Report Builder triggers a group break. The group break completes the old group by displaying
the group footer and starts the new group by displaying the group header.
The ColdFusion Report Builder does not group data itself. Ensure that the SQL used to retrieve the result set is already
grouped in the appropriate order; typically you implement grouping by specifying an ORDER BY clause in the SQL
SELECT statement used for the report. For example, you could use the following SQL SELECT statement:
SELECT EmployeeID, LastName, FirstName, Title, City, Region, Country
FROM Employees
ORDER BY Country, City
For this example, you can define two groups: one that corresponds to Country, and a second group that corresponds
to City. When you define more than one group, the Group Management dialog box appears with Up Arrow and Down
Arrow keys, which you can use to control group hierarchy. For example, country should precede city, because
countries contain cities.
tags can locate and render PDF and FlashPaper reports.
and
cfdocument cfreport
Last updated 8/5/2010
tags. For more information, see the Report Builder
1019