The XML Tag property specifies the element name of the currently selected report, group or column, and may be user-defined. You may choose any name for the element, as the XML tag's purpose is to uniquely identify the object as a particular type or category of data. One reason for generating XML output is to configure objects according to external DTD specifications, which permits integration of your report with a third-party application.
Applies to |
Reports, groups, or columns |
Values |
Can contain any characters in a string of any length. |
Default |
Object name (as displayed in the Name property) |
Required/Optional |
Optional |
The name of the XML element is dependent on the name of the object in the Property Inspector. Changing the Name property will change the XML Tag property to match.
If you do not wish to output XML for this object but do wish to output child tags and data, leave this property blank. For more information, see the example.
Suppose you want to create XML output for the report, group(s), and columns of your query. A query statement such as:
SELECT deptno, dname, loc FROM dept
In a tabular report, this will produce the following XML output:
<MODULE1>
<LIST_G_DEPTNO>
<G_DEPTNO>
<DEPTNO>10</DEPTNO>
<DNAME>ACCOUNTING</DNAME>
<LOC>NEW YORK</LOC>
</G_DEPTNO>
<G_DEPTNO>
<DEPTNO>20</DEPTNO>
<DNAME>RESEARCH</DNAME>
<LOC>DALLAS</LOC>
</G_DEPTNO>
<G_DEPTNO>
<DEPTNO>30</DEPTNO>
<DNAME>SALES</DNAME>
<LOC>CHICAGO</LOC>
</G_DEPTNO>
<G_DEPTNO>
<DEPTNO>40</DEPTNO>
<DNAME>OPERATIONS</DNAME>
<LOC>BOSTON</LOC>
</G_DEPTNO>
</LIST_G_DEPTNO>
</MODULE1>
If you wish to suppress various tags from appearing in the output, simply delete the default name in the XML Tag property field, leaving it blank. This will eliminate tag output, but will not exclude any data associated with child tags.
For instance, if you were to delete the G_DEPTNO
tag, the XML
output would read as follows:
<MODULE1>
<LIST_>
<DEPTNO>10</DEPTNO>
<DNAME>ACCOUNTING</DNAME>
<LOC>NEW YORK</LOC>
<DEPTNO>20</DEPTNO>
<DNAME>RESEARCH</DNAME>
<LOC>DALLAS</LOC>
<DEPTNO>30</DEPTNO>
<DNAME>SALES</DNAME>
<LOC>CHICAGO</LOC>
<DEPTNO>40</DEPTNO>
<DNAME>OPERATIONS</DNAME>
<LOC>BOSTON</LOC>
</LIST_>
</MODULE1>
Note that the tag formerly called <LIST_G_DEPTNO>
is now
called <LIST_>
. This is called an outer XML tag and
is only associated with group tags. The outer XML tag name is selected from
the group XML tag name. If you wish to remove the <LIST_>
tag as well, you may leave the outer XML tag field blank. See Outer
XML Tag property for more information.
Copyright © 1984, 2005, Oracle. All rights reserved.