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
Acknowledgements will be sent back to Oracle Utilities Customer Cloud Service. Configure a Message Sender for sending the messages to Oracle Utilities Customer Cloud Service.
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 checkbox.
• 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: https://oic.oraclecloud.com/api/integration/v1/oracleutilities/oicprocessflow
Sample Message Sender Setup For this Integration
External System
The Acknowledgement outbound message needs to be configured on the Oracle Utilities Customer Cloud Service external system.
Create a new or update an existing external system to support the Oracle Utilities Digital Asset Cloud Service.
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 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-SYNREQACK (Send Sync Request Acknowledgement) 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
Sync Admin Data
Certain extendable lookups in Oracle Utilities Digital Asset Cloud Service are used to translate a Oracle Utilities Customer Cloud Service value to a Oracle Utilities Digital Asset Cloud Service value.
The following extendable lookups might need to be updated. Any value extracted from Oracle Utilities Customer Cloud Service must be in the table and it needs to be associated with a corresponding Oracle Utilities Digital Asset Cloud Service value.
• D1-CCBContactTypeLookup translation
• PER_OR_BUS_FLG lookup > D1_CONTACT_TYPE (Program Subscription Contact Type)
• D1-CCBDivisionLookup translation
• CI_CIS_DIVISION > D1_DIVISION
• D1-CCBLifeSupSensitiveLdLookup translation
• LS_SL_FLG lookup > D1_LS_SL_FLG lookup
• D1-CCBSPTypeLookup translation
• CI_SP_TYPE > D1_SP_TYPE (Metered Service Point Type)
• D2-CCBRateScheduleLookup translation
• CI_RS > D2-CCBRateScheduleLookup extendable lookup
• D2-CCBSAStatusLookup translation
• Already configured with valid SA status codes and not customizable
• D2-CCBSATypeLookup translation
• CI_SA_TYPE > D1_US_TYPE (Metered Service Type)
• D1-CCBKeyLookup translation
• KEY_SW (Y/N) > D1-KeyLookup
• D1-CCBOkToEnterLookup translation
• OK_TO_ENTER_SW (Y/N) > D1-OkToEnterLookup
• D1-CCBSPInstructionLookup translation
• CI_MR_INSTR > D1-SPInstructionLookup
• D1-CCBSPWarningLookup translation
• CI_MR_WARN > D1-SPWarningLookup
• Device Location Codes - no translation
• CI_MTR_LOC > D1-DeviceLocationLookup
Acknowledgement Configuration
Only incremental/ongoing updates can receive acknowledgements. No acknowledgements are sent for initial load.
Acknowledgements are only sent back to the application sending the incremental updates if the Outbound Message Type parameter is populated in the Create Acknowledgement algorithm (X1-CRESRACK).
1. Navigate to the “X1-CRESRACK” algorithm and click Edit.
2. Click the plus sign (+) to create a new set of parameters in the Algorithm Versions section.
3. Add the Effective Date.
4. Add “X1-SYNREQACK” value to Parameter Outbound Message Type.
5. Save the configuration.