通話整合工作

您可以使用「Call Integration」工作,叫用或呼叫在 Google Cloud 專案中建立的其他整合。

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

事前準備

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

設定「通話整合」工作

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

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

    前往 Application Integration

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

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

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

    如要建立新的整合項目:

    1. 在「建立整合」窗格中輸入名稱和說明。
    2. 選取整合作業的區域。
    3. 選取整合的服務帳戶。如要變更或更新整合的服務帳戶詳細資料,請隨時前往整合工具列的「整合摘要」窗格。
    4. 點按「Create」(建立)。新建立的整合服務會在整合服務編輯器中開啟。

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

      舉例來說,如果整合項目 AB 具有相同的 API 觸發條件 ID,則整合項目 AB 都會執行。

    3. 執行單一整合:選取這個選項,只呼叫「整合名稱」欄位中指定的整合。您可以設定「對應子整合回應變數」中詳述的欄位,存取及對應子整合的回應。

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

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

        如果選取這個選項,請設定「執行延遲 (以毫秒為單位)」。設定後,系統會延遲指定時間,再執行整合作業。

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

對應子整合回應變數

下表說明設定屬性,可將主要整合和子整合之間的變數對應:
屬性 說明
Map to sub-integration input(s)

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

舉例來說,如要將主要整合的 productID 變數對應至subIntProductID 子整合變數,請從「要對應的整合變數」欄位選取 productID,並在「要對應的子整合輸入」欄位中輸入 subIntProductID

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

按一下「Subintegration output to map from」(要對應的子整合輸出),然後選取子整合。按一下「要對應的整合變數」,然後選取對應的主要整合變數。

最佳做法

如要瞭解 Call Integration 工作適用的用量限制,請參閱「 用量限制」。

錯誤處理策略

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

配額與限制

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

後續步驟