Implementation

Common Steps

1. Determine the set of geographic area types to be used for summarizing outage information. Common options are coun ties, zip codes, municipalities. The default product configuration includes area types: COUNTY, ZIP_CODE, and CITY.
Note: ODIN recommends using US FIPS County Codes when publishing to their website outage information for area type county.

2. If necessary, create a project-specific definition of the CUSTOMERS_SERVED materialized view to provide counts of customers served for the selected area types.

3. If necessary, create a project-specific definition of the CURRENT_AFFECTED_CUSTOMERS materialized view to include columns for each used geographic area type.

4. If it is desired to include boundary information for the areas when publishing outage information, spatial table or tables containing polygons representing area boundaries as MDSYS.SDO_GEOMERTY objects need to be created and populated.

5. If necessary, create a project-specific definition of the GEOGRAPHIC_OUTAGE_AREAS view:

• Adjust joining conditions to the CURRENT_AFFECTED_CUSTOMERS materialized view for the used geographic area types

• If including area boundary information, add joining conditions to the spatial tables for each used geographic area type.

6. Set configuration parameter ‘config.publish.period’ to the desired publishing interval in minutes.

7. Set geographic area mapping configuration parameters for the area types that should be published.

Steps If Publishing to the ODIN Website

1. Register an account with the ODIN website (see instructions on the ODIN website).

2. Set configuration parameter 'config.strict_odin_format' to 'true'.

3. Set configuration parameter 'config.publish.format' to 'xml'.

4. Configure OAuth authentication using the credentials of the registered account.

5. Set configuration parameter 'config.publish.url' according to the information in the ODIN Developer Guide (available on the ODIN website).

6. Populate configuration parameters specifying utility id and name.

Steps If Publishing to the Oracle Utilities Digital Self Service (DSS) Outage Map

1. Set configuration parameter config.strict_odin_format to false.

2. Set configuration parameter config.publish.format to json.

3. Set configuration parameter config.include_spatial_info to outage.

4. Configure OAuth authentication through the IDCS instance used by the DSS Outage Map.

5. Set configuration parameter config.publish.url.

Limitations

Currently the Oracle Utilities Network Management System - ODIN Adapter can only publish outage information to a single destination.