MessageHistory

The Message History report XML response is invoked by external calls for the MessageHistory table.

This report collects all inbound and outbound messagingText messages exchanged between drivers and dispatchers using TrackIt. activity for an employeeUser accounts for drivers, dispatchers, and other staff to perform varying functions in TrackIt..

Parameters

messageParams
Parameter Description Type Required Notes

dateRange

The day(s) desired for report data querying.

 Date Range Required

 

employeeNum

The identification numbers for the employee(s) queried.

 Integer    

vehicleNum

The identifying numbers for the vehicleAll machines used as a means of production on a construction site or at a batch plant.(s) queried.

 Integer    

typeID

The employee or vehicle type ID depending on which one the query is focused.

 Integer    

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v1="http://v1.report.services.trakitgps.com/">

<soapenv:Header/>

<soapenv:Body>

<v1:MessageHistory>

<!--Optional:-->

<webkey>?</webkey>

<!--Optional:-->

<MessageParams>

<dateRange>

<startDate>

<year>?</year>

<month>?</month>

<day>?</day>

<hour>-1</hour>

<minute>-1</minute>

<second>-1</second>

<!--Optional:-->

<timeZone>?</timeZone>

</startDate>

<endDate>

<year>?</year>

<month>?</month>

<day>?</day>

<hour>-1</hour>

<minute>-1</minute>

<second>-1</second>

<!--Optional:-->

<timeZone>?</timeZone>

</endDate>

</dateRange>

<!--Optional:-->

<employeeNum>?</employeeNum>

<!--Optional:-->

<vehicleNum>?</vehicleNum>

<!--Optional:-->

<typeID>?</typeID>

</MessageParams>

</v1:MessageHistory>

</soapenv:Body>

</soapenv:Envelope>

Returns

messageData
Parameter Description Notes

dateAcknowledged

The timestamp for when the messageText messages exchanged between drivers and dispatchers using TrackIt. was acknowledged by either dispatch or the driver.

  

dateCreated

The timestamp for when the message was originally written, but not sent.

  

dateSent

The timestamp for when the message was sent to dispatch or received by the driver.

  

employeeNum

The employee's identification number.

  

messageBody

The content of the message.

  

messageID

The identification number associated with the message sent, as used by TrackIt for record keeping purposes.

  

statusNum

The statusThe specific activity or task a driver is currently engaged in, typically as part of a process called a "status loop."'s corresponding identification number.

  

vehicleNum

The equipmentAll machines used as a means of production on a construction site or at a batch plant.'s identification number.