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

状态	How it's reached
新添加	The item is added to the queue.
正在进行	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.
已放弃	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.

备注：

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.

字段	必填	描述
Queue name	是	The Orchestrator queue to add the item to.
文件夹路径	是	The Orchestrator folder that contains the queue.
优先级	否	The processing priority of the item.
截止日期	否	The date and time by which the item must be processed.
延期日期	否	The earliest date and time the item becomes available for processing.
Custom data	否	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.

字段	必填	描述
Queue name	是	The Orchestrator queue to add items to.
文件夹路径	是	The Orchestrator folder that contains the queue.
项目	是	The list of items to add, up to 15,000 per call.
Commit type	是	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.

字段	必填	描述
Queue name	是	The Orchestrator queue to remove items from.
文件夹路径	是	The Orchestrator folder that contains the queue.
项目	是	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.

字段	必填	描述
Defer date	是	The earliest date and time the item becomes available for processing again.
到期日期	否	The deadline by which the item must be processed.

备注：

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.

字段	必填	描述
进度	是	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.

字段	必填	描述
状态	是	Successful or Failed.
Error type	条件	Required when status is Failed. BusinessException or ApplicationException.
错误原因	条件	Required when status is Failed. A short description of the error.
错误详情	否	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.