Professional Documents
Culture Documents
August 2010
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
ii
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Table of Contents
Chapter 1: Participating Applications Overview ........................................................................................ 5
Oracle Utilities Customer Care and Billing............................................................................................. 5
Oracle Utilities Meter Data Management ............................................................................................... 5
Terms ..................................................................................................................................................... 5
Prerequisites .......................................................................................................................................... 6
Chapter 2: Understanding the Integration ................................................................................................. 7
Business Process Overview .................................................................................................................. 7
Understanding the Integration Processes.............................................................................................. 9
Chapter 3: Configuration Guidelines ....................................................................................................... 22
Data Synchronization ........................................................................................................................... 22
Setting up Oracle Utilities Customer Care and Billing ......................................................................... 23
Setting Up Oracle Utilities Meter Data Management ........................................................................... 42
Setting up the Process Integration....................................................................................................... 45
Chapter 4: Monitoring, Error Handling and Troubleshooting................................................................... 63
Monitoring from Oracle Utilities Customer Care and Billing ................................................................ 63
Monitoring from Oracle Utilities Oracle Utilities Meter Data Management .......................................... 64
Monitoring from the Integration ............................................................................................................ 65
Chapter 5: Extensibility Options .............................................................................................................. 67
Pre Transformation Extension Point .................................................................................................... 67
Post Transformation Extension Point .................................................................................................. 67
Custom Transformations...................................................................................................................... 67
Appendix A: Data Mapping ...................................................................................................................... 71
SA Information Synchronization .......................................................................................................... 71
SP Information Synchronization .......................................................................................................... 75
Batch Bill Determinants Mapping ......................................................................................................... 78
Online Bill Determinants Mapping ....................................................................................................... 81
Replacement Reads Mapping ............................................................................................................. 85
Appendix B: Cross References ............................................................................................................... 87
iii
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Terms
The following terms and acronyms are used throughout this guide.
Integration Terms
DVM
JMS
SOA
Service-Oriented Architecture Software modules that are provided as services can be integrated or used by
several applications using SOA, even if their respective architectures are substantially different. Rather than
defining an API, SOA defines the interface in terms of protocols and functionality.
JMS Queue
A staging area that contains messages those have been sent and are waiting to be read. The JMS Queues are
available on the Weblogic Application Server
Application Names
CC&B
MDM
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
The applications that are involved in the integration - CC&B and MDM.
Participating
Application
One of the three applications involved in the 3-way integration - CC&B or MDM.
SOAP
Simple Object Access Protocol is a protocol specification for exchanging structured information in the
implementation of Web Services in computer networks.
SA
SP
XML
XSD
UOM
Unit of measure
TOU
Time of use
SQI
BDI
BD
Billing Determinants
VEE
References
For more information on some of the terms and entities related to the integration, see Appendix
B: Cross References.
Prerequisites
All participating applications: Oracle Utilities Customer Care and Billing, Oracle Utilities Meter
Data Management and Oracle SOA Suite must be installed, set up and working properly.
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Terms
Prerequisites
SP synchronization
SA synchronization
Except for replacement reads notification, all other flows are Oracle Utilities Customer Care and
Billing initiated.
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
CCB
Service Point
Information
Service Agreement
Information
Batch Bill
Determinants
Request
Online Bill
Determinants
Request
MDM
CCB Request
MDM Response
Service Point
Information
CCB Request
MDM Response
Account Information
CCB Request
MDM Response
Billing Determinants
CCB Request
MDM Response
MDM Request
CCB Response
Billing Determinants
Replacement Reads
Notification
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Technical Overview
This is a direct integration between Oracle Utilities Customer Care and Billing and
Oracle Utilities Meter Data Management.
The integration receives messages from JMS Queues and sends messages to JMS
Queues. Oracle Utilities Customer Care and Billing and Oracle Utilities Meter Data
Management have the ability to read messages from JMS Queues and write
processed messages to JMS Queues.
Weblogic JMS is used as a queuing mechanism in the integration layer. For each
integration flow there are 8 JMS Queues:
Queue
Description
1.
2.
3.
4.
5.
6.
7.
8.
Two BPEL processes manage each integration flow: one for the request processing
and one for the response processing.
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
10
All technical errors in the integration layer are moved to the error queue of the
queue from which the message has been consumed.
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Source
Request
Queue
Source
Request XSD
Source
Request XSD
JMS Adapter
Consumer
Request
Transformation
Error ?
Yes
Custom Request
Transformation
Source
Request
Error Queue
Target
Request XSD
Target
Request
Queue
JMS Adapter
Producer
No
Error
Notification
Target
Request
Error Queue
Target
Request XSD
Business or
Technical Error?
Technical Error
Domain Value
Maps
Business Error
Error
Transformation
Error
Transformation
Source
Response XSD
Business
Error
Business or
Technical Error?
Target
Response XSD
Target
Responset XSD
Response
Transformation
JMS Adapter
Consumer
Yes
Error
Notification
Source
Response
Queue
JMS Adapter
Producer
Source
Response
Error Queue
No
Error ?
Target
Response
Queue
Target
Response
Error Queue
Technical Error
Source
Response XSD
Custom
Response
Transformation
Source
Response XSD
Domain Value
Maps
11
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Integration Points
The following Integration points are available in Oracle Utilities Customer Care and Billing
Integration to Oracle Utilities Meter Data.
Technical Details
Oracle Utilities Customer Care and Billing sends the SP information in form of xml messages.
These messages are transformed by the integration layer then sent to Oracle Utilities Meter Data
Management SP Sync is triggered before SA Sync so that SPs required by the SAs are in Oracle
Utilities Meter Data Management before SA sync is carried out. Oracle Utilities Meter Data
12
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Composites
Composite Name
Description
OUCCBOUMDMSPSyncReqEBF
OUMDMOUCCBSPSyncRespEBF
JMS Queues
Queue Name
OUCCBSPSyncRequest
Description
CCB SP Sync Request
Used by the integration layer to read incoming SP Sync messages from CCB.
OUCCBSPSyncRequestError
OUCCBSPSyncResponse
OUCCBSPSyncResponseError
OUMDMSPSyncRequest
OUMDMSPSyncRequestError
OUMDMSPSyncResponse
OUMDMSPSyncResponseError
13
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Technical Details
Oracle Utilities Customer Care and Billing sends the SA information in the form of xml messages
which are transformed by the integration layer and sent to Oracle Utilities Meter Data
Management. Oracle Utilities Meter Data Management sends an acknowledgement which is
transformed in the integration layer and sent to Oracle Utilities Customer Care and Billing.
The integration artifacts for SA Sync are as follows:
14
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Composites
Composite Name
Description
OUCCBOUMDMSASyncReqEBF
OUMDMOUCCBSASyncRespEBF
JMS Queues
Queue Name
OUCCBSASyncRequest
Description
CCB SA Sync Request
Used by the integration layer to read incoming SA Sync messages from CCB.
OUCCBSASyncRequestError
OUCCBSASyncResponse
OUCCBSASyncResponseError
OUMDMSASyncRequest
OUMDMSASyncRequestError
OUMDMSASyncResponse
OUMDMSASyncResponseError
15
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Technical Details
The batch billing process in Oracle Utilities Customer Care and Billing is running, requesting bill
determinant calculations from Oracle Utilities Meter Data Management for multiple accounts.
Oracle Utilities Customer Care and Billing initiates the Batch Bill request and Oracle Utilities
Meter Data Management returns Bill determinants to Oracle Utilities Customer Care and Billing
per account.
The integration artifacts for Batch Bill Determinants Integration Flow are as follows:
16
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Composites
Composite Name
Description
OUCCBOUMDMBatchBDReqEBF
OUMDMOUCCBBatchBDRespEBF
JMS Queues
Queue Name
OUCCBBatchBDRequest
Description
CCB Batch BD Request
Used by the integration layer to read incoming Batch BD messages from CCB.
OUCCBBatchBDRequestError
OUCCBBatchBDResponse
OUCCBBatchBDResponseError
OUMDMBatchBDRequest
OUMDMBatchBDRequestError
OUMDMBatchBDResponse
OUMDMBatchBDResponseError
17
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Technical Details
If a user is requesting an ad-hoc bill determinant calculation in Oracle Utilities Customer Care and
Billing for a specific account Oracle Utilities Customer Care and Billing initiates the Online Bill
request for a specific account and Oracle Utilities Meter Data Management returns Bill
determinants for the account. Oracle Utilities Meter Data Management sends out success or
failure acknowledgement to the integration layer so that it can be transformed and sent to Oracle
Utilities Customer Care and Billing.
The integration artifacts for Online Bill Determinants Integration Flow are as follows:
18
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Composites
Composite Name
Description
OUCCBOUMDMOnlineBDReqEBF
OUMDMOUCCBOnlineBDRespEBF
JMS Queues
Queue Name
OUCCBOnlineBDRequest
Description
CCB Online BD Request
Used by the integration layer to read incoming Online BD messages from CCB.
OUCCBOnlineBDRequestError
OUCCBOnlineBDResponse
OUCCBOnlineBDResponseError
OUMDMOnlineBDRequest
OUMDMOnlineBDRequestError
OUMDMOnlineBDResponse
OUMDMOnlineBDResponseError
19
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Technical Details
Replacement meter reads are created in Oracle Utilities Meter Data Management and notification
is sent to Oracle Utilities Customer Care and Billing. Oracle Utilities Customer Care and Billing
creates off cycle bill generator based on the Oracle Utilities Meter Data Management request.
Oracle Utilities Customer Care and Billing sends only failure acknowledgements to Oracle Utilities
Meter Data Management.
The integration artifacts for SP Sync are as follows:
20
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Composites
Composite Name
Description
OUMDMOUCCBReplReadReqEBF
OUCCBOUMWMReplReadRespEBF
JMS Queues
Queue Name
Description
OUMDMReplReadRequest
CCB Replacement Read Request - Used by the integration layer to read incoming
Replacement Read messages from MDM.
OUMDMReplReadRequestError
MDM Replacement Read Request Error - Error Queue for MDM Replacement Read
Request
OUMDMReplReadResponse
MDM Replacement Read Response - Used by the integration layer to add transformed
Replacement Read response messages from MDM. Also any integration business errors
are sent to this queue.
OUMDMReplReadResponseError
MDM Replacement Read Response Error - Error Queue for MDM Replacement Read
Response
OUCCBReplReadRequest
CCB Replacement Read Request - Used by the integration layer to add transformed
Replacement Read request messages.
OUCCBReplReadRequestError
CCB Replacement Read Request Error - Error Queue for CCB Replacement Read
Request Error
OUCCBReplReadResponse
CCB Replacement Read Response - Used by the integration layer to read incoming
Replacement Read response messages from CCB.
OUCCBReplReadResponseError
CCB Replacement Read Response Error - Error Queue for CCB Replacement Read
Response Error
21
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Data Synchronization
Data Synchronization
Oracle Utilities Meter Data Management serves as the database of record for meters and usage
while Oracle Utilities Customer Care and Billing manages customers (persons), accounts (service
agreements) and service points. The SA and SP Sync integration point adds relevant SP/SA
data from Oracle Utilities Customer Care and Billing in Oracle Utilities Meter Data Management.
The data synchronization for the following is not completed by the integration product.
a. Meter to SP Association
b. Rates Setup in Oracle Utilities Meter Data Management and Oracle Utilities Customer
Care and Billing
22
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Admin Tables
Batch Code
BO Algorithms
MO Algorithms
Maintenance Objects
Business Objects
For more information on configuring and working with Oracle Utilities Customer Care and
Billing, see the Oracle Utilities Customer Care and Billing standard documentation.
The following sections provide details into how to configure these items.
Some configurations described may be required for general functionality and do not necessarily
relate directly to the integration; however these are called out as particularly significant
configuration items. The inclusion of such items does not mean that other general items that are
not mentioned do not need to be configured.
Country
Create a country code in Oracle Utilities Customer Care and Billing.
The Main page is used to customize the fields and field descriptions that are displayed where
addresses are used in the system. This ensures that the all addresses conform to the customary
address format and conventions of the particular country you have defined.
Navigation
Admin Menu > Country
Guideline
Create the required country entities
Corresponding DVM
OUCCB_OUMDM_Country
23
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
CIS Division
A CIS division is associated with a jurisdiction. The definition of a jurisdiction is a geographicoriented entity with unique business rules. For example, if you conduct business in California and
Nevada, and each state has different collection rules, you need a separate jurisdiction for each
state. Set up a CIS division for each jurisdiction in which you conduct business.
The codes defined here must exactly match values in the DVM indicated.
Navigation
Admin Menu > CIS Division
Guideline
Corresponding DVM
OUCCB_OUMDM_CISDivision
SA Type
Create the required SA Types. The codes defined here must exactly match values in the DVM
indicated.
Navigation
Admin Menu > SA Type
Guideline
Create SA Types
Corresponding DVM
OUCCB_OUMDM_SAType
SA Status
Create SA Statuses to be sent to Oracle Utilities Meter Data Management. The codes defined
here must exactly match values in the DVM indicated.
Navigation
Admin Menu > Look Up
Guideline
Corresponding DVM
OUCCB_OUMDM_SAStatus
SIC Code
A service agreement for non-residential service should reference a standard industry code (SIC).
This code is used to categorize service agreements for reporting purposes. The codes defined
here must exactly match values in the DVM indicated.
Navigation
Admin Menu > SIC Code
Guideline
Corresponding DVM
OUCCB_OUMDM_SIC
Rate Schedule
Start the rate definition process then enter general information about the rate. The codes defined
here must exactly match values in the DVM indicated.
Navigation
Main Menu > Rates > Rate Schedule
24
Guideline
Add applicable values
Corresponding DVM
OUCCB_OUMDM_RateInfo
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Unit of Measure
Define the Unit of Measure codes. The codes defined here must exactly match values in the DVM
indicated.
Navigation
Guideline
Corresponding DVM
OUMDM_OUCCB_UOM
Time of Use
Define the Time of Use codes. The codes defined here must exactly match values in the DVM
indicated.
Navigation
Admin Menu > Time of Use
Guideline
Define time of use codes
Corresponding
DVM
OUMDM_OUCCB_TOU
Guideline
Corresponding DVM
OUMDM_OUCCB_BDI
Guideline
Corresponding DVM
OUMDM_OUCCB_UsageType
Batch Code
This is the batch process to run the sync request. It is a generic batch process that is used for
different sync processes. It has a couple of parameters that can be used to control which sync
request BOs to process.
Batch Code
F1-SYNRQ
Description
Sync Request Monitor Process. This is the batch process to run the sync request. It is a generic
batch process that is used for different sync processes. It has a couple of parameters that can be
used to control which sync request BOs to process.
25
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Batch Parameters
Parameter Description
maintenanceObject
Value
F1-SYNC REQ
(This is the defaulted value.)
isRestrictedByBatchCode
restrictToBusinessObject
C1-NMSSPSyncRequest
PENDING
restrictToBOStatus
Batch Code
Description
C1-MDMIL
Sync Request Initial Load for MDM - This process starts a corresponding sync request BO for each SA and SP
in the system to setup initial data in MDM. Once this is done, only the next job needs to run on a regular basis.
C1-USGDF
Usage Scheduled Monitor Process (Deferred) - This batch process invokes monitoring rules associated with
the current state of usage records. This batch needs to be executed twice for the Business Object C1UsageRequestCyclicalBilling, once for Pending state and then for Billing Determinants Received state
BILLING
Create bills using bill cycle - The bill cycle process creates bills for accounts with an "open" bill cycle.
BO Algorithms
Algorithm Type
C1-CAPMDMSAI and
C1-CAPMDMSPI
26
Description
Configure the pre-processing algorithms that create the initial snapshot. For the SA Sync, use
algorithm type C1-CAPMDMSAI. For the SP Sync, use C1-CAPMDMSPI. See the algorithm
descriptions for details on how to specify the parameters below.
1.
Define the read BOs each of the algorithms use to build the initial/final snapshot. For the
SA Sync, the base product provides C1-MDMPerson, C1-MDMAccount, C1-MDMSA for
this purpose. For the SP Sync, use C1-MDMPremise and C1-MDMSP. If additional
elements are needed in the sync request, your implementation may create a child of any of
these BOs and add the element under a group called <customElements>. This ensures
that they are included in the sync request message at the proper group nodes so that any
custom translation your implementation may decide to do at the integration layer can be
done.
2.
Define the data area that holds the elements needed in the snapshot. For the SA Sync,
the base product provides C1-MDM1SABasedSnapshot; the SP Sync uses C1MDM1SPBasedSnapshot. Your implementation should not have to create a custom data
area as this already provides <customElements> nodes throughout its schema to allow for
the addition of any elements not included in the base solution.
3.
It is possible to filter qualifying SA Types or SP types for each of the syncs. If this is so,
define these values in the algorithm so that only changes to these SA or SP types are
communicated across to MDM.
4.
It is possible to specify custom read BOs by SA or SP Type. To do so, simply define your
custom BO along with the SA or SP Type you wish to use it with. The algorithm uses this
value instead of those defined in 1.
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Algorithm Type
Description
C1-MDM-TMOT
This monitor algorithm sets a timeout limit on the receipt of a response from the external system.
Define the number of hours your implementation wishes to wait for a response from MDM before
transitioning the sync request into the Error state.
F1-TD-CREATE
This enter algorithm creates a To Do entry. At a minimum, your implementation must define the To
Do Type to use in creating the To Do entry and the Characteristic Type For Log Entry to be used in
linking the to do entry to the sync request via its logs. The base product provides F1-SYNRQ and F1TODO, respectively, for this purpose. For details on the other parameters used by this algorithm, see
the algorithm type description.
MO Algorithms
Configure the MO Audit algorithms. MO Audit algorithms contain the logic to instantiate a sync
request (as long as one does not already exist in the initial state for the MO-Primary Keys
combination). A generic algorithm F1-GCHG-CDCP comes with the base product and is plugged
in on MOs that need to instantiate sync requests for the same MO. This algorithm instantiates
the BOs defined in the Sync Request BO MO Option (see Maintenance Objects below). For MOs
that need a sync request instantiated for a different MO unique algorithms that contain this logic
are used. (For example, changes to the Person or Account MO need to be communicated via an
SA sync request; or changes to the Premise MO need to be communicated via an SP sync)
Algorithm Type
Description
C1-PERCDCSA
C1-ACCTCDCSA
C1-PREMCDCSP
Maintenance Object
Maintenance Object
Description
PERSON
ACCOUNT
SA
Specify the generic MO Audit algorithm F1-GCHG-CDCP. Also specify the C1MDMSASyncRequest BO in the Sync Request BO MO Option.
SP
Specify the generic MO Audit algorithm F1-GCHG-CDCP. Also specify the C1MDMSPSyncRequest BO in the Sync Request BO MO Option.
PREMISE
27
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Business Object
Business Object
C1-MDMSASyncRequest and C1MDMSPSyncRequest
Description
These business objects define the behavior of the outbound sync requests for MDM.
It contains the schema elements monitored and synchronized to MDM.
The following BO Options must be configured to create the outbound sync request:
- Outbound Message Type: This contains a reference to the outbound message BO
to use. The base package includes BO C1-NMSSPSyncReqOutMsg for the NMS SP
Sync. Refer to Defining Outbound Message Types in the user documentation for
more information.
External System: This contains the reference to the outbound message type and its
corresponding configuration for communicating with the external system. The base
package includes the message XSL C1-CCBJMSQAddNamespace.xsl. Please refer
to user documentation referencing External Systems for more information.
Specify the pre-processing algorithm configured in the previous section.
Specify the time out algorithm as a monitor algorithm on the Awaiting
Acknowledgement state for this BO.
Specify the To Do creation algorithm on the Error state for this BO.
Depending on the technology used to communicate the sync request to the external
system, you may need to create your own enter algorithm and plug it into the Send
Request state. The base package comes with an algorithm that creates a message
and drops it into a JMS Queue. If your implementation uses this algorithm (C1-CROUTMSG), you must define the BO Options for External System and Outbound
Message Type.
28
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Business Object
C1-UsageRequest
Description
This business object defines the behavior of a usage request.
To configure your system for usage requests using this business object:
- Create a bill segment type for service agreements that require bill determinants. This
bill segment type should reference the following base product algorithms:
- Create Algorithm: Create bill segment using a usage request
- Get Consumption Algorithm: Get bill segment consumption using a usage request
- Set up SA types for service agreements that require bill determinants. These SA
types SA types should have a special role flag of Bill Determinants Required and
should reference the bill segment type above
- A cancellation reason is required when a usage request is cancelled. Your
implementation must define valid cancel reasons. Navigate to the lookup page and
define valid values for the lookup field C1_USG_CANCEL_RSN_FLG
- Create a 'Check for Response Timeout' algorithm (see above) and specify your
timeout criteria. Update the Awaiting Bill Determinants state on the usage request BO
to reference the timeout algorithm
In addition to the standard BO options, the following BO options are relevant to usage
request business objects:
- External System: An external system is required to communicate usage requests to
the external system
- Outbound Message Type: An outbound message type is required for the usage
request outbound message
C1-UsageRequestNonCyclical
This business object defines the behavior of a usage request created from noncyclical or online bill generation.
In addition to the standard BO options, the following BO options are relevant to usage
request business objects:
- External System: An external system is required to communicate usage requests to
the external system
- Outbound Message Type: An outbound message type is required for the noncyclical billing usage request outbound message. This outbound message type must
reference the base MDM Non-Cyclical Billing Usage Request Outbound Message
C1-UsageRequestCyclicalBilling
This business object defines the behavior of a usage request created from the cyclical
or batch billing process.
In addition to the standard BO options, the following BO options are relevant to usage
request business objects:
- External System: An external system is required to communicate usage requests to
the external system
- Outbound Message Type: An outbound message type is required for the cyclical
billing usage request outbound message. This outbound message type must
reference the base MDM Cyclical Billing Usage Request Outbound Message business
object.
29
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
For more information about the sync request process, the business objects, maintenance
objects and other components use for this process, see the Oracle Utilities Framework User
Guide section titled Data Synchronization.
JMS Configuration
This section describes the JMS configuration to be done in the Oracle Utilities Customer Care
and Billing weblogic server and in the Oracle Utilities Customer Care and Billing deployment xml
files. The configuration in this section is used for receiving JMS messages from the integration
layer.
JMS Module
Create a new JMS Module in the weblogic console.
Enter a meaningful name for the JMS module. This JMS Module is used to create configurations which
consume messages from remote weblogic queues. Example: MDMInegrationModule
Foreign Server
Create a new Foreign Server under the JMS Module in the weblogic console.
30
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
JNDI Connection URL Add the URL for the Integration SOA Server
For example: t3://soserver.com:8002
3. Under the Foreign server create a Foreign Destination for each remote queue.
Local JNDI Name Add a local JNDI name for the Integration Queue. Local JNDI name
is later added manually as part of configuration in the weblogic-ejb-jar.xml <weblogicenterprise-bean> <message-driven-descriptor> <destination-jndi-name>
Remote JNDI Name JNDI name of the queue on the Integration SOA Server
Examples:
For each Integration point, one destination is created.
SP Sync
Destination Name
OUCCBSPSyncResponse
jms/LocalOUCCBSPSyncResponse
SA Sync
Destination Name
OUCCBSASyncResponse
jms/LocalOUCCBSASyncResponse
Batch BD
Destination Name
OUCCBBatchBDResponse
jms/LocalOUCCBBatchBDResponse
Online BD
Destination Name
OUCCBOnlineBDResponse
jms/LocalOUCCBOnlineBDResponse
jms/OUCCBOnlineBDResponse
Replacement Reads
Destination Name
OUCCBReplReadRequest
jms/LocalOUCCBReplReadRequest
31
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Local JNDI Name Add a local JNDI name for the Integration Connection Factory. This
JNDI name is added manually later as part of configuration in the weblogic-ejb-jar.xml
<weblogic-enterprise-bean> <message-driven-descriptor> <connection-factory-jndiname>
Remote JNDI Name JNDI name of the JMS Connection factory on the Integration SOA
Server
For example:
Connection Factory Name
OUCCBOUMDMConnectionFactory
jms/LocalOUCCBOUMDMConnectionFactory
jms/OUCCBOUMDMConnectionFactory
32
The Oracle Utilities Customer Care and Billing configuration files, ejb-jar.xml and ejbweblogic-jar.xml, must be modified to configure Message Driven Beans (MDB). MDBs
which receive messages from the integration queues. These files are part of the Oracle
Utilities Customer Care and Billing Enterprise Archive (EAR) file.
The Oracle Utilities Customer Care and Billing application needs to be redeployed after
these changes are made.
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Enabling changes for the integration: To enable your changes for integration with
Oracle Utilities Meter Data Management it is recommended that you first make a "CM"
copy of the existing template and make your changes to the CM version. If there are
any problems with starting the application it is a simple process to delete the CM
versions of the files and rerun initialSetup to regenerate and redeploy the original
versions.
If you make CM versions of the template files and later install a patch which updates the
base template, the CM version will not be updated.
Working example configuration files are available for download from My Oracle Support in Patch
number 9974118 - CCB - MDM/NMS INTEGRATION CONFIGURATION EXAMPLES. Before
installing the examples please read the Product Fix Design document included in the patch for
more information.
1. Create an MDB for each CCB inbound queue to receive messages and invoke CCB service.
2. Modify the ejb-jar.xml and weblogic-ejb-jar.xml to configure the MDBs.
3. Add the <message-driven> and <container-transaction> tag for each inbound queue in the ejb-jar.xml.
Add a security role with role cisusers in the ejb-jar.xml e.g
<?xml version="1.0" encoding="UTF-8"?>
<ejb-jar>
<display-name>ServiceBean</display-name>
<enterprise-beans>
33
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
<message-driven>
<description>MDB for OUCCBBatchBDResponse</description>
<display-name>OUCCBBatchBDResponse</display-name>
<ejb-name>OUCCBBatchBDResponse</ejb-name>
<ejb-class>com.splwg.ejb.mdb.MessageProcessor</ejb-class>
<messaging-type>javax.jms.MessageListener</messaging-type>
<transaction-type>Bean</transaction-type>
<message-destination-type>javax.jms.Queue</messagedestination-type>
</message-driven>
34
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
<container-transaction>
<method>
<ejb-name>OUCCBOnlineBDResponse</ejb-name>
<method-name>onMessage</method-name>
</method>
<trans-attribute>NotSupported</trans-attribute>
</container-transaction>
4. Modify the weblogic-ejb-jar.xml. Add the <weblogic-enterprise-bean> tag for each inbound queue.
Add a security role with role cisusers.
5. The following are references in the <weblogic-enterprise-bean> tag.
a. <ejb-name> - MDB Name given in ejb-jar.xml
b. <destination-jndi-name> - JNDI name provided in JMS Module Foreign
Server Foreign Destination Local JNDI Name
35
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
<max-beans-in-free-pool>5</max-beans-in-free-pool>
<initial-beans-in-free-pool>1</initial-beans-in-freepool>
</pool>
<destination-jndiname>jms/LocalOUCCBSASyncResponse</destination-jndi-name>
<connection-factory-jndiname>jms/LocalOUCCBOUMDMConnectionFactory</connection-factory-jndi-name>
</message-driven-descriptor>
</weblogic-enterprise-bean>
36
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Outbound Configuration
XAI JNDI Server
Create a new XAI JNDI Server which points to the Integration SOA server.
XAI JMS Queue Queue name in Oracle Utilities Customer Care and Billing
Queue Name JNDI name of the queue on the Integration server For example:
jms/OUCCBSPSyncRequest
XAI JNDI Server Select the XAI JNDI Server created for the integration.
Examples:
Description
Queue Name
SP Sync Request
jms/OUCCBSPSyncRequest
JMS
CI_MDM_JNDI
JMS
CI_MDM_JNDI
Description
Queue Name
SA Sync Request
jms/OUCCBSASyncRequest
37
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Description
Batch Bill Determinant
Request
Queue Name
jms/OUCCBBatchBDRequest
Target Client
Flag
JMS
XAI JNDI
Server
CI_MDM_JNDI
Description
Online Bill Determinant
Request
Queue Name
jms/OUCCBOnlineBDRequest
Target Client
Flag
JMS
XAI JNDI
Server
CI_MDM_JNDI
Description
Online Corrected Read
Response
Queue Name
jms/OUCCBReplReadResponse
Target
Client Flag
JMS
XAI JNDI
Server
CI_MDM_JNDI
XAI JMS Connection Connection name in Oracle Utilities Customer Care and Billing
XAI JNDI Server Select XAI JNDI Server created for this integration as described in
the XAI JNDI Server section
38
Description
CCB MDM Integration
Connection
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
XAI Sender
Create a new XAI Sender for each Oracle Utilities Customer Care and Billing Outbound
Integration Queue.
XAI Sender Sender name in Oracle Utilities Customer Care and Billing
XAI JMS Connection XAI JMS connection created for the integration
XAI JMS Queue XAI JMS Queue created for the Oracle Utilities Customer Care and
Billing Outbound Queue.
4. Select the Context tab and set values for the following Context Types:
Description
CI_MDM_SPSYN
Description
CI_MDM_SASYN
39
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Description
CI_MDM_BBD
CI_MDM_CF
CI_MDM1_BBD
Description
CI_MDM_OBD
CI_MDM_CF
CI_MDM1_OBD
Description
CI_MDM_CRD
CI_MDM_CF
Description
Business Object
C1-MDM1SPSyncReqOutMsg
Description
Business Object
C1-MDM1SASyncReqOutMsg
40
Description
Business Object
C1-CyclicalUsgReqOutMsg
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Description
Business Object
C1-NonCyclicalUsgReqOutMsg
Description
Business Object
CI-CorrectedReadOutMsg
External System
To create a Outbound Message Type for each Oracle Utilities Customer Care and Billing Outbound
queue:
Create a new External System for Oracle Utilities Customer Care and Billing Integration to Oracle
Utilities Meter Data.
4. Associate the Outbound message types created to the External System. For each Outbound message
type set the following
Outbound Message Type Set the outbound message type created for Oracle Utilities
Customer Care and Billing outbound queue
XAI Sender Set the XAI Sender created for the queue.
Processing
Method
XAI Sender
Message XSL
CI_MDM1SPSYN
Real-time
CI_MDM_SPSYN
C1-CCBJMSQAddNamespace.xsl
CI_MDM1SASYN
Real-time
CI_MDM_SASYN
C1-CCBJMSQAddNamespace.xsl
CI_MDM_BBD
Real-time
CI_MDM_BBD
C1-CCBJMSQAddNamespace.xsl
CI_MDM_OBD
Real-time
CI_MDM_OBD
C1-CCBJMSQAddNamespace.xsl
CI-CORRREADM
Real-time
CI_MDM_CRD
C1-CCBJMSQAddNamespace.xsl
41
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
For more information about configuration guidelines see the Oracle Utilities Customer Care and
Billing documentation.
The following sections provide a general overview of these steps, however you should refer to the
Oracle Utilities Meter Data Management Installation and Configuration Guide for detailed steps.
For more information on configuring and working with Oracle Utilities Oracle Utilities Meter Data
Management, please refer to Oracle Utilities Meter Data Management Installation and
Configuration Guide for Release 1.6.1.0.
Standard Oracle Utilities Meter Data Management configuration such as setting up usage
validation rules and setting up services to poll for usage data is covered in the standard Oracle
Utilities Meter Data Management configuration guides.
CCB_SP_TO_MDM_SERVICE
When service point sync requests are sent from Oracle Utilities Customer Care and Billing, they
are sent to a JMS queue monitored by the CCB_SP_TO_MDM_SERVICE service. When a
record is added or changed, the CCB_SP_TO_MDM_SERVICE business rule updates the
service point related data based on the details in the sync request. Configuring the
CCB_SP_TO_MDM_SERVICE service involves the following:
42
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
CCB_SA_TO_MDM_SERVICE
When service account (account data) sync requests are sent from Oracle Utilities Customer Care
and Billing, they are sent to a JMS queue monitored by the CCB_SA_TO_MDM_SERVICE
service. When a record is added or changed, the CCB_SA_TO_MDM_SERVICE business rule
updates the service point-related data based on the details in the sync request. Configuring the
CCB_SA_TO_MDM_SERVICE service involves the following:
CCB_INTEGRATOR_JMS_TRIGGER_SERVICE
When bill determinant calculations are requested from Oracle Utilities Customer Care and Billing,
a record is created in the JMS Queue The CCB_INTEGRATOR_JMS_TRIGGER_SERVICE
service monitors this queue, and when a record is detected, the
CCB_INTEGRATOR_TRIGGER_RULE business rule triggers the Account Selector to create a
record in the BD Request table and record in the BD Queue / BD Queue Archive table for the
account. Configuring the CCB_INTEGRATOR_JMS_TRIGGER_SERVICE service involves the
following:
BD_QUEUEPOLLER
The BD_QUEUEPOLLER service monitors the BD Queue table and when a record is detected,
triggers the Calculator Engine for each record.
When configuring this service and Calculator Engine to process external calculation requests,
include the following parameter in the LODESTAR.CFG configuration file on all application
servers that run the calculator engine:
43
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
BD_QUEUEPUBLISHER
The BD_QUEUEPUBLISHER service monitors the BD Queue table and when a record is
detected, triggers the Bill Determinant Publisher for each record. Configuring the
BD_QUEUEPUBLISHER service involves the following:
CCB_REPL_READ
When replacement usage is detected for an account for which bill determinants have previously
been calculated, a record is created in the Payload Extension table with a Payload Type of
BDRECALC.. The CCB_REPL_READ service monitors this table, and when a record is
detected, the CCB_REPL_READ service sends a message to an outbound queue containing
details of the replacement reading (Account ID, Service Point ID, Start Time, Stop Time, and
Meter ID). Configuring the CCB_REPL_READ service involves the following:
CCB_REPL_ERROR
If there is an error when sending a notification of a replacement reading to Oracle Utilities
Customer Care and Billing, a record is created in a JMS queue The CCB_REPL_ERROR service
monitors this queue, and when a record is detected, the CCB_REPL_ERROR business rule
triggers the Account Selector to create a work queue item noting the failure to send the message.
Configuring the CCB_REPL_ERROR service involves the following:
44
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
<JNDI>
<CONTEXTFACTORY>
weblogic.jndi.WLInitialContextFactory</CONTEXTFACTORY>
<PROVIDERURL> t3://weblogic ip : port </PROVIDERURL>
</JNDI>
</LTMH>
Note: The <PROVIDERURL> element must be updated with the location of the Weblogic
Server. (Example: <PROVIDERURL>t3://10.149.183.43:7021</PROVIDERURL>)
2.
3.
4.
Edit the Classpath field, add the Weblogic client path directory to the end of the data string and click
Save.
Example Classpath= "\portal.jar;.\ltmh.jar;.\lsice.jar;c:\weblogic\wlfullclient.jar"
45
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Configuration properties
System properties
Error handling
Note. Whenever the ConfigurationProperties.xml file is updated, the file must be reloaded for
updates to be reflected in the applications or services that use the updated properties. You can
perform the reload by rebooting the soa server.
Module Configurations are the properties that are shared by multiple integration flows
within this Oracle Utilities Customer Care and Billing Integration to Oracle Utilities Meter
Data.
Service Configurations are the properties that are used by a specific BPEL process.
Module Configurations
DVM flags signal whether an error is triggered when the DVM lookup value is not found for a
DVM. If the value is set to true the integration layer triggers a DVM exception to the initiating
application. If the value is set to false the integration does not trigger any exception and it passes
the source application value as the default value to the target application.
Module Name
Default / Shipped
Value
Description
CCB.Generic.MessageCategory
11114
This is the message category that the integration layer uses for CCB
error messages.
CCB.GenericBusinessException.Messag
eNumber
11001
This is the message number that the integration layer uses for generic
CCB errors.
CCB.GenericDVMException.MessageNu
mber
11401
This is the message number that the integration layer uses for DVM
errors.
SOA-INFRA.AuditLevel
ON
This property needs to be set to OFF if the Audit Level is set to OFF
for the BPEL processes. If the setting is OFF then error handling does
not use the composite and component instance IDs to log the error
message.
46
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Module Name
Default / Shipped
Value
ErrorHandling.GenericEmailID
Description
This property is used to set the administrator email ID for the
errorhandling process to send out an email in case of a critical failure
where even the Errorhandling process fails.
DVM.OUCCB_OUMDM_Country.Throw
Exception
false
DVM.OUCCB_OUMDM_CISDivision.Thr
owException
false
DVM.OUCCB_OUMDM_SAType.Throw
Exception
false
DVM.OUCCB_OUMDM_SAStatus.Thro
wException
false
DVM.OUCCB_OUMDM_SIC.ThrowExce
ption
false
DVM.OUCCB_OUMDM_RateInfo.Throw
Exception
false
DVM.OUMDM_OUCCB_BDI.ThrowExce
ption
false
DVM.OUMDM_OUCCB_TOU.ThrowExc
eption
false
DVM.OUMDM_OUCCB_UOM.ThrowExc
eption
false
DVM.OUMDM_OUCCB_UsageType.Thr
owException
false
Service Configurations
Service Name
OUCCBOUMDMSPSyncR
eqEBF
OUMDMOUCCBSPSyncR
espEBF
Property Name
Default / Shipped
Value
Description
Default.SystemID
OU_CCB_01
Extension.PreXformCCBto
MDM
false
Extension.PreInvokeEnQue
ueToMDM
false
BusinessError.NotificationFl
ag
false
TechnicalError.NotificationF
lag
false
Default.SystemID
OU_MDM_01
Extension.PreXformMDMto
CCB
false
47
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Service Name
OUCCBOUMDMSASyncR
eqEBF
OUMDMOUCCBSASyncR
espEBF
OUCCBOUMDMBatchBDR
eqEBF
OUMDMOUCCBBatchBDR
espEBF
48
Property Name
Default / Shipped
Value
Description
Extension.PreInvokeEnQue
ueToCCB
false
BusinessError.NotificationFl
ag
false
TechnicalError.NotificationF
lag
false
Default.SystemID
OU_CCB_01
Extension.PreXformCCBto
MDM
false
Extension.PreInvokeEnQue
ueToMDM
false
BusinessError.NotificationFl
ag
false
TechnicalError.NotificationF
lag
false
Default.SystemID
OU_MDM_01
Extension.PreXformMDMto
CCB
false
Extension.PreEnqueuetoC
CB
false
BusinessError.NotificationFl
ag
false
TechnicalError.NotificationF
lag
false
Default.SystemID
OU_CCB_01
Extension.PreXformCCBto
MDM
false
Extension.PreEnqueuetoM
DM
false
BusinessError.NotificationFl
ag
false
TechnicalError.NotificationF
lag
false
Default.SystemID
OU_MDM_01
Extension.PreXformMDMto
CCB
false
Extension.PreEnqueuetoC
CB
false
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Service Name
OUCCBOUMDMOnlineBD
ReqEBF
OUMDMOUCCBOnlineBD
RespEBF
OUMDMOUCCBReplRead
ReqEBF
OUCCBOUMDMReplRead
RespEBF
Property Name
Default / Shipped
Value
Description
BusinessError.NotificationFl
ag
false
TechnicalError.NotificationF
lag
false
Default.SystemID
OU_CCB_01
Extension.PreXformCCBto
MDM
false
Extension.PreEnqueuetoM
DM
false
BusinessError.NotificationFl
ag
false
TechnicalError.NotificationF
lag
false
Default.SystemID
OU_MDM_01
Extension.PreXformMDMto
CCB
false
Extension.PreEnqueuetoC
CB
false
BusinessError.NotificationFl
ag
false
TechnicalError.NotificationF
lag
false
Default.SystemID
OU_MDM_01
Extension.PreXformMDMto
CCB
false
Extension.PreInvokeEnQue
ueToCCB
false
BusinessError.NotificationFl
ag
false
TechnicalError.NotificationF
lag
false
Default.SystemID
OU_CCB_01
Extension.PreXformCCBto
MDM
false
Extension.PreInvokeEnQue
ueToMDM
false
BusinessError.NotificationFl
ag
false
49
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Service Name
Property Name
TechnicalError.NotificationF
lag
Default / Shipped
Value
false
Description
If set to true Technical error notification is sent via
email.
Integration Points
Description
OUCCB_OUMDM_ErrorCode
All
OUCCB_OUMDM_Country
SP Sync
OUCCB_OUMDM_CISDivision
SA Sync
OUCCB_OUMDM_SAType
SA Sync
OUCCB_OUMDM_SAStatus
SA Sync
OUCCB_OUMDM_SIC
SA Sync
50
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
DVM
Integration Points
Description
OUCCB_OUMDM_RateInfo
SA Sync
OUMDM_OUCCB_UOM
OUMDM_OUCCB_TOU
OUMDM_OUCCB_BDI
OUMDM_OUCCB_UsageType
For more information refer the chapters Working with Domain Value Maps and Using SOA
Composer with Domain Value Maps in the Oracle Fusion Middleware Developer's Guide
for Oracle SOA Suite for more information about Domain Value Maps
OUCCB_OUMDM_ErrorCode
This DVM is used by the integration code to transform the Oracle Utilities Meter Data
Management error code to Oracle Utilities Customer Care and Billing message number. This help
the implementation layer to map specific message numbers to specific error codes and thus
provide more user friendly error messages in Oracle Utilities Customer Care and Billing.
OUCCB_ErrorCode
OUMDM_ErrorCode
OUCCB_OUMDM_Country
This DVM is used by the integration layer to map the Oracle Utilities Customer Care and Billing
country code to corresponding Oracle Utilities Meter Data Management Country code and Oracle
Utilities Meter Data Management Address format.
OUCCB_CountryCode
This is a valid country code defined in CCB
OUMDM_Country Code
This is a valid country code defined
in MDM
OUMDM_AddressFormat
This is the address format defined in MDM
which corresponds to the country code
OUCCB_OUMDM_CISDivision
This DVM is used by the integration layer to map the Oracle Utilities Customer Care and Billing
CIS Division to corresponding Oracle Utilities Meter Data Management CIS Division.
OUCCB_CISDivision
This is a valid CIS Division defined in CCB
OUMDM_CISDivision
This is a valid CIS Division defined in MDM
OUCCB_OUMDM_SAType
This DVM is used by the integration layer to map the Oracle Utilities Customer Care and Billing
SA Type to corresponding Oracle Utilities Meter Data Management SA Type.
51
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
OUCCB_SAType
This is a valid SA Type defined in CCB
OUMDM_SAType
This is a valid SA Type defined in MDM
OUCCB_OUMDM_SAStatus
This DVM is used by the integration layer to map the Oracle Utilities Customer Care and Billing
SA status to corresponding Oracle Utilities Meter Data Management SA status.
OUCCB_SAStatus
This is a valid SA Status defined in CCB
OUMDM_SAStatus
This is a valid SA Status defined in MDM
OUCCB_OUMDM_SIC
This DVM is used by the integration layer to map the Oracle Utilities Customer Care and Billing
standard industrial code (SIC) to corresponding Oracle Utilities Meter Data Management standard
industrial code.
OUCCB_SIC
This is a valid SIC defined in CCB
OUMDM_SIC
This is a valid SIC defined in MDM
OUCCB_OUMDM_RateInfo
This DVM is used by the integration layer to map the Oracle Utilities Customer Care and Billing
Rate schedule to the corresponding Oracle Utilities Meter Data Management Rate schedule, rate
code, rate form code and jurisdiction.
OUCCB_RateSche
dule
OUMDM_RateSc
hedule
OUMDM_RateCod
e
OUMDM_RateF
ormCode
OUMDM_Jurisdictio
n
OUMDM_OUCCB_UOM
This DVM is used by the integration layer to map the Oracle Utilities Meter Data Management
UOM to corresponding Oracle Utilities Customer Care and Billing UOM.
OUMDM_UOM
This is a valid UOM defined in MDM
OUCCB_UOM
This is a valid UOM defined in CCB
OUMDM_OUCCB_TOU
This DVM is used by the integration layer to map the Oracle Utilities Meter Data Management
TOU to corresponding Oracle Utilities Customer Care and Billing TOU.
OUMDM_TOU
This is a valid TOU defined in MDM
52
OUCCB_TOU
This is a valid TOU defined in CCB
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
OUMDM_OUCCB_BDI
This DVM is used by the integration layer to map the Oracle Utilities Meter Data Management
BDI to Oracle Utilities Customer Care and Billing SQI, UOM and TOU. If the service quantity list
sent by Oracle Utilities Meter Data Management contains BDI then the OUMDM_OUCCB_UOM
and OUMDM_OUCCB_TOU are not used for that list. Instead the values picked up from this
DVM are used even for UOM and TOU mapping.
OUMDM_BDI
OUCCB_SQI
OUCCB_UOM
OUCCB_TOU
This is a valid TOU defined in
CCB
OUMDM_OUCCB_UsageType
This DVM is used by the integration layer to map the Oracle Utilities Meter Data Management
usage type to corresponding Oracle Utilities Customer Care and Billing usage type.
OUMDM_UsageType
This is a valid Usage type defined in MDM
OUCCB_UsageType
This is a valid Usage type defined in CCB
53
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Error Handling
Integration Layer
Request Processing BPEL
Source Request
Queue
Business
Error ?
Source Request
Error Queue
Technical
Error ?
No
Target Request
Queue
No
Target Request
Error Queue
Yes
Yes
Error
Notification
Source Response
Queue
No
Technical
Error ?
Business
Error ?
No
Yes
Source Request
Error Queue
Yes
Target Response
Queue
Target Response
Error Queue
Error
Notification
S. No
A1
54
Business Errors triggered when the DVM lookup values are not found or there is a
transformation error in the integration layer.
Business errors are sent back to the source application and can be re-tried from
there.
Technical Errors trigger when there are connectivity issues between queues.
Technical errors are sent to the error queue and can be re-tried from integration
layer.
Integration Flow
SP Information Sync
CCB originated request
processing
Type of error
Business error
Action
Notification
Type
Retry
Data Correction in
CCB
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
S. No
Integration Flow
A2
A3
SP Information Sync
MDM originated
response processing
A4
B1
SA Information Sync
CCB originated request
processing
B2
B3
SA Information Sync
MDM originated
response processing
B4
C1
Batch BD CCB
originated request
processing
C2
C3
Batch BD MDM
originated response
processing
Type of error
Action
Notification
Type
Retry
Technical error
Email (optional)
Administrator has to
move the messages
to the CCB SP
Request Queue
from Weblogic
Admin Console
Business error
Data Correction in
CCB
Technical error
Email (optional)
Administrator has to
move the messages
to the MDM SP
Response Queue
from Weblogic
Admin Console
Business error
Data Correction in
CCB
Technical error
Email (optional)
Administrator has to
move the messages
to the CCB SA
Request Queue
from Weblogic
Admin Console
Business error
Data Correction in
CCB
Technical error
Email (optional)
Administrator has to
move the messages
to the MDM SA
Response Queue
from Weblogic
Admin Console
Business error
Data Correction in
CCB
Technical error
Email (optional)
Administrator has to
move the messages
to the CCB Batch
BD Request Queue
from Weblogic
Admin Console
Business error
Data Correction in
CCB
55
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
S. No
Integration Flow
C4
D1
Online BD CCB
originated request
processing
D2
D3
Online BD MDM
originated response
processing
D4
E1
Replacement Read
MDM originated request
processing
E2
E3
E4
56
Replacement Read
CCB originated
response processing
Type of error
Action
Notification
Type
Retry
Technical error
Email (optional)
Administrator has to
move the messages
to the MDM Batch
BD Response
Queue from
Weblogic Admin
Console
Business error
Data Correction in
CCB
Technical error
Email (optional)
Administrator has to
move the messages
to the CCB Online
BD Request Queue
from Weblogic
Admin Console
Business error
Data Correction in
CCB
Technical error
Email (optional)
Administrator has to
move the messages
to the MDM Online
BD Response
Queue from
Weblogic Admin
Console
Business error
Message sent to
MDM Replacement
Read Response
Queue
Email (optional)
Data Correction in
MDM
Technical error
Email (optional)
Administrator has to
move the messages
to the MDM
Replacement Read
Request Queue
from Weblogic
Admin Console
Business error
Message sent to
MDM Replacement
Read Response
Queue
Data Correction in
CCB
Technical error
Email (optional)
Administrator has to
move the messages
to the CCB
Replacement Read
Response Queue
from Weblogic
Admin Console
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
INTEGRATION_ERR_STORE
The INTEGRATION_ERR_STORE table is used to store all the error details for each message
failure The table is populated for each integration point based on the
BusinessError.NotificationFlag and TechnicalError.NotificationFlag properties for each service in
the ConfigurationProperties.xml.
INTEGRATION_ERR_LOOKUP
Error handling module configuration is governed by the Integration_err_lookup table. This table
contains processing instructions for each composite. The Error_Processing_Parent composite
picks data for one composite and calls error_Processing_Detail for processing. The configuration
in this table is used to process the error records stored in the INTEGRATION_ERR_STORE
table.
Copyright 2010, Oracle and/or its affiliates. All rights reserved.
57
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
S. No.
Column Name
Description
LookUp_ID
Auto generated
IP_Name
Example
OUMDMOUCCBReplReadReqEBF
3
Processing_Status
Run_Flag
Next_Runtime
SYSDATE+200
Halt_For_Error
Allowed values Y or N.
RunTime_Interval
Default : P10Y0M0DT0H0M0S
Example : P10Y0M0DT0H0M0S
Next processing is done after
10 years 0 months 0 days 0 hours 0
minutes and 0 seconds
This value must be updated based on the
business requirement. Setting fewer
intervals may have impact on performance.
8
Email_ID
Default : email@email.com
58
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
9
Email_Content_Type
Default : GENERIC
Email_XSL
11
Error_Count_Per_Processing
Default : 100
Email_Attachment_Location
13
Email_Attachment_Flag
59
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
14
Publish_Human_Task_Flag
ID_Human_Task
weblogic
Last_Updated_Date
SYSDATE
17
Purge_Error_Store_Flag
Y Purge data
Default : N
N No purge require
The process PurgeIntegrationErrorStore is
deployed when the flag,
purge.process.deploy=true, in the
deploy.properties file is set to true during
installation.
If flag.purge.process = false then value of
this column Purge_Error_Store_Flag will
always be N.
18
Purge_Processing_Status_Flag
Default : N
60
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
19
Purge_Frequency
Default : P10Y0M0DT0H0M0S
Example : P10Y0M0DT0H0M0S
Next processing will be done after
10 years 0 months 0 days 0 hours 0
minutes and 0 seconds
This value has to be updated based on the
business requirement. Setting fewer
intervals may have impact on performance.
Need to set this value appropriately.
Applicable only when flag.purge.process =
true in deploy.properties file during
installation and the process
PurgeIntegrationErrorStore ID deployed.
20
Next_Purge_Date
SYSDATE+100
Purge_File_Name
61
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
62
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Notifications
Errors in the Integration are communicated back to the Initiating application.
In Oracle Utilities Customer Care and Billing an XAI Inbound service is invoked to report back the
errors. If this service fails then a ToDo item is created in Oracle Utilities Customer Care and
Billing
Connection Errors
Information can be found in the log files in the folders described above.
63
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
64
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Notifications
Errors in the integration are communicated back to the initiating application. In Oracle Utilities
Meter Data Management the adapter service errors are reported by a HUBInbound exception or
Work Queue item creation.
Information can be found in the log file described above.
Connection Errors
Information can be found the log file described above.
65
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
7. The composite flow lists all the activities in the process instance.
Data Purge
The Oracle Fusion Middleware maintains state of the instances and the database needs to be
purged periodically. Refer to Note 815896.1 on Oracle Metalink for details about purging data
from Fusion Middleware database.
66
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Custom Transformations
Custom Transformations
The custom transformations are used to add data to custom elements in the incoming and
outgoing messages. The incoming and outgoing messages have custom elements defined in the
message. These custom elements refer to a Custom xml schema. The main transformation
invokes custom transformation.
Empty custom transformation and custom schemas are shipped with the product. The
implementation team can add additional fields in the custom schema and map them using the
custom transformations.
Using custom transformations allows the implementation to define and pass additional data from
the source system to the target system.
67
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
68
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
soapAction="http://xmlns.oracle.com/OUCCBOUMDMSPSyncReqEBF/OUCCBOUMDMSPSyncR
eqExtension/V1/PreInvokeMDMEnQueue"/>
<input>
<soap:body use="literal" parts="MDMEnqueue"/>
</input>
<output>
<soap:body use="literal" parts="MDMEnqueue"/>
</output>
<fault name="fault">
<soap:fault name="fault" use="literal"/>
</fault>
</operation>
</binding>
<service name="OUCCBOUMDMSPSyncReqV1ExtensionService">
<!-- Port name must match the port name used for the Extension service in
the composite.xml for the process - ->
<port name="OUCCBOUMDMSPSyncReqV1ExtensionService"
binding="ccbext:OUCCBOUMDMSPSyncReqV1ExtensionServiceSOAP11Binding">
<soap:address location="<endpoint url of the Extension
server>"/>
</port>
</service>
Note: The binding and service can be added easily using the Oracle Jdeveloper 11g.
69
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
8. The custom xsd files are located in the product install home under the directories
CCB_MDM_INSTALL_HOME/MDSArtifacts/AIAMetaData/AIAComponents/ApplicationObjectLibrary/OUCCB/V1/schemas and
CCB_MDM_INSTALL_HOME/MDSArtifacts/AIAMetaData/AIAComponents/ApplicationObjectLibrary/OUMDM/V1/schemas
9. The custom xsl files are located in the product install home under the directory
CCB_MDM_INSTALL_HOME/services/industry/Utilities/EnterpriseBusinessFlow/<Process Name>/xsl
10. After updating the xsd and xsl files in the product install home update MDS using the ant scripts and
restart the SOA server. Refer to command for MDS update in the installation guide to update MDS.
For example: To modify the SA Synchronization process to pass
sendDetailsinitialSnapshotsaInfocustomElementsdistMethod element in CCB to
SyncRequestinitialSnapshotsaInfocustomElementsdistributionMethod element in
MDM, the following changes need to be done. a. OUCCBSASyncRequestCustomType.xsd
<xsd:complexType name="saInfoCustomType">
<xsd:sequence>
<xsd:element name="distMethod" type="xsd:string"/>
</xsd:sequence>
<xsd:complexType>
b. OUMDMSASyncRequestCustomType.xsd
<xs:complexType name="saInfoCustomType">
<xsd:sequence>
<xsd:element name="distributionMethod" type="xsd:string"/>
</xsd:sequence>
<xsd:complexType>
c. Transformation_CCB_To_MDM_custom.xsl
<xsl:template name="initialSnapshot-saInfo-customElements">
<!-- this template is use for Xformation of
//initialSnapshot/saInfo/customElements in Request Message-->
<distributionMethod
xmlns="http://xmlns.oracle.com/OUMDM/RequestMessage">
<xsl:value-of
select="/tns1:sendDetails/tns1:syncRequestDetails/tns1:initialSnapshot/tns1:
saInfo/tns1:customElements/tns1:distMethod"/>
</distributionMethod>
</xsl:template>
70
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
SA Information Synchronization
SA Sync Request Mapping
CCB SA Sync Request Message
Element Name
Parent
Element
sendDetails
Type
Element Name
OutermostTag
SyncRequest
syncRequestId
syncRequestId
sendDetails
Field
bo
sendDetails
Field
boStatus
sendDetails
Field
createDateTime
sendDetails
Field
statusDateTime
sendDetails
Field
version
sendDetails
Field
sourceSystem
sendDetails
Field
syncRequired
sendDetails
Field
forceSync
sendDetails
Field
initialLoad
sendDetails
Field
discardReason
sendDetails
Field
cancelReason
sendDetails
Field
mo
sendDetails
Field
pkValue1
sendDetails
Field
pkValue2
sendDetails
Field
pkValue3
sendDetails
Field
pkValue4
sendDetails
Field
pkValue5
sendDetails
Field
saBO
sendDetails
Field
accountBO
sendDetails
Field
personBO
sendDetails
Field
snapshotDA
sendDetails
Field
Parent
Element
Type
DVM Mapping
DVM
OutermostTag
SyncRequest
Field
71
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
CCB SA Sync Request Message
DVM Mapping
postScript
sendDetails
Field
syncRequestDetails
sendDetails
Group
initialSnapshot
sendDetails
Group
initialSnapshot
SyncRequest
Group
personInfo
initialSnapshot
Group
personInfo
initialSnapshot
Group
personId
personInfo
Field
personId
personInfo
Field
name
personInfo
Field
name
personInfo
Field
customElements
personInfo
Group
customElements
personInfo
Group
accountInfo
initialSnapshot
Group
accountInfo
initialSnapshot
Group
accountId
accountInfo
Field
accountId
accountInfo
Field
billCycle
accountInfo
Field
mainPerson
accountInfo
Field
personId
accountInfo
Field
customElements
accountInfo
Group
customElements
accountInfo
Group
saInfo
initialSnapshot
Group
saInfo
initialSnapshot
Group
saId
saInfo
Field
saId
saInfo
Field
accountId
saInfo
Field
accountId
saInfo
Field
cisDivision
saInfo
Field
cisDivision
saInfo
Field
OUCCB_OUMDM_CISDivision
saType
saInfo
Field
saType
saInfo
Field
OUCCB_OUMDM_SAType
status
saInfo
Field
status
saInfo
Field
OUCCB_OUMDM_SAStatus
saStartDate
saInfo
Field
saStartDate
saInfo
Field
saStopDate
saInfo
Field
saStopDate
saInfo
Field
sic
saInfo
Field
sic
saInfo
Field
saRateHistory
saInfo
List
saRateHistory
saInfo
List
effectiveDate
saRateHistory
Field
effectiveDate
saRateHistory
Field
rateSchedule
saRateHistory
Field
rateSchedule
saRateHistory
Field
OUCCB_OUMDM_RateInfo
rateCode
saRateHistory
Field
OUCCB_OUMDM_RateInfo
rateFormCode
saRateHistory
Field
OUCCB_OUMDM_RateInfo
jurisCode
saRateHistory
Field
OUCCB_OUMDM_RateInfo
saSp
saInfo
List
saSp
saInfo
List
saSpId
saSp
Field
saSpId
saSp
Field
spId
saSp
Field
spId
saSp
Field
saSpStartDateTime
saSp
Field
saSpStartDateTime
saSp
Field
72
OUCCB_OUMDM_SIC
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
CCB SA Sync Request Message
DVM Mapping
saSpStopDateTime
saSp
Field
saSpStopDateTime
saSp
Field
howToUse
saSp
Field
howToUse
saSp
Field
usePercent
saSp
Field
usePercent
saSp
Field
customElements
saInfo
Group
customElements
saInfo
Group
customElements
initialSnapshot
Group
customElements
initialSnapshot
Group
finalSnapshot
sendDetails
Group
finalSnapshot
SyncRequest
Group
personInfo
finalSnapshot
Group
personInfo
finalSnapshot
Group
personId
personInfo
Field
personId
personInfo
Field
name
personInfo
Field
name
personInfo
Field
customElements
personInfo
Group
customElements
personInfo
Group
accountInfo
finalSnapshot
Group
accountInfo
finalSnapshot
Group
accountId
accountInfo
Field
accountId
accountInfo
Field
billCycle
accountInfo
Field
mainPerson
accountInfo
Field
personId
accountInfo
Field
customElements
accountInfo
Group
customElements
accountInfo
Group
saInfo
finalSnapshot
Group
saInfo
finalSnapshot
Group
saId
saInfo
Field
saId
saInfo
Field
accountId
saInfo
Field
accountId
saInfo
Field
cisDivision
saInfo
Field
cisDivision
saInfo
Field
OUCCB_OUMDM_CISDivision
saType
saInfo
Field
saType
saInfo
Field
OUCCB_OUMDM_SAType
status
saInfo
Field
status
saInfo
Field
OUCCB_OUMDM_SAStatus
saStartDate
saInfo
Field
saStartDate
saInfo
Field
saStopDate
saInfo
Field
saStopDate
saInfo
Field
sic
saInfo
Field
sic
saInfo
Field
saRateHistory
saInfo
List
saRateHistory
saInfo
Group
effectiveDate
saRateHistory
Field
effectiveDate
saRateHistory
Field
rateSchedule
saRateHistory
Field
rateSchedule
saRateHistory
Field
OUCCB_OUMDM_RateInfo
rateCode
saRateHistory
Field
OUCCB_OUMDM_RateInfo
rateFormCode
saRateHistory
Field
OUCCB_OUMDM_RateInfo
jurisCode
saRateHistory
Field
OUCCB_OUMDM_RateInfo
saSp
saInfo
List
saSp
saInfo
List
OUCCB_OUMDM_SIC
73
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
CCB SA Sync Request Message
saSpId
saSp
Field
saSpId
saSp
Field
spId
saSp
Field
spId
saSp
Field
saSpStartDateTime
saSp
Field
saSpStartDateTime
saSp
Field
saSpStopDateTime
saSp
Field
saSpStopDateTime
saSp
Field
howToUse
saSp
Field
howToUse
saSp
Field
usePercent
saSp
Field
usePercent
saSp
Field
customElements
saInfo
Group
customElements
saInfo
Group
customElements
finalSnapshot
Group
customElements
finalSnapshot
Group
DVM Mapping
Parent Element
SyncReque
stResult
Type
Element Name
OutermostTag
F1UpdateAndTransitionSyncR
equest
Parent Element
DVM
Mapping
Type
OutermostTag
syncReque
stId
SyncRequestRe
sult
Field
syncRequestId
F1UpdateAndTransitionSyncRequest
Field
Error
SyncRequestRe
sult
Group
exceptionInfo
F1UpdateAndTransitionSyncRequest
Group
messageCategory
F1UpdateAndTransitionSyncRequest
Field
messageNumber
F1UpdateAndTransitionSyncRequest
Field
sequence
F1UpdateAndTransitionSyncRequest
Field
comments
F1UpdateAndTransitionSyncRequest
Field
messageParameters
exceptionInfo
List
parameterSequence
messageParameters
Field
messageParameterValue
messageParameters
Field
customElements
F1UpdateAndTransitionSyncRequest
Group
ErrorCode
ErrorDesc
customEle
ments
Error
Error
SyncRequestRe
sult
74
Field
Field
Group
DVM
OUCCB_OUMD
M_ErrorCode
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
SP Information Synchronization
SP Sync Request Mapping
CCB SP Sync Request Message
Element Name
Parent Element
sendDetails
Type
Element Name
Parent Element
Type
OutermostTa
g
SyncRequest
syncRequestId
SyncRequest
Field
DVM
OutermostTa
g
syncRequestId
sendDetails
Field
bo
sendDetails
Field
boStatus
sendDetails
Field
createDateTime
sendDetails
Field
statusDateTime
sendDetails
Field
version
sendDetails
Field
sourceSystem
sendDetails
Field
syncRequired
sendDetails
Field
forceSync
sendDetails
Field
initialLoad
sendDetails
Field
discardReason
sendDetails
Field
cancelReason
sendDetails
Field
mo
sendDetails
Field
pkValue1
sendDetails
Field
pkValue2
sendDetails
Field
pkValue3
sendDetails
Field
pkValue4
sendDetails
Field
pkValue5
sendDetails
Field
spBO
sendDetails
Field
premiseBO
sendDetails
Field
snapshotDA
sendDetails
Field
postScript
sendDetails
Field
syncRequestDetails
sendDetails
Group
initialSnapshot
syncRequestDetails
Group
initialSnapshot
SyncRequest
Group
spInfo
initialSnapshot
Group
spInfo
initialSnapshot
Group
spId
spInfo
Field
spId
spInfo
Field
premiseId
spInfo
Field
premiseId
spInfo
Field
spType
spInfo
Field
DVM Mapping
75
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
CCB SP Sync Request Message
DVM Mapping
installDate
spInfo
Field
installDate
spInfo
Field
abolishDate
spInfo
Field
abolishDate
spInfo
Field
customElements
spInfo
Group
customElements
spInfo
Group
premiseInfo
initialSnapshot
Group
premiseInfo
initialSnapshot
Group
premiseId
premiseInfo
Field
premiseId
premiseInfo
Field
country
premiseInfo
Field
country
premiseInfo
Field
OUCCB_OUMDM_
Country
addressFormat
premiseInfo
Field
OUCCB_OUMDM_
Country
address1
premiseInfo
Field
address1
premiseInfo
Field
address2
premiseInfo
Field
address2
premiseInfo
Field
address3
premiseInfo
Field
address3
premiseInfo
Field
address4
premiseInfo
Field
address4
premiseInfo
Field
houseType
premiseInfo
Field
houseType
premiseInfo
Field
number1
premiseInfo
Field
number1
premiseInfo
Field
number2
premiseInfo
Field
number2
premiseInfo
Field
inCityLimit
premiseInfo
Field
inCityLimit
premiseInfo
Field
city
premiseInfo
Field
city
premiseInfo
Field
geographic
premiseInfo
Field
geographicCode
premiseInfo
Field
county
premiseInfo
Field
county
premiseInfo
Field
state
premiseInfo
Field
state
premiseInfo
Field
postal
premiseInfo
Field
postal
premiseInfo
Field
customElements
premiseInfo
Group
customElements
premiseInfo
Group
customElements
initialSnapshot
Group
customElements
initialSnapshot
Group
finalSnapshot
syncRequestDetails
Group
finalSnapshot
SyncRequest
Group
spInfo
finalSnapshot
Group
spInfo
finalSnapshot
Group
spId
spInfo
Field
spId
spInfo
Field
premiseId
spInfo
Field
premiseId
spInfo
Field
spType
spInfo
Field
installDate
spInfo
Field
installDate
spInfo
Field
abolishDate
spInfo
Field
abolishDate
spInfo
Field
customElements
spInfo
Group
customElements
spInfo
Group
premiseInfo
finalSnapshot
Group
premiseInfo
finalSnapshot
Group
premiseId
premiseInfo
Field
premiseId
premiseInfo
Field
country
premiseInfo
Field
country
premiseInfo
Field
76
OUCCB_OUMDM_
Country
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
CCB SP Sync Request Message
premiseInfo
Field
address1
premiseInfo
Field
address1
premiseInfo
Field
address2
premiseInfo
Field
address2
premiseInfo
Field
address3
premiseInfo
Field
address3
premiseInfo
Field
address4
premiseInfo
Field
address4
premiseInfo
Field
houseType
premiseInfo
Field
houseType
premiseInfo
Field
number1
premiseInfo
Field
number1
premiseInfo
Field
number2
premiseInfo
Field
number2
premiseInfo
Field
inCityLimit
premiseInfo
Field
inCityLimit
premiseInfo
Field
city
premiseInfo
Field
city
premiseInfo
Field
geographic
premiseInfo
Field
geographicCode
premiseInfo
Field
county
premiseInfo
Field
county
premiseInfo
Field
state
premiseInfo
Field
state
premiseInfo
Field
postal
premiseInfo
Field
postal
premiseInfo
Field
customElements
premiseInfo
Group
customElements
premiseInfo
Group
customElements
finalSnapshot
Group
customElements
finalSnapshot
Group
DVM Mapping
OUCCB_OUMDM_
Country
Parent Element
SyncReq
uestResu
lt
Type
Element Name
OutermostT
ag
F1UpdateAndTransitionSync
Request
Parent Element
DVM Mapping
Type
Outermo
stTag
syncReq
uestId
SyncRequestResu
lt
Field
syncRequestId
F1UpdateAndTransitionSync
Request
Field
Error
SyncRequestResu
lt
Group
exceptionInfo
F1UpdateAndTransitionSync
Request
Group
messageCategory
F1UpdateAndTransitionSync
Request
Field
messageNumber
F1UpdateAndTransitionSync
Request
Field
sequence
F1UpdateAndTransitionSync
Request
Field
ErrorCod
e
Error
Field
DVM
OUCCB_OUMDM_Error
Code
77
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
MDM SP Sync Response Message
ErrorDes
c
Error
Field
DVM Mapping
comments
F1UpdateAndTransitionSync
Request
Field
messageParameters
exceptionInfo
List
parameterSequence
messageParameters
Field
messageParameterValue
messageParameters
Field
Parent Element
sendDetails
Type
Element Name
Parent Element
Type
OutermostTag
request
usageId
request
Field
createDateTime
request
Field
DVM
OutermostTag
usageId
sendDetails
Field
bo
sendDetails
Field
boStatus
sendDetails
Field
createDateTime
sendDetails
Field
statusDateTime
sendDetails
Field
intervalProcessing
sendDetails
Group
startDateTime
intervalProcessing
Field
startDateTime
request
Field
endDateTimeFrom
intervalProcessing
Field
endDateTime
request
Field
endDateTimeTo
intervalProcessing
Field
scalarProcessing
sendDetails
Group
billingOption
scalarProcessing
Field
startDateTime
scalarProcessing
Field
endDateTime
scalarProcessing
Field
minDaysOffset
scalarProcessing
Field
maxDaysOffset
scalarProcessing
Field
allowEstimate
scalarProcessing
Field
estimateDate
scalarProcessing
Field
isEstimate
scalarProcessing
Field
externalReferenceId
sendDetails
Field
externalReferenceId
request
Field
saId
sendDetails
Field
saId
request
Field
billSegmentId
sendDetails
Field
78
DVM
Mapping
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
CCB Batch BD Request Message
version
sendDetails
Field
dateBreaks
sendDetails
List
dateBreaks
request
Group
breakDateTime
dateBreaks
Field
breakDateTime
dateBreaks
List
billCondition
sendDetails
Field
customElements
sendDetails
Group
customElements
request
Group
billCycle
sendDetails
Field
windowStartDate
sendDetails
Field
billModeInfo
sendDetails
Field
billMode
sendDetails
Field
billModeInfo
sendDetails
Field
DVM
Mapping
Parent
Element
MDMResponse
Type
Element Name
OutermostT
ag
C1UpdateUsageRequ
est
Parent Element
Type
DVM
OutermostT
ag
usageId
MDMRespon
se
Field
usageId
C1UpdateUsageRequ
est
Field
usagePeriod
MDMRespon
se
Group
usagePeriod
C1UpdateUsageRequ
est
Group
startDateTime
usagePeriod
Field
startDateTime
usagePeriod
Field
endDateTime
usagePeriod
Field
endDateTime
usagePeriod
Field
scalarProcessing
C1UpdateUsageRequ
est
Group
isEstimate
scalarProcessing
Field
spUsagePeriod
MDMRespon
se
List
spUsagePeriod
C1UpdateUsageRequ
est
List
startDateTime
spUsagePeri
od
Field
startDateTime
spUsagePeriod
Field
endDateTime
spUsagePeri
od
Field
endDateTime
spUsagePeriod
Field
serviceQty
spUsagePeri
od
List
serviceQty
spUsagePeriod
List
DVM Mapping
79
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
MDM Batch BD Response Message
DVM Mapping
mdm_bdi
serviceQty
Field
sqi
serviceQty
Field
OUMDM_OUCCB_BDI
mdm_tou
serviceQty
Field
tou
serviceQty
Field
OUMDM_OUCCB_TOU
mdm_uom
serviceQty
Field
uom
serviceQty
Field
OUMDM_OUCCB_UOM
seq
serviceQty
Field
seq
serviceQty
Field
spId
serviceQty
Field
spId
serviceQty
Field
qty
serviceQty
Field
qty
serviceQty
Field
usagePeriods
MDMRespon
se
List
usagePeriods
C1UpdateUsageRequ
est
List
endDateTime
usagePeriods
Field
endDateTime
usagePeriods
Field
startDateTime
usagePeriods
Field
startDateTime
usagePeriods
Field
usageRequestTyp
e
usagePeriods
Field
usageRequestType
usagePeriods
Field
serviceQty
usagePeriods
List
serviceQty
usagePeriods
List
mdm_uom
serviceQty
Field
uom
serviceQty
Field
OUMDM_OUCCB_UOM
mdm_tou
serviceQty
Field
tou
serviceQty
Field
OUMDM_OUCCB_TOU
mdm_bdi
serviceQty
Field
sqi
serviceQty
Field
OUMDM_OUCCB_BDI
seq
serviceQty
Field
seq
serviceQty
Field
qty
serviceQty
Field
qty
serviceQty
Field
reads
C1UpdateUsageRequ
est
List
spId
reads
Field
readSeq
reads
Field
startReadDateTime
reads
Field
endReadDateTime
reads
Field
uom
reads
Field
tou
reads
Field
sqi
reads
Field
startReading
reads
Field
endReading
reads
Field
measuredQty
reads
Field
finalQty
reads
Field
finalUom
reads
Field
80
OUMDM_OUCCB_Usage
Type
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
MDM Batch BD Response Message
Error
MDMRespon
se
ErrorCode
Error
ErrorDesc
Error
customElements
MDMRespon
se
List
Field
reads
Field
finalSqi
reads
Field
sphowToUse
reads
Field
reghowToUse
reads
Field
constant
reads
Field
measuresPeakQuantit
y
reads
Field
usePercent
reads
Field
customElements
reads
Group
exceptionInfo
C1UpdateUsageRequ
est
List
messageCategory
exceptionInfo
Field
messageNumber
exceptionInfo
Field
sequence
exceptionInfo
Field
comments
exceptionInfo
Field
messageParameters
exceptionInfo
Group
parameterSequence
messageParameters
Field
messageParameterVa
lue
messageParameters
Field
customElements
C1UpdateUsageRequ
est
Group
Field
Group
DVM Mapping
OUCCB_OUMDM_ErrorC
ode
Parent Element
sendDetails
Type
Element Name
OutermostTag
request
usageId
request
Field
createDateTime
request
Field
usageId
sendDetails
Field
bo
sendDetails
Field
boStatus
sendDetails
Field
createDateTime
sendDetails
Field
Parent Element
Type
DVM
Mapping
DVM
OutermostTag
81
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
CCB Online BD Request Message
statusDateTime
sendDetails
Field
intervalProcessing
sendDetails
Group
startDateTime
intervalProcessing
Field
startDateTime
request
Field
endDateTimeFrom
intervalProcessing
Field
endDateTime
request
Field
endDateTimeTo
intervalProcessing
Field
scalarProcessing
sendDetails
Group
billingOption
scalarProcessing
Field
startDateTime
scalarProcessing
Field
endDateTime
scalarProcessing
Field
minDaysOffset
scalarProcessing
Field
maxDaysOffset
scalarProcessing
Field
allowEstimate
scalarProcessing
Field
estimateDate
scalarProcessing
Field
isEstimate
scalarProcessing
Field
externalReferenceId
sendDetails
Field
externalReferenceId
request
Field
saId
sendDetails
Field
saId
request
Field
billSegmentId
sendDetails
Field
version
sendDetails
Field
dateBreaks
sendDetails
List
dateBreaks
request
Group
breakDateTime
dateBreaks
Field
breakDateTime
dateBreaks
List
billCondition
sendDetails
Field
customElements
sendDetails
Group
customElements
request
Group
userId
sendDetails
Field
billModeInfo
sendDetails
Field
billMode
sendDetails
Field
billModeInfo
sendDetails
Field
DVM
Mapping
82
Parent
Element
Type
Parent Element
Type
DVM Mapping
DVM
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
MDM Online BD Response Message
MDMResponse
OutermostTa
g
C1UpdateUsageReque
st
DVM Mapping
OutermostTa
g
usageId
MDMRespons
e
Field
usageId
C1UpdateUsageReque
st
Field
usagePeriod
MDMRespons
e
Group
usagePeriod
C1UpdateUsageReque
st
Group
startDateTime
usagePeriod
Field
startDateTime
usagePeriod
Field
endDateTime
usagePeriod
Field
endDateTime
usagePeriod
Field
scalarProcessing
C1UpdateUsageReque
st
Group
isEstimate
scalarProcessing
Field
spUsagePeriod
MDMRespons
e
List
spUsagePeriod
C1UpdateUsageReque
st
List
startDateTime
spUsagePerio
d
Field
startDateTime
spUsagePeriod
Field
endDateTime
spUsagePerio
d
Field
endDateTime
spUsagePeriod
Field
serviceQty
spUsagePerio
d
List
serviceQty
spUsagePeriod
List
mdm_bdi
serviceQty
Field
sqi
serviceQty
Field
OUMDM_OUCCB_B
DI
mdm_tou
serviceQty
Field
tou
serviceQty
Field
OUMDM_OUCCB_T
OU
mdm_uom
serviceQty
Field
uom
serviceQty
Field
OUMDM_OUCCB_U
OM
seq
serviceQty
Field
seq
serviceQty
Field
spId
serviceQty
Field
spId
serviceQty
Field
qty
serviceQty
Field
qty
serviceQty
Field
usagePeriods
MDMRespons
e
List
usagePeriods
C1UpdateUsageReque
st
List
endDateTime
usagePeriods
Field
endDateTime
usagePeriods
Field
startDateTime
usagePeriods
Field
startDateTime
usagePeriods
Field
usageRequestTyp
e
usagePeriods
Field
usageRequestType
usagePeriods
Field
serviceQty
usagePeriods
List
serviceQty
usagePeriods
List
mdm_uom
serviceQty
Field
uom
serviceQty
Field
OUMDM_OUCCB_Us
ageType
OUMDM_OUCCB_U
OM
83
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
MDM Online BD Response Message
mdm_tou
serviceQty
Field
serviceQty
DVM Mapping
Field
OUMDM_OUCCB_T
OU
mdm_bdi
serviceQty
Field
sqi
serviceQty
Field
OUMDM_OUCCB_B
DI
seq
serviceQty
Field
seq
serviceQty
Field
qty
serviceQty
Field
qty
serviceQty
Field
reads
C1UpdateUsageReque
st
List
spId
reads
Field
readSeq
reads
Field
startReadDateTime
reads
Field
endReadDateTime
reads
Field
uom
reads
Field
tou
reads
Field
sqi
reads
Field
startReading
reads
Field
endReading
reads
Field
measuredQty
reads
Field
finalQty
reads
Field
finalUom
reads
Field
finalTou
reads
Field
finalSqi
reads
Field
sphowToUse
reads
Field
reghowToUse
reads
Field
constant
reads
Field
measuresPeakQuantity
reads
Field
usePercent
reads
Field
customElements
reads
Group
exceptionInfo
C1UpdateUsageReque
st
List
messageCategory
exceptionInfo
Field
messageNumber
exceptionInfo
Field
sequence
exceptionInfo
Field
comments
exceptionInfo
Field
Error
MDMRespons
e
ErrorCode
ErrorDesc
84
Error
Error
List
Field
Field
OUCCB_OUMDM_Er
rorCode
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
MDM Online BD Response Message
customElements
MDMRespons
e
Group
exceptionInfo
Group
parameterSequence
messageParameters
Field
messageParameterVal
ue
messageParameters
Field
customElements
C1UpdateUsageReque
st
Group
DVM Mapping
Parent Element
ReplacementUsag
e
ID
ReplacementUsag
e
Type
Element Name
OutermostTa
g
C1DetAcctCreateCorrectedReadOCB
G
Field
Parent Element
Type
OutermostTag
replacementRead
C1DetAcctCreateCorrectedR
eadOCBG
Group
usageId
replacementRead
Field
externalReferenceId
replacementRead
Field
saList
replacementRead
List
saId
ReplacementUsag
e
List
saId
saList
Field
servicePoint
ReplacementUsag
e
Field
spId
replacementRead
Field
startTime
ReplacementUsag
e
Field
readStartDateTime
replacementRead
Field
stopTime
ReplacementUsag
e
Field
readEndDateTime
replacementRead
Field
meterId
ReplacementUsag
e
Field
customElements
ReplacementUsag
e
Field
customElements
replacementRead
Group
85
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
Parent Element
sendDetails
Type
Element Name
OutermostTa
g
ReplUsgErr
Parent
Element
Type
DVM
OutermostTa
g
externalReferenceId
sendDetails
Field
ID
ReplUsgEr
r
exceptionInfo
sendDetails
Group
Error
ReplUsgEr
r
Group
messageCategory
exceptionInfo
Field
messageNumber
exceptionInfo
Field
ErrorCode
Error
Field
comments
exceptionInfo
Field
ErrorDesc
Error
Field
messageParameters
exceptionInfo
Group
parameterSequence
messageParameter
s
Field
messageParameterValu
e
messageParameter
s
Field
customElements
sendDetails
Group
customElement
s
ReplUsgEr
r
Group
86
DVM Mapping
OUCCB_OUMDM_ErrorCode
Customer Care and Billing Integration to Oracle Utilities Meter Data Management
Implementation Guide
87