Custom Reporting -- Creating Reports

This documentation applies specifically to iHRIS 4.0, although much of it applies to version 3.1.

Uso para el que fue Diseñado

Este paso está destinado para aquel que tenga una comprensión moderada de como los datos se relacionan en el sistema. COnsiste en poco más de escoger una relación de formularios y seleccionar los datos que se quieren en el informe marcando las casillas específicas.

Una vez que el informe ha sido definido, se puede crae un multiple views de los datos en el informe.

Pasos Iniciales

Para crear un informe, primero debe:

• escoger un relationship
• seleccionar un "Display Name" para el informe, el nombre del informe para el usuario final.
• seleccione un "Short Name" para el informe, wo cual es una manera de hacer referencia internamente al informe y sólo puede contener caracteres alfa-numericos y algunos signos limitados de puntuación tales como _ y -.
• Una descripción del informe.
• Una categoría para el informe. Esto se utiliza para agrupar distintas vistas de informes.

Estructura de las Tablas en los Informes

Los informes se basan en form relationship. Cada juego de formularios que satisfacen una relación corresponden a una fila en una tabla de informe. Un informe llamado XXXXX ocasionara que una tabla llamada 'zebra_XXXXX y populated se creen en la base de datos .

Las columnas en una tabla de informe son:

• `$reportFormName+id`: Las id de cada uno de los formularios que satisfacen la relación.
• `$reportFormName+$fieldName`: Cualquiera de los selected fields de cada unao de los formularios en la relación asi como cualquier campo utilizado para limit del reporte.
• `$function`: Cualquier functions que esté seleccionado para el informe

Selección de Campos

Cualquiera de los campos en cualquiera de los formularios que satisfagan la relación de formulario seleccionada puede ser incluido en el reporte.

Selección de Límites

Cualquiera de los campos de un formulario en la relación puede ser seleccionado para limitar el informe. Estos límites apareceran en las vistas del inforem. Hay varias formas (estilos) para limitar un campo, dependiendo del campo, y son catalogados here.

Para cada estilo de límite para un campo, se puede fijar el encabezado de texto bajo el cual el límite es desplegado en la vista del informe.

Selección de Funciones

Cualquiera de las functions definidas para una relación puede ser seleccionada para incluirse en el informe. También pueden ser escogidas como límites.

Pivots

En opciones de Límites para Campos de Informes, hay una opciónn "Enable Pivoting on this Limit". El pivot permite vincular los valores mostrados en un informe a los limites/filtros de otro informe.

Para un ejemplo de esto, observemos el iHRIS Manage Demo site, busque bajo informe "Facility List". Junto a los valores en la columna "Facility Name", se observa un [+]. Supongamos que estamos viendo el "Rushonga Hospital"

Al hacer click en el [+] se abrira una lista de informes relacionados, Job Breakdown, Position List, Staff directory. Si se hace click en el link "Switch to Staff Directory" nos llevará al informe Staff Directory donde el límite del "Rushonga Hospital" ya ha sido aplicado.

Report Table Generation

The zerbra_XXXXX tables contain the data of the report and are built from the form caches. These tables are generated by a background process once a report is consider stale. The background process is spawned by default every 10 minutes. This can be specified by setting the value in magic data at:

• /modules/CustomReports/times/background

The stale time for a report defaults to 10 minutes. This can be over-ridden by the following setting values in magic data:

• /modules/CustomReports/times/stale
• /modules/CustomReports/times/stale_by_report/XXXXX