Configuring Admin Data
This section describes the admin data setup in Oracle Utilities Digital Asset Cloud Service related to the integration. The Admin menus can be configured to be grouped alphabetically or by functional groups. The descriptions that follow will include both groupings.
Message Senders
Create a new or update an existing real-time message sender for each Oracle Utilities Digital Asset Cloud Service Outbound Message used for the integration.
To create a message sender:
1. In the Admin menu navigate to [M or Integration] > Message Sender > Add.
2. Enter a unique message sender and its description.
3. Populate the following values:
• Message Sender: Sender name in Oracle Utilities Digital Asset Cloud Service
• Description: Sender’s description
• Invocation Type: Real-time
• Message Class: RTJSONSNDR (Sender for real-time HTTP / JSON messages)
• Active: Select the check box.
• MSG Encoding: UTF-8 message encoding
4. Select the Context tab and set values for the following context types:
• HTTP Header: application/json
• HTTP Login User: User ID to access OIC
• HTTP Login Password: Password to access OIC
• HTTP Method (POST/GET): POST
• HTTP Timeout: 300
• HTTP Transport Method: SendReceive
• HTTP URL 1:
Sample format:
https://[oic.oraclecloud.com]/ic/api/integration/v2/flows/oracleutilities/project/[projectName]/[oicprocessflow]
Sample Message Sender Setup For This Integration
Note: The Integration URL is obtained in the Oracle Integration Cloud (OIC). Log in to OIC, go to the DACS DERMS project and select the integration to invoke from DACS. Go to actions and select Run details; click the metadata URL and you will get the endpoint URL.
External System
Create a new or update an existing external system to support the Distributed Energy Resources Management System.
To create an external system:
1. In the Admin menu navigate to [M or Integration] > External System > Add.
2. Enter a unique External System and its Description.
3. Add the following outbound message types to the external system. For each outbound message type, set the following:
• Outbound Message Type
• Controllable Device Status Check: Use the X1-CTRLDVCS (Controllable Device Status Check) outbound message type
• Synchronize Digital Asset: Use the X1-NMSDASMSG (Synchronize Digital Asset (NMS)) outbound message type
• Processing Method: Real-time
• Message Sender: Set the corresponding message sender for the outbound message
• Date/Time Format: XSD
• JSON Conversion Method: Base JSON conversion
Inbound Web Service (IWS)
The following REST inbound web services are delivered for this integration:
• X1-ProgramEnrollment
• X1-ControllableDeviceStatus
• X1-ProgramEventParticipation
• X1-ProgramEvent
The full URI component for the REST inbound web service is configurable.
The Oracle Utilities Digital Asset Cloud Service documentation provides instructions about the one-time setup. Refer to the
Documentation and Resources section in
Configuring Oracle Utilities Digital Asset Cloud Service for information about documentation resources.
Master Configuration
This section describes the master configuration details for the integration. The following Master Configurations can be found from the Admin menu > [M or General] > Master Configuration.
Cross Product Master Configuration
The Cross Product master configuration is used in a Oracle Utilities Customer to Meter (C2M) implementation. The External System define here is used for all communications between Oracle Utilities Customer Care and Billing and Oracle Utilities Meter Data Management applications, such as sync requests, Service Order Management (SOM) queries, and so on.
Digital Asset Integration Master Configuration
The Digital Asset master configuration is used to synchronize digital asset customer information to Oracle Utilities Grid Edge Distributed Energy Resources Management System.
To create a Digital Asset Integration master configuration:
1. In the NMS Integration Parameters section, populate the following:
• External System: DERMS External System
• Sync Request Outbound Message Type: X1-NMSDASMSG (Synchronize Digital Asset (NMS))
• Program Subscription Types Eligible for Sync: Configure one or more program subscription types that are eligible for sync to NMS-DERMS.
2. Save the configuration details.
Seeder Sync Request Master Configuration
The Seeder Sync master configuration identifies the ongoing synchronization request business object and key reference view for the maintenance object specified in the synchronization request.
Master Data Synchronization Master Configuration
The Seeder Sync master configuration identifies the ongoing synchronization request business object and key reference view for the maintenance object specified in the synchronization request.
Head End System
Create a new or update an existing head end system for each external energy aggregator interfaced to Oracle Utilities Live Energy Connect.
To create a head end system:
1. In the Admin menu navigate to [H or Digital Asset Management] > Head End System > Add.
2. Enter a unique head end system and its description.
3. Specify the external system created for Oracle Utilities Grid Edge Distributed Energy Resources Management System.
4. Add a processing method for processing role Device Status Check. On the processing method, set the following:
• Default Business Object: X1-CtrlDvcStatusCheckComm (Controllable Device - Device Status Check)
• Default Outbound Message Type: Controllable Device Status Check
Controllable Asset Specification
Specifications describe design details and functional performance criteria for a set of controllable assets. This can include manufacturer, model, and other information specified for the assets.
Create new or update existing controllable asset specification for each combination of head end system, make and model.
To create a specification:
1. In the Main menu, navigate to [Asset Management] > Specification > Add.
2. Select Specification Business Object: Controllable Asset Specification (X1-ControllableAssetSpec)
3. Enter a unique specification and its description.
4. Enter the Asset Type for the controllable asset.
5. Enter the Manufacturer, Make, and Head End System.
Program
Programs represent specific demand response programs in which customers can participate and let their utility service provider temporarily take control of specific devices in their homes in response to periods of high demand.
Note: You can create new demand response programs, or update the existing ones.
To create a program:
1. In the Main menu navigate to [Digital Asset Management] > Program > Add.
2. Select Program Type associated with the program. Program types define certain parameters and attributes of a class of programs.
3. Enter a unique description.
4. Enter the Program External Id. The Program ID or Code used by external systems.
5. Enter other relevant information as needed.
Activity Type
Create a new or update an existing activity type for the Controllable Device Status Check activity.
To create an activity type:
1. In the Admin menu, navigate to [A or Communication].
2. Add or edit the Controllable Device Status Check activity and its description. Refer to the embedded help for more information.
Communication Type
Create a new or update an existing communication type for the following Communication Types:
• Controllable Device: Device Status Check
• Controllable Device: Device Status Check Response
To create a communication type:
1. In the Admin menu navigate to [C or Communication Type].
2. Enter a unique communication type and its description. Refer to the embedded help for more information.
Service Task Type
Create a new or update an existing service task type for the following Service Task Type Business Objects:
• Digital Asset Enrollment Request Task Type
• Digital Asset Unenrollment Request Task Type
To create a service task type:
1. In the Admin menu navigate to [S or General].
2. Enter a unique service task type and its description. Refer to the embedded help for more information.
Sync Request Process
The Sync Request Process is used to synchronize customer enrollment and unenrollment data from Oracle Utilities Digital Asset Cloud Service to Oracle Utilities Grid Edge Distributed Energy Resources Management System. Maintenance Object - Audit algorithms are responsible for instantiating subscription based sync request records.
To configure a Maintenance Object:
1. In the Admin menu, navigate to [M or Database] > Maintenance Object > Search.
2. Navigate to the following Maintenance Objects and configure the following:
• Usage Subscription (D1-US): Under the Maintenance Object - Options tab, add the “Sync Request BO” MO Option with an option value “X1-NMSDigitalAssetCustSync (NMS Digital Asset Customer Sync Request)”. Plug in the F1-GCHG-CDCP (Generic Change Data Capture) MO audit algorithm. When a change is detected on a program subscription, this algorithm is responsible for instantiating the sync request.
• Contact (D1-CONTACT): Plug in the X1-CNTCDCDA (Contact Change Data Capture (Digital Asset Subscription Based)) MO audit algorithm. When a change is detected on a contact associated to an eligible program subscription, this algorithm is responsible for instantiating the sync request.
• Device (D1-DEVICE): Plug in the X1-DVCCDCDA (Device Change Data Capture (Digital Asset Subscription Based)) MO audit algorithm. When a change is detected on a controllable device associated to an eligible program subscription, this algorithm is responsible for instantiating the sync request.
• Service Point (D1-SP): Plug in the X1-LOCCDCDA (Location Change Data Capture (Digital Asset Subscription Based)) MO audit algorithm.When a change is detected on a device location associated to an eligible program subscription, this algorithm is responsible for instantiating the sync request.