プロパティとデータを設定する

Runtime properties and data configuration options for BPMN events, tasks, and gateways in Maestro Orchestrate, showing how to connect diagrams to executable workflows via the Properties panel.

実行時の動作を設定する

Configuring properties is how you make your process run. It's where your BPMN diagram becomes an executable workflow. Every event, task, or gateway in Maestro Orchestrate has runtime properties that define what it does, what data it uses, and what happens next.

[プロパティ] パネルを使用してプロセスをオートメーション、エージェント、または API に接続し、データ マネージャーを使用して変数とマッピングを処理します。これらが連携して、プロセスを通じて情報がどのように移動するかを制御します。

クイック スタート: 任意の要素を設定する

BPMN 要素を設定するには、キャンバスで要素を選択し、[プロパティ] パネルで実行時の動作を定義します。

1. キャンバス上で要素を選択します。

2. 右上隅のレンチ アイコンを使用して、[プロパティ] パネルを開きます。

3. [実装] でアクションを選択します (例: [RPA ワークフローを開始して待機])。

4. ステップ間でデータを渡すために、[入力] と [出力] を追加または選択します。

5. データ マネージャーで変数を確認し、設定をテストします。

   ヒント:

   パブリッシュする前に、[デバッグ] または [シミュレート] を使用して設定をすぐにテストできます。

結果

選択した要素に実行時の動作が設定され、入力と出力のマッピングが定義されます。パブリッシュする前に、[デバッグ] または [シミュレート] を使用してプロセスをテストできるようになります。

プロパティ パネルの主要なセクション

セクション	目的
全般	要素の名前、説明、およびシステム ID を定義します。
実装	カテゴリに分類されたオプションから実行時のアクション (オートメーション、エージェント、コネクタなど) を選択します。
入力/出力	要素で使用する変数、式、または Data Fabric のフィールドをマップします。
XML	未加工の BPMN XML を検査します (上級ユーザーまたはサポート用)。

実装が設定されていない要素を選択すると、[プロパティ] パネルの [実装] 領域が自動的に展開されるので、その要素をすぐに設定できます。

警告:

設定済みの要素で実装アクションまたは要素の種類を変更すると、既存の設定が上書きされます。変更を適用する前に、確認を求める警告が表示されます。

注:

BMPN XML でサポートされている要素については、「BPMN Specification - Business Process Model and Notation」をご覧ください。

警告:

XML の bpmn:process id 属性は編集しないでください。この属性はダイアグラムを識別するための主キーです。変更すると、ダイアグラムのすべての参照が破損し、「No diagrams found in the BPMN file (BPMN ファイルにダイアグラムが見つかりません)」というエラーが発生します。破損したプロセスを回復するには、スナップショット (バージョン管理) またはローカルに保存されたコピーから復元する必要があります。これらがない場合、セルフサービスで回復する方法はありません。

注:

開始イベントの入力と終了イベントの出力を設定すると、Orchestrator のインターフェイスまたは API からプロセスを開始するときに入力引数の値を設定できます。これにより、前述のソースに出力を返すこともできます。

要素レベルのリトライ

Element-level retries let you define how Maestro Orchestrate should automatically retry a task-level failure before marking it as faulted. Use this feature to handle temporary issues without manual intervention.

要素レベルのリトライを使用する理由

When a task fails, Maestro Orchestrate can re-execute it based on a retry strategy that you define in the Properties panel. This helps stabilize long-running processes by absorbing transient errors and giving dependent systems time to recover.

リトライの設定方法

1. タスク要素 (サービス タスクなど) を選択します。
2. [プロパティ] パネルで、[エラー処理] → [Element-level retries]を展開します。
3. [エラー発生時にリトライ] をオンにします。
4. リトライ ストラテジのパラメーターを選択または編集します。
   • 最大リトライ回数: タスクが完全に失敗するまでのリトライ試行の回数です。
   • 初期待機時間: 最初のリトライまでの待機時間です (ISO 8601 形式の時間、PT1S など)。
   • [バックオフ]の種類: [静的]、[線形] 、または [指数] から選択します。
   • 指数ベース: (任意) [バックオフ] で [指数] を選択した場合に適用されます。
   • 最大時間: (任意) リトライ間の最大待機時間です。
   • エラー発生時にリトライ: リトライをトリガーするエラーを選択します (例: [すべて])。

結果

The retry strategy is saved for the selected task element. Maestro Orchestrate automatically retries the task on failure according to the configured parameters before marking it as faulted.

Each retry setting must stay within its supported range:

• Max retries: 1 to 10.
• Initial delay: 1 second to 1 hour.
• Exponential base: 1 to 5.

Retries can span up to 24 hours in total. A value outside its range shows an error in the form and in the Issues panel. Existing retry settings are kept as they are, and out-of-range values in them are reported instead of being changed.

注:

要素レベルのリトライは、実行可能なタスク (例: サービス、エージェント、API ワークフロー、キュー アイテム) にのみ適用されます。ゲートウェイやイベント キャッチ要素では利用できません。

データ マネージャー (Data Manager)

データ マネージャーには、プロセスのすべての変数、引数、データ ソースが一元されます。

• 入力データと出力を定義してから、それをタスク間で再利用する

• Data Fabric またはコネクタのペイロードからのデータ構造をプレビューする

• デプロイ前に式を検証およびテストする

  

ヒント:

変数名を常に意味のある名前 (例: InvoiceId、ApprovalStatus) にしておくと、後でデバッグや監視するのが容易になります。

注:

開始イベントの入力と終了イベントの出力を設定すると、Orchestrator のインターフェイスまたは API からプロセスを開始するときに入力引数の値を設定できます。これにより、前述のソースに出力を返すこともできます。