SCADAAnalogChangedNotification

The SCADAAnalogChangedNotification method provides a way for VTScada to send to an OASClosed Outage Analysis System such as Milsoft DisSPatch, notifications of changes in VTScada’s analog tag values. This method can be used to send one or more scadaAnalog data objects for any tags that have data updates.

 

A sample SCADAAnalogChangedNotification request sent by VTScada. It carries the updates from 5 analog tags.

 

POST / HTTP/1.1\r\n
SOAPAction: http://www.multispeak.org/Version_4.1_Release/SCADAAnalogChangedNotification
User-Agent: VTScada/12.0.26
Accept-Encoding:gzip, deflate
Content-Type: text/xml; charset=utf-8
Content-Length: 2691
Connection: keep-alive
Host: MultiSRV:8083

<?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="b00b93f3-1f87-449f-b10a-f6f3501a2c8c" 
                             TimeStamp="2021-01-25T21:42:48.503Z" Context="Production" /> 
  </soapenv:Header> 
  <soapenv:Body> 
    <tns:SCADAAnalogChangedNotification> 
      <tns:scadaAnalogs soapenc:arrayType="tns:scadaAnalog[5]">
        <tns:scadaAnalog objectID="quywa8lOb5" verb="Change"> 
          <tns:objectName>CalcMom\Calc1\Calc2\Calc3</tns:objectName> 
          <tns:value units="Calc3/Units">8.6602540381562</tns:value> 
          <tns:quality>Calculated</tns:quality> 
          <tns:timeStamp>2021-01-25T21:42:48.501Z</tns:timeStamp> 
        </tns:scadaAnalog> 

        <tns:scadaAnalog objectID="cjZaH10iYp" verb="Change"> 
          <tns:objectName>CalcMom\Calc1\Calc2\Calc3\CalcChildWithaLongName_ABCDEFGHIJKLMNOPQRSTUVWXYZ</tns:objectName> 
          <tns:value units="Calc4/Units">5.0000000010801</tns:value> 
          <tns:quality>Calculated</tns:quality> 
          <tns:timeStamp>2021-01-25T21:42:48.501Z</tns:timeStamp> 
        </tns:scadaAnalog> 

        <tns:scadaAnalog objectID="i8ho{7gz&amp;p\#}s}143_r;\ke6tuvsd2r" verb="Change"> 
          <tns:objectName>CalcMom\Calc1\Calc2</tns:objectName> 
          <tns:value units="Calc2/Units">9.6592582629714</tns:value> 
          <tns:quality>Calculated</tns:quality> 
          <tns:timeStamp>2021-01-25T21:42:48.501Z</tns:timeStamp> 
        </tns:scadaAnalog> 

        <tns:scadaAnalog objectID="i8ho{7gz&amp;p" verb="Change"> 
          <tns:objectName>CalcMom</tns:objectName> 
          <tns:value units="MomUnits">-9.9785892323911</tns:value> 
          <tns:quality>Calculated</tns:quality> 
          <tns:timeStamp>2021-01-25T21:42:48.501Z</tns:timeStamp> 
        </tns:scadaAnalog> 

        <tns:scadaAnalog objectID="i8ho{7gz&amp;p\#}s}143_r;" verb="Change"> 
          <tns:objectName>CalcMom\Calc1</tns:objectName> 
          <tns:value units="Calc1/Units">9.9144486137585</tns:value> 
          <tns:quality>Calculated</tns:quality> 
          <tns:timeStamp>2021-01-25T21:42:48.501Z</tns:timeStamp> 
        </tns:scadaAnalog> 
      </tns:scadaAnalogs> 
    </tns:SCADAAnalogChangedNotification>  
  </soapenv:Body> 
</soapenv:Envelope>

 

A sample SCADAAnalogChangedNotification response coming back from an OAS to VTScada. An empty SCADAAnalogChangedNotificationResult (one that has no errorObject content) means notification received successfully.

 

<?xml version="1.0"" encoding="utf-8"?> 
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
               xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/>             
  <soap:Body soap:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"> 
     <snp:SCADAAnalogChangedNotificationResponse xmlns:snp="http://www.multispeak.org/Version_4.1_Release"> 
       <snp:SCADAAnalogChangedNotificationResult/>
     </snp:SCADAAnalogChangedNotificationResponse>
  </soap:Body>
</soap:Envelope>

 

A sample ScadaAnalogChangedNotification response coming back from an OAS to VTScada with an error:

<?xml version=""1.0"" encoding="utf-8"?> 
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/>"             
  <soap:Body soap:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"> 
    <snp:SCADAAnalogChangedNotificationResponse xmlns:snp="http://www.multispeak.org/Version_4.1_Release"> 
      <snp:SCADAAnalogChangedNotificationResult>
        <snp:errorObject errorString="User could not be authenticated." eventTime="2015-01-01T10:00:00Z"/>
      </snp:SCADAAnalogChangedNotificationResult>
    </snp:SCADAAnalogChangedNotificationResponse> 
  </soap:Body>
</soap:Envelope>