查看 Application Integration 支援的連接器。

監聽 Cloud Pub/Sub 主題並傳送電子郵件

瞭解如何使用應用程式整合和 Cloud Pub/Sub 觸發條件建立整合範例。以下步驟說明如何設定執行完整整合作業所需的觸發條件、工作、變數和資料對應。

總覽

在本快速入門課程中，您將建立整合作業，並使用 Cloud Pub/Sub 觸發條件監聽現有的 Pub/Sub 主題，該主題會從 IoT 裝置接收以攝氏度為單位的溫度讀數。接著，您可以使用「資料對應」工作，將 Pub/Sub 訊息轉換為攝氏度，並透過電子郵件傳送值。

事前準備

將下列 Identity and Access Management (IAM) 角色指派給 Google Cloud 專案中的 Application Integration Service Agent (service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com)：

  • Pub/Sub 編輯者
  • Application Integration 叫用者

    如要進一步瞭解如何指派 IAM 角色，請參閱「IAM 角色和權限」。

設定環境

建立新的 Cloud Pub/Sub 主題

本快速入門導覽課程假設您有一個 Pub/Sub 主題，可從 IoT 裝置接收以絕對溫標為單位的溫度讀數。您不必實際將主題連結至裝置。本快速入門測試整合功能，可在觸發時監聽主題並執行工作。

如要為本快速入門建立範例主題，請按照下列步驟操作：

  1. 前往 Cloud 控制台的 Pub/Sub 主題頁面。

    前往 Pub/Sub 主題頁面

  2. 按一下 [Create a topic] (建立主題)。
  3. 在「Topic ID」欄位中，提供專屬主題名稱。例如：temperaturesensor
  4. 按一下「儲存」。

建立新的整合功能

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

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

    前往「應用程式整合」

  2. 按一下左側導覽選單中的「整合」，開啟「整合」頁面。
  3. 按一下「建立整合」。
  4. 在「Create Integration」對話方塊中輸入名稱和說明。例如：my-test-integration。
  5. 選取整合作業的區域。
  6. 按一下「建立」開啟整合服務編輯器。

新增 Cloud Pub/Sub 觸發條件

如要將 Cloud Pub/Sub 觸發條件新增至整合，請按照下列步驟操作：
  1. 在整合編輯器中，選取「觸發條件」，即可顯示可用觸發條件清單。
  2. 按一下並將 Cloud Pub/Sub 觸發條件元素放入設計工具。

設定 Cloud Pub/Sub 觸發事件

按一下整合編輯器中的「Cloud Pub/Sub 觸發條件」元素，即可查看觸發條件設定窗格。

在「Pub/Sub topic」欄位中，使用以下格式指定觸發條件應聆聽的主題：

projects/PROJECT_ID/topics/TOPIC_ID
 其中：
  • PROJECT_ID 是建立主題的 Google Cloud 專案。
  • TOPIC_ID 是您在事前準備中建立的 Cloud Pub/Sub 主題 ID。

舉例來說，如果您的專案名稱為 my-project，而主題名稱為 temperaturesensor，請輸入：

projects/my-project/topics/temperaturesensor。

如要查看 Google Cloud 專案中的所有可用主題，請參閱「主題」中的「主題名稱」欄。

「Cloud Pub/Sub 觸發條件」設定窗格會自動在「Trigger Output」欄位中填入變數，以便保留 Pub/Sub 訊息。

