UiPath Documentation
maestro
latest
false
Maestro ユーザー ガイド
重要 :
このコンテンツの一部は機械翻訳によって処理されており、完全な翻訳を保証するものではありません。 新しいコンテンツの翻訳は、およそ 1 ~ 2 週間で公開されます。

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
NewThe item is added to the queue.
InProgressA queue trigger starts a process instance for the item and sets it to InProgress.
Successful / FailedThe process sets the final state with Set transaction status.
AbandonedAutomatic, 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.

フィールドRequired説明
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.

フィールドRequired説明
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.

フィールドRequired説明
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.

フィールドRequired説明
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.

フィールドRequired説明
進行状況はい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.

フィールドRequired説明
ステータスはいSuccessful or Failed.
Error type条件Required when status is Failed. BusinessException or ApplicationException.
Error reason条件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.

このページは役に立ちましたか?

接続

ヘルプ リソース サポート

学習する UiPath アカデミー

質問する UiPath フォーラム

最新情報を取得