4.0 Get (New) Inspections

4.2 Data Returned

Back to Index
Returned information:

An inspection list.

DTD:

<!ELEMENT insplist (count, insp*)>
<!ATTLIST insplist ver CDATA #REQUIRED>
<!ELEMENT count (#PCDATA)>
<!ELEMENT insp (#PCDATA)>
<!ATTLIST insp timestamp CDATA #REQUIRED>
<!ATTLIST insp stat CDATA #REQUIRED>
<!ATTLIST insp fleet CDATA #REQUIRED>
<!ATTLIST insp operator CDATA #REQUIRED>
<!ATTLIST insp optag CDATA #REQUIRED>
<!ATTLIST insp repair CDATA #REQUIRED>
<!ATTLIST insp loadlocation CDATA #REQUIRED>
<!ATTLIST insp startime CDATA #REQUIRED>
<!ATTLIST insp endtime CDATA #REQUIRED>
<!ATTLIST insp extractor CDATA #REQUIRED>
<!ATTLIST insp config CDATA #REQUIRED>
<!ATTLIST insp manual CDATA #REQUIRED>
<!ATTLIST insp verified CDATA #REQUIRED>
<!ATTLIST insp assetid CDATA #REQUIRED>
<!ATTLIST insp opid CDATA #REQUIRED>
<!ATTLIST insp defect CDATA #REQUIRED>
<!ATTLIST insp assetvalue CDATA #REQUIRED>
<!ATTLIST insp cfglabel CDATA #REQUIRED>
<!ATTLIST insp loadtime CDATA #REQUIRED>
<!ATTLIST insp sn CDATA #REQUIRED>
<!ATTLIST insp asset_exsid CDATA #REQUIRED>
<!ATTLIST insp operator_exsid CDATA #REQUIRED>
<!ATTLIST insp vin CDATA #REQUIRED>

Reply Data
Name Description
count The number of inspections returned.
timestamp The timestamp of the inspection. Specifically the timestamp of the primary asset tag read. Unix epoch timestamp (UTC).
stat Inspection status. Single ASCII character.

  • R Inspection is status Red. Either has critical defects or is incomplete.
  • Y Inspection is status Yellow. Has non critical defects and is complete.
  • G Inspection is status Green. Is complete and has no defects.
  • U Status is unknown. This should not occur.
fleet The primary asset fleet number. Usually displayed in the web interface as Asset No. Alphanumeric, 20 characters maximum.
operator Name of the operator (driver) that performed the inspection. First name, last name, 32 characters each maximum.
optag Tagid for the operator (driver) that performed the inspection. Numeric.
repair Count of the repairs for the inspection.
loadlocation The upload location the inspection was sent from. Alphanumeric, 32 characters maximum, may be empty.
startime Earliest timestamp in the inspection. Generally the operator login timestamp. Unix epoch timestamp (UTC).
endtime The latest timestamp in the inspection. Generally the inspection store timestamp. Unix Epoch timestamp (UTC).
extractor The device that extracted the inspection from the Zonar 2010 hand held device.

  • RDS Reader Download Station. The device was a standard Zonar download station.
  • RADIO Device was an Evirnet radio.
  • MODEM Device was an Evircomm modem station.
  • EDITOR Manually generated inspection, created from a software application. Not currently implemented.
  • TEST Synthetic inspection created by testing software. Should not be seen in a production account.
  • UNK Unknown device. Should not be seen.
config Inspection configuration name and version string. This is the actual name used internally in the system. For the label displayed in the web application see the cfglabel element.
Example: TRUCK-2.0.1
manual Flag to indicate the inspection contains one or more manually inspected zones. If the value is 1 the operator did not actually scan an RFID tag. Either 0 or 1.
verified Flag to indicate that the inspection is complete. If value is 1 the inspection was completed. The operator indicated good or bad for every zone. If the value is 0 then the inspection was not completed, the operator did not indicate good or bad on one or more zones.
assetid Primary asset id.
opid Operator (driver) id.
defect A count of the defects reported in the inspection.
assetvalue The numeric value reported for the primary asset. Usually, but not always the odometer reading at the time of the inspection. The specific inspection procedures will determine what this value means.
cfglabel Inspection configuration label.
loadtime When the inspection was loaded into the database. Unix epoch timestamp (UTC).
sn The serial number of the 2010 device used to perform the inspection.
asset_exsid Asset External System Identifier. An arbitrary text string of up to 40 characters in length. Used to provide compatibility with external systems. This must be unique per asset.
operator_exsid Operator External System Identifier. An arbitrary text string of up to 40 characters in length. Used to provide compatibility with external systems. This must be unique per operator.
vin (logvers >= 2) The asset’s VIN.
Inspection id number. Use as a target for the get inspection details function.

 

Note: The assetvaluecfglabel and loadtime elements were added in protocol version 2.0.3 / 1.10.

Example Request

http://development.zonarsystems.net/interface.php?action=showopen
&operation=insp&format=xml&timestamp=1140220882&status=all 

Example Success Reply