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

Maestro BPMN プロセスのキュー タスク アクティビティ: Orchestrator のキュー アイテムを作成、更新、解決するための必須フィールドです。アクティビティ別に整理されています。

キュー タスク アクティビティは、Maestro BPMN プロセスのタスクから Orchestrator キュー アイテムを作成、更新、解決します。キュー アクティビティには、タスクの [プロパティ] パネルの [ アクション ] ドロップダウンからアクセスします。キュー アクティビティは、以下のタスクの種類で利用できます。すべてのタスクのリストについては、「 タスク 」をご覧ください。

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

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

ステート	リーチ方法
New	アイテムがキューに追加されます。
InProgress	キュー トリガーによって、アイテムのプロセス インスタンスが開始され、アイテムが [進行中] に設定されます。
成功/失敗	このプロセスは、[ トランザクションのステータスを設定] で最終ステートを設定します。
Abandoned	項目が最終ステートに達することなく 24 時間 [進行中] のままである場合は、自動的に実行されます。キューにリトライが設定されている場合、Orchestrator はアイテムを複製して再キューに登録します。

注:

1 つのキュー アイテムで開始される Maestro BPMN プロセス インスタンスは 1 つだけです。このリリースでは、ループ内で複数の項目を使用する 1 つのインスタンスはサポートされていません。

キュー アイテムを作成する

[ 新規 ] ステータスの Orchestrator キューに新しいアイテムを追加します。

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

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

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

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

複数のアイテムを 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	条件	ステータスが [失敗] の場合は必須 です。エラーの簡単な説明です。
エラーの詳細	いいえ	追加のエラー情報。

基になる呼び出しが 4xx エラーで失敗しない限り、Maestro はタスクを自動的にリトライします。失敗すると、タスクはエラー コード OrchestratorSetTransactionResultFailedを返します。

キュー アイテムからプロセスを開始するトリガーについては「 イベント」をご覧ください。タスクについて詳しくは、「 BPMN モデリングのタスク」をご覧ください。