キュー タスクのアクティビティ

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:

• サービス タスク
• ユーザー タスク
• 送信タスク
• 受信タスク
• ビジネス ルール タスク
• スクリプト タスク

キュー アイテムのライフサイクル

ステート	リーチ方法
New	アイテムがキューに追加されます。
InProgress	キュー トリガーによって、アイテムのプロセス インスタンスが開始され、アイテムが [進行中] に設定されます。
成功/失敗	このプロセスは、[ トランザクションのステータスを設定] で最終ステートを設定します。
Abandoned	項目が最終ステートに達することなく 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 キューに新しいアイテムを追加します。

フィールド	Required	説明
キュー名	はい	アイテムを追加する Orchestrator のキューです。
フォルダー パス	はい	キューを含む Orchestrator のフォルダーです。
優先度	いいえ	アイテムの処理優先度です。
処理期限	いいえ	アイテムを処理する期限の日付と時刻です。
延期日	いいえ	アイテムが処理可能になる最も早い日付と時刻です。
カスタム データ	いいえ	アイテムに添付された追加データ。アイテムを処理するロボットまたはプロセスで使用できます。

キュー アイテムを作成して待機

アイテムをキューに追加し、アイテムが最終ステートに達するまで待機してからプロセスを続行します。[ キュー アイテムを作成] と同じフィールドを使用します。

キュー アイテムを取得

キューから取り出したりロックしたりすることなく、Orchestrator のキュー上のアイテムに対してクエリを実行し、読み取り専用の検査やキューの状態の条件付き分岐を行います。

フィールド	Required	説明
キュー名	はい	クエリを実行する Orchestrator のキューです。
フォルダー パス	はい	キューを含む Orchestrator のフォルダーです。
ステータス	いいえ	アイテムのステータスでフィルター処理する。
参照	いいえ	アイテムの参照でフィルター処理する。
作成日時の範囲	いいえ	アイテムが作成された日付範囲でフィルター処理します。
優先度	いいえ	アイテムの優先度でフィルター処理する

このアクティビティは、最新の一致 100 個の項目と合計数を返します。100 個を超える項目に一致するフィルターは、切り捨てられたリストを返します。フィルターを絞り込んで残りの項目を表示します。

キュー イベントを待機

この待機要素は、受信タスクまたは中間キャッチ イベントで使用可能で、トランザクション アイテムが Orchestrator のキューで使用可能になるまで実行をブロックします。

フィールド	Required	説明
キュー名	はい	待機する Orchestrator のキューです。
フォルダー パス	はい	キューを含む Orchestrator のフォルダーです。

アイテムがキューから取り除かれると、そのフィールドは、[ キュー アイテムを取得] と同じ形式でプロセスの出力として利用できるようになります。待機にはタイムアウトはありません。境界タイマーをアタッチして、設定した時間が経過すると待機を停止します。この要素は、V1 と V2 の両方の実行エンジンでサポートされています。

キュー アイテムを一括追加

複数のアイテムを 1 つのバッチでキューに追加します。1 回の呼び出しで最大 15,000 アイテムを追加します。

フィールド	Required	説明
キュー名	はい	アイテムを追加する Orchestrator のキューです。
フォルダー パス	はい	キューを含む Orchestrator のフォルダーです。
アイテム	はい	追加する項目のリストです (1 回の呼び出しで最大 15,000)。
コミットの種類	はい	AllOrNothing は、検証に失敗した項目がある場合、バッチ全体を拒否します。ProcessAllIndependent は、有効な項目をすべて追加し、失敗を個別に報告します。

コミットの種類が [ProcessAllDependent] の場合、追加に失敗した項目のリストが返されます。

キュー アイテムを削除

指定したキューから [新規] ステータスのアイテムを削除します。

フィールド	Required	説明
キュー名	はい	アイテムを削除する Orchestrator のキューです。
フォルダー パス	はい	キューを含む Orchestrator のフォルダーです。
アイテム	はい	削除するアイテムです。削除できるのは 、[新規] ステータスのアイテムのみです。

トランザクション アイテムを延期

処理中のトランザクション アイテムに延期日 (任意で期限日) を設定し、アイテムを 新規 ステータスに戻します。

フィールド	Required	説明
延期日	はい	アイテムが再び処理可能になる最も早い日付と時刻です。
期限日	いいえ	アイテムが処理される期限です。

注:

[トランザクション アイテムを延期] は、基になる呼び出しが 4xx エラーで失敗した場合、自動的にリトライされません。

トランザクションの進行状況を設定

処理中のトランザクション アイテムをカスタムのステータス文字列で更新します。ステータスは Orchestrator に表示されます。

フィールド	Required	説明
進行状況	はい	アイテムの現在の処理状態を表すカスタム テキスト文字列です。

トランザクションのステータスを設定

トランザクション アイテムの最終ステートを [ 成功 ] または [失敗] に設定します。

フィールド	Required	説明
ステータス	はい	成功 または 失敗。
エラーの種類	条件	ステータスが [失敗] の場合は必須 です。BusinessException または ApplicationException。
Error reason	条件	ステータスが [失敗] の場合は必須 です。エラーの簡単な説明です。
エラーの詳細	いいえ	追加のエラー情報。

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 モデリングのタスク」をご覧ください。