---

12.0 Expired Operators Report

Returns a report of operator expiry information.
Note: This action was added to protocol version 1.01.

12.1 Request Data

Required Information
Name	Description
action	showexpire
operation	operator
format	xml
rpttype	The type of report to create. Acceptable values: date Return operators that will expire within the specified threshold. If no threshold is specified, a threshold of 0 will be assumed. operator Create an expiry report for the specified operator. A target operator must be specified.
Optional Information
location	Location to filter with. Text. If provided only operators assigned to that location will be returned. returned. If location is not supplied or an empty location is specified, assets from all locations will be returned.
threshold	Threshold to include expiry information in the report. A number of days. Expirations that will occur within the specified number of days are included. If not specified a threshold of 0 will be used. Note: threshold is not used if rpttype=operator
target	The operator to create the report for. If report type is specified as operator this must be supplied. Note: target is not used if rpttype=date
reqtype	Flag to identify the key being used to identify the target operator. Acceptable values: dbid Key is the internal database id number. The most reliable key to use. cdl Key is the operator's CDL (Commercial Driver's License number). empnum Key is the operator's employee number. tag Key is the operator's Zonar RFID tag number. Note: reqtype is not used if rpttype=date
expdatetype	May be specified for any report type. Only return expiry dates of the specified type. Must be a valid expiry type.

12.2 Data Returned

Returned information:
A list of operators with expiry dates.
DTD:
<!ELEMENT opexpirelist (opexpire*)>
<!ATTLIST opexpirelist ver CDATA #REQUIRED>
<!ELEMENT opexpire (fname, lname, cdl, empnum, status, location, dateexpire)>
<!ATTLIST opexpire dbid CDATA #REQUIRED>
<!ELEMENT fname (#PCDATA)>
<!ELEMENT lname (#PCDATA)>
<!ELEMENT cdl (#PCDATA)>
<!ELEMENT empnum (#PCDATA)>
<!ELEMENT location (#PCDATA)>
<!ELEMENT tag (#PCDATA)>
<!ELEMENT dateexpire (label, expdate, remainingdays)>
<!ELEMENT label (#PCDATA)>
<!ELEMENT expdate (#PCDATA)>
<!ELEMENT remainingdays (#PCDATA)>


The dbid attribute is the database id number of the operator. The remainingdays is the number of days remaining until the expiration occurs. This may be zero or a negative number in which case the expiration has already occurred.
In protocol version 1.07 the tag element was added to provide the operator's Zonar RFID tag number.

Example Request:
Return a list of all operator expirations that will occur within 10 days.
http://development.zonarsystems.net/interface.php?action=showexpire&operation=operator&format=xml&rpttype=date&threshold=10

Example Success Reply