查看 Application Integration 支援的連接器。

擷取 API 酬載並傳送電子郵件

瞭解如何在 Application Integration 中建立範例整合作業。以下步驟說明如何設定執行完整整合作業所需的觸發條件、工作、邊緣、變數和資料對應項目。

總覽

在本快速入門課程中，您將從公開 API 擷取網頁瀏覽次數，將資料轉換為可用格式，並透過電子郵件傳送結果清單，所有操作都會在整合編輯器中完成。

如要直接在 Google Cloud 控制台按照逐步指南操作，請按一下「Guide me」(逐步引導)：

逐步引導

建立新的整合功能

如要建立新的整合，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的「Application Integration」頁面。

   前往「應用程式整合」

2. 按一下左側導覽選單中的「整合」，開啟「整合」頁面。
3. 按一下「建立整合」。
4. 在「Create Integration」對話方塊中輸入名稱和說明。

   在本快速入門課程中，請輸入名稱 my-test-integration 和說明 Integration for quickstart。

5. 選取整合作業的區域。
6. 按一下「建立」開啟整合服務編輯器。

新增及設定 API 觸發條件

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

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

1. 在整合服務編輯器中，按一下「觸發條件」，即可顯示可用的觸發條件清單。
2. 在整合服務編輯器中，按一下「API 觸發條件」。
3. 如要設定觸發條件，請按一下「API 觸發條件」。觸發事件設定窗格隨即顯示。
4. Application Integration 會自動填入觸發事件的「Label」和「Trigger ID」。觸發事件 ID 是由機器產生，您無法編輯這個值。不過，您可以編輯「Label」屬性的值。

   系統會自動儲存屬性變更。

新增及設定工作

任務是一組可執行的步驟，可將變數做為輸入內容，並產生變數做為輸出內容。與觸發條件一樣，整合項目中可使用任何可用的任務。本快速入門會使用「呼叫 REST 端點」、「資料對應」和「傳送電子郵件」工作。下列步驟會說明各項工作的設定詳細資料。

設定呼叫 REST 端點任務

如要設定「呼叫 REST 端點」任務，請按照下列步驟操作：

1. 選取「工作」，即可查看可用的工作清單。
2. 在整合服務編輯器中，按一下並放置「Call REST Endpoint」。
3. 將滑鼠懸停在「API trigger」(API 觸發條件) 的控制點，然後點選並拖曳線條至「Call REST Endpoint」(呼叫 REST 端點) 任務的控制點，即可從「API trigger」(API 觸發條件) 新增邊緣連線至「Call REST Endpoint」(呼叫 REST 端點) 。邊緣表示從「API trigger」(API 觸發條件) 到「Call REST Endpoint」(呼叫 REST 端點) 任務的控制流程。

   邊緣是指整合項目中任何兩個元素之間的連線。連線表示從一個元素 (任務或觸發條件) 到另一個元素的控制流程方向。如要進一步瞭解邊緣，請參閱「邊緣」。

4. 如要設定任務，請按一下「Call REST Endpoint」。任務設定窗格隨即顯示。設定下列屬性：
   • 標籤：輸入這項工作的自訂名稱。例如輸入 Call REST Endpoint Task。
   • 驗證：這個快速入門課程不需要驗證設定檔。如要進一步瞭解如何將驗證設定檔用於其他用途，請參閱「 在 Application Integration 中建立驗證設定檔」。
   • 工作輸入：輸入呼叫 REST 端點的詳細資料。這裡輸入的資訊會用於呼叫 REST 端點工作。下圖顯示「Call REST Endpoint」任務的「Task Input」和「HTTP settings」部分：

     

     輸入下列資訊：

     • 端點基準網址：輸入 https://wikimedia.org/api/rest_v1/metrics/pageviews/per-article/en.wikipedia/desktop/user/Tree/monthly/20201001/20201031。這個來自 wikimedia.org 的公用 API 會傳回文章「Tree」在特定月份的網頁瀏覽次數。
     • HTTP 方法：使用下拉式清單選取 GET。
   • HTTP 設定：應用程式整合會填入下列值：
     1. 追蹤重新導向： True
     2. 任務應在 HTTP 錯誤時失敗： True
   • 任務輸出：應用程式整合會填入三個變數，用於儲存呼叫 REST 端點的回應資料輸出內容。下圖顯示「呼叫 REST 端點」任務的「任務輸出」和其他部分：

     

     查看下列資訊：

     • responseHeader(Call REST Endpoint)：這個變數會保留與Call REST Endpoint任務相關聯的回應標頭資料。變數資料的類型為 String (STR)。
     • responseBody(Call REST Endpoint)：這個變數會保留與Call REST Endpoint 任務相關聯的回應主體資料。變數資料的類型為 String (STR)。
     • responseStatus(Call REST Endpoint)：這個變數會保留與Call REST Endpoint 工作相關聯的回應狀態資料。變數資料的類型為 String (STR)。
   • 其餘欄位應包含下列預設值：
     • 這項工作的執行策略： When all tasks succeed
     • 下一個工作項目的執行政策： Run all match

   系統會自動儲存屬性變更。

新增及設定資料對應工作

如要設定資料對應工作，請按照下列步驟操作：

