Comprobaciones de umbral
Cuando un archivo bulk se divide en múltiples niveles de flows que interactúan, a menudo es importante poder determinar cuándo completa un nivel de flow.
Por ejemplo, imagina un archivo simple con dos registros de nivel superior, cada uno con 5 subregistros. Desde la perspectiva del procesamiento de flows, podemos representar esto como 2 flows "padre" y 10 flows "hijo". Aquí puede ser importante que un flow "padre" sepa cuándo todos sus "hijos" han completado.
Para esto introducimos el concepto de comprobación de umbral (threshold check). Su trabajo es rastrear la interacción entre los flows padre y sus hijos y determinar cuándo cada uno ha completado.
Cuando se implementa dentro de un flow, la comprobación de umbral rastreará los resultados de todos los hijos y, cada vez que un hijo devuelva su estado de resultado, determinará si el umbral de finalización se ha superado.
Configuración
La comprobación de umbral asume por defecto que, para superarla, se requiere que el 100% de las transacciones hijas se devuelvan con éxito. Esta cifra puede modificarse mediante la propiedad:
ipf.debulker.threshold.percentage=100Resultados
Hay cuatro resultados posibles de la comprobación de umbral:
-
Threshold Passed: se produce cuando el número de registros devueltos con éxito es mayor o igual que el valor de umbral sin que se produzcan fallos.
-
Threshold Failed: se produce cuando el número de registros que se devuelven sin éxito implica que ya no es posible superar el valor de umbral.
-
Threshold Passed With Errors: se produce cuando el número de registros devueltos con éxito es mayor o igual que el valor de umbral pero se han producido errores en algunos registros.
-
In Progress: la comprobación de umbral esperará más registros porque todavía espera suficientes resultados para determinar un resultado.
Cuando se produce cualquiera de los tres primeros resultados se emite un evento equivalente que luego puede manejarse como de costumbre en el flo. Cuando se produce el cuarto resultado, el flow no realiza ninguna acción adicional y espera a que vuelva el siguiente registro.
Uso de la comprobación de umbral
Usamos la comprobación de umbral como una acción normal; llamarla dentro del flow hará que automáticamente se emitan los tres eventos. Estos deberán manejarse según el procesamiento estándar del flow, por ejemplo:
Para una guía detallada sobre cómo usar las comprobaciones de umbral, consulta el quick-start.