BPEL Processes

These processes are responsible for performing the conversion from Oracle Utilities format to Silver Spring Networks format, invoking process callouts and invoking the remote endpoint to trigger the device events.

OnDemandRead Composite Process — Provides access points to edge application and handles data between edge application and head end system. It invokes sequence of web methods to head end system and retrieves meter read and send it back to Edge application.

ConnectDisconnect Composite Process — Performs the conversion from Oracle Utilities format to SSN format, invokes process callouts, and invokes the remote endpoint to trigger the connect event. A second, asynchronous reply will call back into the OUAF layer when the status change is completed at the head-end system. Another asynchronous reply will call back into the OUAF layer to send Meter Read Results.

CommissionDecommission Composite Process — Performs the conversion from Oracle Utilities format to SSN UIQ format, invokes process callouts, and invokes the remote endpoint to trigger the commission or decommission of meter.

DeviceStatusCheck Composite — Performs the conversion from Oracle Utilities format to SSN format, invokes process callouts, and makes a call via a proxy to the head-end system starting the Meter Ping operation. In an ideal scenario, the job status is returned as completed and the results are acquired and sent back to OUAF. If the job takes longer, OUAF will initiate a second request that will poll the head end system for the job status. When the job is completed, the results are returned to OUAF.

Common Composite — Contains two main classes of operations: Proxies and ProcessCallouts. Proxies are simple mediators that forward a web service call to a preset endpoint. No transformations are performed. They are convenient because they allow head end URLs and security to be set in a single composite. ProcessCallouts are points of customization which allow users to modify data and/or initiate some external business process.

BulkRequest Composite — Provides access points to requesting application. It decouples the bulk request into single commands for each meter/device in the request and sends it to edge application for processing.

Web Services

The following web services are all defined in the Silver Spring Networks head-end system:

• CommissionDecommissionService

  • BPEL Process: CommissionDecommission

  • Operation: ReplaceDeviceAtLocation

  • Enpoint URL: http://<EM_​SERVER>:<EM_​SERVER_​PORT>/soa-infra/services/SSN/CommissionDecommission/CommissionDecommissionService

• CommissionDecommissionService

  • BPEL Process: CommissionDecommission

  • Operation: ReplaceLocation

  • Enpoint URL: http://<EM_​SERVER>:<EM_​SERVER_​PORT>/soa-infra/services/SSN/CommissionDecommission/CommissionDecommissionService

• ConnectDisconnectService

  • BPEL Process: ConnectDisconnect

  • Operation: AddRemoteProvisioningJob

  • Enpoint URL: http://<EM_​SERVER>:<EM_​SERVER_​PORT>/soa-infra/services/SSN/ConnectDisconnect/ConnectDisconnectService

• DeviceStatusCheckService

  • BPEL Process: DeviceStatusCheck

  • Operation: AddPingJob

  • Enpoint URL: http://<EM_​SERVER>:<EM_​SERVER_​PORT>/soa-infra/services/SSN/DeviceStatusCheck/DeviceStatusCheckService

• AddMeterReadJobService

  • BPEL Process: AddMeterRead

  • Operation: AddMeterReadJob

  • Enpoint URL: http://<EM_​SERVER>:<EM_​SERVER_​PORT>/soa-infra/services/SSN/OnDemandRead/AddMeterReadJobService

• OnDemandReadService

  • BPEL Process: OnDemandRead

  • Operation: GetJobStatus

  • Enpoint URL: http://<EM_​SERVER>:<EM_​SERVER_​PORT>/soa-infra/services/SSN/OnDemandRead/OnDemandReadService

Silver Spring Networks Utility IQ Web Services

The following table describes the Silver Spring Networks Utility IQ web services and operations used for the Oracle Utilities Smart Grid Gateway command messaging:

Smart Grid Gateway Command	AMI Adapter Business Objects	Silver Spring Networks Web Services	Silver Spring Networks Operations
Device Commissioning	D7-ReplaceLocation	Device Manager	findDevice ReplaceLocation
Device Decommissioning	D7-ReplaceDeviceAtLocForDecomm	Device Manager	findDevice ReplaceDeviceAtLocation
Remote Connect/ Remote Disconnect	D7-ConnectDisconnect D7-GetStatus	Device Manager Job Manager DeviceResults	findDevice addRemoteProvisioningJob getJobStatusForDevice getRemoteProvisioningResultsByJobID findJob getJobStatus getMeterReadResultsByJobID
Device Status Check	D7-AddPingJob	Device Manager Job Manager DeviceResults	findDevice addPingJob, getJobStatus getPingResultsByJobID
On-Demand Read	D7-AddMeterReadJobInterval D7-AddMeterReadJobScalar	Device Manager Job Manager DeviceResults	findDevice addMeterReadJob getJobStatus getMeterReadResultsByJobID