Driver


Click here for a complete list of operations.

GetDataRanges

Returns a list of driver IDs and the first and last status change for each driver. At most 1000 drivers at a time will be returned. On the first call, omit or pass an empty string as the driver ID. On subsequent calls, pass the last driver ID returned from the previous call so that the next 1000 drivers are returned. Continue this until no drivers are returned. Drivers are always returned in alphabetical order based on the driver ID. The FirstStatusChange for a driver is the earliest status change as of the time of the call. The LastStatusChange for a driver is the last status change as of the time of the call. This will be the start time of his current duty status.

Test

The test form is only available for requests from the local machine.

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /QHOSWSNA/driver.asmx HTTP/1.1
Host: hosx.omnitracs.ca
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://www.omnitracs.com/GetDataRanges"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetDataRanges xmlns="http://www.omnitracs.com">
      <request>
        <LastDriverId>string</LastDriverId>
        <TimeResolutionInSeconds>boolean</TimeResolutionInSeconds>
      </request>
    </GetDataRanges>
  </soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetDataRangesResponse xmlns="http://www.omnitracs.com">
      <GetDataRangesResult>
        <DriverDataRanges>
          <DriverDataRange>
            <DriverId>string</DriverId>
            <FirstStatusChange>dateTime</FirstStatusChange>
            <LastStatusChange>dateTime</LastStatusChange>
          </DriverDataRange>
          <DriverDataRange>
            <DriverId>string</DriverId>
            <FirstStatusChange>dateTime</FirstStatusChange>
            <LastStatusChange>dateTime</LastStatusChange>
          </DriverDataRange>
        </DriverDataRanges>
      </GetDataRangesResult>
    </GetDataRangesResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /QHOSWSNA/driver.asmx HTTP/1.1
Host: hosx.omnitracs.ca
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <GetDataRanges xmlns="http://www.omnitracs.com">
      <request>
        <LastDriverId>string</LastDriverId>
        <TimeResolutionInSeconds>boolean</TimeResolutionInSeconds>
      </request>
    </GetDataRanges>
  </soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <GetDataRangesResponse xmlns="http://www.omnitracs.com">
      <GetDataRangesResult>
        <DriverDataRanges>
          <DriverDataRange>
            <DriverId>string</DriverId>
            <FirstStatusChange>dateTime</FirstStatusChange>
            <LastStatusChange>dateTime</LastStatusChange>
          </DriverDataRange>
          <DriverDataRange>
            <DriverId>string</DriverId>
            <FirstStatusChange>dateTime</FirstStatusChange>
            <LastStatusChange>dateTime</LastStatusChange>
          </DriverDataRange>
        </DriverDataRanges>
      </GetDataRangesResult>
    </GetDataRangesResponse>
  </soap12:Body>
</soap12:Envelope>