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] に追加します。[+] の横にある + 記号をクリックします。関数のリストを下にスクロールし、[FOR_EACH(Any) -> JSON] を選択します。
5. [FOR_EACH] 関数の入力パラメータを入力します。[変数または値] をクリックし、[~obj1] を選択します。
6. [保存] をクリックします。
7. マッピング関数を [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] 要素上のコントロールポイントに線をドラッグします。
同様に、[データマッピング] 要素から [メールを送信] 要素にエッジを追加します。

サブインテグレーションをテストして公開する

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

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

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

メインインテグレーションに API トリガーを追加する

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

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

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

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

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

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

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"
  }, {
    "orderId": "2",
    "customerName": "Tim Harvey",
    "emailId": "YOUR_EMAIL_ID",
    "shippingAddress": {
      "city": "Los Angeles",
      "country": "USA",
      "zipcode": "210738"
    },
    "items": [{
      "itemid": "222-333-444",
      "itemName": "Laptop",
      "itemPrice": 5999.0,
      "quantity": 1.0
   }],
    "paymentDetails": {
      "mode": "Online Payment",
      "status": "Success"
    },
    "expectedDelivery": "21 Feb 2023"
  }]

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

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

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

For Each Loop タスクを作成して構成する

統合エディタで [タスク] をクリックします。
統合エディタで [For Each Loop] 要素をクリックして配置します。
統合デザイナーで [For Each Loop] タスク要素をクリックして、タスク構成ペインを開きます。
[設定] ペインで、以下のように操作します。
1. 反復処理するリスト: 作成した入力変数 [order_requests] を選択します。
2. API トリガー ID: サブ統合で API トリガーを選択します。このクイックスタートでは、[api_trigger/ForEachSendEmailSubIntegration_API_1] を選択します。
3. 統合名: 呼び出すサブ統合の名前を選択します。このクイックスタートでは、[ForEachSendEmailSubIntegration] を選択します。
4. 反復処理要素のサブ統合マッピング: [order_details] を選択します。

メイン統合の要素を接続する

[API トリガー] 要素から [For Each Loop] 要素にエッジを追加します。[API トリガー] 要素のコントロールポイントにカーソルを合わせてから、線をクリックして [For Each Loop] 要素のコントロールポイントにドラッグします。

メイン統合をテストして公開する

最後のタスクは、メイン統合をテストして公開することです。

統合デザイナーツールバーの [テスト] をクリックし、[テスト統合] ダイアログで [テスト統合] をクリックします。テストが完了すると、成功メッセージが表示されます。
この統合を公開するには、統合デザイナーツールバーの [公開] をクリックします。

正常に完了すると、統合によりメール送信タスクで指定したメールアドレスにメールが送信されます。ご自身のメールクライアントでメールの受信を確認します。

割り当てと上限

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