Application Integration でサポートされているコネクタをご覧ください。

エッジとエッジ条件

Edge

エッジは、統合の 2 つの要素間の接続です。接続は、ある要素（タスクまたはトリガー）から別の要素への制御フローの方向を示します。接続は、トリガーと別のトリガーの間、またはタスクと別のタスクの間で行うことができます。フォークと結合に合わせてエッジを使用することで、統合での複雑な分岐や条件を実装できます。詳細については、フォークと結合をご覧ください。

たとえば、メールを送信タスクから統合の呼び出しタスクの間にエッジがある場合、メールを送信した後を意味し、次に実行するタスクは統合の呼び出しタスクです。エッジは、条件付きチェックもサポートしています。コントロールが次のタスクに進む前に、エッジの条件を確認して、その結果に基づいてタスクの実行を決定できます。サポートされている条件付きチェックの詳細については、エッジ条件をご覧ください。

エッジ条件

エッジ条件を使用すると、エッジで接続されたタスクに渡す統合を制御するために満たされる必要がある条件を指定できます。タスクは、指定された条件が満たされた場合にのみ実行されます。エッジ条件は、タスクに複数の受信エッジがあり、各エッジがタスクの前に特定の条件をチェックする場合に有用です。

次の手順でエッジ条件を指定します。

1. Google Cloud コンソールで [Application Integration] ページに移動します。

   Application Integration に移動

2. ナビゲーション メニューで [統合] をクリックします。

   [統合] ページが開き、Google Cloud プロジェクトで使用可能なすべての統合が一覧表示されます。

3. 既存の統合を選択するか、[統合の作成] をクリックして新しい統合を作成します。

   新しい統合を作成する場合:

   1. [統合の作成] ペインで名前と説明を入力します。
   2. 統合のリージョンを選択します。
      注: [リージョン] プルダウンには、Google Cloud プロジェクトにプロビジョニングされたリージョンのみが表示されます。新しいリージョンをプロビジョニングするには、[リージョンを有効にする] をクリックします。詳細については、新しいリージョンを有効にするをご覧ください。
   3. 統合用のサービス アカウントを選択します。統合のサービス アカウントの詳細は、統合ツールバーの [統合の概要] ペインでいつでも変更または更新できます。
      注: サービス アカウントを選択するオプションは、選択したリージョンで統合ガバナンスを有効にしている場合にのみ表示されます。
   4. [作成] をクリックします。

   統合エディタで統合が開きます。

4. 統合エディタのナビゲーション バーで、[タスク] をクリックして、使用可能なタスクとコネクタのリストを表示します。
5. 既存の統合を選択するか、新しい予算を作成します。
6. 統合エディタでエッジをクリックして、エッジ構成ペインを開きます。
7. エッジを構成します。
   • Label（省略可）: エッジのカスタム名を追加します。
   • 条件: サポートされている演算子と関数を使用してエッジ条件を設定します。

条件を指定する際の重要なヒント:

• 変数値を参照するには、変数名の前後にドル記号（$）を使用します。たとえば、変数 productId が 10 より大きいかどうかを確認する場合、構文は $productId$ > 10 になります。
• ドル記号が表記されていないテキストは、リテラル値として解釈されます。たとえば、テキスト customerId はリテラル値として解釈されます。
• 複数の条件を確認するには、条件を個々のチェックに分割し、AND または OR を使用して組み合わせます。たとえば、$productId$ > 5 AND < 9 ではなく $productId$ > 5 AND $productId$ < 9 を使用します。

サポートされている演算子

次の表に、エッジ条件で利用可能なサポートされている演算子を示します。

演算子	説明	例
=	2 つの値の等価性を確認します。	$var$ = "value"
!=	2 つの値の不等価性を確認します。	$var$ != "value"
<	値がもう一方の値より小さいかどうかを確認します。	5 < 10
<=	値がもう一方の値以下かどうかを確認します。	$var$ <= 5
>	値がもう一方の値より大きいかどうかを確認します。	1 > 0
>=	値がもう一方の値以上であるかどうかを確認します。	$var$ >= 0
:	文字列に特定の部分文字列が含まれているかどうか、またはリストに特定のプリミティブ値が含まれているかどうかを確認します。	$longString$ : "substring" $list of values$ : "value"
AND	2 つの式を確認し、両方の式が true と評価された場合に true を返します。	$a$ > $b$ AND $b$ < $c$
OR	2 つの式を確認し、いずれかの式が true と評価された場合に true を返します。	$a$ > $b$ OR $b$ < $c$
NOT	否定演算子。式の結果を反転します。	NOT($var$ = "value")

サポートされる関数

次の表では、エッジ条件で利用可能なサポートされている関数について説明します。

関数	説明
exists(VARIABLE)	指定された変数が存在するかどうかを確認します。
does_not_exist(VARIABLE)	指定された変数が存在しないかどうかを確認します。
is_empty(VARIABLE)	指定された変数がリストかつ空かどうかを確認します。JSON 配列を除く配列変数型をサポートします。
is_not_empty(VARIABLE)	指定された変数がリストかつ空ではないかどうかを確認します。JSON 配列を除く配列変数型をサポートします。

割り当てと上限

割り当てと上限については、割り当てと上限をご覧ください。

次のステップ

• すべてのタスクとトリガーを確認する。
• インテグレーションをテストして公開する方法について学習する。
• エラー処理について学習する。
• 統合の実行ログについて学習する。