Skip to main content
Omnitracs Knowledge Base

Get Sent Configuration Status Webservice Details

Authorization Requirements

The credentials supplied with this method call (as specified in the accompanying WS-Security header) must be authorized to the following application(s) and their associated role-based permissions.
Required Application Licenses

  • Vehicle Maintenance
    The user must also have been granted the capability 'Can query TTIA settings' on the Customer portal.

Calling Interface

 

GetCurrentConfigurationResponse getCurrentConfiguration (GetCurrentConfigurationRequest getRequests) throws WSException

  • getCurrentConfiguration: The GetCurrentConfigurationRequest encapsulates the information required to query for last known TTIA alert configuration status on the mobile
     
  • returns GetCurrentConfigurationResponse
    • Indicates the TTIA alert settings and the status


 

GetCurrentConfigurationRequest

 

Element

 

 

Type 

 

 

Description

 

 

Required

 

Routing

RoutingType

Contains the routing information for this message. The Primary Service Id should be set to 'VM', the secondary service Id should be set to 'TTIACONFIGURATION' the Destination should be filled in with the Vehicle Unified Address, and/or Vehicle Id. If both Vehicle Unified Address and Vehicle Id are present, Vehicle Id will take higher precedence.

Yes

Sample XML Requests

Only the SOAP body is shown. To see a sample SOAP Envelope and Header, click here.
This sample asks for TTIA configuration for vehicle UA 105375593.

<soapenv:Envelope xmlns:ns="http://cfg.data.eip.omnitracs.com/1.0" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">

   <soapenv:Body>

      <ns:GetCurrentConfigurationRequest>

         <Routing>

            <!--Zero or more repetitions:-->

            <Destination>

               <Type>Vehicle</Type>

               <SystemAssignedId>105375593</SystemAssignedId>

            </Destination>

            <Service>

               <Primary>

                  <Id>VM</Id>

               </Primary>

               <Secondary>

                  <Id>

                     <Id>TTIACONFIGURATION</Id>

                  </Id>

               </Secondary>

            </Service>

         </Routing>

      </ns:GetCurrentConfigurationRequest>

   </soapenv:Body>

</soapenv:Envelope>


 

 GetCurrentConfigurationResponse

 

Element

 

 

Type 

 

 

Description

 

 

Required

 

Configuration

ConfigurationType

List of Mobiles and the configuration and the status for each mobile.

Yes

 

ConfigurationType

 

Element

 

 

Type 

 

 

Description

 

 

Required

 

Routing

RoutingType

Contains the information about how the message was routed

Yes

Configuration

ConfigurationResourceType

Container for actual payload in the message

No

Status

ConfigurationStatusType

Message creation time 

Yes

Resources

AssociatedResourceType

Any additional information about the creation and changes to the message

No

MetaData

NameValueType

Any additional information about the creation and changes to the message

No

 

ConfigurationStatusType

 

Element

 

 

Type 

 

 

Description

 

 

Required

 

State

ConfigurationStateType

The state of configuration. The possible values are Pending/Failed/Delivered/Unknown/NoValue

Yes

StateTime

dateTime

When the state is updated.

No

Reason

string

Detail reason why the mobile has this state.

No


 

Sample XML Response

The sample XML response shows the TTIA configuration with delivered state for vehicle 106017282.

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

   <SOAP-ENV:Header/>

   <SOAP-ENV:Body>

      <ns4:GetCurrentConfigurationResponse xmlns:ns4="http://cfg.data.eip.omnitracs.com/1.0" xmlns:ns3="http://res.data.eip.omnitracs.com/1.0" xmlns:ns5="http://base.data.eip.omnitracs.com/1.0">

         <Configuration>

            <Routing>

               <Destination>

                  <Type>Vehicle</Type>

                  <SystemAssignedId>106017282</SystemAssignedId>

                  <CustomerAssignedId>0106017282</CustomerAssignedId>

               </Destination>

               <Service>

                  <Primary>

                     <Id>VM</Id>

                  </Primary>

                  <Secondary>

                     <Id>

                        <Id>TTIACONFIGURATION</Id>

                     </Id>

                  </Secondary>

               </Service>

            </Routing>

            <Configuration>

               <Payload>

                  <Type>Text</Type>

                  <Text><![CDATA[<ns2:ConfigurationPayload xmlns:ns2="http://www.omnitracs.com/TPMInput">

    <TTIAConfigurationPayload>

        <TTIAAlertConfiguration>

            <Label>Bad Tire ABC</Label>

            <AlertType>Non-Critical</AlertType>

            <EventDurationThreshold>30</EventDurationThreshold>

            <EventCount>3</EventCount>

            <AlertDurationThreshold>86400</AlertDurationThreshold>

        </TTIAAlertConfiguration>

        <TTIAAlertConfiguration>

            <Label>Good Tire ABC</Label>

            <AlertType>Critical</AlertType>

            <EventDurationThreshold>40</EventDurationThreshold>

            <EventCount>3</EventCount>

            <AlertDurationThreshold>86400</AlertDurationThreshold>

        </TTIAAlertConfiguration>

    </TTIAConfigurationPayload>

</ns2:ConfigurationPayload>]]></Text>

               </Payload>

            </Configuration>

            <Status>

               <State>Delivered</State>

               <StateTime>2013-06-18T18:48:35.000Z</StateTime>

            </Status>

         </Configuration>

      </ns4:GetCurrentConfigurationResponse>

   </SOAP-ENV:Body>

</SOAP-ENV:Envelope>

  • Was this article helpful?