本頁面由 Cloud Translation API 翻譯而成。

查看 Application Integration 支援的連接器。

使用 For Each Loop 工作叫用子整合

本快速入門導覽課程說明如何建立整合，使用 For Each 迴圈工作項叫用子整合。子整合會接收主要整合作業的輸入內容，並使用「傳送電子郵件」任務將電子郵件傳送給收件者。

建立子整合

前往 Google Cloud 控制台的「Application Integration」頁面。
前往「應用程式整合」
按一下左側導覽選單中的「整合」，開啟「整合」頁面。
按一下「建立整合功能」。
輸入整合作業的名稱和說明。
在本快速入門課程中，請輸入名稱 ForEachSendEmailSubIntegration 和說明 Quickstart sub-integration。
選取整合作業的區域。
注意：「Regions」下拉式選單只會列出 Google Cloud 專案中已佈建的地區。如要佈建新的區域，請按一下「啟用區域」。詳情請參閱「啟用新區域」一文。
按一下「建立」開啟整合編輯器。

在子整合項目中新增 API 觸發條件

您必須使用觸發條件，才能啟動整合作業的一系列任務。在本快速入門導覽課程中，您將使用 API 觸發條件來啟動整合作業。

如要新增及設定 API 觸發條件，請執行下列步驟：

在整合服務編輯器中，按一下「觸發條件」，即可查看可用的觸發條件清單。
在整合服務編輯器中，按一下並放置「API trigger」元素。

在子整合項目中建立輸入變數

子整合會使用變數，將從主要整合收到的詳細資料儲存在 JSON 格式中。如要建立新的輸入變數，請按照下列步驟操作：

按一下設計工具導覽列中的 (切換面板)，即可顯示「變數」窗格。
按一下「+ 建立」，建立變數。

在「Create Variable」窗格中，執行下列步驟：

a. 「Name」：輸入 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. 按一下「Use as an input to integration」(做為整合輸入內容使用)。

f. 按一下 [建立]。

新增及設定資料對應工作

資料對應工作可讓您在整合作業中執行變數指派作業、取得及設定 JSON 物件的屬性，以及將巢狀轉換函式套用至值。資料對應工作使用的變數可以是整合變數或工作變數。

如要新增及設定資料對應工作，請執行下列步驟：

在整合服務編輯器中，按一下「Tasks」即可查看可用任務清單。
在整合服務編輯器中按一下並放置「Data Mapping」(資料對應) 元素。
按一下整合服務編輯器中的「Data Mapping」(資料對應) 元素，開啟任務設定窗格。
按一下「Open Data Mapping Editor」。
如以下所示設定「Input」：
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 中新增對應函式。在括號內的 FOR EACH 列中，點選剛新增的 obj1 元素後方的 +。在函式清單中，向下捲動並選取「GET PROPERTY(String) -> JSON」。
8. 按一下「變數或值」，然後在「值」中輸入 itemName。
9. 按一下 [儲存]。
10. 在「GET PROPERTY」後方的資料列中，按一下「+ 新增函式」，然後選取「TO_STRING() -> String」。
11. 按一下最後一列的「+ 新增函式」，然後選取「TO_STRING() -> 字串」。
請依照下列方式設定「Output」：
1. 建立新的輸出變數。在「輸出」部分，按一下「建立新輸出」。
2. 在「Create Variable」窗格中輸入名稱 items，保留所有其他欄位的預設值，然後按一下「Create」。
請確認資料對應設定類似下圖。
關閉「資料對應關係編輯器」，返回整合編輯器。

新增並設定「傳送電子郵件」任務

如要新增並設定「Send Email」任務，以便傳送電子郵件給每位收件者，請執行下列步驟。

