通話整合工作
您可以使用「Call Integration」工作,叫用或呼叫在 Google Cloud 專案中建立的其他整合。
在需要定義多個小型整合 (子整合),並使用主要整合 (父項整合) 控制這些整合的案例中,通話整合工作非常實用。執行子整合後,您也可以在主要整合中讀取子整合的回應。
事前準備
- 「呼叫整合」工作會使用 API 觸發條件來識別及呼叫其他整合和子整合。因此,請務必使用 API 觸發條件設定要呼叫的整合功能。如要瞭解如何設定 API 觸發條件,請參閱「API 觸發條件」。
- 確認您已將使用者代管的服務帳戶附加至整合功能。如果整合服務未設定使用者管理的服務帳戶,系統預設會使用預設服務帳戶 (
service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com) 進行驗證。 - 確認服務帳戶具備「Application Integration 叫用者」IAM 角色。如要瞭解如何將角色授予服務帳戶,請參閱「管理服務帳戶的存取權」。
設定「通話整合」工作
如要設定「通話整合」工作,請按照下列步驟操作:
- 前往 Google Cloud 控制台的「Application Integration」頁面。
- 在導覽選單中,按一下「整合」。
系統會顯示「整合」頁面,列出 Google Cloud 專案中可用的所有整合項目。
- 選取現有整合,或按一下「建立整合」建立新整合。
如要建立新的整合項目:
- 在「建立整合」窗格中輸入名稱和說明。
- 選取整合作業的區域。
- 選取整合的服務帳戶。如要變更或更新整合的服務帳戶詳細資料,請隨時前往整合工具列的「整合摘要」窗格。
- 點按「Create」(建立)。新建立的整合服務會在整合服務編輯器中開啟。
- 在整合編輯器的導覽列中,按一下「Tasks」(工作),即可查看可用工作和連結器的清單。
- 在整合服務編輯器中,按一下並放置「Call Integration」(呼叫整合服務) 元素。
- 在設計工具中,按一下「呼叫整合」任務元素,即可查看「呼叫整合」任務設定窗格。
- 設定下列子整合詳細資料:
- API 觸發條件 ID:輸入要呼叫的整合API 觸發條件 ID。您可以使用相同的觸發 ID 呼叫單一或多個整合。
- 使用這個 API 觸發條件 ID 執行所有整合:選取這個選項,即可呼叫具有相同 API 觸發條件 ID 的所有整合。
舉例來說,如果整合項目
A和B具有相同的 API 觸發條件 ID,則整合項目A和B都會執行。 - 執行單一整合:選取這個選項,只呼叫「整合名稱」欄位中指定的整合。您可以設定「對應子整合回應變數」中詳述的欄位,存取及對應子整合的回應。
- 執行策略:選取要呼叫的子整合執行模式。
- SYNC:以同步模式執行子整合。在這個模式中,主要整合作業會等待子整合作業完成,再繼續執行下游工作。
-
ASYNC:以非同步模式執行子整合。在此模式下,主要整合不會等待子整合完成。呼叫子整合後,主要整合會立即執行下游工作。
如果選取這個選項,請設定「執行延遲 (以毫秒為單位)」。設定後,系統會延遲指定時間,再執行整合作業。
系統會自動儲存所有屬性變更。
對應子整合回應變數
下表說明設定屬性,可將主要整合和子整合之間的變數對應:| 屬性 | 說明 |
|---|---|
Map to sub-integration input(s)
|
將主要整合的值對應至子整合。這個欄位會以鍵/值組合的形式取值,其中鍵是主要整合中的變數,值則是子整合中的對應輸入變數。 舉例來說,如要將主要整合的 |
Map values to sub-integration output(s)
|
將子整合輸出變數對應至主要整合變數。 按一下「Subintegration output to map from」(要對應的子整合輸出),然後選取子整合。按一下「要對應的整合變數」,然後選取對應的主要整合變數。 |
最佳做法
如要瞭解 Call Integration 工作適用的用量限制,請參閱「 用量限制」。
錯誤處理策略
工作錯誤處理策略會指定工作因暫時性錯誤而失敗時,系統應採取的動作。如要瞭解如何使用錯誤處理策略,以及不同類型的錯誤處理策略,請參閱「錯誤處理策略」。
配額與限制
如要瞭解配額和限制,請參閱「配額與限制」。