blob: 30f56ec35ee8bd332978f9b0f57477b077cfe49f (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
|
<!-- if you want to validate this file separately, uncomment this prolog:
<?xml version="1.0" ?>
<!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd">
-->
<sect1 id="kugardata-element">
<sect1info>
<authorgroup>
<author>
<firstname>Alexander</firstname>
<surname>Dymo</surname>
<affiliation>
<address><email>[email protected]</email></address>
</affiliation>
</author>
<author>
<firstname>Phil</firstname>
<surname>Thompson</surname>
<affiliation>
<address><email>[email protected]</email></address>
</affiliation>
</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
</sect1info>
<title><sgmltag class="element">KugarData element</sgmltag></title>
<para>
The <sgmltag class="element">KugarData</sgmltag> element defines a
report's data source. The basic structure is a collection of rows and
columns. This document does not define data types and their attributes.
<!--at this time. -->The report template defines column data type information.
</para>
<para>
The document creator can apply an &XSL; style sheet to an existing
document to convert it to this format. If &XSL; is used, the creator
can apply custom macros using &XSL; for column calculations, sorting,
&etc;.
</para>
<synopsis>
<!ELEMENT KugarData (Row*)>
<!ATTLIST KugarData
Template CDATA #REQUIRED>
<!ELEMENT Row EMPTY>
<!ATTLIST Row
level CDATA #REQUIRED
col1 CDATA #IMPLIED
col2 CDATA #IMPLIED
... CDATA #IMPLIED
coln CDATA #IMPLIED>
</synopsis>
<sect2 id="kugar-data-element">
<title>Kugar data element</title>
<para>
The <sgmltag class="element">KugarData</sgmltag> element contains zero
or more <sgmltag class="element">Row</sgmltag> elements. A <sgmltag
class="element">Row</sgmltag> must contain one <sgmltag class="attribute">level</sgmltag>
attribute with a value corresponding to detail level in the template. Other attributes
represent data columns.
</para>
<para>
<anchor id="template-att"/>The value of the <sgmltag class="attribute">Template</sgmltag>
attribute is the &URL; of the report template
used to format the data.
</para>
<!--
<variablelist>
<varlistentry id="template-att">
<term><sgmltag class="attribute">Template</sgmltag></term>
<listitem>
<para>
This is an attribute of the <sgmltag class="element">KugarData</sgmltag>
element. The value of the attribute is the &URL; of the report template
used to format the data.
</para>
</listitem>
</varlistentry>
-->
</sect2>
<sect2 id="row-element">
<title>Row element</title>
<variablelist>
<varlistentry>
<term>Attributes</term>
<listitem>
<variablelist>
<varlistentry>
<term><anchor id="level-att"/><sgmltag class="attribute">level</sgmltag></term>
<listitem>
<para>
The attribute value indicates which detail in the report template
is used to display data. Rows can contain various column sets for various levels,
so any attribute except <sgmltag class="attribute">level</sgmltag> should
be stated as #IMPLIED.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><anchor id="column-att"/><sgmltag class="attribute">column</sgmltag></term>
<listitem>
<para>
The name of the attribute is the column name, and uses the format as given
in the <sgmltag class="element">KugarData</sgmltag> definition.
The attribute name is used in the report template to bind the data to the
report fields.
</para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>
|
