docs/koffice/kugar/dataref.docbook

   1 <!-- if you want to validate this file separately, uncomment this prolog:
   2
   3 <?xml version="1.0" ?>
   4 <!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd">
   5
   6 -->
   7
   8 <sect1 id="kugardata-element">
   9 <sect1info>
  10 <authorgroup>
  11 <author
  12 ><firstname
  13 >Alexander</firstname
  14 > <surname
  15 >Dymo</surname
  16 >  <affiliation
  17 > <address
  18 ><email
  19 >cloudtemple@mksat.net </email
  20 ></address>
  21 </affiliation>
  22 </author>
  23 <author
  24 ><firstname
  25 >Phil</firstname
  26 > <surname
  27 >Thompson</surname
  28 >  <affiliation
  29 > <address
  30 ><email
  31 >phil@river-bank.demon.co.uk </email
  32 ></address>
  33 </affiliation>
  34 </author>
  35 <othercredit role="translator"
  36 ><firstname
  37 >Олег</firstname
  38 ><surname
  39 >Баталов</surname
  40 ><affiliation
  41 ><address
  42 ><email
  43 >olegbatalov@mail.ru</email
  44 ></address
  45 ></affiliation
  46 ><contrib
  47 >Перевод на русский язык</contrib
  48 ></othercredit
  49 >
  50 </authorgroup>
  51 </sect1info>
  52 <title
  53 ><sgmltag class="element"
  54 >Элемент KugarData</sgmltag
  55 ></title>
  56
  57 <para
  58 >Элемент <sgmltag class="element"
  59 >KugarData</sgmltag
  60 > определяет источник данных отчёта. Основная структура является набором срок и колонок. Этот документа не определяет типы данных и их атрибуты. Шаблон отчёт определяет информацию о типе данных столбцов. </para>
  61
  62 <para
  63 >Создатель документа может применять таблицы стилей &XSL; к существующему документу, чтобы преобразовать его в этот формат. Если используется &XSL;, создатель может применять заказные макросы используя &XSL; для счётчиков в колонках, сортировки и &etc;. </para>
  64
  65 <synopsis
  66 >&lt;!ELEMENT KugarData (Row*)&gt;
  67 &lt;!ATTLIST KugarData
  68         Template      CDATA  #REQUIRED&gt;
  69
  70 &lt;!ELEMENT Row EMPTY&gt;
  71 &lt;!ATTLIST Row
  72         level         CDATA  #REQUIRED
  73         col1          CDATA  #IMPLIED
  74         col2          CDATA  #IMPLIED
  75         ...           CDATA  #IMPLIED
  76         coln          CDATA  #IMPLIED&gt;
  77 </synopsis>
  78
  79
  80 <sect2 id="kugar-data-element">
  81 <title
  82 >Элемент данных Kugar</title>
  83 <para
  84 >Элемент <sgmltag class="element"
  85 >KugarData</sgmltag
  86 > содержит ноль или более элементов <sgmltag class="element"
  87 >Строка</sgmltag
  88 >. <sgmltag class="element"
  89 >Строка</sgmltag
  90 > может содержать один атрибут <sgmltag class="attribute"
  91 >Уровень</sgmltag
  92 > со значением, соответствующим уровню секции в шаблоне. Остальные атрибуты представляют столбцы данных. </para>
  93 <para
  94 ><anchor id="template-att"/>Значение атрибута <sgmltag class="attribute"
  95 >Template</sgmltag
  96 > является &URL; шаблона отчёта, используемого для форматирования данных. </para>
  97 <!--
  98 <variablelist>
  99 <varlistentry id="template-att">
 100 <term
 101 ><sgmltag class="attribute"
 102 >Template</sgmltag
 103 ></term>
 104 <listitem>
 105 <para>
 106 This is an attribute of the <sgmltag class="element"
 107 >KugarData</sgmltag>
 108 element.  The value of the attribute is the &URL; of the report template
 109 used to format the data.
 110 </para>
 111 </listitem>
 112 </varlistentry>
 113 -->
 114 </sect2>
 115
 116 <sect2 id="row-element">
 117 <title
 118 >Элемент строка</title>
 119
 120 <variablelist>
 121
 122 <varlistentry>
 123 <term
 124 >Атрибуты</term>
 125 <listitem>
 126
 127 <variablelist>
 128
 129 <varlistentry>
 130 <term
 131 ><anchor id="level-att"/><sgmltag class="attribute"
 132 >Уровень</sgmltag
 133 ></term>
 134 <listitem>
 135 <para
 136 >Значение атрибута указывает, какие секции в шаблоне используются для отображения данных. Строки, для отображения данных  могут содержать различные наборы столбцов, так что любой атрибут исключая <sgmltag class="attribute"
 137 >уровень</sgmltag
 138 > должен быть заявлен как #IMPLIED. </para>
 139 </listitem>
 140 </varlistentry>
 141
 142 <varlistentry>
 143 <term
 144 ><anchor id="column-att"/><sgmltag class="attribute"
 145 >колонка</sgmltag
 146 ></term>
 147 <listitem>
 148 <para
 149 >Имя атрибута является и именем колонки, и использует формат который определён в <sgmltag class="element"
 150 >KugarData</sgmltag
 151 >. Имя атрибута используется в шаблоне отчёта для связи данных и полей отчёта. </para>
 152 </listitem>
 153 </varlistentry>
 154 </variablelist>
 155 </listitem>
 156 </varlistentry>
 157 </variablelist>
 158
 159 </sect2>
 160
 161 </sect1>
 162