8
<chapter id="kugardata-element">
9
<title><sgmltag class="element">KugarData</sgmltag></title>
8
<sect1 id="kugardata-element">
9
<title><sgmltag class="element">KugarData element</sgmltag></title>
12
12
The <sgmltag class="element">KugarData</sgmltag> element defines a
13
13
report's data source. The basic structure is a collection of rows and
14
columns. This document does not define data types and their attributes
15
at this time. The report template defines column data type information.
14
columns. This document does not define data types and their attributes.
15
<!--at this time. -->The report template defines column data type information.
26
<!ELEMENT KugarData (<link linkend="row-element">Row</link>* )>
26
<!ELEMENT KugarData (Row*)>
27
27
<!ATTLIST KugarData
28
<link linkend="template-att">Template</link> CDATA #REQUIRED>
28
Template CDATA #REQUIRED>
30
<!ELEMENT <link linkend="row-element">Row</link> EMPTY>
31
<!ATTLIST <link linkend="row-element">Row</link>
32
<link linkend="column-att">col1</link> CDATA #REQUIRED
33
<link linkend="column-att">col2</link> CDATA #REQUIRED
34
<link linkend="column-att">...</link> CDATA #REQUIRED
35
<link linkend="column-att">coln</link> CDATA #REQUIRED>
30
<!ELEMENT Row EMPTY>
36
coln CDATA #IMPLIED>
44
<varlistentry id="row-element">
45
<term><sgmltag class="element">Row</sgmltag></term>
40
<sect2 id="kugar-data-element">
41
<title>Kugar data element</title>
48
43
The <sgmltag class="element">KugarData</sgmltag> element contains zero
49
44
or more <sgmltag class="element">Row</sgmltag> elements. A <sgmltag
50
class="element">Row</sgmltag> must contain one or more attributes
51
representing data columns.
60
<term>Attributes</term>
45
class="element">Row</sgmltag> must contain one <sgmltag class="attribute">level</sgmltag>
46
attribute with value corresponding to detail level in the template. Other attributes
47
represent data columns.
50
<anchor id="template-att"/>The value of the <sgmltag class="attribute">Template</sgmltag>
51
attribute is the &URL; of the report template
52
used to format the data
64
56
<varlistentry id="template-att">
65
57
<term><sgmltag class="attribute">Template</sgmltag></term>
75
<varlistentry id="column-att">
76
<term><sgmltag class="attribute">Column</sgmltag></term>
79
This is an attribute of the <link linkend="row-element"><sgmltag
80
class="element">Row</sgmltag></link>. The name of the attribute is the
81
column name, and uses the format as given in the <sgmltag
82
class="element">KugarData</sgmltag> definition. The attribute name is
83
used in the report template to bind the data to the report fields.
69
<sect2 id="row-element">
70
<title>Row element</title>
75
<term>Attributes</term>
81
<term><anchor id="level-att"/><sgmltag class="attribute">level</sgmltag></term>
84
The attribute value indicates which detail in the report template
85
is used to display data. Rows can contain various column set for various levels,
86
so any attribute except <sgmltag class="attribute">level</sgmltag> should
87
be stated as #IMPLIED.
93
<term><anchor id="column-att"/><sgmltag class="attribute">column</sgmltag></term>
96
The name of the attribute is the column name, and uses the format as given
97
in the <sgmltag class="element">KugarData</sgmltag> definition.
98
The attribute name is used in the report template to bind the data to the