Queue task activities

Queue task activities in Maestro BPMN processes: required fields for creating, updating, and resolving Orchestrator queue items, organized by activity.

Queue task activities create, update, and resolve Orchestrator queue items from a task in a Maestro BPMN process. Queue activities are accessed from the Action dropdown in a task's Properties panel. Queue activities are available in the following task types — refer to Tasks for the full list:

• Service tasks
• User tasks
• Send tasks
• Receive tasks
• Business rule tasks
• Script tasks

Queue item lifecycle

Estado	How it's reached
Nuevo	The item is added to the queue.
EnCurso	A queue trigger starts a process instance for the item and sets it to InProgress.
Successful / Failed	The process sets the final state with Set transaction status.
Abandonado	Automatic, if an item stays InProgress for 24 hours without reaching a final state. If retry is configured on the queue, Orchestrator clones the item and re-queues it.

Nota:

One queue item starts exactly one Maestro BPMN process instance. A single instance consuming multiple items in a loop isn't supported in this release.

Create queue items

Adds a new item to an Orchestrator queue with New status.

Campo	Obligatorio	Descripción
Queue name	Sí	The Orchestrator queue to add the item to.
Ruta de la carpeta	Sí	The Orchestrator folder that contains the queue.
Prioridad	No	The processing priority of the item.
Fecha límite	No	The date and time by which the item must be processed.
Posponer fecha	No	The earliest date and time the item becomes available for processing.
Custom data	No	Additional data attached to the item, available to the robot or process that processes it.

Create and wait for queue items

Adds an item to a queue and waits for the item to reach a final state before continuing the process. Uses the same fields as Create queue items.

Bulk add queue items

Adds multiple items to a queue in a single batch, up to 15,000 items per call.

Campo	Obligatorio	Descripción
Queue name	Sí	The Orchestrator queue to add items to.
Ruta de la carpeta	Sí	The Orchestrator folder that contains the queue.
Elementos	Sí	The list of items to add, up to 15,000 per call.
Commit type	Sí	AllOrNothing rejects the entire batch if any item fails validation. ProcessAllIndependently adds all valid items and reports failures individually.

When commit type is ProcessAllIndependently, the activity returns the list of items that failed to be added.

Delete queue items

Removes items with New status from a specified queue.

Campo	Obligatorio	Descripción
Queue name	Sí	The Orchestrator queue to remove items from.
Ruta de la carpeta	Sí	The Orchestrator folder that contains the queue.
Elementos	Sí	The items to remove. Only items with New status can be removed.

Postpone transaction item

Sets a defer date, and optionally a due date, for an in-progress transaction item, and returns the item to New status.

Campo	Obligatorio	Descripción
Defer date	Sí	The earliest date and time the item becomes available for processing again.
Fecha límite	No	The deadline by which the item must be processed.

Nota:

Postpone transaction item isn't retried automatically when the underlying call fails with a 4xx error.

Set transaction progress

Updates an InProgress transaction item with a custom status string. The status is visible in Orchestrator.

Campo	Obligatorio	Descripción
Progreso	Sí	A custom text string describing the current processing state of the item.

Set transaction status

Sets the final state of a transaction item to Successful or Failed.

Campo	Obligatorio	Descripción
Estado	Sí	Successful or Failed.
Error type	Condicional	Required when status is Failed. BusinessException or ApplicationException.
Razón del error	Condicional	Required when status is Failed. A short description of the error.
Detalles de error	No	Additional error information.

Maestro automatically retries the task unless the underlying call fails with a 4xx error. On failure, the task returns the error code OrchestratorSetTransactionResultFailed.

For the trigger that starts a process from a queue item, refer to Events. For more information about tasks, refer to Tasks in BPMN modeling.