You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
381 lines
12 KiB
381 lines
12 KiB
<!-- If you want to validate or edit this document 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">
|
|
|
|
-->
|
|
<chapter id="tutorial">
|
|
<chapterinfo>
|
|
<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
|
|
>Rafael</firstname
|
|
> <surname
|
|
>Carreras</surname
|
|
> <affiliation
|
|
><address
|
|
><email
|
|
>rcarreras@caliu.cat</email
|
|
></address
|
|
></affiliation
|
|
> <contrib
|
|
>Traductor</contrib
|
|
> </othercredit
|
|
>
|
|
</authorgroup>
|
|
</chapterinfo>
|
|
<title
|
|
>Tutorial</title>
|
|
|
|
<para
|
|
>Aquest tutorial pretén ser una breu introducció al Kugar.</para>
|
|
|
|
<para
|
|
>Podeu crear una plantilla d'informe de prova amb el &kudesigner;, un fitxer de dades de prova i, finalment, generar un informe complet.</para>
|
|
|
|
<para
|
|
>El codi font per a les plantilles de prova i els fitxers de dades es poden trobar a <filename
|
|
>sample1.ktf</filename
|
|
> i <filename
|
|
>sample1.kdf</filename
|
|
>, que es distribueixen amb el &kugar;.</para>
|
|
|
|
|
|
<sect1 id="tut-1">
|
|
<title
|
|
>Creant la plantilla d'informe amb el &kudesigner;</title>
|
|
|
|
<para
|
|
>Executeu el Kugar Designer teclejant <command
|
|
>kudesigner</command
|
|
> al terminal. </para>
|
|
|
|
<para
|
|
>Després d'iniciar el dissenyador, escolliu <guimenu
|
|
>Fitxer</guimenu
|
|
>|<guilabel
|
|
>Nou</guilabel
|
|
> i arrangeu la mida de la pàgina <guilabel
|
|
>Carta</guilabel
|
|
> i orientació del paper a <guilabel
|
|
>Apaïsat</guilabel
|
|
>. Arrangeu els marges esquerre i dret a 48, els marges dalt i baix a 40. Totes les dimensions en el &kudesigner; (marges de pàgina, mides, posicions, &etc;) es mesuren en mil·límeters. <screenshot
|
|
> <mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="tut_file_new.png" format="PNG"/>
|
|
</imageobject>
|
|
<textobject>
|
|
<phrase
|
|
>Diàleg <interface
|
|
>Nou informe</interface
|
|
></phrase>
|
|
</textobject>
|
|
</mediaobject>
|
|
</screenshot>
|
|
</para>
|
|
|
|
<para
|
|
>Ara s'ha creat un nou informe i estan disponibles tots els botons de la <guilabel
|
|
>Barra d'eines Ítems</guilabel
|
|
> i la <guilabel
|
|
>Barra d'eines Seccions Toolbar</guilabel
|
|
> (els corresponents ítems de menú d'<guilabel
|
|
>Ítems</guilabel
|
|
> i <guilabel
|
|
>Seccions</guilabel
|
|
> també estan disponibles). <screenshot
|
|
> <mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="tut_empty_report.png" format="PNG"/>
|
|
</imageobject>
|
|
<textobject>
|
|
<phrase
|
|
>Finestra d'informe buida</phrase>
|
|
</textobject>
|
|
</mediaobject>
|
|
</screenshot>
|
|
</para>
|
|
|
|
<para
|
|
>Ara és hora d'afegir algunes seccions a l'informe i determina les seves mides. Afegirem un <link linkend="report-header-and-footer"
|
|
>capçalera i peu d'informe</link
|
|
>, <link linkend="page-header-and-footer"
|
|
>capçalera i peu de pàgina</link
|
|
> i una única secció <link linkend="detail"
|
|
>detall</link
|
|
>. Les capçaleres i peus d'informe s'imprimeixen a la primera i última pàgina de l'informe abans i després de qualsevol altra dada d'informe. Els peus d'informe són bons llocs per a <link linkend="calculated-field-element"
|
|
>camps calculats</link
|
|
>. Les capçaleres i peus de pàgina s'imprimeixen a la part superior i inferior de cada pàgina. El nostre informe tindrà una secció de detall amb nivell 0. Això vol dir que totes les nostres files de dades tenen idèntica estructura (és a dir, camps). Si l'estructura de dades és més complexa o està organitzada d'acord amb una relació master-detall, s'hauran de crear més nivells de detall. Mireu <filename
|
|
>sample3.ktf</filename
|
|
> i <filename
|
|
>sample3.kdf</filename
|
|
> per a un exemple de com es pot fer això. Referiu-vos a les <link linkend="template-elements"
|
|
>descripcions d'elements de plantilla</link
|
|
> per a informacions addicionals. </para>
|
|
|
|
<para
|
|
>Les seccions s'afegeixen usant el menú <guilabel
|
|
>Seccions</guilabel
|
|
> o una <guilabel
|
|
>Barra d'eines Seccions</guilabel
|
|
>. Ara afegiu una capçalera i peu d'informe, una capçalera i peu de pàgina i llavors una secció detall. Quan afegiu una secció detall, arrangeu el seu nivell a 0 com es mostra a la captura de pantalla de sota. <screenshot
|
|
> <mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="tut_set_level.png" format="PNG"/>
|
|
</imageobject>
|
|
<textobject>
|
|
<phrase
|
|
>Arranjant el nivell de detall</phrase>
|
|
</textobject>
|
|
</mediaobject>
|
|
</screenshot>
|
|
</para>
|
|
|
|
<para
|
|
>El nostre informe ha de semblar-se a aquest a la captura de pantalla. <screenshot
|
|
> <mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="tut_rep_look1.png" format="PNG"/>
|
|
</imageobject>
|
|
<textobject>
|
|
<phrase
|
|
>Informe amb seccions</phrase>
|
|
</textobject>
|
|
</mediaobject>
|
|
</screenshot>
|
|
</para>
|
|
|
|
<para
|
|
>Totes les nostres seccions tenen una alçada predefinida - 50mm. Canviem-la. Per a fer-ho, dretcliqueu a la secció Capçalera d'informe o cliqueu el botó <guilabel
|
|
>Edita les propietats</guilabel
|
|
> a la <guilabel
|
|
>Barra d'eines Edita</guilabel
|
|
> i llavors escolliu una secció. S'hauria de mostrar la finestra de Propietats. <screenshot
|
|
> <mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="tut_edit_height.png" format="PNG"/>
|
|
</imageobject>
|
|
<textobject>
|
|
<phrase
|
|
>Editant l'alçada de la secció</phrase>
|
|
</textobject>
|
|
</mediaobject>
|
|
</screenshot>
|
|
</para>
|
|
|
|
<para
|
|
>Ara arrangeu l'alçada de la capçalera d'informe a 70. Fem el mateix peer a totes les altres seccions. Arrangeu l'alçada de capçalera de pàgina a 45 i la de detalls a 30. Els peus de pàgina i d'informe han de ser de 32 mm d'alçada. </para>
|
|
|
|
<para
|
|
>Una plantilla d'informe amb les seccions correctament amidades està llesta per a omplir-se amb ítems d'informe. <screenshot
|
|
> <mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="tut_rep_look2.png" format="PNG"/>
|
|
</imageobject>
|
|
<textobject>
|
|
<phrase
|
|
>Informe amb les seccions amidades</phrase>
|
|
</textobject>
|
|
</mediaobject>
|
|
</screenshot>
|
|
</para>
|
|
|
|
<para
|
|
>Ara podeu afegir-hi ítems a les seccions de l'informe. Es poden afegir cinc tipus diferents d'ítems a l'informe. <link linkend="label-element"
|
|
>Etiqueta</link
|
|
> és una àrea rectangular que poden tenir vores i es poden omplir amb qualsevol tipus de dades textuals. Els colors de primer pla i de fons de l'etiqueta, així com fonts, es poden afegir. Els tipus de línia de les vores i els colors de línia també són personalitzables. Els <link linkend="field-element"
|
|
>Camps</link
|
|
> es poden emplaçar en una secció detall. Els Camps representen camps de dades; els seus valors es recolliran des d'un fitxer de dades mentre es genera un informe. Els comptes, sumatoris, mitjanes, &etc; per als valors de camp es poden imprimir a l'informe mitjançant <link linkend="calculated-field-element"
|
|
>Camps calculats</link
|
|
>. <link linkend="special-element"
|
|
>Especials</link
|
|
> són etiquetes amb text predefinit, com a dada actual o número de pàgina. L'aparença d'informe general es pot refinar amb <link linkend="line-element"
|
|
>Línies</link
|
|
>. </para>
|
|
|
|
<para
|
|
>Per a afegir un ítem d'informe, cliqueu el botó de l'ítem corresponent de la <guilabel
|
|
>Barra d'eines d'ítems</guilabel
|
|
> i emplaceu-lo (clic) a la secció. L'ítem escollit s'emplaçarà a la secció seleccionada amb la cantonada superior esquerra a les coordenades donades. Altres propietats s'arrangen als valors per omissió i es poden canviar amb el diàleg <guilabel
|
|
>Opcions d'ítem d'informe</guilabel
|
|
> (la mateixa manera que vam fer servir per a canviar l'alçada de la secció). </para>
|
|
|
|
<para
|
|
>Bé, anem a afegir etiquetes a les capçaleres d'informe i de pàgina com es mostra a la captura de pantalla de sota. Noteu que l'etiqueta <quote
|
|
>Mutiny Bay Software</quote
|
|
> té les seves <guilabel
|
|
>BorderStyle</guilabel
|
|
> i <guilabel
|
|
>BorderWidth</guilabel
|
|
> arranjades a 0 i <quote
|
|
>Software Inventory Report</quote
|
|
> a 1mm. Qualsevol color està arranjat a una combinació de tres valors (RGB - red,green,blue) separats per comes. </para>
|
|
|
|
<para
|
|
>També volem afegir elements a la secció detall. Just assumiu que tenim quatre camps - títol, versió, plataforma i còpies. Per tant, s'emplaçaran quatre elements de <guilabel
|
|
>Camp</guilabel
|
|
> i els seus conjunts de propietats de <guilabel
|
|
>Camp</guilabel
|
|
>. Noteu que la propietat <guilabel
|
|
>Text</guilabel
|
|
> s'arranja automàticament a <quote
|
|
>[<userinput
|
|
>field_name</userinput
|
|
>]</quote
|
|
>. </para>
|
|
|
|
<para
|
|
>El nostre peu de pàgina és un bon lloc per a mostrar la data actual i el número de pàgina, així que hi afegim dos camps especials i arranjats les seves propietats de <guilabel
|
|
>Tipus</guilabel
|
|
> a 0 i 1. Un especial amb Type=0 representarà la data i una amb Type=1 el número de pàgina. Noteu que la propietat especial de <guilabel
|
|
>Text</guilabel
|
|
> es canvia automàticament. </para>
|
|
|
|
<para
|
|
>L'últim element per a emplaçar és un <guilabel
|
|
>Camp calculat</guilabel
|
|
> per al camo <quote
|
|
>còpies</quote
|
|
>. Per a adquirir un sumatori (còpies) arrangeu la propietat del camp calculat <guilabel
|
|
>Camp</guilabel
|
|
> a <quote
|
|
>còpies</quote
|
|
> i <guilabel
|
|
>CalculationType</guilabel
|
|
> a 1 (funció sum). </para>
|
|
|
|
<para
|
|
>Finalment, la nostra plantilla d'informe hauria de semblar-se a això: <screenshot
|
|
> <mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="tut_rep_complete.png" format="PNG"/>
|
|
</imageobject>
|
|
<textobject>
|
|
<phrase
|
|
>Informe complet</phrase>
|
|
</textobject>
|
|
</mediaobject>
|
|
</screenshot>
|
|
</para>
|
|
|
|
</sect1>
|
|
|
|
|
|
|
|
<sect1 id="tut-2">
|
|
<title
|
|
>Crea el fitxer de dades d'informe</title>
|
|
|
|
<para
|
|
>Generalment, els fitxers de dades es poden crear de moltes maneres. Algunes usaran taules de transformació xsl per a generar &XML; correcte des d'un altre document &XML; (com el full de càlcul &kspread;); altres usaran el seu propi programa per a agafar les dades des d'una base de dades i omplir el fitxer de dades. En aquest tutorial, el crearem simplement a mà. El codi font per a l'exemple es pot trobar al fitxer <filename
|
|
>sample1.kdf</filename
|
|
> o es pot copiar des de l'exemple de sota. </para>
|
|
|
|
<programlisting
|
|
><?xml version=<quote
|
|
>1.0</quote
|
|
> encoding=<quote
|
|
>UTF-8</quote
|
|
>?>
|
|
|
|
<!DOCTYPE KugarData [
|
|
<!ELEMENT KugarData (Row* )>
|
|
<!ATTLIST KugarData
|
|
Template CDATA #REQUIRED>
|
|
|
|
<!ELEMENT Row EMPTY>
|
|
<!ATTLIST Row
|
|
level CDATA #REQUIRED
|
|
title CDATA #REQUIRED
|
|
version CDATA #REQUIRED
|
|
platform CDATA #REQUIRED
|
|
copies CDATA #REQUIRED>
|
|
]>
|
|
|
|
<KugarData Template="sample1.ktf">
|
|
<Row level="0" title=" BRU" version="15.0" platform="x86" copies="1"/>
|
|
<Row level="0" title=" Caldera Open Linux" version="2.2" platform="x86" copies="3"/>
|
|
<Row level="0" title=" K Desktop" version="1.1.1" platform="x86" copies="1"/>
|
|
<Row level="0" title=" Netscape Communicator" version="4.6" platform="x86" copies="10"/>
|
|
<Row level="0" title=" Redhat Linux" version="5.0" platform="x86" copies="11"/>
|
|
<Row level="0" title=" Redhat Linux" version="5.1" platform="x86" copies="12"/>
|
|
<Row level="0" title=" Redhat Linux" version="5.2" platform="x86" copies="14"/>
|
|
<Row level="0" title=" Redhat Linux" version="6.0" platform="x86" copies="15"/>
|
|
<Row level="0" title=" Star Office" version="5.0" platform="x86" copies="1"/>
|
|
<Row level="0" title=" Star Office" version="5.1" platform="x86" copies="3"/>
|
|
<Row level="0" title=" Microsoft Windows NT" version="3.1" platform="x86" copies="1"/>
|
|
<Row level="0" title=" Microsoft Windows NT" version="3.51" platform="x86" copies="1"/>
|
|
<Row level="0" title=" Microsoft Windows NT" version="4.0" platform="x86" copies="1"/>
|
|
<Row level="0" title=" Microsoft Windows NT" version="5.0" platform="x86" copies="1"/>
|
|
<Row level="0" title=" Sun Solaris" version="2.5" platform="Sparc" copies="1"/>
|
|
</KugarData>
|
|
</programlisting>
|
|
|
|
</sect1>
|
|
|
|
<sect1 id="tut-3">
|
|
<title
|
|
>Generant l'informe</title>
|
|
|
|
<para
|
|
>En aquest moment, tenim una plantilla d'informe (<filename
|
|
>sample1.ktf</filename
|
|
>) i un fitxer de dades d'informe (<filename
|
|
>sample1.kdf</filename
|
|
>). </para>
|
|
<para
|
|
>Per a generar un informe, teclegeu la següent comanda al terminal: <command
|
|
>kugar <option
|
|
>-r <replaceable
|
|
>sample1.ktf</replaceable
|
|
></option
|
|
> <option
|
|
>-d <replaceable
|
|
>sample1.kdf</replaceable
|
|
></option
|
|
></command
|
|
> </para>
|
|
|
|
<para
|
|
>Això presentarà una finestra d'espai de treball del &kugar; amb l'informe generat. <screenshot
|
|
> <mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="tut_rep_generated.png" format="PNG"/>
|
|
</imageobject>
|
|
<textobject>
|
|
<phrase
|
|
>Informe generat</phrase>
|
|
</textobject>
|
|
</mediaobject>
|
|
</screenshot>
|
|
</para>
|
|
|
|
</sect1>
|
|
|
|
</chapter>
|