01.02.2013 Views

Publishing Reports to the Web - Downloads - Oracle

Publishing Reports to the Web - Downloads - Oracle

Publishing Reports to the Web - Downloads - Oracle

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

Debugging XML Report Definitions<br />

Ra<strong>the</strong>r than opening each report and manually making <strong>the</strong> change in <strong>Reports</strong> Builder,<br />

you can run RWCONVERTER once and make <strong>the</strong> same change <strong>to</strong> a large number of<br />

reports at once.<br />

The following example applies two XML report definitions, translate.xml and<br />

cus<strong>to</strong>mize.xml, <strong>to</strong> three RDF files, INVEN1.RDF, INVEN2.RDF, and MANU.RDF, and<br />

saves <strong>the</strong> revised definitions <strong>to</strong> new files, INVEN1_NEW.RDF, INVEN2_NEW.RDF, and<br />

MANU_NEW.RDF.<br />

rwconverter username/password@my_db<br />

stype=rdffile<br />

source="(inven1.rdf, inven2.rdf, manu.rdf)"<br />

dtype=rdffile<br />

dest="(inven1_new.rdf, inven2_new.rdf, manu_new.rdf)"<br />

cus<strong>to</strong>mize="(d:\apps\trans\translate.xml,d:\apps\cus<strong>to</strong>m\cus<strong>to</strong>mize.xml)"<br />

batch=yes<br />

16.5 Debugging XML Report Definitions<br />

The following features are available <strong>to</strong> help you debug your XML report files:<br />

■ XML Parser Error Messages<br />

■ Tracing Options<br />

■ rwbuilder<br />

■ Writing XML <strong>to</strong> a File for Debugging<br />

These features are discussed in <strong>the</strong> following sections.<br />

16.5.1 XML Parser Error Messages<br />

16.5.2 Tracing Options<br />

Note: In this example, <strong>the</strong> CUSTOMIZE command entry<br />

demonstrates a direc<strong>to</strong>ry path <strong>to</strong> files s<strong>to</strong>red on a Windows<br />

platform. For UNIX, use that platform's standard for specifying<br />

direc<strong>to</strong>ry paths (i.e., forward slashes instead of backward).<br />

The XML parser is part of <strong>Oracle</strong>'s XML Development Kit (XDK), which is delivered<br />

with <strong>the</strong> core <strong>Oracle</strong> Database release. The XML parser is a Java package that checks<br />

<strong>the</strong> validity of XML syntax. The JAR files that contain <strong>the</strong> XML parser are<br />

au<strong>to</strong>matically set up on install and are available <strong>to</strong> <strong>Oracle</strong> <strong>Reports</strong>.<br />

The XML parser catches most syntax errors and displays an error message. The error<br />

message contains <strong>the</strong> line number in <strong>the</strong> XML where <strong>the</strong> error occurred as well as a<br />

brief description of <strong>the</strong> problem.<br />

For more information on <strong>the</strong> XML parser, see <strong>the</strong> <strong>Oracle</strong> Technology Network,<br />

(http://otn.oracle.com). Search for XML parser or XDK. Information is also<br />

available in <strong>the</strong> documentation that came with your <strong>Oracle</strong> Database.<br />

When testing your XML report definition, it can be useful <strong>to</strong> run your report along<br />

with additional options <strong>to</strong> create a trace file. For example:<br />

RWRUN /@<br />

Cus<strong>to</strong>mizing <strong>Reports</strong> with XML 16-17

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!