# Tutorial

Este tutorial intenta ser una introducción breve a Kugar.

Creará un informe de ejemplo con &kudesigner;, un archivo de datos de ejemplo, y finalmente generará un informe completo.

El código fuente de las plantillas de ejemplo y los archivos de datos se puede encontrar en `sample1.kut` y `sample1.kud`, que se distribuyen con &kugar;.

## Creando la plantilla del informe con &kudesigner;

Ejecute el diseñador de Kugar tecleando `kudesigner` en el shell.

Tras iniciar el diseñador, seleccione Archivo|Nuevo y fije el tamaño de página a Carta y la orientación del papel a Apaisado. Fije los márgenes izquierdo y derecho a 48, los márgenes superior e inferior a 40. Todas las dimensiones en &kudesigner; (márgenes de página, tamaños, posiciones, etc.) se miden en milímetros. Diálogo Nuevo informe

El nuevo informe se crea ahora y todos los botones de la Barra de herramientas de elementos y Barra de herramientas de secciones se activan (también se activan los elementos del menú correspondientes de Elementos y Secciones). Diálogo de infome vacío

Ahora hay que añadir algunas secciones al informe y determinar sus tamaños. Añadiremos encabezado y pie del informe, encabezados y pies de la página y una sección de detalle sencilla. Los encabezados y los pies del informe se imprimen en la primera y última página del informe antes de cualquier otro dato del informe. Los pies del informe son buenos sitios para los datos calculados. Los encabezados y pies de página se imprimen arriba y abajo de cada página. Nuestro informe tendrá una sección de detalle con el nivel 0. Esto significa que todas nuestras filas de datos tienen idéntica estructura (&ie;, campos). Si la estructura de datos es más compleja o si está organizada de acuerdo a una relación maestro-detalle, se pueden crear más niveles de detalle. Vea `sample3.kut` y `sample3.kud` para un ejemplo de cómo se puede hacer esto. Vea las descripciones de los elementos de la plantilla para obtener información adicional.

Las secciones se añaden usando el menú Secciones o la barra de herramientas Secciones. Ahora añada un encabezado y pie del informe, encabezado y pie de la página y luego el detalle. Al añadir la sección del detalle, fije su nivel a 0 como se muestra en la captura de pantalla de abajo. Fijando el nivel de detalle

Nuestro informe se debe parecer a éste de la captura de pantalla. Informe con secciones

Todas nuestras secciones tienen una altura predefinida - 50mm. Cambiémosla. Para ello, haga &RMB; sobre la sección de encabezado del informe o haga clic en el botón Editar propiedades de la barra de herramientas de edición y luego elija una sección. Se debe mostrar la ventana de propiedades. Editando la altura de la sección

Ahora fije una altura del encabezado del informe de 70. Realice este proceso para todas las demás secciones. Fije la altura del encabezado de página a 45 y la del detalle a 30. Los pies del informe deben tener una altura de 32 mm.

La plantilla del informe con los tamaños de secciones adecuados ya está lista para ser rellenada con elementos del informe. Informe con secciones con tamaño

Ahora puede añadir elementos a las secciones del informe. Se pueden añadir al informe cinco tipos diferentes de elementos. Etiqueta es un área rectangular que puede tener bordes y se puede rellenar con cualquier clase de datos de texto. Tanto el texto como los colores del fondo y las tipografías se pueden cambiar en la etiqueta. Los tipos de líneas de bordes y los colores de las líneas también son personalizables. Campo se puede poner en una sección de detalle. El campo representa los campos de datos, sus valores serán capturados de un archivos de datos al generar el informe. Se pueden imprimir contadores, sumas, promedios, etc. para los valores del campo en el informe por medio de los Campos calculados. Especiales son etiquetas con texto predefinido, como la fecha actual o el número de página. El aspecto general del informe se puede refinar con las Líneas.

Para añadir un elemento del informe, haga clic sobre el botón del elemento correspondiente en la barra de herramientas Elementos y póngalo (clic) en la sección. Los elementos elegidos se ponen en la sección seleccionada con la esquina superior izquierda en las coordenadas dadas. Otras propiedades se fijan a los valores predeterminados y se pueden cambiar con el diálogo Opciones del elemento del informe (de la misma forma que solíamos cambiar el alto de la sección).

Por tanto, añada etiquetas al encabaezado del informe y al encabezado de página como se muestra en la captura de pantalla de abajo. Fíjese en que la etiqueta Mutiny Bay Software tiene su BorderStyle y BorderWidth fijados a 0 y Software Inventory Report - 1mm. Cualquier color se fija como una combinación de tres valores (RGB - rojo, verde, azul) divididos por comas.

Añada también elementos de campos a la sección de detalle. Simplemente, suponga que tenemos cuatro campos - título, versión, plataforma y copias. Por tanto, se deben poner cuatro elementos Campo y fijar sus propiedades de Campo. Tenga en cuenta que la propiedad Texto se pone automáticamente a [`nombre_campo`]

El pie de página hay un buen sitio para mostrar la fecha y el número de la página actual, así que añada dos campos especiales y fije sus propiedades Tipo a 0 y 1 respectivamente. En especial, con Tipo=0 representará la fecha y en el Tipo=1, el número de página. Tenga en cuenta que la propiedad Texto de los campos especiales se cambia automáticamente.

El último elemento a ubiar es Campo calculado, para el campo copias. Para lograr una suma de las copias, fije la propieda Campo del campo calculado a copias y Tipo de cálculo a 1 (función suma).

Al final, la plantilla de informe debe parecerse a ésta. Informe completo

## Creando el archivo de datos del informe

Los archivos de datos se pueden crear de varias formas. Unos pueden usar las tablas de transformación xsl para generar &XML; válido desde otro documento &XML; (como la hoja de datos &kspread;), otros usarán sus propios programas para capturar datos de una base de datos y rellenar el archivo de datos. En este tutorial, simplemente lo crearemos a mano. El código fuente para el ejemplo se puede encontrar en el archivo `sample1.kud` o se puede copiar del ejemplo de abajo.

    <?xml version=1.0 encoding=UTF-8?>

    <!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.kut">
        <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>

## Generando el informe

Ahora tenemos una plantilla de informe (`sample1.kut`) y los datos del informe (`sample1.kud`).

Para generar un informe, teclee el siguiente comando en la shell:`kugar `-r `sample1.kut`` `-d `sample1.kud```

Esto hará surgir una ventana de shell de &kugar; con el informe generado. Informe generado