16. Get Operators

Returns a list of operators in the system.
Note: This action was added in protocol version 1.02.

Required Information
Name	Description
action	showopen
operation	showoperators
format	xml
Optional Information
target	Filter will return data for that specific operator.
reqtype	Flag to identify the key being used to identify the operator. Acceptable values: `cdl` Comercial Drivers License Number. `tagid` Zonar Tag Number. `exsid` External System Identifier. `empnum` Operator's employee number.
location	Location to filter with. Text. If provided only operators assigned to that location will be returned. If location is not supplied or an empty location is specified, operators from all locations will be returned.
status	Operator status to filter with. Text. If provided only operators with the specified status will be returned. Possible values are: `active` Operator is active and can load inspections. `revoked` Operator has been revoked, is no longer active and cannot load inspections. `all` Both If all is specified for a status or a blank status is supplied no filtering on status is performed.

16.2 Data Returned

Returned information:
DTD:


   <!ELEMENT oplist (operator*)>

   <!ELEMENT operator (fname, lname, cdl, tag, empnum, status, location)>

   <!ELEMENT fname (#PCDATA)>

   <!ELEMENT lname (#PCDATA)>


   <!ELEMENT cdl (#PCDATA)>

   <!ELEMENT tag (#PCDATA)>

   <!ELEMENT empnum (#PCDATA)>

   <!ELEMENT status (active | revoked)>

   <!ELEMENT location (#PCDATA)>

   <!ELEMENT exsid (#PCDATA)>

Name	Description
fname	Operator's first name. An arbitrary text string of up to 32 characters in length.
lname	Operator's last name. An arbitrary text string of up to 32 characters in length.
cdl	Operator's Commercial Drivers License number.
tag	Zonar Systems™ RFID tag number of the operator. A non zero 32 bit integer quantity.
empnum	Operator's employee number.
status	Operator status either active or revoked. Revoked operators may not load inspections.
location	The location that the operator is assigned to.
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.

Example Request:


 http://development.zonarsystems.net/interface.php?action=showopen&operation=showoperators&format=xml

Example Success Reply

Single Target Example Request:


 http://development.zonarsystems.net/interface.php?action=showopen&operation=showoperators&format=xml&target=2021&reqtype=exid

16. Get Operators

16.1 Request Data

16.2 Data Returned

16.3 Related Functions