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