Implementing a Weather Service

Utilities can choose to implement a third-party weather service so that temperature information is displayed in usage charts of the Customer Experience for Sales and Customer Experience for Agent Service solutions. The weather information appears as a line that overlays the usage bars in the chart. The line includes data points that, when clicked or hovered over, display the minimum, maximum, and average temperature associated with the bar that contains the data point. For example, if the bar represents an entire bill period, the data displays the temperature data associated with that bill period.

To implement a weather service, you must:

1. Select a third-party service.
2. Follow the specifications provided by Oracle to integrate your weather data with the Customer Experience for Utilities solutions.
3. Generate an access token.
4. Register your weather service system.
5. Enable the weather line display.

Understanding Weather Data Specifications

For your weather data to appear in the solution, you must follow the openapi 3 specification. To view the specification, use the following:

Method: GET
URL: https://<HOST>:<PORT>/api/weather/v1/describe

Generate an Access Token

For instructions, see Generate the Access Token.

Register Your Weather Service

You must register your third-party weather service along with your Oracle Utilities customer information system environment with CX Industry Framework. To do this, contact your Oracle Delivery Team. For additional information, see register-oracle-utilities-environ-fa.html#GUID-A6BDF482-5E9C-416C-B27D-C2796C6447D6.

Enable the Weather Data Display

After you have completed all of the above setup, you can then use the ORA_UER_DISPLAY_WEATHER_LINE profile option to display the weather line on usage charts. For additional information, see available-profile-options.html#GUID-6A93BCF9-897B-4C1D-AB46-5E2C074B8C30.