BPEL Processes
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.
Common Composite — 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.
Web Services
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
ConnectDisconnectService
BPEL Process: ConnectDisconnect
Operation: ReconnectMeter
Enpoint URL: http://<EM_​SERVER>:<EM_​SERVER_​PORT>/soa-infra/services/<EM_​PARTITION>/ConnectDisconnect/ConnectDisconnectService
ConnectDisconnectService
BPEL Process: ConnectDisconnect
Operation: DisconnectMeter
Enpoint URL: http://<EM_​SERVER>:<EM_​SERVER_​PORT>/soa-infra/services/<EM_​PARTITION>/ConnectDisconnect/ConnectDisconnectService
DeviceStatusCheckService
BPEL Process: DeviceStatusCheck
Operation: DeviceStatusCheck
Enpoint URL: http://<EM_​SERVER>:<EM_​SERVER_​PORT>/soa-infra/services/<EM_​PARTITION>/DeviceStatusCheck/DeviceStatusCheckService
OnDemandReadService
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:
Smart Grid Gateway Command
AMI Adapter Business Objects
Itron OpenWay Web Services
Itron OpenWay Operations
Device Commissioning
D8-AddMeterDefinitions
ProvisioningService
AddMeterDefinitions
Device Decommissioning
D8-DeregisterMeter
ProvisioningService
DeregisterMeters
Remote Connect
D8-ReconnectMeter
D8-DetectLoadSideVoltageByMtr
D8-ReadDisconStateByMtr
ControlService
DiagnosticService
ReconnectMeter
DetectLoadSideVoltageByMeter
ReadDisconnectStateByMeters
Remote Disconnect
D8-DisconnectMeter
ControlService
DisconnectMeter
Device Status Check
D8-PingByEndpoints
ControlService
PingByEndpoints
GetPingByEndpointsResult
On-Demand Read
D8-ReadInterval
D8-ReadScalar
D1-InitialLoadIMD
D1-DeviceEventSeeder
DataService
ContingencyReadByEndpoints
GetContingencyReadByEndpointsResult
InterrogateByGroup
GetInterrogateByGroupResult
DataSubscriberService (Async Response)
DataArrived
Event Loading
D1-DeviceEventSeeder
ExceptionSubscriberService
ExceptionsArrived