Maestro Flow を設計する

フロー キャンバスを使用して Studio Web で Maestro Flow を設計します。これには、トリガーとノードの追加と接続、プロパティの設定、変数の管理、エラーの処理、プロセスのデバッグの方法が含まれます。

注:

Maestro Flow はプレビュー版です。

Maestro Flow キャンバスは視覚的なデザイナーであり、ノードを配置して順番に接続することでオートメーションを構築します。

Maestro Flow キャンバス

キャンバスには、フローがエッジで接続されたノードのグラフとして表示されます。実行はトリガー ノードから開始され、接続された各ノードを順番に移動します。

ノードを追加するには、既存ノードの出力エッジにある [+ ] ハンドルを選択して、[ ノードを追加 ] パネルを開きます。2 つのノードを手動で接続するには、あるノードの出力ハンドルから別のノードの入力ハンドルにドラッグします。Maestro Flow キャンバスでノードのラベルを開くと、ノードの名前を変更できます。

上部のツールバーには以下があります。

• クラウドでデバッグ — フローをクラウドでエンドツーエンドで実行します。
• ステップごとにデバッグ — フローを一度に 1 ノードずつ進めます。
• パブリッシュ — フローをパッケージ化して Orchestrator にパブリッシュします。

トリガーを追加する

フローは、オンデマンドでフローを開始する既定の [ 手動トリガー ] ノードで始まります。キャンバスでトリガーを選択し、[ プロパティ] パネルで設定します。

トリガーのプロパティ

• ID — トリガーの識別子です。式 (例: $vars.manualTrigger1.output.userId) で出力を参照するために使用します。
• ラベル — キャンバスでのトリガーの表示名です。
• 変数 — トリガーが所有する入力変数です。トリガーが起動すると、その入力は下流で $vars.<triggerId>.output.<inputName>として使用できます。

ノードの追加

ノードを追加するには、任意のノードの出力エッジにある [+ ] ハンドルを選択して [ ノードを追加 ] パネルを開き、カテゴリを選択してノードの種類を選択します。利用可能なノードの種類の完全なリストについては、「 Maestro Flow」をご覧ください。

ノードのプロパティ

ノードを選択すると、その設定が右側の [ プロパティ ] パネルで開き、次のセクションに整理されます。

• 全般 — ノードの ID ( $vars 式で使用)、 ラベル (キャンバス上の表示名)、 説明、 アイコンの色です。
• エラー処理 — [エラー処理を有効化 ] を切り替えて、ノードにエラー出力ハンドルを追加します。有効化されたときにノードに障害が発生すると、実行はフローを停止するのではなく、エラー パスにルーティングされます。
• 変数を更新 — ノードの完了時にプロセス変数に値を割り当てます。[ + 変数の更新を追加] を選択し、対象の変数を選択して、割り当てる式を入力します。

[ 変数 ] タブ ([プロパティ] の横) では、プロセス レベルの変数を定義します。各変数には、名前、型 (String、Number、Boolean、Object、または Array)、および方向 (入力、出力、または双方向) があります。

キャンバス上のノードのコンテキスト メニューを開くと、コンテキスト メニューが開き、[ ブレークポイントを追加]、[ プローブを追加]、[ コピー]、[ 切り取り]、[ 貼り付け]、[ 削除] が表示されます。

変数とデータ フロー

ノードはデータを自動的に共有しません。下流のノードは、 $vars プレフィックスを使用する式を通じてノードの出力にアクセスします。

データを生成するすべてのノードは、その出力を $vars.<nodeId>.outputとして使用できるようにします。ノード ID はノードの種類に基づいて自動的に割り当てられます (たとえば、最初の API ワークフロー ノードは です apiWorkflow1です。ノードの ID は、[プロパティ] パネルの [ 全般 ] セクションで確認および編集できます。

// Access the output of a node named apiWorkflow1
$vars.apiWorkflow1.output

// Access the response body of an HTTP request node
$vars.httpRequest1.output.body

[ 変数 ] タブでは、プロセス全体でアクセスできる必要がある変数、またはプロセスの入力と出力を定義する変数を定義します。変数は $vars.<variableName>として参照されます。

式の文法とスコープのルールについて詳しくは、Maestro ガイドの「 変数とデータ フロー 」をご覧ください。

エラー処理

既定では、ノードに障害が発生するとフロー全体が停止します。特定のノードの障害を処理するには、ノードの [プロパティ] パネルで [エラー処理を有効化 ] を切り替えます。これにより、キャンバス上のノードの右下にエラー出力ハンドルが追加されます。エラー ハンドルを下流のノードに接続して、エラーを別のパスにルーティングします。

ノードに障害が発生し、そのエラー ハンドルが接続されている場合、エラーの詳細がエラー パスの $vars.<nodeId>.error として利用可能です。フィールドには message、 code、 status、 detailが含まれます。

ログ アンド コンティニュ、リトライ、アラート アンド 強制終了などのパターンについては、『Maestro ガイド』の 「エラー処理 」をご覧ください。

Debugging a Maestro Flow

上部のツールバーで [ クラウドでデバッグ ] を選択して、フローをエンドツーエンドで実行します。実行が完了したら、キャンバスで任意のノードを選択してその出力を調べます。成功したノードには緑色のインジケーターが表示されます。失敗したノードでは、選択したノードにエラーの詳細が表示されます。

[ ステップごとにデバッグ ] を選択して、一度に 1 ノードずつフローを進めます。

任意のノードのコンテキスト メニューを開き、[ ブレークポイントを追加 ] を選択すると、デバッグ実行中にそのノードでの実行が一時停止されます。[ プローブを追加 ] を選択して、一時停止せずにノードの出力をキャプチャします。

関連リンク

• 変数とデータ フロー
• エラー処理
• サブフロー
• 制御フロー
• フローをパブリッシュしてデプロイする