在整合服務編輯器中，按一下「新增任務/觸發條件」。
前往「Tasks」(任務)，然後在整合服務編輯器中按一下並放置「Send Email」(傳送電子郵件) 元素。
按一下整合編輯器中的「Send Email」任務元素，開啟任務設定窗格。
設定下列「工作輸入」欄位：
1. 收件者：按一下「變數」，然後選取「order_details.emailId」。
2. 主旨：輸入電子郵件主旨。在這個快速入門導覽課程中，請輸入 Order delivery notification。
3. Body in Plain Text：輸入以下文字：
```
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 觸發條件」元素新增邊緣至「資料對應」元素。將滑鼠懸停在「API trigger」(API 觸發條件) 元素的控制點，然後點選線條並拖曳到「Data Mapping」(資料對應) 元素的控制點。
同樣地，從「資料對應」元素新增邊緣至「傳送電子郵件」元素。

測試及發布子整合

如要測試這個子整合項目，請按一下整合服務編輯器工具列中的「Test」，然後在「Test Integration」對話方塊中按一下「Test integration」。子整合作業會以預設值做為輸入內容執行，並傳送電子郵件至「Send Email」(傳送電子郵件) 任務中指定的電子郵件地址。測試完成後，畫面上應會顯示成功訊息。
如要發布這個子整合項目，請在整合服務編輯器工具列中按一下「Publish」。

建立主要整合

在導覽選單中，按一下「Integrations」即可返回「Integrations」頁面。
按一下「建立整合功能」。
輸入整合作業的名稱和說明 (選填)。在本快速入門課程中，請輸入名稱 ForEachSendEmail 和說明 Quickstart main integration。
從支援區域清單中選取整合作業的「Region」(區域)。請務必在與子整合項目相同的地區建立主要整合項目。
按一下 [建立]。

在主要整合中新增 API 觸發條件

在整合服務編輯器中，按一下「Triggers」，即可查看可用任務和觸發條件清單。
在整合服務編輯器中，按一下並放置「API trigger」元素。

在主要整合項目中建立輸入變數

在主要整合作業中，輸入變數會用來儲存透過 For Each 迴圈傳遞至子整合作業的資料。您可以立即建立這個變數，也可以在下一個步驟中新增及設定 For Each 迴圈工作時再建立。在本快速入門導覽課程中，請立即建立變數。

按一下設計工具導覽列中的 (切換面板)，即可顯示「變數」窗格。

在「Create Variable」窗格中，執行下列步驟：

a. 「Name」：輸入 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. 按一下「Use as an input to integration」(做為整合輸入內容使用)。

f. 按一下 [建立]。

新增及設定 For Each Loop 工作

在整合服務編輯器中，按一下「Tasks」。
在整合服務編輯器中按一下並放置「For Each Loop」元素。
按一下整合服務編輯器中的「For Each Loop」任務元素，開啟任務設定窗格。
在設定窗格中執行下列操作：
1. 要重複的清單：選取您建立的輸入變數 order_requests。
2. API 觸發條件 ID：選取子整合項目中的 API 觸發條件。在本快速入門導覽課程中，請選取 api_trigger/ForEachSendEmailSubIntegration_API_1。
3. 整合名稱：選取要叫用的子整合項目名稱。在這個快速入門導覽課程中，請選取「ForEachSendEmailSubIntegration」ForEachSendEmailSubIntegration。
4. 迭代元素子整合對應：選取「order_details」。

連結主要整合項目中的元素

從「API trigger」元素新增邊緣至「For Each Loop」元素。將滑鼠懸停在「API trigger」(API 觸發條件) 元素的控制點，然後點選線條並拖曳到「For Each Loop」(逐個迴圈) 元素的控制點。

測試並發布主要整合項目

最後一項工作是測試並發布主要整合項目。

在整合服務編輯器的工具列中，按一下「Test」，然後在「Test Integration」對話方塊中，按一下「Test integration」。測試完成後，畫面上應會顯示成功訊息。
如要發布這項整合功能，請在整合服務編輯器工具列中按一下「發布」。

成功完成後，整合作業會傳送電子郵件至「「Send Email」(傳送電子郵件) 任務中指定的電子郵件地址。請在電子郵件用戶端中確認已收到這封電子郵件。

配額與限制

如要進一步瞭解配額和限制，請參閱「配額與限制」。