Personalización de reportes

En este mensaje se presentan los puntos más importantes a considerar para personalizar las salidas del sistema SIU-Mapuche.

Pasos:

1. Ubicar la plantilla provista por Mapuche que genera la salida que se desea modificar. 

El directorio raiz donde se encuentran las plantillas provistas por el sistema se puede consultar accediendo desde el sistema a la opción de menú “Ayuda → Información de Ejecución” y seleccionando el Servidor Web (ver cajita con información de Directorios). Por ejemplo, si se desea personalizar el recibo de sueldo y la institución genera un recibo por cada cargo, la plantilla original se encuentra en <dir_instalacion>\mapuche\aplicacion\php\modelos\impresion\pdf\plantillas\recibos\recibo_por_cargo\siu_recibo_por_cargo.xsl. Nota: Todas las plantillas provistas por el sistema están prefijadas con “siu_”.

2. Copiar la plantilla del punto anterior dentro del directorio de personalizaciones. 

El directorio donde se encuentran las personalizaciones se puede conocer de igual manera que se explicó en el punto anterior (navegando la opción “Información de Ejecución”). Las plantillas dentro del directorio de personalizaciones tienen la misma estructura de directorios que en el punto 1. y deben colocarse siguiendo la misma ruta que en el directorio original. Para el ejemplo de personalización del recibo del punto anterior, la plantilla debería copiarse dentro del directorio <dir_instalación>\mapuche\aplicacion\personalizacion\plantillas\recibos\recibo_por_cargo y ponerle un nombre representativo (por ejemplo: “unl_recibo_por_cargo_con_triplicado.xsl”).

3. Modificar la plantilla creada en el punto 2. para que refleje los cambios deseados.

Los datos contenidos en el XML se pueden consultar descargando el archivo desde el mismo lugar de donde se imprime el reporte. Si faltaran datos en el XML, estos se pueden pedir al equipo de desarrollo para que los incluya en una próxima versión.

Logo: todas las plantillas van a buscar por defecto un archivo con el nombre “logo_institucion.png” que se encuentra dentro del directorio <dir_instalacion>\mapuche\aplicacion\personalizacion\soporte\images. Por lo tanto, para cambiar las plantillas existen dos alternativas:

i) colocar el logo que se desee utilizar en este directorio y ponerle al archivo el nombre "logo_institucion.png" (sobreescribiendo el archivo provisto por el sistema), o

ii) modificar las plantillas personalizadas haciendo referencia al directorio y nombre del archivo que contiene el logo de la institución.

La primer opción es la más sencilla y sin necesidad de modificar ninguna plantilla todas las salidas del sistema saldrán con el logo propio. La segunda opción es más recomendable cuando se desea que algunas salidas en particular utilicen un logo distinto.

El tamaño del logo se ajusta desde dentro de la plantilla. Por ejemplo, en los recibos de sueldos, el tamaño del logo está definido por las siguientes dos variables:


$tamanio_largo_logo = 62;
$tamanio_ancho_logo = 10;

Aclaración: no todos los archivos PNG con transparencia son soportados. En caso de que tener problemas con el formato del logo, por favor ver este hilo del foro: http://comunidad.siu.edu.ar/index.php?topic=3903.msg14852#msg14852

Cambios de versión: Las personalizaciones se mantienen automáticamente entre versiones (si se utiliza el instalador/actualizador del sistema). Por lo tanto, no hay que hacer ningún mantenimiento especial para mantener estas personalizaciones.

EQUIPO MAPUCHE, les consulto. Cualquier dato que no aparezca en un reporte si o si se tiene que pedir al equipo de desarrollo???. Estaba probando modificar la plantilla cargos_en_baja.xsl y si bien la modificación no me dio error al generar el archivo, no me muestra ningún dato.

Quise agregar, luego de la categoria, el caracter. Pero no me muestra datos.

Gracias desde ya
Saludos

Hola Caro,

Si quieren incluir en una plantilla un dato faltante en el XML, deben hacer el pedido y nosotros lo resolvemos.

Con respecto a que no te muestre nada cuando generás un reporte con una plantilla modificada, puede deberse a que haya quedado algún error en la plantilla y el archivo PDF no llegue a generarse. Lamentablemente, debuggear las plantillas suele ser complicado, pero como paso inicial te conviene revisar el log de PHP para ver qué tipo de error está sucediendo.

Un beso,
Igna


Ignacio Marcovecchio
Equipo SIU-Mapuche/Pampa
Consorcio SIU
Tel/Fax +54 2293 432304
http://www.siu.edu.ar

Te pago el log Igna para ver si vos entendes algo de lo que aparece mejor que yo.
Aclaro que la versión de php que tenemos es php 5.3.3-7+squeeze8. Vi algo de “obsoleto” googleando pero no se si tendrá que ver con esto.

Gracias


errorphp.txt (239 KB)

Hola Caro,

Los errores que aparecen en el log son sobre métodos que no existen más en PHP 5.3 y que consume la librería que usamos como soporte para la generación de PDFs (fpdf). Ya tenemos en agenda actualizar esta librería pero eso no es lo que está provocando que la plantilla no funcione.

Lamentablemente, te voy a tener que pedir que vuelvas la plantilla a su versión original y vayas aplicando los cambios que hiciste de a uno, hasta detectar cuál es la línea que está causando que el informe se rompa. Las plantillas suelen ser difíciles de debuggear y eso es lo que solemos hacer nosotros cuando las estamos haciendo y se nos presentan problemas. Una vez que tengas identificada la línea que está generando el problema, si no lográs ver por qué es que está rompiendo el reporte, mandanos esa línea (junto con la plantilla modificada) y te ayudamos a analizarla.

Suerte!!

Un beso,
Igna


Ignacio Marcovecchio
Equipo SIU-Mapuche/Pampa
Consorcio SIU
Tel/Fax +54 2293 432304
http://www.siu.edu.ar

Buenas!
Estoy personalizando el recibo único por legajo y tengo la siguiente duda:
Los valores:
(A) RB 0,00
(B) NRB 0,00
(C) RNB 0,00
(D) NRNB 0,00
Salen siempre en cero.
En primer lugar no tengo claro qué debería salir ahí.
En segundo lugar cómo hacer para que acumule realmente lo que tenga que mostrar.
Gracias!
Agustina

Ya nos dimos cuenta!!
Son los valores configurados en la categoría para:
RB Remuneracion Bonificable
NRB No Rem. Bonificable
RNB Rem. No Bonificable
NRNB No Rem. No Bonificable

Gracias!! y Disculpen las molestias!!
Agustina