Bundle Verificador de Procesos

Disponible a partir de Release 5.3.0 (Ultimate) de Plataforma

Introducción

El nuevo activo Verificador de Procesos permite comprobar el resultado de la ejecución de procesos desarrollados sobre la plataforma permitiendo verificar la carga correcta de datos en plataforma.

Además de esto, el Verificador de Procesos nos permite añadir reglas a estos procesos para un mayor control de los datos insertados, por ejemplo una regla que compruebe la correcta integridad de los datos cargados (dataExist) o una que nos permita controlar el número de registros cargados (volumetry).

Conceptos del Verificador de Procesos

En el diagrama podemos ver el flujo que sigue el Verificador de Procesos:

 


Entidad bitácora

Esta entidad contiene la información sobre los procesos a verificar.

image-20240110-103956.png

Esta Entidad almacena la información sobre los procesos a lanzar así como las reglas a aplicar, sus atributos son:

  • process: en este campo se registrará el nombre del proceso.

  • date: hace referencia al campo del proceso que almacena la fecha de la inserción de información.

  • granularity: frecuencia de los datos insertados.

  • temporality: frecuencia con la que se insertan los datos.

  • day_week: día de la semana en la que se realiza la carga de datos (Lunes = 1, Domingo = 7).

  • day_month: día del mes en el que se realiza la carga de datos.

  • monthly_mismatch: diferencia de meses entre la carga de datos y la información que esta referencia.

  • weekly_mismatch: diferencia de semanas entre la carga de datos y la información que esta referencia.

  • daily_mismatch: diferencia diaria entre la carga de datos y la información que esta refencia.

  • comments: comentarios que podemos añadir sobre el proceso para más información.

  • rules: campo que alberga la definición de las reglas que aplican a cada proceso. Este campo se divide a su vez de la siguiente forma:

    • type: tipo de regla que aplica para este proceso.

    • records: registros esperados para este proceso (solo aplica en regla “volumétrica”).

    • tolerance: tolerancia de registros esperados (solo aplica en regla “volumétrica”).

Entidad Registro

Esta entidad almacena el registro de ejecución de los procesos y si han superado las distintas reglas definidas para estos:

 

  • process: nombre del proceso.

  • date: fecha donde se ha realizado la verificación.

  • type: tipo de regla que se ha verificado.

  • detail: información en caso de error en la verificación.

  • status: registro sobre el estado del proceso para cierta regla(“Passed” o “Failed”).

¿Cómo usar el Verificador de procesos?

Flujo Main

Para usar el Verificador de Procesos crearé un flujo en el FlowEngine como este:

En el fujo Main tendremos un “trigger” manual que nos permitirá lanzar el proceso bajo petición. En la imagen se muestra cómo ejecutarlo en una fecha concreta:

Además el proceso puede lanzarse de forma dinámica por el nodo “trigger dynamic” una vez por día.

En los nodos de parametrización definimos las siguientes variables:

  • fecha: fecha de día de hoy.

  • ont: entidad bitácora de la cual obtendremos la información.

  • ontLog: entidad registro donde insertaremos la información.

Flujo de ejecución de las reglas

En este flujo se define toda la configuración necesaria antes de verificar las distintas reglas de cada proceso:

 

En el nodo de “parametrización consulta” se lleva a cabo la formación de la query necesaria para obtener la información de cada proceso y almacenarla en la variable “msg.payload

Con el nodo “payload to JSON” simplemente se transforma la salida de la query a un JSON, mientas que el nodo “split payload” nos separa el este JSON en distintos objetos.

Después de esto se debe realizar la separación de reglas, esto se realizar en el nodo “split rules”, donde creamos una nueva variable ( msg.rule ) que utilizaremos en el siguiente nodo “switch” para separar los objetos y aplicaremos la regla que le aplique.

Después de pasar por el flujo de la regla que se deba aplicar realizaremos la inserción del resultado en la entidad registro.

Reglas:

Después de separar por reglas entramos a la definición de cada una de ellas en sus respectivos flujos. Podremos añadir cuantas reglas deseemos, inicialmente se incluyen estas dos:

Regla dataExist

En esta regla comprobamos la existencia de datos para la granularidad especificada en el proceso, en caso de no existir datos se dará la regla como “Failed” y se dejará reflejado en el campo “detail” un mensaje explicativo del motivo del error.

En el caso contrario la regla quedara como “Passed”.

Regla volumetry

Con esta regla se comprueba el volumen de datos registrados para un proceso en específico. El número de registros esperados y la tolerancia (número porcentual) viene dados dentro de la misma regla.

En caso de recibir un numero de registros que este dentro de los esperados se dará la regla como “Passed”, pero en caso contrario esta quedará como “Failed” y se añadira en el campo “detail” un mensaje explicativo del fallo.


Ejemplo de ejecución

A continuación, mostraremos un ejemplo de la ejecución de este verificador para estos procesos:

Código del ejemplo para el Flow Engine

En este ZIP se encuentra el código del activo para importar en Plataforma.

Para importarlo simplemente descargaremos el archivo y nos dirigiremos a la sección de “Bundle Load“ dentro de “Version Control” en Plataforma.

Una vez en esta página haremos click en el boton “Upload ZIP” y esto tran ello en “Import“.

Definición Proceso 1:

  • process: Process1

  • date: datetime

  • fromat: yyyy/mm/dd

  • granularity: daily

  • temporality: weekly

  • day_week: 0

  • day_month: 0

  • monthly_mismatch: 0

  • weekly_mismatch: 0

  • daily_mismatch: 0

  • rules:

    • Item 1

      • type: dataExist

    • Item 2

      • type: volumetry

      • records: 336

      • tolerance: 20

Definición Proceso 2:

  • process: Process2

  • date: datetime

  • fromat: yyyy/mm/dd

  • granularity: daily

  • temporality: weekly

  • day_week: 0

  • day_month: 0

  • monthly_mismatch: 0

  • weekly_mismatch: 0

  • daily_mismatch: 0

  • rules:

    • Item 1

      • type: dataExist

    • Item 2

      • type: volumetry

      • records: 1

      • tolerance: 20

Para este caso no existirán datos del proceso 1 el día 14/22/2023, además de ello el total de registros insertados del proceso 2 es 66.

Tras lanzar nuestro verificador de procesos el resultado en la entidad registro será el siguiente: