Configurar la gestión de errores

Cada nodo de tu proceso BPMN puede tener una o varias asignaciones de errores que definen cómo Maestro maneja los errores que se producen en runtime. Usa la propiedad Asignación de errores en el panel de propiedades para especificar qué errores detecta un nodo, en qué condiciones y cómo enrutarlos.

Errores y asignaciones de error

Maestro distingue entre dos conceptos relacionados:

• Los errores se definen en el nivel de proceso. Representan tipos de error nombrados a los que puede hacer referencia cualquier nodo del proceso.
• Las asignaciones de error se definen en el nivel de elemento. Cada nodo tiene su propia lista de asignaciones que se vinculan a los errores en el nivel de proceso y definen las condiciones de captura para ese nodo específico.

Cuando un nodo arroja un error en runtime, Maestro evalúa sus asignaciones de error en orden de prioridad y aplica la primera asignación cuya condición se evalúa como true.

Añadir una asignación de error

1. Selecciona el nodo en el lienzo.
2. En el panel de propiedades, ve a Asignación de errores.
3. Selecciona Añadir asignación.
4. Configura los campos de asignación (consulta Propiedades de asignación de error más abajo).

Propiedades de asignación de error

Campo	Descripción
Error	El error en el nivel de proceso que detecta esta asignación. Selecciona del menú desplegable o haz clic en el botón de menú para abrir el cuadro de diálogo de creación de error y definir un nuevo error en línea. Al seleccionar un error, se establece el errorRef de la asignación como el ID del error en el nivel de proceso elegido.
Condición	Define cuándo se aplica esta asignación. Usa el selector de variables para crear la expresión o cambia al editor de JavaScript o C# para condiciones complejas. Déjalo en blanco para detectar el error incondicionalmente.
Detalles	Una descripción de texto libre para la asignación. Usa esto para el documento de la asignación para tu equipo.

Reordenar las asignaciones por prioridad

Maestro evalúa las asignaciones de error en el orden en que aparecen. Para cambiar el orden de evaluación, arrastra una asignación a una nueva posición de la lista. La asignación que está más arriba se evalúa en primer lugar.

Propagación de error

Una vez que una asignación de errores coincide, Maestro enruta el error al controlador adecuado adjunto al nodo:

• Eventos de límite: el error se propaga al evento de límite de error adjunto al nodo y el proceso sigue la ruta saliente del evento de límite.
• Subprocesos de eventos: los errores que se producen en el proceso principal se propagan a los subprocesos de evento que utilizan un evento de inicio de error, lo que desencadena una gestión de errores centralizada definida en el subproceso.

Para modelar patrones que utilizan eventos de límite y subprocesos de eventos, consulta Errores y recuperación.

Crear errores de proceso

Los errores en el nivel de proceso se comparten entre todos los nodos del proceso. Para crear un nuevo error:

1. En el campo Error de cualquier asignación, haz clic en el botón de menú.
2. En el cuadro de diálogo que se abre, introduce un nombre y, opcionalmente, un código de error.
3. Selecciona Crear. El error se añade al proceso y se selecciona en la asignación actual.

Las asignaciones de diversos nodos pueden hacer referencia al mismo error.