<!-- 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
>Pedro</firstname
><surname
>Morais</surname
><affiliation
><address
><email
>morais@kde.org</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 
</authorgroup>
</sect1info>
<title
><sgmltag class="element"
>Elemento KugarData</sgmltag
></title>

<para
>O elemento <sgmltag class="element"
>KugarData</sgmltag
> define uma fonte de dados do relatório. A estrutura básica é uma colecção de linhas e colunas. Este documento não define os tipos de dados nem os seus atributos. O modelo do relatório define a informação do tipo de dados da coluna. </para>

<para
>O criador do documento poderá aplicar uma folha de estilo &XSL; para um documento existente de modo a convertê-lo neste formato. Se for usada a &XSL;, o criador poderá aplicar macros personalizadas com ela para os cálculos das colunas, a ordenação, &etc;. </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
>Elemento dados Kugar (KugarData)</title>
<para
>O elemento <sgmltag class="element"
>KugarData</sgmltag
> contém zero ou mais elementos <sgmltag class="element"
>Row</sgmltag
>. Um elemento <sgmltag class="element"
>Row</sgmltag
> deverá conter um atributo <sgmltag class="attribute"
>level</sgmltag
> com o valor correspondente ao nível de detalhe do modelo. Os outros atributos representam as colunas de dados. </para>
<para
><anchor id="template-att"/>O valor do atributo <sgmltag class="attribute"
>Template</sgmltag
> é o &URL; do modelo de relatório usado para formatar os dados. </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
>Elemento linha (Row)</title>

<variablelist>

<varlistentry>
<term
>Atributos</term>
<listitem>

<variablelist>

<varlistentry>
<term
><anchor id="level-att"/><sgmltag class="attribute"
>level</sgmltag
></term>
<listitem>
<para
>O valor do atributo indica qual o detalhe no modelo de relatório que é usado para mostrar os dados. As linhas poderão conter vários conjuntos de colunas para vários níveis, como tal, qualquer atributo excepto o <sgmltag class="attribute"
>level</sgmltag
> deverá ser indicado como #IMPLIED (implícito). </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><anchor id="column-att"/><sgmltag class="attribute"
>column</sgmltag
></term>
<listitem>
<para
>O nome do atributo é o nome da coluna, o qual usa o formato que é indicado na definição do <sgmltag class="element"
>KugarData</sgmltag
>. O nome do atributo é usado no modelo do relatório para associar os dados aos campos do relatório. </para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>

</sect2>

</sect1>

