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.

Cus<strong>to</strong>mization Overview<br />

■ Using XML Files at Runtime<br />

■ Debugging XML Report Definitions<br />

This chapter lists and provides examples of <strong>the</strong> supported elements in <strong>the</strong><br />

reports.dtd file. However, only some of <strong>the</strong> attributes of <strong>the</strong>se elements are listed.<br />

For more information, ei<strong>the</strong>r on <strong>the</strong> additional attributes or on <strong>the</strong> <strong>Oracle</strong> <strong>Reports</strong> XML<br />

elements, tags, and attributes, refer <strong>to</strong> <strong>the</strong> following sources:<br />

■ The reports.dtd file lists all <strong>the</strong> <strong>Oracle</strong> <strong>Reports</strong> XML elements, tags, and<br />

attributes and, where present, <strong>the</strong> attributes' default values. The reports.dtd<br />

file is located in ORACLE_HOME\reports\dtd\ on both Windows and UNIX<br />

platforms. Many of <strong>the</strong> sub-elements include symbols that denote usage rules. For<br />

example:<br />

■ A plus sign (+) means you can have one or more of this type of element in<br />

your XML file.<br />

■ An asterisk (*) means you can have from zero <strong>to</strong> many of this type of element<br />

in your XML file.<br />

■ A question mark (?) means you can have ei<strong>the</strong>r zero or one of this type of<br />

element in your XML file.<br />

■ No mark means <strong>the</strong> element is required, and you can have one and only one of<br />

this type of element in your XML file.<br />

If multiple sub-elements are enclosed in paren<strong>the</strong>ses and followed by a symbol,<br />

<strong>the</strong> symbol applies <strong>to</strong> all enclosed sub-elements.<br />

■ Topic "<strong>Oracle</strong> <strong>Reports</strong> XML tags" in <strong>the</strong> Reference section of <strong>the</strong> <strong>Reports</strong> Builder<br />

online help for descriptions of selected tags.<br />

■ Build a report that includes <strong>the</strong> type of cus<strong>to</strong>mization you are trying <strong>to</strong> build, save<br />

<strong>the</strong> report as XML, and view <strong>the</strong> saved file in a text edi<strong>to</strong>r. This provides an<br />

excellent means of seeing <strong>Oracle</strong> <strong>Reports</strong> XML in action and provides you with<br />

examples of <strong>the</strong> more complex models you may wish <strong>to</strong> build.<br />

16.1 Cus<strong>to</strong>mization Overview<br />

By using <strong>the</strong> <strong>Oracle</strong> <strong>Reports</strong> XML tags, you can cus<strong>to</strong>mize reports created using<br />

<strong>Reports</strong> Builder.<br />

Note: Although it is possible <strong>to</strong> create an entire report manually<br />

using <strong>the</strong> <strong>Oracle</strong> <strong>Reports</strong> XML tags, only manually created<br />

cus<strong>to</strong>mizations and data models are documented and supported.<br />

Creating and applying an XML cus<strong>to</strong>mization is a three-step process:<br />

1. Create a cus<strong>to</strong>mization file using <strong>Oracle</strong> <strong>Reports</strong> XML tags.<br />

You can create this cus<strong>to</strong>mization by building a report using <strong>Reports</strong> Builder <strong>the</strong>n<br />

saving your report as XML. You can also build <strong>the</strong> cus<strong>to</strong>mization manually, with<br />

any sort of text edi<strong>to</strong>r or a sophisticated XML edi<strong>to</strong>r, as long as you include <strong>the</strong><br />

XML tags that are required for <strong>the</strong> particular <strong>Oracle</strong> <strong>Reports</strong> cus<strong>to</strong>mization.<br />

For descriptions of selected <strong>Oracle</strong> <strong>Reports</strong> XML tags, see opic "<strong>Oracle</strong> <strong>Reports</strong><br />

XML tags" in <strong>the</strong> Reference section of <strong>the</strong> <strong>Reports</strong> Builder online help for<br />

descriptions of selected tags.<br />

16-2 <strong>Oracle</strong> Application Server <strong>Reports</strong> Services <strong>Publishing</strong> <strong>Reports</strong> <strong>to</strong> <strong>the</strong> <strong>Web</strong>

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

Saved successfully!

Ooh no, something went wrong!