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

For Each Loop タスクを使用してサブ統合を呼び出す

このクイックスタートでは、For Each Loop タスクを使用してサブ統合を呼び出す統合を作成する方法について説明します。サブ統合はメイン統合から入力を受け取り、Send Email タスクを使用して受信者にメールを送信します。

サブ統合を作成する

Google Cloud コンソールで [Application Integration] ページに移動します。
Application Integration に移動
ナビゲーションメニューで [統合] をクリックします。[統合リスト] ページが表示されます。
[統合を作成] をクリックします。
統合の名前と説明を入力します。
このクイックスタートでは、名前 ForEachSendEmailSubIntegration と説明 Quickstart sub-integration を入力します。
統合のリージョンを選択します。
注: [リージョン] プルダウンには、Google Cloud プロジェクトにプロビジョニングされたリージョンのみが表示されます。新しいリージョンをプロビジョニングするには、[リージョンを有効にする] をクリックします。詳細については、新しいリージョンを有効にするをご覧ください。
[Create] をクリックしてインテグレーションデザイナーを開きます。

サブ統合に API トリガーを追加する

統合を構成する一連のタスクを開始するには、トリガーが必要です。このクイックスタートでは、API トリガーを使用して統合を開始します。

API トリガーを追加して構成するには、次の手順を実行します。

統合エディタで、[トリガー] をクリックして、使用可能なトリガーのリストを表示します。
統合デザイナーで、[API trigger] 要素をクリックして配置します。

サブ統合で入力変数を作成する

サブ統合では、メイン統合から JSON 形式で受信した詳細を変数で格納します。新しい入力変数を作成するには、次の手順を行います。

デザイナーナビゲーションバーの（切り替えパネル）をクリックして、[変数] ペインを表示します。
[+ 作成] をクリックして、変数を作成します。

[変数の作成] ペインで、次の操作を行います。

a. 名前: 「order_details」と入力します。

b. データ型:: JSON を選択します。

c. [デフォルト値から推測] をクリックします。

d. [デフォルト値] に、次の JSON を入力します。

  {
    "orderId": "1",
    "customerName": "Harry Ford",
    "emailId": "YOUR_EMAIL_ID",
    "shippingAddress": {
      "city": "New York",
      "country": "USA",
      "zipcode": "103487"
      },
    "items": [{
      "itemid": "111-222-333",
      "itemName": "Smartphone",
      "itemPrice": 999.0,
      "quantity": 1.0
      }, {
      "itemid": "444-555-666",
      "itemName": "Mobile Cover",
      "itemPrice": 49.0,
      "quantity": ""
      }],
    "paymentDetails": {
      "mode": "COD",
      "status": ""
      },
    "expectedDelivery": "15 March 2023"
  }

このサンプル JSON オブジェクトで、YOUR_EMAIL_ID を、統合のテストに使用するメール ID に置き換えます。

e. [統合への入力として使用する] をクリックします。

f. [作成] をクリックします。

データマッピングタスクを作成して構成する

データマッピングタスクを使用すると、統合で変数の割り当てを実行し、json オブジェクトのプロパティを取得して設定し、値にネストされた変換関数を適用できます。データマッピングタスクで使用される変数は、統合変数またはタスク変数のいずれかです。

データマッピングタスクを追加して構成するには、次の手順を行います。