新增及設定資料對應工作

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

  1. 選取「工作」，即可查看可用的工作清單。
  2. 在整合服務編輯器中按一下並放置「Data Mapping」(資料對應) 元素。
  3. 按一下設計工具中的「Data Mapping」工作，開啟該工作的設定窗格。
  4. 按一下「Open Data Mapping Editor」。

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

    在本快速入門導覽課程中，請按照下列步驟使用 CloudPubSubMessage 做為輸入內容，建立對應項目：

    1. 展開「Variables」清單中的 CloudPubSubMessage JSON 變數，然後將 CloudPubSubMessage.data 變數拖曳至第一個「Input」列。
    2. 按一下 CloudPubSubMessage.data 變數旁的「+」(新增函式)，即可查看可用函式的下拉式清單。
    3. 選取 TO_DOUBLE() 將 CloudPubSubMessage.data 值轉換為 double 資料類型。
    4. 再次按一下「+ (新增函式)」，選取並連結 SUBTRACT 函式。
    5. 輸入 273.15 做為 SUBTRACT 函式值。這是將絕對溫標轉換為攝氏溫標。
    6. 按一下「Output」欄中的第一列，建立新的輸出變數，用來儲存轉換後資料的值。填寫下列欄位：
      • 名稱：輸入 TempInCelsius。
      • 勾選「Use as an output of integration」(以整合輸出內容的形式使用)。
      • 按一下「Create」建立變數，然後關閉窗格。新的 TempInCelsius 變數會顯示在「變數」清單中。
    7. 將「TempInCelsius」變數從「變數」清單拖曳至「輸入」欄的第二行。
    8. 在「TempInCelsius」變數中按一下「+」 (新增函式)，即可查看可用函式的下拉式清單。
    9. 按一下 TO_STRING()，將變數的資料類型從 double 轉換為 string。
    10. 按一下「Output」欄中的第二列，建立新的變數來儲存已轉換資料的值。填寫下列欄位：
      • 名稱：輸入 TempInCelsiusString。
      • 預設值留空代表：選取「空字串」。
      • 勾選「Use as an output of integration」(以整合輸出內容的形式使用) 核取方塊。
      • 按一下「Create」建立變數，然後關閉窗格。新的變數會顯示在資料對應編輯器左側的「變數」清單中。
    11. 對應完成後，請關閉資料對應編輯器。系統會自動儲存所有變更。

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

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

  1. 在整合編輯器中選取「Tasks」，即可顯示可用工作清單。
  2. 在整合服務編輯器中，按一下並放置「Send Email」元素。
  3. 按一下設計工具中的「Send Email」元素，即可開啟任務的設定窗格。設定下列屬性：
    • 收件者：輸入您的電子郵件地址。您將使用這封電子郵件，確認整合作業是否順利完成。
    • 主旨：輸入 Temperature in Celsius。
    • 純文字內文：選取先前在「資料對應」工作中建立的 TempInCelsiusString 變數。
    • 其餘選項則可保留預設設定。
    系統會自動儲存您對屬性所做的變更。

新增必要的邊緣連線

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

  1. 將滑鼠懸停在「Cloud Pub/Sub trigger」元素的控制點，然後點選並拖曳線條至「Data Mapping」任務元素的控制點，即可從「Cloud Pub/Sub trigger」元素至「Data Mapping」元素新增邊緣連線。這條邊緣表示從「Cloud Pub/Sub trigger」任務到「Data Mapping」任務的控制流程。
  2. 透過將滑鼠懸停在「Data Mapping」元素的控制點，接著點選線條並拖曳到「Send Email」任務元素的控制點，即可從「Data Mapping」元素至「Send Email」元素新增邊緣連線。這條邊緣表示從「Data Mapping」任務到「Send Email」任務的控制流程。

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

顯示快速入門流程的圖片 顯示快速入門流程的圖片

發布整合

如要發布整合項目，請在整合服務編輯器工具列中按一下「發布」。

成功發布整合後，您可以查看及檢查已發布的整合項目的執行記錄。如要查看記錄，請按一下「查看這項整合的執行記錄」顯示執行記錄圖示的圖片。系統隨即會顯示「執行記錄」頁面。

使用 Cloud Pub/Sub 測試整合

如要透過 Pub/Sub 主題頁面測試新的整合，請按照下列步驟操作：

  1. 前往 Cloud 控制台的 Pub/Sub 主題頁面。

    前往 Pub/Sub 主題頁面

  2. 搜尋並選取您建立的 temperaturesensor 主題。
  3. 在主題詳細資料頁面中，按一下「+ 發布訊息」，開啟「發布訊息」設定窗格。
  4. 在「Message body」(訊息內文) 欄位中輸入 307.15。

    建立這則訊息可模擬 Pub/Sub 從 IoT 裝置收到的溫度讀數，並以攝氏度發布。

  5. 按一下「發布」，即可將訊息發布至主題並觸發整合作業。

成功完成後，整合作業會傳送電子郵件至「Send Email」任務中指定的電子郵件地址，並將攝氏溫度轉換為攝氏溫度。請在電子郵件用戶端中確認已收到這封電子郵件。

整合功能傳送的電子郵件應包含含有 34 值的訊息主體。

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

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

配額與限制

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