Publishing Reports to the Web - Downloads - Oracle

16.4.1 Applying an XML Report Definition at Runtime
Using XML Files at Runtime
To apply an XML report definition to an RDF or XML file at runtime, you can use the
CUSTOMIZE command line keyword or the SRW.APPLY_DEFINITION built-in
procedure. CUSTOMIZE can be used with rwclient, rwrun, rwbuilder,
rwconverter, and URL report requests.
Note: Refer to Performing Batch Modifications for more
information about using CUSTOMIZE with rwconverter.
16.4.1.1 Applying One XML Report Definition
The following command line sends a job request to OracleAS Reports Services and
applies an XML report definition, EMP.XML, to an RDF file, emp.rdf. In this example,
the CUSTOMIZE command refers to a file located in a Windows directory path. For
UNIX, specify the path according to UNIX standards (i.e., myreports/emp.xml).
rwclient report=emp.rdf customize=\myreports\emp.xml
USERID=username/password@my_db destype=file desname=emp.pdf
desformat=PDF server=server_name
When you use RWRUN, the Reports Runtime command, the equivalent command line
would be:
RWRUN USERID=username/password@my_db report=emp.rdf
customize=\myreports\emp.xml destype=file desname=emp.pdf
desformat=PDF
When testing your XML report definition, it is sometimes useful to run your report
requests with additional options to create a trace file. For example:
TRACEFILE=emp.log TRACEMODE=trace_replace TRACEOPT=trace_app
Note: Unless you care to change the default, it isn't necessary to
include a trace in the command line if you have specified a default
trace option in the Reports Server configuration file.
The trace file provides a detailed listing of the creation and formatting of the report
objects.
16.4.1.2 Applying Multiple XML Report Definitions
You can apply multiple XML report definitions to a report at runtime by providing a
list with the CUSTOMIZE command line keyword. The following command line sends
a job request to OracleAS Reports Services that applies two XML report definitions,
EMP0.XML and EMP1.XML, to an RDF file, EMP.RDF:
rwclient report=emp.rdf
customize="(d:\corp\myreports\emp0.xml,d:\corp\myreports\emp1.xml)"
userid=username/password@my_db destype=file desname=emp.pdf
desformat=PDF server=server_name
Note: In this example, the CUSTOMIZE command entry
demonstrates a directory path to files stored on a Windows
platform. For UNIX, use that platform's standard for specifying
directory paths (i.e., forward slashes instead of backward).
Customizing Reports with XML 16-13