統合エディタで、[タスク] をクリックして、使用可能なタスクのリストを表示します。
統合デザイナーで [Data Mapping] 要素をクリックして配置します。
統合デザイナーで [データマッピング] 要素をクリックして、タスク構成ペインを開きます。
[Open Data Mapping Editor] をクリックします。
[入力] を次のように構成します。
1. [入力] セクションで [変数または値] をクリックします。
2. [変数] に「item」と入力し、[order_details.items] を選択します。
3. [保存] をクリックします。
4. マッピング関数を [order_details.items] に追加します。[order_details.items] の横にある + 記号をクリックします。関数のリストを下にスクロールし、[FOR_EACH(Any) -> JSON] を選択します。
5. [FOR_EACH] 関数の入力パラメータを入力します。[変数または値] をクリックし、[~obj1] を選択します。
6. [保存] をクリックします。
7. マッピング関数を [obj1] に追加します。追加した [obj1] 要素の後の括弧内の [FOR EACH] 行で [+] をクリックします。関数のリストを下にスクロールし、[GET PROPERTY(String) -> JSON] を選択します。
8. [変数または値] をクリックし、[値] に「itemName」と入力します。
9. [保存] をクリックします。
10. [GET PROPERTY] の後の行で [+ 関数を追加] をクリックし、[TO_STRING() -> String] を選択します。
11. 最後の行の [+ 関数を追加] をクリックし、[TO_STRING() -> String] を選択します。
[出力] を次のように構成します。
1. 新しい出力変数を作成します。[出力] セクションで、[新しい出力を作成] をクリックします。
2. [変数を作成] ペインで、名前 items を入力し、それ以外のフィールドはすべてデフォルト値のままにして、[作成] をクリックします。
データマッピングの構成が次の画像と同様であることを確認します。
データマッピングエディタを閉じて統合デザイナーに戻ります。

Send Email タスクを追加して構成する

各受信者にメールを送信するようにSend Email タスクを追加して構成するには、次の手順を行います。

統合エディタで、[タスク/トリガーを追加] をクリックします。
[タスク] に移動して、統合デザイナーで [Send Email] 要素をクリックして追加します。
統合デザイナーで [Send Email] タスク要素をクリックして、タスク設定ペインを開きます。
次の [タスク入力] フィールドを設定します。
1. 送信先: [変数] をクリックし、[order_details.emailId] を選択します。
2. 件名: メールの件名を入力します。このクイックスタートでは、「Order delivery notification」と入力します。
3. 書式なしテキストの本文: 次のテキストを入力します。
```
Hi $order_details.customerName$! Your order with Order Id: $order_details.orderId$ with items: $items$ has been successfully placed. Expected delivery by: $order_details.expectedDelivery$.
```

サブ統合の要素を接続する

サブ統合に必要なタスクとトリガーを追加して構成したので、要素間の接続（エッジ）を追加します。エッジは、ある要素から次の要素への制御のフローを示します。

[API トリガー] 要素から [Data Mapping] 要素にエッジを追加します。[API トリガー] 要素上のコントロールポイントにカーソルを合わせて、[Data Mapping] 要素上のコントロールポイントに線をドラッグします。
同様に、[Data Mapping] 要素から [Send Email] 要素にエッジを追加します。

サブ統合をテストして公開する

このサブ統合をテストするには、統合エディタのツールバーで [テスト] をクリックし、[Test Integration] ダイアログで [Test integration] をクリックします。サブ統合は入力としてデフォルト値で実行され、Send Email タスクで指定されたメールアドレスにメールが送信されます。テストが完了すると、成功のメッセージが表示されます。
このサブ統合を公開するには、統合デザイナーツールバーの [公開] をクリックします。

メインインテグレーションを作成する

ナビゲーションメニューで [統合] をクリックして [統合] ページに戻ります。
[統合を作成] をクリックします。
統合の名前と、必要に応じて説明を入力します。このクイックスタートでは、名前 ForEachSendEmail と説明 Quickstart main integration を入力します。
サポートされているリージョンのリストから、統合のリージョンを選択します。メイン統合がサブ統合と同じリージョンに作成されていることを確認してください。
[作成] をクリックします。

メイン統合に API トリガーを追加する

統合エディタで、[トリガー] をクリックして、使用可能なタスクとトリガーのリストを表示します。
統合デザイナーで、[API trigger] 要素をクリックして配置します。

メイン統合に入力変数を作成する

メイン統合では、入力変数を使用して、For Each Loop を介してサブ統合に渡されるデータを保存します。この変数は、今すぐ、または For Each Loop タスクを追加して構成するときに、次のステップで作成できます。このクイックスタートでは、今すぐ変数を作成します。

デザイナーナビゲーションバーの（切り替えパネル）をクリックして、[変数] ペインを表示します。