Adding New Insights With User Actions

You can use VB Studio to make a new custom insight appear in your Customer Experience for Utilities solution, and you can add your own user action to that insight.

For example, you might want to create an insight that appears when a customer's usage exceeds a certain value. You can also create a custom user action for that insight so that if you click on the View details link on your new insight, the system brings you to the Usage tab.

This image shows an example of an insight, and the View details link, which is used to launch the user action.

Figure 14-3 User Action Link

You can add these types of actions:

• Open URL action

• Navigate to page action

Before you complete this task, you must first complete these tasks using the information available in the Customer Experience for Utilities Configuration Tasks topic:

1. Create a new insight type.

2. Create a new insight group insight type, and associate your new insight with this new insight group.

3. Create the user action you want to use in your insight.

4. Create a new user action insight type to associate your user action with the specific type of insight for which you want the action to be available.

5. Delete the existing insight type user action that is associated with the insight type to which you want to add your custom action.

This example assumes that the reader understands how to use Visual Builder. For additional information, see:

• The Visual Builder Studio library in the Oracle Help Center

• Customizing Variables and Constants in the Extending Oracle Cloud Applications with Visual Builder Studio Guide

For additional information about insights, see:

• Using the Overview Tab in the Using CX for Utilities Agent Service Guide

• Managing Insights in the Using CX for Utilities Agent Service Guide

Example: Adding a New Insight with a Custom User Action

1. Log into CX for Utilities Agent Service or CX for Utilities Sales as an administrator.

2. Click the menu at the top right of the page and select Edit Page in Visual Builder Studio.

3. Select your workspace and click Select. Note that you can also create a new workspace if needed.

4. In the App UIs panel, expand Oracle Utilities Advanced Care UI application and then select advanced-customer-care.

5. Select the Variables sub-tab to display the constants and variables.

6. Click on the USER_ACTION_CONTEXT_LIST constant.

7. On the right side of the screen, enter the following sample code in the Default Value field.

   Be sure that any params that you include in your code sample are also included in your URL. Also be sure that the value of “id” matches the id of the user action you created.

   [
   
   {
   
   "id": "CUSTOM_ACTION_NAME",
   
   "label": "Custom Menu Label",
   
   "active": true,
   
   "context": {
   
   "type": "Url",
   
   "url":
   
   "https://custommenuname.html?component=${component}&demo=${demo}&tes
   
   tId=${testId}&billingAccountId=${billingAccountId}&contactPartyNumbe
   
   r=${contactPartyNumber}": [
   
   {
   
   "name": "component",
   
   "value": "menu"
   
   },
   
   {
   
   "name": "demo",
   
   "value": "overview"
   
   },
   
   {
   
   "name": "extTestId",
   
   "scope": "ext"
   
   }
   
   {
   
   "name": "billingAccountId"
   
   }
   
   {
   
   "name": "contactPartyNumber"
   
   }
   
   ]
   
   }
   
   }
   
   ]

8. If there are extensions params that you want to use in action meta-data's context params, complete these steps:

   1. Return to the main-keyaccounts-dashboard-start tab and select the Variables sub-tab.

   2. Click on the USER_ACTION_PARAMS_INSIGHTS constant.

   3. In the Default Value field, enter the value mapping for extension params:

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

9. Click on the JSON sub-tab to display a view where you can easily edit this sample code, and update the code sample so it reflects your custom values.