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

查看 Application Integration 支援的連接器。

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

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

建立子整合

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

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

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

如要新增及設定 API 觸發條件，請按照下列步驟操作：

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

在子整合作業中建立輸入變數

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

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

在「建立變數」窗格中，執行下列操作：

a. 「Name」(名稱)：輸入 order_details。

b. 資料類型：選取「JSON」。

c. 按一下「從預設值推斷」。

d. 在「Default Value」(預設值) 中輸入下列 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」(任務)，即可查看可用任務清單。
在整合服務編輯器中，點按並放置「資料對應」元素。
在整合服務編輯器中，按一下「資料對應」元素，開啟任務設定窗格。
按一下「開啟資料對應編輯器」。
請按照下列方式設定「輸入」：
1. 在「輸入」部分中，按一下「變數或值」。
2. 在「變數」中輸入 item，然後選取「order_details.items」order_details.items。
3. 按一下 [儲存]。
4. 將對應函式新增至 order_details.items。按一下「order_details.items」旁邊的 + 符號。在函式清單中捲動並選取「FOR_EACH(Any) -> JSON」。
5. 輸入 FOR_EACH 函式輸入參數。按一下「變數或值」，然後選取「~obj1」。
6. 按一下 [儲存]。
7. 在 obj1 中新增對應函式。在您剛新增的 obj1 元素後，按一下括號內的「+」。在函式清單中捲動並選取「GET PROPERTY(String)」->「JSON」。
8. 按一下「變數或值」，然後在「值」中輸入 itemName。
9. 按一下 [儲存]。
10. 在「GET PROPERTY」後方的資料列中，按一下「+ 新增函式」，然後選取「TO_STRING() -> String」。
11. 按一下最後一列的「+ 新增函式」，然後選取「TO_STRING() -> String」。
請依照下列方式設定「輸出」：
1. 建立新的輸出變數。在「輸出」部分，按一下「建立新的」。
2. 在「建立變數」窗格中，輸入名稱 items，保留所有其他欄位的預設值，然後按一下「建立」。
確認資料對應設定與下圖類似。
關閉「資料對應編輯器」，返回整合編輯器。

新增及設定「傳送電子郵件」工作

如要新增及設定「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 trigger」(API 觸發條件) 元素至「Data Mapping」(資料對應) 元素新增邊緣。將滑鼠懸停在「API trigger」(API 觸發條件) 元素上的控制點，然後將線條拖曳到「Data Mapping」(資料對應) 元素上的控制點。
同樣地，從「資料對應」元素到「傳送電子郵件」元素新增邊緣。

測試並發布子整合

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

建立主要整合

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

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

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

在主要整合作業中建立輸入變數

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

按一下設計工具導覽列中的「切換面板」圖示，開啟「變數」窗格。

在「建立變數」窗格中，執行下列操作：

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」(API 觸發條件) 元素到「For Each Loop」(針對每個迴圈) 元素新增邊緣。將滑鼠懸停在「API trigger」(API 觸發條件) 元素上的控制點，接著將線條拖曳到「For Each Loop」(針對每個迴圈) 元素上的控制點。

測試並發布主要整合項目

最後一個任務是測試及發布主要整合。

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

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

配額與限制

如要瞭解配額和限制，請參閱配額和限制。