エッジとエッジ条件について

エッジ

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

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

ハイライト表示されたエッジを示す画像 ハイライト表示されたエッジを示す画像

エッジ条件

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

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

  1. Apigee UI で、Apigee 組織を選択します。
  2. [Develop] > [Integrations] の順にクリックします。
  3. 既存のインテグレーションを選択するか、[Create Integration] をクリックして新しいインテグレーションを作成します。

    新しいインテグレーションを作成する場合:

    1. [Create Integration] ダイアログで名前と説明を入力します。
    2. サポートされているリージョンのリストから、インテグレーションのリージョンを選択します。
    3. [Create] をクリックします。

    インテグレーション デザイナーでインテグレーションが開きます。

  4. 統合デザイナーのナビゲーション バーで、[+ Add a task/trigger] > [Tasks] の順にクリックして、使用可能なタスクのリストを表示します。
  5. 既存の統合を選択するか、新しい統合を作成します。
  6. 統合エディタで、エッジをクリックしてエッジ構成ペインを開きます。
  7. エッジを構成します。
ハイライト表示されたエッジの状態を示す画像 ハイライト表示されたエッジの状態を示す画像

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

次の表に、エッジ条件で利用可能な演算子を示します。

演算子 説明
= 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) 指定された変数がリストかつ空かどうかを確認します。
is_not_empty(VARIABLE) 指定された変数がリストかつ空ではないかどうかを確認します。