About the DST file

Advanced Concepts 2-59 lt;include src=mainSectiongt; ■ The Repeat On property must be set appropriately for the sections specified in the distribution XML file. ■ The sections specified in the distribution XML file in the report paper layout must not be empty. Examples Example 1 You can use sectioning and distribution to publish your report output in HTML, and also send a PostScript version to the printer. Example 2 You can send an executive summary of a report to senior management, and also e-mail detailed breakdowns to individual managers. In this example, a single report with two report sections needs to be created: a portrait-sized summary section and a landscape-sized detail section. Use the Repeat On property to associate the detail section with a data model group that lists the managers and then alter the destination to burst the report on each instance of the data model group to send the output to the appropriate managers. See also Section 2.1.2, About report sectioning and sections Section 4.14.19, Tracing report distribution Chapter Creating Advanced Distributions in the Oracle Fusion Middleware Publishing Reports to the Web with Oracle Reports Servicesmanual.

2.8.3.1 About the DST file

As an alternative to defining the distribution for a report or report section in the Distribution dialog box, you can also create a DST file and specify its name on the command line with the DESTINATION keyword to distribute the report. If a DST file is specified on the command line, the distribution that it defines overrides the distribution defined using the Distribution dialog box. The format of each line of a DST file is as follows: dist_ID : output_def Note: DST files are supported for backward compatibility with prior releases; the preferred and recommended method of distributing reports is with the Distribution dialog box or using XML. Note: If you trace report distribution to identify distribution errors see Section 4.14.19, Tracing report distribution , the trace file format is very similar to the DST file, so you can cut and paste to generate a DST file from the trace file. 2-60 Oracle Reports Users Guide to Building Reports where dist_ID is an identifier for a distribution destination. output_def is a series of rwrun or rwclient command line keywords that specify the distribution definition. In addition, the following parameter is valid: LEVEL specifies the scope of the distribution. Values for LEVEL REPORT means that the distribution applies to the entire report. Header_Section means that the distribution applies to the header section only. Main_Section means that the distribution applies to the main body section only. Trailer_Section means that the distribution applies to the trailer section only. Default REPORT Example The definition in this example sends report output to an HTML file, 3 copies of the main section to a printer, and the header section to a PDF file. ;dst file specified with the DESTINATION keyword on the command line DEST1: DESNAME=dst1.HTM DESTYPE=file DESFORMAT=HTML COPIES=1 LEVEL=Report DEST2: DESNAME=prt1 DESTYPE=printer DESFORMAT=BITMAP COPIES=3 LEVEL=Main_Section DEST3: DESNAME=SECT1.pdf DESTYPE=file DESFORMAT=pdf COPIES=1 LEVEL=Header_Section See also Section 2.1.2, About report sectioning and sections

2.8.4 About pluggable destinations