¿Cómo configurar la exportación de un reporte para integración con un sistema BI?

Si el reporte de un formulario va a ser consumido por un sistema de Business Intelligence, te recomendamos la siguiente configuración. 

Comando de exportación

Utiliza el comando:

export_doctype_report_native

Puedes ver cómo configurar su ejecución desde ¿Cómo programar tareas automáticas?

Parámetros de configuración del comando

El comando de exportación debe configurarse en modo diferencial o delta. Es decir, el comando debería exportar sólo la información nueva o actualizada. Esto es importante porque el mal uso de este comando puede dar lugar a problemas de rendimiento.

--name

En el parámetro "name" debes indicar el nombre interno del formulario para el cuál se quieren exportar los datos.

--max 10000

El parámetro "max" recibe un número entero e indica la máxima cantidad de líneas que va a contener el reporte. 10.000 es un número razonable de filas, pero debes tener en cuenta el número de documentos de ese formulario que se generan/modifican al día apróximadamente. Los registros se incluyen en el reporte en función de la última fecha de modificación.

--days_ago 2

El parámetro "days_ago" espera un número entero y hace referencia al número de días que se incluirán en el reporte, contados a partir de la fecha actual. 2 o 3 días es una configuración razonable, pero depende también de con qué frecuencia se necesita la información actualizada en el BI. Quizás sólo necesites la información actualizada con caracter mensual, en cuyo caso, puedes indicar 30 días.

En resumen, tu comando debería lucir como:

export_doctype_report_native --name mi_formulario --max 10000 --days_ago 3

Frecuencia de ejecución

Dependerá de cuándo se necesite la informacióna actualizada, por ejemplo, diariamente. Recomendamos que la ejecución del comando se haga durante horas no laborables o cuando el sistema tenga menos carga de trabajo.

Configuración del BI 

Con el comando configurado como hemos mostrado, el reporte se generará únicamente con los nuevos registros o aquellos que han sido modificados. Por tanto, debes configurar el BI para tener en cuenta esta circunstancia. 

También es importante tener en cuenta que la primera vez que configures el BI, tendrás que hacer una exportación de todos los registros.

En tu sistema de BI, necesitarás actualizar los datos en función de una clave, que será el UUID de los documentos.

En Zoho Analytics por ejemplo, esta sería la configuración.