新增動作至處所客戶歷史

您可以使用 VB Studio，為 CX for Utilities Agent Service 中「處所」畫面上的客戶歷史記錄新增自訂動作。您可以在每個客戶歷史記錄右側的動作功能表中使用這些自訂動作，如下所示：

圖 14-7 處所客戶歷史記錄

您可以新增下列類型的動作：

開啟 URL 動作
導覽至頁面動作

下列範例顯示，如何將「開啟 URL」動作或「導覽至頁面」動作新增至按鈕。

此範例假設讀者熟悉處所資料，同時瞭解如何使用 Visual Builder。如需其他資訊，請參閱：

管理處所
Oracle Help Center 中的 Visual Builder Studio 文件庫
使用 Visual Builder Studio 擴充 Oracle Cloud 應用程式指南中的自訂變數與常數

範例：將動作功能表項目新增至處所畫面中的客戶歷史記錄

以管理員的身分登入 CX for Utilities Agent Service。
按一下頁面右上角的功能表，然後選取在 Visual Builder Studio 編輯頁面。
選取您的工作區，然後按一下選取。請注意，您也可以視需求建立新的工作區。
在應用程式 UI 面板中，展開「Customer Experience (CX)」，然後依序展開「Customer Experience For Utilities」及「片段」。
選取 e11y-user-action-template 片段。
選取變數子頁籤，以顯示常數和變數。
按一下 USER_ACTION_CONTEXT_LIST 常數。
在畫面右側的預設值欄位中，輸入下列範例代碼，同時確保您納入代碼範例中的任何參數，也都被包含在 URL 中。
```
[

{

"id": "UNIQUE_ID_TO_IDENTIFY_THIS_ACTION",

"label": "Custom Action",

"active": true,

"context": {

"type": "Url",

"url": "https://test.url.com/trunk/${from}.html?component=${customerClass}&demo=${billingAccountId}",

"windowName": "_blank",

"params": [

{

"name": "from",

"value": "jetCookbook"

},

{

"name": "customerClass",

},

{

"name": "billingAccountId"

}

]

}

}

]
```
此範例代碼使用動作中繼資料中的 customerClass 和 billingAccountId 參數，這些參數是供 Visual Builder 擴充功能使用的。如需我們匯出之參數的完整列表，請參閱該頁面的變數 UserActionParamsUiQuickActionBar，其中目前包括：
- customerClass
- billingAccountId
- setupDate
- endDate
- serviceTypes
- mainCustomer
- relatedParties
如果您想在動作中繼資料的內容參數中使用延伸參數，請完成下列步驟：
1. 返回主要-處所-登陸頁面-開始頁籤，然後選取變數子頁籤。
2. 按一下 USER_ACTION_PARAMS_CUSTOMER_HISTORY_ACTION 常數。
3. 在預設值欄位中，輸入延伸參數的值對應：
```
[[

[

{

"name": "extTestId",

"value": $page.variables.extTestId

}

]

]]
```
按一下 JSON 子頁籤以顯示可讓您輕鬆編輯此範例代碼的檢視，然後更新該代碼範例以反映您的自訂值。
返回主要-處所-登陸頁面-開始頁籤，然後選取變數子頁籤。
按一下 USER_ACTION_UI_CUSTOMER_HISTORY_ACTION 常數。
在預設值欄位中，輸入您在上方的代碼範例中使用的 ID。例如，在此欄位中輸入 ["UNIQUE_ID_TO_IDENTIFY_THIS_ACTION"]。「id」的值必須與您先前建立之使用者動作的 ID 相符。
預覽您的變更，以確認變更是否如您預期般顯示。這將會啟動包含處所畫面的新頁籤。請確認您的新選項是否可用，以及是否能讓您前往適當的 URL。
如果您的變更已可供使用時，請完成將該變更發布至生產環境的步驟。

上階主題：Customer Experience for Utilities 使用案例