外部動作設定
外部動作可讓Journey Optimizer B2B edition中的帳戶歷程直接從歷程畫布連線外部系統。 當帳戶對象到達外部動作節點時，系統會非同步呼叫已設定的外部服務，傳遞帳戶、人員或兩者的對象屬性資料。 外部服務使用回呼處理資料及回應，傳回可用於引導歷程執行的對象資料及中繼資料。
此功能支援兩種歷程節點型別：
- 外部動作 — 呼叫外部服務並沿著單一傳出路徑繼續。 適合 引發並忘記 整合，例如更新CRM記錄或觸發下游通知。
- 外部分割路徑 — 呼叫外部服務並評估回應，以沿著數個已定義的路徑之一路由帳戶。
實施概述
設定外部動作需要依序在三個角色之間進行協調：
實作外部服務 implement-service
開發人員必須建立並發佈符合Adobe Journey Optimizer B2B edition外部動作服務提供者介面的公開顯示網頁服務。
服務上線後，將OpenAPI規格的URL和驗證認證提供給負責設定動作的產品管理員。
設定動作 configure-action
必須先設定並啟動動作，行銷人員才能在歷程中使用。 動作以 草稿 狀態建立，且您的變更會自動儲存。 在您啟動它之前，它一直保持為草稿。
-
移至管理 > 組態。
-
按一下中繼面板上的外部動作。
-
按一下右上角的建立動作。
-
輸入外部服務的OpenAPI規格URL，然後按一下建立。
外部服務必須為即時狀態且可連線，此步驟才能成功。 如果發生驗證錯誤，對話方塊會顯示訊息以說明錯誤，並提供解決錯誤的建議。 如需詳細資訊，請參閱疑難排解。
-
當URL成功解析時，請檢閱服務詳細資料。
建立動作時，會直接從OpenAPI規格讀取服務詳細資料。 建立後，您無法在設定中變更這些屬性。
table 0-row-3 1-row-3 2-row-3 3-row-3 屬性 說明 OpenAPI規格屬性 名稱 動作的名稱 info.title說明 動作的說明 info.descriptionURL 定義外部服務的OpenAPI規格的URL servers.url -
輸入外部服務(
components.securitySchemes)的 驗證 認證。note NOTE 顯示的認證欄位取決於外部服務中定義的驗證機制。 支援的型別為API金鑰、OAuth2和HTTP基本驗證。 
當設定的動作處於 草稿 或 作用中 狀態時，您可以視需要變更認證。
-
按一下下一步。
-
設定 組態 屬性以定義動作與外部服務交換資料的方式。
note NOTE 標示為_靜態_的屬性在設定時不可更新，而且是以服務定義為基礎。 -
動作型別 （靜態） — 支援的歷程節點型別：
- 外部動作 (
enableSplitPath= false) - 外部動作分割路徑 (
enableSplitPath= true)
建立動作設定後，您無法變更動作型別。
- 外部動作 (
-
存取子 （靜態） — （僅限外部動作分割路徑）外部服務傳回的變數可用作外部分割路徑節點中的路徑條件。 (
invocationPayloadDef.accessorsMetadata) -
歷程內容 （靜態） — 要求中傳送的對象資料範圍(
supportedEntityType)：-
帳戶 — 僅傳送帳戶
-
人員 — 僅傳送人員
-
帳戶中的人員 — 傳送帳戶和與帳戶相關的人員
-
-
傳出欄位 — 將表格中的每個欄位對應到XDM欄位。 這些欄位會在要求內文中傳送給外部服務。 服務定義屬性：
invocationPayloadDef.accountFields，invocationPayloadDef.fields。
-
傳入欄位 — 將資料表中的每個欄位對應到可更新的XDM欄位。 這些欄位會從外部服務回應填入。 服務定義屬性：
callbackPayloadDef.accountFields，callbackPayloadDef.fields。 建立後可更新。 -
標頭引數 — 輸入每個資料列的值，以作為要求中的HTTP標頭傳遞。 服務定義屬性：
invocationPayloadDef.headers。 -
逾時 — 輸入在要求被視為失敗之前，等待外部服務呼叫回呼的分鐘數。 服務定義屬性：
timeout。 -
全域屬性 — 輸入每個資料列的值，以做為要求內文中的靜態欄位。 服務定義屬性：
invocationPayloadDef.globalAttributes。
-
-
按一下 上一箭號 以返回清單並將動作保持在 草稿 狀態。
或者，按一下[啟動] 將動作組態變更為[啟動]__狀態。 設定的外部動作必須處於作用中狀態，才能用於帳戶歷程。
疑難排解 troubleshooting
當您輸入外部服務的OpenAPI規格URL並按一下 建立 時，系統會執行服務驗證。 發生錯誤時，對話方塊會顯示訊息以說明錯誤。
驗證錯誤詳細資料
This URL is already used by another external actionAn action with this name already existsinfo.title符合已經存在的動作info.title欄位中的標題變更為獨一無二的標題。Duplicate operation ID found in the specificationoperationId。operationId。Field in the specification exceeds the maximum allowed lengthThe provided document is not a valid OpenAPI specificationRequired OpenAPI field is missinginfo或paths）。Required endpoint is missing from the specificationRequired extension field is missingx-擴充功能欄位。Security schemes are missing from the specificationcomponents下定義securitySchemes。Multiple authentication types are not supportedThe authentication type is not supportedoauth2或openIdConnect）。The OpenAPI version is not supportedAn unexpected error occurred將外部節點新增至歷程 add-journey-node
動作啟動後，行銷人員可以將 外部動作 或 外部分割路徑 節點新增至任何帳戶歷程。 如需如何在帳戶歷程畫布中新增及使用這些節點的詳細資訊，請參閱外部節點。