Definir datos mediante columnas y widgets
El plugin utiliza un sistema parecido a las vistas XML de los ExtendedController del Core. Así para definir un dato u objeto que se imprime dentro del informe debemos utilizar las etiquetas column y dentro de cada column establecer el tipo de dato mediante el uso de un widget.
Tanto la etiqueta column como la etiqueta widget tienen distintos atributos que nos permitirán personalizar la impresión del dato.
Etiqueta column
Mediante esta etiquetas establecemos el lugar y el espacio donde se imprimirá un dato u objeto (linea, imagen, etc). Para ello debemos utilizar los atributos:
- height: Indica el alto reservado para el dato. Por defecto su valor es 15.
- width: Indica el ancho reservado para el dato. Por defecto su valor es 30.
- posx: Indica la posición en el eje horizontal respecto al inicio de la banda donde se encuentra la columna. Por defecto 0.
- posy: Indica la posición en el eje vertical respecto al inicio de la banda donde se encuentra la columna. Por defecto 0.
Ejemplos:
<column posx="510" posy="25" width="60">
[ ... ]
</column>
<column posx="20" width="50">
[ ... ]
</column>
<column posx="10" posy="1" width="550" height="1">
[ ... ]
</column>Etiqueta widget
Cada columna debe tener una etiqueta widget que define el tipo de dato a imprimir. Dado que esto establece un amplio conjunto de posibilidades cada widget utilizado puede necesitar distintos valores o atributos que deben informarse para su correcto funcionamiento. Aún así, existe un conjunto de atributos que son generales a todos los widgets:
- type: (Obligatorio) Indica el widget que se desea utilizar para imprimir el dato.
- value: (Opcional) Si se indica, establece el valor fijo que se imprimirá. Sólo se imprimirá este valor si el atributo fieldname está vacío o no se informa.
- fieldname: (Opcional) Si se indica, establece el nombre del campo que tiene la información a imprimir.
- color: Indica el color del texto con el que se imprimirá el dato. Por defecto black (negro). Los colores se pueden indicar mediante el nombre del color en inglés (ver lista más adelante) o mediante el valor RGB precedido por un '#', por ejemplo #255150204.
Lista de colores
- black: Negro
- blue: Azul
- green: Verde
- orange: Naranja
- red: Rojo
- white: Blanco
- yellow: Amarillo
- silver: Gris claro o Gris Plateado