Configuring Customer Cloud Service
This chapter provides details on the configurations needed for the integration used by Oracle Utilities Customer Cloud Service. It covers the following areas:
- Configurations for Integrations Related to Communications
- Configurations for Integrations Related to Affordability
- Scheduling Batch Jobs
- Adding Oracle Integration Cloud Certificates
For more information, refer to the Oracle Utilities Customer Cloud Service documentation on Oracle Help Center.
Configurations for Integrations Related to Communications
Application Services
Ensure that your user has access to the following application services.
- C1-CUSENGERROR- secures the Customer Engagement Error BO.
- C1-CUSEGERAS - secures the periodic monitor process for the Customer Engagement Error BO.
Communication Product Event Type Mapping Extendable Lookup
The Communication Product Event Type Mapping (C1-CustEngageValueMapping) extendable lookup defines the mapping between an Opower communication product and event type combination and a Customer Cloud Service notification event type. The lookup is delivered configured out of the box.
Notification Admin Configuration
The following admin data must be configured for its corresponding notification event type lookup value:
- Notification Event Type
- Notification Type
- Customer Contact Type with Contact Action set to ‘Record Customer Engagement’.
Notes:
- A distinct Notification Type and Customer Contact Type can be defined for each Notification Event Type, or multiple Notification Event Types can use the same Notification Type and Customer Contact Type.
- An error is raised if a Notification Event Type or Notification Type is not defined for the incoming communication product/event. If a Customer Contact Type is not defined, the communication is skipped.
Customer Engagement Integration Configuration Extendable Lookup
The Customer Engagement (C1CE) value for the Customer Engagement Integration Configuration (C1-CustEngageIntegration) extendable lookup defines the following:
-
The External System and Outbound Message Type used when sending outbound messages for retrieving an account’s recent communications and viewing communication content
-
The system delivers the following external system and outbound message types:
- External System Opower (F1OPOWER)
- Outbound Message Type View Communication Content (C1COMMUOM)
- Outbound Message Type Account Communications (C1ACCCOMMUOM)
Note that these can be overridden in the extendable lookup.
-
-
Whether an account’s recent communications are retrieved in real-time on load of the Customer Activity History zone.
-
Interval parameters that determine how soon after the most recent communication the on-demand query will be performed again
Message Senders
Configure the context values of the message senders associated with the effective external system and outbound message types.
- The external system and outbound message type combination determines message sender to be used.
- The following message senders referenced by the delivered external system and outbound message types have no context values
- View Communication Content (C1VwCommCont)
- Account Communications (C1AcctComms)
Web Service Catalog
The web service catalog is used by Oracle Integration Cloud to communicate with the Customer Cloud Service inbound and outbound APIs.
Configure the REST Web Service Class. Add the following REST inbound web services and external system to the catalog.
The following table identifies the external system and inbound service that OIC requires in the Customer Cloud Service web service catalog:
Service Type | Service Name | Description |
|---|---|---|
External System | F1OPOWER | Opower |
Inbound Web Service | C1-CustomerEngagement | Customer Engagement |
Refer to Customer Engagement in the Administrative User Guide for more information.
Configurations for Integrations Related to Affordability
Object Storage Configuration
Configure the following:
-
An Oracle Cloud Object Storage file storage location in the File Storage Configuration extendable lookup
-
A Key Ring
Business Flag Upload Configuration
Configure the following:
- A Business Flag Type for Low-to-Moderate Income (LMI) accounts or service agreements
- A custom algorithm based on the Add/Update Customer Profile Attributes (C1CPAUCPA) algorithm type that references the Customer Profile Type defined below
Customer Profile - Admin Configuration
Refer to Setting Up the System for Customer Profile Uploads under Uploading Customer Profiles in the Administrative User Guide for details regarding setting up customer profiles.
Configure the following admin data:
- Customer Profile Attribute Types
- A Customer Profile Attribute Type for Low-to-Moderate Income (LMI)
- Occurrence= Single - Per Related Object
- A Customer Profile Attribute Type for the Low-to-Moderate Income Selection Reason
- Occurrence = Multiple
- A Customer Profile Attribute Type for Low-to-Moderate Income (LMI)
- A Customer Profile Type for Low-to-Moderate Income (LMI) Affordability
- Valid Attributes Types: The Customer Profile Attribute Types deefined above
- Values for the LMI Selection Reason (C1-LMISelectionReasonLookup) extendable lookup. Examples might include :
- ENERGY_BURDEN
- HIGH_POVERTY_TRACT
- J40
- LIHEAP
- PROGRAM_PARTICIPATION
Scheduling Batch Jobs
Run the following Oracle Utilities Customer Cloud Service batch processes:
- Customer Profile Business Flag Upload
Customer Profile Business Flag Upload
Customer Profile Business Flag Upload (C1-CPRUP): This batch process uploads the Opower Affordability Indicator file into Customer Cloud Service. Configure at least the following required batch parameters.
The following table lists the file parameters shown for the Customer Profile Business Flag Upload batch process:
| Batch Parameters | Parameter Description | Value |
|---|---|---|
| fileName | File Name | filename from Opower |
| filePath | The file path where the output should be placed. Refer to Referencing URIs in the user documentation for more details | file-storage: <object storage bucket/folder> |
Adding Oracle Integration Cloud Certificates
Add the Oracle Integration Cloud certificate to the appropriate stores in Oracle Utilities Customer Cloud Service to securely send transactions to the Oracle Integration Cloud layer.
For more information about configuration, refer to the Oracle Utilities Customer Cloud Service documentation on Oracle Help Center.