查看 Application Integration 支援的連接器

通話整合工作

通話整合工作可讓您叫用或呼叫 Google Cloud 專案中建立的其他整合。

如果您需要定義多個小型整合 (子整合),並使用主要整合 (父項整合) 加以控制,通話整合工作就非常實用。執行子整合後,您也可以在主要整合中讀取子整合的回應。

事前準備

  • 「通話整合」工作會使用 API 觸發條件,識別並呼叫其他整合和子整合。因此,您必須確保要呼叫的整合功能已使用 API 觸發條件設定。如要瞭解如何設定 API 觸發條件,請參閱「API 觸發條件」一文。
  • 請確認您已將使用者代管的服務帳戶連結至整合項目。如果整合作業未設定使用者自管服務帳戶,系統會預設使用預設服務帳戶 (service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com) 進行驗證。
  • 請確認服務帳戶具備 Application Integration 叫用者 IAM 角色。如要瞭解如何將角色授予服務帳戶,請參閱「管理服務帳戶的存取權」。

設定「通話整合」工作

如要設定「通話整合」工作,請按照下列步驟操作:

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

    前往「應用程式整合」

  2. 在導覽選單中,按一下「整合」

    系統隨即會顯示「Integrations」頁面,列出 Google Cloud 專案中可用的所有整合項目。

  3. 選取現有的整合,或按一下「建立整合」來建立新的整合。

    如果您要建立新的整合功能:

    1. 在「Create Integration」窗格中輸入名稱和說明。
    2. 選取整合作業的區域。
    3. 選取要用於整合的服務帳戶。您隨時可以透過整合工具列的 「整合摘要」窗格,變更或更新整合作業的服務帳戶詳細資料。
    4. 按一下「建立」,新建立的整合服務會在整合服務編輯器中開啟。

  4. 整合編輯器導覽列中,按一下「Tasks」,即可查看可用任務和連接器清單。
  5. 在整合服務編輯器中,按一下並放置「Call Integration」元素。
  6. 按一下設計工具中的「Call Integration」任務元素,即可查看「Call Integration」任務設定窗格。
  7. 設定下列子整合作業詳細資料:
    1. API 觸發 ID:請輸入要呼叫的整合服務的 API 觸發 ID。您可以呼叫單一整合或多個整合,並使用相同的觸發 ID。
    2. 使用此 API 觸發 ID 執行所有整合:選取這個選項,即可呼叫所有具有相同 API 觸發 ID 的整合。

      舉例來說,如果整合 A 和整合 B 具有相同的 API 觸發 ID,系統會同時執行整合 AB

    3. 執行單一整合:選取這個選項,即可只呼叫「Integration name」欄位中指定的整合。您可以設定地圖子整合回應變數中的欄位,藉此存取子整合功能的回應並進行對應。

    4. 執行策略:為要呼叫的子整合項目選取執行模式。
      • SYNC:以同步模式執行子整合作業。在這個模式中,主整合作業會等待子整合作業完成,再繼續執行下游工作。

      • ASYNC:以非同步模式執行子整合作業。在這個模式中,主要整合作業不會等待子整合作業完成。在呼叫子整合項目後立即執行主整合項目的下游工作。

        如果選取這個選項,請設定執行延遲時間 (以毫秒為單位)。如已設定,則會指定整合作業的延遲時間。

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

對應子整合回應變數

下表說明設定屬性,以便將主要整合項目與子整合項目之間的變數對應起來:
資源 說明
Map to sub-integration input(s)

將主要整合項目的值對應至子整合項目。這個欄位會以鍵/值組合的形式接受值,其中鍵是主要整合項目中的變數,而值則是子整合項目中的對應輸入變數。

舉例來說,如果您想將主整合作業的 productID 變數對應至 subIntProductID 子整合作業變數,請在「Integration variable to map from」欄位中選取 productID,然後在「Subintegration input to map to」欄位中輸入 subIntProductID

Map values to sub-integration output(s) 將子整合作業輸出變數對應至主要整合變數。

按一下「要對應的子整合作業輸出內容」,然後選取子整合作業。按一下「要對應的整合變數」,然後選取對應的主要整合變數。

最佳做法

如要瞭解適用於通話整合任務的用量限制,請參閱「 用量限制」一文。

錯誤處理策略

工作錯誤處理策略會指定在工作因暫時性錯誤而失敗時,應採取的動作。如要瞭解如何使用錯誤處理策略,以及不同類型的錯誤處理策略,請參閱「錯誤處理策略」。

配額與限制

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

後續步驟