Adapter-Specific Test Harness Commands
This section provides specific details for invoking commands for specific adapters.
Each adapter comprises multiple web services that enable commands. The commands available for each web service for each adapter are provided below.
HTTP Header Format
The format used for the HTTP Header is as follows:
SoapAction: {URI}
That's using a colon, followed by a space between the SoapAction and the value. You cannot use an equals (=) sign. For example:
SoapAction: http://www.multispeak.org/Version_4.1_Release/MeterAddNotification
Itron OpenWay Commands
Control Service
The table below lists details for commands available via the Itron OpenWay Control Service web service.
|
Command |
Web Method |
HTTP Header |
HTTP URL |
|---|---|---|---|
|
Connect |
ReconnectMeter |
SoapAction: http://www.itron.com/ami/2008/10/control/ControlService/ReconnectMeter |
@SGG_TEST@/itron/www.itron.com.ami.2008.10.control |
|
Connect (Result) |
GetReconnectMeterResult |
SoapAction: http://www.itron.com/ami/2008/10/control/ControlService/GetReconnectMeterResult |
@SGG_TEST@/itron/www.itron.com.ami.2008.10.control |
|
Disconnect |
DisconnectMeter |
SoapAction: http://www.itron.com/ami/2008/10/control/ControlService/DisconnectMeter |
@SGG_TEST@/itron/www.itron.com.ami.2008.10.control |
|
Disconnect (Result) |
GetDisconnectMeterResult |
SoapAction: http://www.itron.com/ami/2008/10/control/ControlService/GetDisconnectMeterResult |
@SGG_TEST@/itron/www.itron.com.ami.2008.10.control |
|
Load Check |
DetectLoadSideVoltageByMeter |
SoapAction: http://www.itron.com/ami/2008/10/control/ControlService/DetectLoadSideVoltageByMeter |
@SGG_TEST@/itron/www.itron.com.ami.2008.10.control |
|
Load Check (Result) |
GetDetectLoadSideVoltageByMeterResult |
SoapAction: http://www.itron.com/ami/2008/10/control/ControlService/GetDetectLoadSideVoltageByMeterResult |
@SGG_TEST@/itron/www.itron.com.ami.2008.10.control |
Control Diagnostic
The table below lists details for commands available via the Itron OpenWay Control Diagnostic web service.
|
Command |
Web Method |
HTTP Header |
HTTP URL |
|---|---|---|---|
|
Device Status Check |
PingByEndpoints |
SoapAction: http://www.itron.com/ami/2012/03/control/diagnostic/DiagnosticService/PingByEndpoints |
@SGG_TEST@/itron//www.itron.com.ami.2012.03.control.diagnostic |
|
Device Status Check (Result) |
GetPingByEndpointsResult |
SoapAction: http://www.itron.com/ami/2012/03/control/diagnostic/DiagnosticService/GetPingByEndpointsResult |
@SGG_TEST@/itron//www.itron.com.ami.2012.03.control.diagnostic |
|
Read Disconnect State |
ReadDisconnectStateByMeters |
SoapAction: http://www.itron.com/ami/2012/03/control/diagnostic/DiagnosticService/ReadDisconnectStateByMeters |
@SGG_TEST@/itron//www.itron.com.ami.2012.03.control.diagnostic |
|
Read Disconnect State (Result) |
GetReadDisconnectStateByMetersResult |
SoapAction: http://www.itron.com/ami/2012/03/control/diagnostic/DiagnosticService/GetReadDisconnectStateByMetersResult |
@SGG_TEST@/itron//www.itron.com.ami.2012.03.control.diagnostic |
Data Service
The table below lists details for commands available via the Itron OpenWay Data Service web service.
|
Command |
Web Method |
HTTP Header |
HTTP URL |
|---|---|---|---|
|
On-Demand Read |
ContingencyReadByEndpoints |
SoapAction: http://www.itron.com/ami/2008/10/data/DataService/ContingencyReadByEndpoints |
@SGG_TEST@/itron//www.itron.com.ami.2008.10.data |
|
On-Demand Read (Result) |
GetContingencyReadByEndpointsResult |
SoapAction: http://www.itron.com/ami/2008/10/data/DataService/GetContingencyReadByEndpointsResult |
@SGG_TEST@/itron//www.itron.com.ami.2008.10.data |
|
Scheduled Read |
InterrogateByGroup |
SoapAction: http://www.itron.com/ami/2008/10/data/DataService/InterrogateByGroup |
@SGG_TEST@/itron//www.itron.com.ami.2008.10.data |
|
Scheduled Read (Result) |
GetInterrogateByGroupResult |
SoapAction: http://www.itron.com/ami/2008/10/data/DataService/GetInterrogateByGroupResult |
@SGG_TEST@/itron//www.itron.com.ami.2008.10.data |
Provisioning Service
The table below lists details for commands available via the Itron OpenWay Provisioning Service web service.
|
Command |
Web Method |
HTTP Header |
HTTP URL |
|---|---|---|---|
|
Commission |
AddMeterDefinitions |
SoapAction: http://www.itron.com/ami/2009/08/provisioning/ProvisioningService/AddMeterDefinitions |
@SGG_TEST@/itron/www.itron.com.ami.2009.08.provisioning |
|
Decommission |
DeregisterMeters |
SoapAction: http://www.itron.com/ami/2009/08/provisioning/ProvisioningService/DeregisterMeters |
@SGG_TEST@/itron/www.itron.com.ami.2009.08.provisioning |
Landis+Gyr Commands
MR_CB
The table below lists details for commands available via the Landis+Gyr MR_CB web service.
|
Command |
Web Method |
HTTP Header |
HTTP URL |
|---|---|---|---|
|
Commission |
MeterAddNotification |
SoapAction: http://www.multispeak.org/Version_3.0/MeterRemoveNotification |
@SGG_TEST@/lg/MR_CB |
|
Decommission |
MeterRemoveNotification |
SoapAction: http://www.multispeak.org/Version_3.0/MeterAddNotification |
@SGG_TEST@/lg/MR_CB |
|
Meter Retire |
MeterRetireNotification |
SoapAction: http://www.multispeak.org/Version_3.0/MeterRetireNotification |
@SGG_TEST@/lg/MR_CB |
|
On-Demand Read |
InitiateMeterReadByMeterNumber |
SoapAction: http://www.multispeak.org/Version_3.0/InitiateMeterReadByMeterNumber |
@SGG_TEST@/lg/MR_CB |
|
Scheduled Demand Reset |
ScheduleDemandReset |
SoapAction: http://www.multispeak.org/Version_3.0/ScheduleDemandReset |
@SGG_TEST@/lg/MR_CB |
CD_MR
The table below lists details for commands available via the Landis+Gyr CD_MR web service.
|
Command |
Web Method |
HTTP Header |
HTTP URL |
|---|---|---|---|
|
Meter Exchange |
MeterExchangeNotification |
SoapAction: http://www.multispeak.org/Version_3.0/MeterExchangeNotification |
@SGG_TEST@/lg/CB_MR |
CD_CB
The table below lists details for commands available via the Landis+Gyr CD_CB web service.
|
Command |
Web Method |
HTTP Header |
HTTP URL |
|---|---|---|---|
|
Connect/Disconnect |
InitiateConnectDisconnect |
SoapAction: http://www.multispeak.org/Version_3.0/InitiateConnectDisconnect |
@SGG_TEST@/lg/CD_CB |
Metering
The table below lists details for commands available via the Landis+Gyr Metering web service.
|
Command |
Web Method |
HTTP Header |
HTTP URL |
|---|---|---|---|
|
Add Meter to Inventory |
AddMeterToInventory |
SoapAction: turtletech.com/TS2/AddMeterToInventory |
@SGG_TEST@/lg/Metering |
CIM
The table below lists details for commands available via the Landis+Gyr CIM web service.
|
Command |
Web Method |
HTTP Header |
HTTP URL |
|---|---|---|---|
|
On Demand Read (Interval & Scalar) Device Status Check |
AMIRequest |
SoapAction: urn:LandisGyr.GSIS.CimService.CIMService.AMIRequest |
@SGG_TEST@/lg/CIMService |
Note: The Landis+Gyr ScheduleDemandReset API does not offer a way to pass a callback URL in. In actual use, L+G allows the callback to be configured in their system. To handle the scenario in the Test Harness, add an additional HTTP header named SGG-Callback-Endpoint to the callback URL in the Message Sender. The value of the header should be the address of the D3-CB_MR Inbound Web Service, for example: SGG-Callback-Endpoint: “https://144.25.14.142:8086/iddev2/prod/ccs/soap/api/iws/D3-CB_MR”. The URL value is located near the bottom of the WSDL on the Inbound Web Service record.
Sensus Commands
MR_Server
The table below lists details for commands available via the Sensus MR_Server web service.
|
Command |
Web Method |
HTTP Header |
HTTP URL |
|---|---|---|---|
|
Commission |
MeterAddNotification |
SoapAction: http://www.multispeak.org/Version_4.1_Release/MeterAddNotification |
@SGG_TEST@/sensus/MR_Server |
|
Decommission |
MeterRemoveNotification |
SoapAction: http://www.multispeak.org/Version_4.1_Release/MeterRemoveNotification |
@SGG_TEST@/sensus/MR_Server |
|
On-Demand Read |
InitiateMeterReadingsByMeterNumber |
SoapAction: http://www.multispeak.org/Version_4.1_Release/InitiateMeterReadingsByMeterID |
@SGG_TEST@/sensus/MR_Server |
CD_Server
The table below lists details for commands available via the Sensus CD_Server web service.
|
Command |
Web Method |
HTTP Header |
HTTP URL |
|---|---|---|---|
|
Connect/Disconnect |
InitiateConnectDisconnect |
SoapAction: http://www.multispeak.org/Version_4.1_Release/InitiateConnectDisconnect |
@SGG_TEST@/sensus/CD_Server |
OD_Server
The table below lists details for commands available via the Sensus OD_Server web service.
|
Command |
Web Method |
HTTP Header |
HTTP URL |
|---|---|---|---|
|
Device Status Check |
InitiateOutageDetectionEventRequest |
SoapAction: http://www.multispeak.org/Version_4.1_Release/InitiateOutageDetectionEventRequest |
@SGG_TEST@/sensus/OD_Server |
Silver Spring Networks Commands
Note: The Silver Spring Networks adapter works differently from the other adapters. This adapter does not use SoapAction identifiers on the operations, so the HTTP Header can be left off of the Message Sender configuration.
DataAggregation
The table below lists details for commands available via the Silver Spring Networks DataAggregation web service.
|
Command |
Web Method |
HTTP URL |
|---|---|---|
|
GetMeterFieldStatus |
@SGG_TEST@/ssn/DataAggregation |
DeviceManager
The table below lists details for commands available via the Silver Spring Networks DeviceManager web service.
|
Command |
Web Method |
HTTP URL |
|---|---|---|
|
All |
FindDevice |
@SGG_TEST@/ssn/DeviceManager |
|
Commission |
ReplaceLocation |
@SGG_TEST@/ssn/DeviceManager |
|
Decommission |
ReplaceDeviceAtLocation |
@SGG_TEST@/ssn/DeviceManager |
JobManager
The table below lists details for commands available via the Silver Spring Networks JobManager web service.
|
Command |
Web Method |
HTTP URL |
|---|---|---|
|
Connect/Disconnect |
addRemoteProvisioningJob |
@SGG_TEST@/ssn/JobManager |
|
On-Demand Read |
addMeterReadJob |
@SGG_TEST@/ssn/JobManager |
|
Device Status Check |
addPingJob |
@SGG_TEST@/ssn/JobManager |
|
On-Demand Read, Device Status Check |
getJobStatus |
@SGG_TEST@/ssn/JobManager |
|
Connect/Disconnect |
getJobStatusForDevice |
@SGG_TEST@/ssn/JobManager |
DeviceResults
The table below lists details for commands available via the Silver Spring Networks DeviceResults web service.
|
Command |
Web Method |
HTTP URL |
|---|---|---|
|
Connect/Disconnect |
getRemoteProvisioningResultsByJobID |
@SGG_TEST@/ssn/DeviceResults |
|
On-Demand Read |
getMeterReadResultsByJobID |
@SGG_TEST@/ssn/DeviceResults |
|
Device Status Check |
getPingresultsByJobID |
@SGG_TEST@/ssn/DeviceResults |