The basic communication for all business processing is essentially the same. A communication request is sent from the Oracle Utilities application to Itron OpenWay. This request would be for a connect/disconnect, commission/decommission, measurement data, device status check, or an on-demand read. The designated BPEL process transforms the request from Oracle Utilities format to Itron OpenWay format and invokes the related Itron OpenWay web service. Itron OpenWay then returns a reply, and the BPEL process transforms the reply message back to the appropriate format so that Oracle Utilities can receive the response.
The following sections describe the key components in this processing, including:
Base Package Business Objects
The Itron OpenWay Adapter base package includes the following communication business objects:
Itron OpenWay Event Data Mapping
The Itron OpenWay event file format maps as follows into the business object, D1-DeviceEventMappingLookup:
You must create an External System for each external system to which Oracle Utilities Smart Grid Gateway will send messages. Each external system defines a set of outbound message types that will be sent to that system. Each external system outbound message type also specifies the following:
•
|
The processing method used to send the message (Batch, XAI, or Real-time)
|
•
|
The corresponding XAI senders
|
•
|
Batch Control (if Processing Method is set to Batch)
|
•
|
Message XSL, W3C Schema, and Response XSL (as applicable)
|
Acknowledgement and response messages are sent and received validating that commands have been transmitted.
The XML Application Integration (XAI) utility allows you to configure your system to receive information from and to send information to external applications using XML. The Itron OpenWay adapter for Smart Grid Gateway uses one XAI inbound service to map device events. This is the same XAI inbound service used by the D1 application.
XAI inbound systems define the details of how messages are received from an external system, including the inbound communication business object (or business service or service script) to be invoked when the response message is received. As in the case of inbound communication business objects, the set of XAI inbound services you need to create is based on the types of messages the system is designed to send.
The Oracle Utilities Smart Grid Gateway adapter for Itron OpenWay includes the following XAI inbound services:
XAI senders define the details of how messages are sent to an external system. As in the case of outbound communication business objects and outbound message types, the set of XAI senders you need to create is based on the types of messages the system is designed to accept.
These processes are responsible for performing the conversion from Oracle Utilities format to Itron OpenWay format, invoking process callouts and invoking the remote endpoint to trigger the device events. BPEL modules are divided into "Composites," or collections of business logic.
OnDemandRead Composite Process
The OnDemandRead composite invokes a sequence of web methods that call the head-end system to retrieve meter reading data and send it back to the OUAF layer. In the case of Itron OpenWay, this is accomplished using the ContingencyReadByEndpoints/GetContingencyReadByEndpointsResult services defined in the Data service WSDL.
ConnectDisconnect Composite Process
This composite is responsible for triggering the Connect and Disconnect events on the head-end system. A second, asynchronous reply sends the results back into the OUAF layer when the head-end system signals a change in the status of the device. The Itron OpenWay Adapter uses the ReconnectMeter/GetReconnectMeterResult web service pair to connect, and the DisconnectMeter/GetDisconnectMeterResult web service pair to disconnect. Each of these services is defined in the Control service WSDL.
CommissionDecommission Composite Process
Commissioning and Decommissioning of devices, sometimes referred to as "Provisioning," is handled by the CommissionDecommission composite. Commissioning invokes the AddMeterDefinitions web service and Decommissioning uses the DeregisterMeters web service. Both are defined in the Provisioning service.
DeviceStatusCheck Composite
This composite uses the PingByEndpoints and GetPingByEndpointsResult web services to check the health of a device. These Itron OpenWay services are defined in the Control.Diagnostic service.
The Common composite contains three main classes of operations: Proxies, ProcessCallouts, and utility functions. Proxies are usually simple mediators that forward a web service call to a preset endpoint. In this Adapter they have two additional roles. First, they interrogate a composite property and determine whether the supported version of head-end software is 3.70 or 3.90. Some of the proxies will also append the callback URL for the StatusChanged service. Proxies are convenient because they allow head-end URLs and security to be set in a single composite. In this case, they also offer a common location to make these checks. ProcessCallouts are points of customization which allow users to modify data and/or initiate some external business process. Utility functions serve as a central location for business logic needed by multiple composites.
The following web services are all defined in the Itron OpenWay head-end system:
•
|
CommissionDecommissionService
|
•
|
BPEL Process: CommissionDecommission
|
•
|
Operation: AddMeterDefinitions
|
•
|
Enpoint URL: http://<EM_SERVER>:<EM_SERVER_PORT>/soa-infra/services/<EM_PARTITION>/CommissionDecommission/CommissionDecommissionService
|
•
|
CommissionDecommissionService
|
•
|
BPEL Process: CommissionDecommission
|
•
|
Operation: DeregisterMeters
|
•
|
Enpoint URL: http://<EM_SERVER>:<EM_SERVER_PORT>/soa-infra/services/<EM_PARTITION>/CommissionDecommission/CommissionDecommissionService
|
•
|
BPEL Process: ConnectDisconnect
|
•
|
Operation: ReconnectMeter
|
•
|
Enpoint URL: http://<EM_SERVER>:<EM_SERVER_PORT>/soa-infra/services/<EM_PARTITION>/ConnectDisconnect/ConnectDisconnectService
|
•
|
BPEL Process: ConnectDisconnect
|
•
|
Operation: DisconnectMeter
|
•
|
Enpoint URL: http://<EM_SERVER>:<EM_SERVER_PORT>/soa-infra/services/<EM_PARTITION>/ConnectDisconnect/ConnectDisconnectService
|
•
|
BPEL Process: DeviceStatusCheck
|
•
|
Operation: DeviceStatusCheck
|
•
|
Enpoint URL: http://<EM_SERVER>:<EM_SERVER_PORT>/soa-infra/services/<EM_PARTITION>/DeviceStatusCheck/DeviceStatusCheckService
|
•
|
BPEL Process: OnDemandRead
|
•
|
Operation: ContingencyReadByEndpoints
|
•
|
Enpoint URL: http://<EM_SERVER>:<EM_SERVER_PORT>/soa-infra/services/<EM_PARTITION>/OnDemandRead/OnDemandReadService
|
Itron OpenWay Web Services
The following table describes Itron OpenWay web services and operations used for the Oracle Utilities Smart Grid Gateway command messaging: