GetSCADAAnalogByScadaPointID

The GetSCADAAnalogByScadaPointID method is used by an OAS Outage Analysis System to request SCADA analog data on demand for a specific SCADA point. The analog data is used as view-only data by Milsoft.

 

Sample GetSCADAAnalogByScadaPointID request from an OAS:

 

POST http://MultiSRV/multispeaktestrealm/ HTTP/1.1
Connection:Keep-Alive 
Content-Type:text/xml; charset=utf-8 
Accept:text/* 
Authorization:Basic YTph 
User-Agent:SOAPWinHTTPClient 
SOAPAction:"http://www.multispeak.org/Version_4.1_Release/GetSCADAAnalogBySCADAPointID"
Content-Length:1006
Host:MultiSRV

 

Sample GetSCADAAnalogByScadaPointID response from VTScada. If successful (pointID corresponds to a tag that is accessible by the user according to the filtering rules being applied ) then the response contains the tag name, value, timestamp, quality, and units. If it fails then the response contains an error such as “tag not found” or “incorrect tag type”. The latter happens if we pass in an objectID that corresponds to a status and not an analog.

 

HTTP/1.1 200 OK
Date: Mon, 25 Jan 2021 21:03:06 GMT
Server: VTScada 12.0.26
Content-Type: text/xml; charset="utf-8"
Content-Length: 1536
Cache-Control: no-cache, no-store

 <?xml version="1.0" encoding="UTF-8"?> 
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
                  xmlns:http="http://schemas.xmlsoap.org/wsdl/http/" 
                  xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/" 
                  xmlns:s="http://www.w3.org/2001/XMLSchema" 
                  xmlns:s1="cpsm_V4.1_Release" 
                  xmlns:s2="gml_V4.1_Release" 
                  xmlns:s3="http://www.w3.org/1999/xlink" 
                  xmlns:si="http://www.w3.org/2001/XMLSchema-instance" 
                  xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" 
                  xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" 
                  xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" 
                  xmlns:tm="http://microsoft.com/wsdl/mime/textMatching/" 
                  xmlns:tns="http://www.multispeak.org/Version_4.1_Release" 
                  xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"> 

  <soapenv:Header> 
    <tns:MultiSpeakMsgHeader MajorVersion="4" MinorVersion="1" Build="6" BuildString="Release" 
                             AppName="VTScada" AppVersion="12.0026" Company="Trihedral Engineering Ltd." 
                             MessageID="27371d7b-8dd7-423f-beeb-57cc535625e5" 
                             TimeStamp="2021-01-25T21:03:06.217Z" Context="Production" /> 
    </soapenv:Header> 
    <soapenv:Body> 
      <tns:GetSCADAAnalogBySCADAPointIDResponse> 
        <tns:GetSCADAAnalogBySCADAPointIDResult objectID="cjZaH10iYp" verb="Change"> 
          <tns:objectName>CalcMom\Calc1\Calc2\Calc3\CalcChildWithaLongName_ABCDEFGHIJKLMNOPQRSTUVWXYZ</tns:objectName> 
          <tns:value units="Calc4/Units">10</tns:value> 
          <tns:quality>Calculated</tns:quality> 
          <tns:timeStamp>2021-01-25T21:03:06.001Z</tns:timeStamp> 
        </tns:GetSCADAAnalogBySCADAPointIDResult> 
      </tns:GetSCADAAnalogBySCADAPointIDResponse> 
    </soapenv:Body> 
</soapenv:Envelope>

Sample response with an error:

<?xml version="1.0" encoding="UTF-8"?> 
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
                  xmlns:http="http://schemas.xmlsoap.org/wsdl/http/" 
                  xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/" 
                  xmlns:s="http://www.w3.org/2001/XMLSchema" 
                  xmlns:s1="cpsm_V4.1_Release" 
                  xmlns:s2="gml_V4.1_Release" 
                  xmlns:s3="http://www.w3.org/1999/xlink" 
                  xmlns:si="http://www.w3.org/2001/XMLSchema-instance" 
                  xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" 
                  xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" 
                  xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" 
                  xmlns:tm="http://microsoft.com/wsdl/mime/textMatching/" 
                  xmlns:tns="http://www.multispeak.org/Version_4.1_Release" 
                  xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"> 
  <soapenv:Header> 
    <tns:MultiSpeakMsgHeader MajorVersion="4" MinorVersion="1" Build="6" 
                             BuildString="Release" AppName="VTScada" AppVersion="12.0026" 
                             Company="Trihedral Engineering Ltd." 
                             MessageID="ee292939-4760-447b-a421-e430725be877" 
                             TimeStamp="2021-01-25T21:10:10.530Z" Context="Production" /> 
  </soapenv:Header> 
  <soapenv:Body> 
    <tns:GetSCADAAnalogBySCADAPointIDResponse> 
    <tns:GetSCADAAnalogBySCADAPointIDResult objectID="cjZaH10iY" errorString="Tag not found" /> 
    </tns:GetSCADAAnalogBySCADAPointIDResponse> 
  </soapenv:Body> 
</soapenv:Envelope>