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