新增動作至人員與處所搜尋

您可以使用 VB Studio，為 CX for Utilities Agent Service 中「人員與處所搜尋」畫面上的「動作」按鈕新增自訂動作。

圖 14-1 人員與處所搜尋

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

• 開啟 URL 動作

• 導覽至頁面動作

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

此範例假設讀者瞭解如何使用 VB Studio。如需其他資訊，請參閱：

• 使用 CX for Utilities Agent Service 指南中的使用人員與處所搜尋

• Oracle Help Center 中的 Visual Builder Studio 文件庫

• 使用 Visual Builder Studio 擴充 Oracle Cloud 應用程式指南中的自訂變數與常數

範例：將動作功能表項目新增至人員與處所搜尋

1. 以管理員的身分登入 CX for Utilities Agent Service，然後選取人員與處所搜尋頁面頁籤。

2. 按一下頁面右上角的功能表，然後選取在 Visual Builder Studio 編輯頁面。

3. 選取您的工作區，然後按一下選取。請注意，您也可以視需求建立新的工作區。

4. 在應用程式 UI 面板中，展開「Customer Experience (CX)」，然後依序展開「Customer Experience For Utilities」及「片段」。

5. 選取 e11y-user-action-template 片段。

6. 選取變數子頁籤，以顯示常數和變數。

7. 按一下 USER_ACTION_CONTEXT_LIST 常數。

8. 在畫面右側的預設值欄位中，輸入下列範例代碼，這將會新增一個開啟 URL 動作：

   [
   
   {
   
   "id": "CUSTOM_ACTION_NAME",
   
   "label": "Custom Menu Label",
   
   "active": true,
   
   "context": {
   
   "type": "Url",
   
   "url": "https://custommenuname.html?component=${component}&demo=${demo}&testId=${testId}",
   
   "params": [
   
   {
   
   "name": "component",
   
   "value": "menu"
   
   },
   
   {
   
   "name": "demo",
   
   "value": "overview"
   
   },
   
   {
   
   "name": "testId",
   
   "scope": "ui"
   
   }
   
   ]
   
   }
   
   }
   
   ]

   您也可以新增「導覽至頁面」動作，方法是把上方的代碼範例替換成下列的代碼範例：

   [
   
   {
   
   "id": "CUSTOM_ACTION_NAME",
   
   ...
   
   },
   
   {
   
   "id": "NAVIGATE_ACTION_NAME",
   
   "label": "Navigate to digital-sales page",
   
   "active": true,
   
   "context": {
   
   "type": "InAppNavigation",
   
   "appName":  "digital-sales",
   
   "appPage": "es/p/mycustomers/contacts",
   
   "windowName": "_blank",
   
   "params": [
   
   {
   
   "name": "puid",
   
   "alias": "partyNumber"
   
   }
   
   }
   
   }
   
   ]

9. 如果您想在動作中繼資料的內容參數中使用延伸參數，請完成下列步驟：

   1. 返回「主要-聯絡資訊-開始」頁籤，然後選取變數子頁籤。

   2. 按一下 USER_ACTION_PARAMS_HEADER_ACTIONS 常數。

   3. 在預設值欄位中，輸入延伸參數的值對應：

      [[
      
      [
      
      {
      
      "name": "testId",
      
      "value": $page.variables.testId
      
      }
      
      ]
      
      ]]

10. 按一下 JSON 子頁籤以顯示可讓您輕鬆編輯此範例代碼的檢視，然後更新該代碼範例以反映您的自訂值。

11. 返回 主要-聯絡資訊-開始 頁籤，然後選取變數子頁籤。

12. 按一下 USER_ACTION_UI_HEADER_ACTIONS 常數。

13. 在預設值欄位中，輸入您在上方的代碼範例中使用的 ID。例如，在此欄位中輸入 ["CUSTOM_ACTION_NAME"]。

14. 預覽您的變更，以確認變更是否如您預期般顯示。這將會啟動包含人員與處所搜尋的新頁籤。請確認您的新選項是否可用，以及是否能讓您前往適當的 URL。

15. 如果您的變更已可供使用時，請完成將該變更發布至生產環境的步驟。