Configurar la gestión de errores

Configure error mappings on BPMN nodes to define how Maestro Orchestrate catches, evaluates conditions for, and routes runtime errors during process execution.

Each node in your BPMN process can have one or more error mappings that define how Maestro Orchestrate handles errors thrown at runtime. Use the Error mapping property in the properties panel to specify which errors a node catches, under what conditions, and how to route them.

Errores y asignaciones de error

Maestro Orchestrate distinguishes between two related concepts:

• 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.

When a node throws an error at runtime, Maestro Orchestrate evaluates its error mappings in priority order and applies the first mapping whose condition evaluates to true.

Añadir una asignación de error

Para añadir una asignación de errores a un nodo, utiliza la sección Asignación de errores en el panel de propiedades para definir qué errores detecta el nodo y cómo enrutarlos en runtime.

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).

Resultado

The error mapping is added to the node. Maestro Orchestrate evaluates it at runtime when the node throws an error, applying the first mapping whose condition evaluates to true.

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 el botón del menú para abrir el cuadro de diálogo de creación de errores 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 Orchestrate evaluates error mappings in the order they appear. To change evaluation order, drag a mapping to a new position in the list. The mapping at the top is evaluated first.

Propagación de error

Once an error mapping matches, Maestro Orchestrate routes the error to the appropriate handler attached to the node:

• 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, selecciona el botón del menú.
2. En el cuadro de diálogo que se abre, introduce un nombre y, opcionalmente, un código de error.
3. Selecciona Crear.

Resultado

El error se añade al proceso y se selecciona en la asignación actual.Ahora está disponible como referencia a través de las asignaciones de errores de cualquier nodo.

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