1. 選取「工作」，即可查看可用的工作清單。
2. 在整合服務編輯器中，按一下並放置「資料對應」。
3. 將滑鼠懸停在「Call REST Endpoint」的控制點上，然後點選並拖曳線條至「Data Mapping」任務的控制點，即可從「Call REST Endpoint」新增至「Data Mapping」的邊緣連線。邊緣表示從「Call REST Endpoint」任務到「Data Mapping」任務的控制流程。
4. 如要設定工作，請按一下「資料對應」工作。任務的設定窗格隨即會顯示。
5. 按一下「Open Data Mapping Editor」。

   資料對應編輯器可讓您使用可用的轉換函式，將輸入變數對應至所需的輸出變數。接著，輸出內容可做為任何其他整合作業或觸發事件的變數。如要進一步瞭解如何將資料做為變數傳遞，請參閱「 變數」一文。

   在本快速入門導覽課程中，請使用 responseBody(Call REST Endpoint) 做為輸入內容，建立對應項目：

   1. 將「responseBody」變數從「變數」窗格拖曳至第一個「輸入」列。
   2. 點選 responseBody 變數方塊中的「+」 (新增函式)，即可查看可用函式清單。您可以套用多個函式，以轉換輸入變數中的資料。

      在這種情況下，您可以將酬載轉換為 JSON，然後在回應陣列中執行迴迭，取得電子郵件通知所需的產品名稱清單。步驟如下：

      • 選取 TO_JSON() 將 responseBody 字串轉換為 JSON。
      • 按一下「responseBody」變數方塊中的「+ (新增函式)」，選取並連結 GET_PROPERTY() 函式。
      • 如要為 GET_PROPERTY() 新增輸入參數，請按一下「變數或值」，然後在「值」中輸入 items。

        這個函式會從 JSON 酬載中擷取屬性。將 items 屬性傳入做為此函式的參數。這項作業只會傳回產品名稱清單，不包含其他產品資訊。函式應如下所示：

        responseBody(Call REST Endpoint).TO_JSON().GET_PROPERTY(items)

      • 如需移除或刪除函式，請按一下 - 符號。
   3. 按一下「Output」欄中的第一個欄位，建立新的輸出變數，用來儲存轉換後資料的值。填寫下列欄位：
      • 在「Name」(名稱) 欄位中輸入 JSONList。
      • 在「變數類型」清單中選取「整合輸出」。
      • 在「資料類型」清單中選取「JSON」
      • 如要建立變數並關閉窗格，請按一下「建立」。新的 JSONList 變數會顯示在資料對應編輯器左側的「變數」清單中。
   4. 對應完成後，請關閉資料對應編輯器。系統會自動儲存所有變更。下圖顯示資料對應編輯器，以及在本快速入門導覽課程中建立的對應項目：

      

新增並設定「Send Email」(傳送電子郵件) 任務

如要設定「傳送電子郵件」工作，請按照下列步驟操作：

1. 在整合編輯器中選取「Tasks」，即可顯示可用工作清單。
2. 在整合服務編輯器中，按一下並放置「Send Email」。
3. 將滑鼠懸停在「Data Mapping」的控制點上，然後點選並拖曳線條至「Send Email」任務的控制點，即可從「Data Mapping」新增至「Send Email」的邊緣連結。邊緣表示從「Data Mapping」任務到「Send Email」任務的控制流程。
4. 如要設定工作，請按一下「Send Email」。任務的設定窗格隨即會顯示。在「Task Input」部分中，設定下列屬性：
   • 收件者：輸入您的電子郵件地址。您將使用這封電子郵件，確認整合作業是否順利完成。
   • 主旨：輸入 Email from Application Integration。
   • 純文字內文：選取先前在「資料對應」工作中建立的 JSONList 變數。
   • 其餘選項則可保留預設設定。

   系統會自動儲存屬性變更。

確認必要的邊緣連線

請確認您已在整合中為任務和觸發條件新增邊緣連線。連線表示從一個元素 (任務或觸發條件) 到另一個元素的控制流程方向。如要進一步瞭解邊緣，請參閱「邊緣」。

完成的連線應如下圖所示：

測試整合

如要測試新的整合功能，請按照下列步驟操作：

1. 在整合服務編輯器的工具列中，按一下「Test」。

   「Test Integration」窗格隨即顯示。

2. 按一下「測試整合」。

如要進一步瞭解測試，請參閱「測試及發布整合」。

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

整合功能傳送的電子郵件應包含類似以下的內文：

[{
   "project": "en.wikipedia",
   "article": "Tree",
   "granularity": "monthly",
   "timestamp": "2020100100",
   "access": "desktop",
   "agent": "user",
   "views": 33828.0
}]

除了驗證電子郵件內容之外，您還可以檢查記錄，查看特定整合項目的狀態和酬載。如要查看記錄，請按照下列步驟操作：

1. 在整合服務編輯器的工具列中，按一下「Logs」。
2. 您可以在「執行記錄」頁面中，查看每次嘗試執行整合功能的詳細資料。 每個項目都包含執行作業的詳細資料，包括：
   • 整合名稱
   • 執行作業 ID
   • 狀態
   • 開始時間
   • 時間長度
   • 整合版本
   • 觸發條件 ID
   • Cloud Logging
3. 按一下已執行整合項目旁的展開箭頭 (>)，即可查看整合項目中的工作和變數展開清單，以及工作狀態和變數酬載。

配額與限制

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