<!-- 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
>cloudtemple@mksat.net</email
></address>
</affiliation>
</author>
<author
><firstname
>Phil</firstname
> <surname
>Thompson</surname
> <affiliation
> <address
><email
>phil@river-bank.demon.co.uk</email
></address>
</affiliation>
</author>
<othercredit role="translator"
><firstname
>Hans-Frieder</firstname
><surname
>Hirsch</surname
><affiliation
><address
><email
>f.hirsch@t-online.de</email
></address
></affiliation
><contrib
>Deutsche Übersetzung</contrib
></othercredit
> 
</authorgroup>
</sect1info>
<title
><sgmltag class="element"
>Das Element KugarData</sgmltag
></title>

<para
>Das Element <sgmltag class="element"
>KugarData</sgmltag
> definiert die Datenquelle eines Berichts. Die Grundstruktur ist eine Ansammlung von Zeilen und Spalten. Dieses Dokument definiert keine Datentypen oder deren Attribute. Die Berichtvorlage definiert Datentypen für Spalten. </para>

<para
>Der Dokumentersteller kann eine &XSL;-Stilvorlage auf ein existierendes Dokument anwenden, um es in dieses Format umzuwandeln. Wird &XSL; verwendet, kann der Ersteller benutzerdefinierte Makros mit &XSL; für Berechnungen, Sortierung, &etc; verwenden. </para>

<synopsis
>&lt;!ELEMENT KugarData (Row*)&gt;
&lt;!ATTLIST KugarData
        Template      CDATA  #REQUIRED&gt;

&lt;!ELEMENT Row EMPTY&gt;
&lt;!ATTLIST Row
        level         CDATA  #REQUIRED
        col1          CDATA  #IMPLIED
        col2          CDATA  #IMPLIED
        ...           CDATA  #IMPLIED
        coln          CDATA  #IMPLIED&gt;
</synopsis>


<sect2 id="kugar-data-element">
<title
>Das KugarData Element</title>
<para
>Das <sgmltag class="element"
>KugarData</sgmltag
>-Element enthält keine oder mehrere <sgmltag class="element"
>Zeilen</sgmltag
>elemente. Einer <sgmltag class="element"
>Zeile</sgmltag
> muss das Attribut <sgmltag class="attribute"
>Stufe</sgmltag
> mit einem Wert zugeordnet sein, der der Detailstufe in der Vorlage entspricht. Andere Attribute stellen Datenspalten dar. </para>
<para
><anchor id="template-att"/>Der Wert des Attributs <sgmltag class="attribute"
>Vorlage</sgmltag
> ist die &URL; der Berichtvorlage mit der die Daten formatiert wurden. </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
>Zeilenelement</title>

<variablelist>

<varlistentry>
<term
>Attribute</term>
<listitem>

<variablelist>

<varlistentry>
<term
><anchor id="level-att"/><sgmltag class="attribute"
>Stufe</sgmltag
></term>
<listitem>
<para
>Der Attributwert gibt an, welches Detail in der Berichtvorlage verwendet wird um Daten anzuzeigen. Zeilen können verschiedene Spaltensätze für verschiedene Stufen enthalten, sodass jedes Attribut, mit Ausnahme der <sgmltag class="attribute"
>Stufe</sgmltag
>, als #IMPLIED betrachtet werden sollte. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><anchor id="column-att"/><sgmltag class="attribute"
>Spalte</sgmltag
></term>
<listitem>
<para
>Der Name des Attributs ist der Spaltenname, mit dem Format, wie es in der <sgmltag class="element"
>KugarData</sgmltag
>-Definition festgelegt ist. Der Attributname wird in der Berichtvorlage dazu verwendet, die Daten mit den Berichtfeldern zu verbinden. </para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>

</sect2>

</sect1>