Integration Processing for Meter or Item Validation
This section includes graphical representations of the functionality included for this integration point.
Validation Processing Between WAM v1.9.1.x and CC&B
This technical diagram shows how validations are processed between Oracle Utilities Work and Asset Management v1.9.1.x and Oracle Utilities Customer Care and Billing:
Processing Details
• Oracle Utilities Work and Asset Management v1.9.1.x assembles the request message for Meter/Item validation. This request message is sent to the Oracle Utilities Work and Asset Management v1.9.1.x Requester ABCS, which is a synchronous BPEL process where the message is transformed and enriched into Installed Product for Utilities EBO format.
• The message is routed through a Mediator process, UtilitiesInstalledProductEBSV2 to the provider ABCS (Oracle Utilities Customer Care and Billing).
• Once the message is correctly routed to the Oracle Utilities Customer Care and Billing provider ABCS (synchronous BPEL process), the message is transformed from Installed Product EBO format to a format that Inbound Web Service (ValidateMeterItemResponse) requires in Oracle Utilities Customer Care and Billing.
• Oracle Utilities Customer Care and Billing validates the Installed Product (Meter/Item) and sends a response to the Oracle Utilities Customer Care and Billing Provider ABCS. The Provider ABCS transforms it back to the EBO format and the message is routed through the Mediator process to the Oracle Utilities Work and Asset Management v1.9.1.x Requester ABCS.
• The Requester ABCS transforms the message from EBO format into a format that Oracle Utilities Work and Asset Management v1.9.1.x understands.
• Any errors are handled in the integration layer.
• If an Item/Meter is invalid, the Error Code and Error Message information is sent back as part of the response. The Registers node in the response message are not present for an Item Validation or if the Meter/Item is invalid.
Validating Meter Numbers in Oracle Utilities Work and Asset Management v1.9.1.x
1. Open a service request that references an external order.
On the search options screen place a % in the External Order field to find all records that reference an external order.
2. Select Meter Information from the Views list.
3. Enter a Meter Badge Number and click Validate.
The system initiates a request to Oracle Utilities Customer Care and Billing that verifies whether or not the badge number exists on the service point of the service request. If the badge number is valid and this meter can be installed on this service point, Oracle Utilities Customer Care and Billing returns register information to populate the Meter Information view.
After meter information is returned, the user can update the Read Date/Time, Status, Disconnect Location, and the actual reading.
Validation Processing Between MWM and CC&B
This technical diagram shows how validations are processed between Oracle Utilities Mobile Workforce Management and Oracle Utilities Customer Care and Billing:
Processing Details
• The Oracle Utilities Mobile Workforce Management Requester ABCS is a synchronous BPEL process where the message is transformed and enriched into Installed Product for Utilities EBO format.
• The message is routed through a Mediator process, UtilitiesInstalledProductEBSV2 to the provider ABCS (Oracle Utilities Customer Care and Billing).
• Once the message is correctly routed to the Oracle Utilities Customer Care and Billing provider ABCS (synchronous BPEL process), the message is transformed from Installed Product EBO format to a format that Inbound Web Service (ValidateMeterItemResponse) requires in Oracle Utilities Customer Care and Billing.
• Oracle Utilities Customer Care and Billing validates the Installed Product (Meter/Item) and sends back a response to the Oracle Utilities Customer Care and Billing Provider ABCS. The Provider ABCS transforms it back to the EBO format and the message is routed back through the Mediator process to the Oracle Utilities Mobile Workforce Management Requester ABCS.
• The Requester ABCS transforms the message from EBO format into a format that Oracle Utilities Mobile Workforce Management understands and invokes Oracle Utilities Mobile Workforce Management with the response message.
• Any errors are handled in the integration layer.
Validating a Meter in Oracle Utilities Mobile Workforce Management
1. In the Mobile Application, open an activity requiring a new device to be set that references a Host External ID and access the New Meter/Item map or fragment.
2. Enter the meter/item badge number and click Verify.
The map is locked (user input is not accepted).
3. Wait while the validation is processed by Oracle Utilities Customer Care and Billing.
Valid response: If a valid response is received, an Override check box is displayed. If the device being set is a meter, the information returned in the response is reflected on the map. The Meter Configuration Type is automatically selected and the reading details are displayed. Invalid response: If an invalid response or error response is received, a message is displayed indicating the reason for the verification failure. An Override check box is displayed. The user can retry the verification by modifying the badge number and clicking Verify again. If the badge number is correct, the user can override the verification by selecting the Override check box, which allows the user to complete the activity without a valid verification. If the device being set is a meter, the user must select a Meter Configuration Type, which causes the application to build the reading details.
For more information about incoming and outgoing meter validation messages, see Oracle Utilities Customer Care and Billing documentation topic “Defining Field Order Options - Incoming Validate Meter / Item Message and Outgoing Validate Meter / Item Message”. Also refer to the Oracle Utilities Customer Care and Billing User Guide section on Meter Management.