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 |