队列任务活动

Queue task activities in 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 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:

• 服务任务
• 用户任务
• 发送任务
• 接收任务
• 业务规则任务
• 脚本任务

队列项目生命周期

状态	这是如何达成的
新添加	该项目随即添加到队列中。
正在进行	队列触发器为项目启动流程实例，并将其设置为正在进行。
成功/失败	流程通过“ 设置事务状态 ”设置最终状态。
已放弃	“自动”如果项目保持“正在进行”持续 24 小时而未达到最终状态。如果在队列上配置了重试功能，则 Orchestrator 会克隆项目并重新加入队列。

备注：

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

创建队列项目

将新项目添加到 Orchestrator 队列中，并以“新”状态进行。

字段	必填	描述
队列名称	是	要将项目添加到的 Orchestrator 队列。
文件夹路径	是	包含队列的 Orchestrator 文件夹。
优先级	否	项目的处理优先级。
截止日期	否	必须处理项目的日期和时间。
延期日期	否	项目可进行处理的最早日期和时间。
自定义数据	否	附加到项目的其他数据，可供处理该项目的机器人或流程使用。

创建并等待队列项目

将项目添加到队列中，等待该项目达到最终状态，然后再继续执行流程。使用与创建队列项目相同的字段。

获取队列项目

查询 Orchestrator 队列中的项目，无需使项目出队或锁定，可实现只读检查或队列状态条件分支。

字段	必填	描述
队列名称	是	要查询的 Orchestrator 队列。
文件夹路径	是	包含队列的 Orchestrator 文件夹。
状态	否	按项目状态筛选。
参考	否	按项目引用筛选。
创建日期范围	否	按创建项目的日期范围筛选。
优先级	否	按项目优先级筛选。

该活动将返回前 100 个最新匹配的项目和总计数。如果筛选器匹配到超过 100 个项目，则返回一个被截断的列表 — 请缩小筛选范围，以查看剩余项目。

等待队列事件

此等待元素可用于接收任务或中间捕获事件，它会阻止执行，直到 Orchestrator 队列中的事务项目变为可用。

字段	必填	描述
队列名称	是	要等待的 Orchestrator 队列。
文件夹路径	是	包含队列的 Orchestrator 文件夹。

当项目出队时，其字段将可作为流程输出，其形式与获取队列项目相同。等待没有超时 — 附加一个边界计时器，以在设置的时长后停止等待。V1 和 V2 执行引擎均支持此元素。

批量添加队列项目

单批将多个项目添加到队列中，每次调用最多添加 15,000 个项目。

字段	必填	描述
队列名称	是	要添加项目的 Orchestrator 队列。
文件夹路径	是	包含队列的 Orchestrator 文件夹。
项目	是	要添加的项目列表，每次调用最多添加 15,000 个项目。
提交类型	是	如果任何项目验证失败，则“全部或无”会拒绝整个批次。“独立处理全部”会添加所有有效项目，并分别报告失败。

当提交类型为“独立处理全部”时，该活动将返回添加失败的项目的列表。

删除队列项目

从指定队列中删除状态为“新”的项目。

字段	必填	描述
队列名称	是	要从中删除项目的 Orchestrator 队列。
文件夹路径	是	包含队列的 Orchestrator 文件夹。
项目	是	要删除的项目。只能删除状态为“新”的项目。

延缓事务项目

为正在进行的事务项目设置推迟日期和到期日期（可选），并将该项目返回到“新”状态。

字段	必填	描述
推迟日期	是	项目再次可用于处理的最早日期和时间。
到期日期	否	必须处理项目的截止日期。

备注：

当基础调用因 4xx 错误而失败时，系统不会自动重试延期事务项目。

设置事务进度

使用自定义状态字符串更新正在进行的事务项目。状态在 Orchestrator 中可见。

字段	必填	描述
进度	是	描述项目当前处理状态的自定义文本字符串。

设置事务状态

将事务项目的最终状态设置为“成功”或“失败” 。

字段	必填	描述
状态	是	成功或失败。
错误类型	条件	当状态为“失败”时为必需。业务异常或应用程序异常。
错误原因	条件	当状态为“失败”时为必需。错误的简短说明。
错误详情	否	附加错误信息。

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

有关从队列项目启动流程的触发器，请参阅事件。有关任务的更多信息，请参阅“BPMN 建模中的任务” 。