Custom Reporting -- Exporting Relationships and Reports to a Module (4.0.13) - ES

From IHRIS Wiki


Se ha creado una herramienta que permite que las relaciones y todos los informes relacionados y reportViews se exporten de manera sencilla a un módulo que luego se podrá compartir con otras personas.

Habilitando la Herramienta

la herramienta es parte del módulo exportReport. Este módulo puede encontrarse bajo Pages->Admin->exportReport. También se puede habilitar esto con

php index.php --update=1 --enable=exportReport

de las pages del directorio del sitio.

Utilizando la Herramienta

Vaya al sub-directory de páginas del directorio del sitio. El directorio del sitio es donde se encuentra el archivo de módulo del sitio, e.j. iHRIS-Manage-Demo.xml. Ahora escriba este comando:

<source lang="bash"> php index.php --page=admin/exportReport </source> Cuando se ejecute preguntará si desea incluir la relación en el módulo. Sí creó una nueva relación, entonces escriba Y si. Si desea exportar informes nuevos o visualizaciones de informes entonces escriba N no.

A continuación mostrará una lista de todos los informes que utilizan la relación dada. Escriba el número que está al lado del informe(s) que desea incluir. Escriba sólo un número a la vez seguido de enter. Cuando haya seleccionado todo lo que desee incluir escriba q seguido de enter.

Por cada informe que seleccionó, ahora se mostrarán la lista de visualizaciones de informe para ese informe. Una vez más seleccione las visualizaciones del informe que desea incluir en el módulo y escriba q seguido de enter y con eso habrá terminado.

Un archivo se creará llamado CustomReports-full-XXX.xml en su directorio actual. El XXX será reemplazado por la relación que escoja. Sí el archivo ya existe se le agregarán números de esta manera: CustomReports-full-XXX001.xml.

Ahora puede agregar un directorio en el directorio de módulos de su sitio para su módulo nuevo y luego mover el archivo de configuración ahí. Finalmente si desea que este se habilite por defecto, habilite el módulo en su archivo de configuración del sitio.

Opciones

Existen unas cuantas otras opciones por defecto que puede deshabilitar que afectarán el módulo completado.

--version (--version=4.0.3.2)
Fije la versión a ser utilizada por el módulo. Puede fijar esto cuando haya hecho cambios y necesite hacer un nuevo archivo de módulo basado en un módulo existente.
--module (--module=MyReport-relationship)
Fije el nombre del módulo para el módulo y el filename que se creará.
--display (--display="My Report Module")
Fije el nombre a mostrarse para el módulo.
--description (--description="This is my report relationship and report/report view definitions.")
Fije la descripción para el módulo.

La visualización y descripción aparecerán en la página Configure Modules page para definir de manera más detallada el módulo que ha creado.

Pruebas

Al hacer pruebas debe tomar en cuenta dos opciones: ¿Va a hacer una prueba en la misma máquina que utilizó para exportar estos informes? O ¿va a hacer una prueba en otra máquina?

Hacer una Prueba en el Mismo Sitio

Si va a hacer una prueba en el mismo sitio que utilizó para crear estos informes, recuerde que aún tendrá los informes (relaciones, informes y reportViews) que creo en el Navegador. Sin embargo la herramienta para exportar inserta líneas <conflict> que borrarán todas las entradas creadas desde la Graphical User Interface. Por alguna razón a veces esto no trabaja correctamente. Así que tal vez tenga que ir a borrarlos manualmente del Magic Data Browser al buscar en

Configure System -> Browse Magic Data -> modules -> CustomReports -> relationships
desde aquí tiene que borrar las relaciones que está seguro que exportó al archivo XML.

Debería repetir lo mismo para informes y reportViews. Luego habilite su módulo en el archivo site config e inicie la actualización desde el navegador.

Warning:
debe ser extra cuidadoso de no borrar algo que no esté relacionado con lo que exportó.

Hacer una Prueba en una máquina/sitio diferente

Esto no significa que necesariamente debe ser en una máquina diferente, podría ser simplemente otra instancia de iHRIS ejecutándose en la misma máquina. Tendrá que borrar las entradas de <erase> en el archivo de módulo final y luego habilitarlos en la site config.