7.0 Get Aux Item(s)

7.2 Data Returned

Back to Index
Returned information, Version 2.X

A list of aux items

DTD

<!ELEMENT auxlist (aux*)>
<!ATTLIST auxlist ver CDATA #REQUIRED>
<!ELEMENT aux (tag, unit, auxtype, valuelabel, value, location)>
<!ATTLIST aux id CDATA #REQUIRED>
<!ELEMENT tag (#PCDATA)>
<!ELEMENT unit (#PCDATA)>
<!ELEMENT auxtype (#PCDATA)>
<!ELEMENT valuelabel (#PCDATA)>
<!ELEMENT value (#PCDATA)>
<!ELEMENT location (#PCDATA)>
<!ELEMENT timestamp (#PCDATA)>

Returned information, Version 1.X

An aux item message

DTD

<!ELEMENT aux (tag, unit, auxtype, valuelabel, value, location)>
<!ATTLIST aux ver CDATA #REQUIRED>
<!ELEMENT tag (#PCDATA)>
<!ELEMENT unit (#PCDATA)>
<!ELEMENT auxtype (#PCDATA)>
<!ELEMENT valuelabel (#PCDATA)>
<!ELEMENT value (#PCDATA)>
<!ELEMENT location (#PCDATA)>

Reply Data
Name Description
tag Zonar Systems™ RFID tag number of the aux item. This combined with the auxtype uniquely identifies the item.
id Version 2.X only. The internal database identifier for the aux item. Numeric, always non zero.
unit The unit number or name assigned to the object. Text, not longer than 32 characters. This value will be unique to the aux item.
auxtype The type of object this item is. Text, not longer than 32 characters. This combined with the tag number uniquely identifies identifies the item.
valuelabel A label identifying the units the value refers to. Text, not longer than 32 characters. The valuelabel is a property of the aux type.
value The last reported value for this aux item. Numeric, may be zero.
location The location that the aux item is assigned to. Text, not longer than 32 characters.
Timestamp Timestamp if available. , Unix epoch timestamp (UTC).
Example Request (Version 2.X)

Return a list of all aux items. http://development.zonarsystems.net/interface.php?action=showopen&operation=aux&format=xml&version=2
Reply, with 16 aux items

Return a list of all aux items of type ‘REFER’ http://development.zonarsystems.net/interface.php?action=showopen&operation=aux&format=xml&version=2&auxtype=REFER

Reply, with 5 aux items

Example Request (Version 1.X Preferred form)

http://development.zonarsystems.net/interface.php?action=showopen&operation=aux&format=xml&auxtype=REFER&target=2300

Example Request (Version 1.X Deprecated form)

http://development.zonarsystems.net/interface.php?action=extgetaux&auxtype=REFER&target=2300

Reply, with a single aux item