39. Edit Operator Status

Use this to change the status of an operator (driver). Active operators may be set to an inactive or revoked status, or inactive operators may be returned to an active status.

Inactive or revoked operators are excluded by default from reports and are prevented from loading inspections. This provides a means of removing inactive personnel from display and reports while maintaining any previous inspections they may have performed.

39.1 Request Data

Required Information
Name Description
action adminoperators
operation editstatus
format xml
target The operator to modify.
A request type must be specified as well (see below).
reqtype Flag to identify the key being used to identify the operator. Acceptable values:
  • tag Key is a Zonar RFID tag number.
  • exsid Key is the external system id.
status The status to set the operator to. Acceptable values:
  • 1 Active. The operator is active, normal status.
  • 2 Revoked, inactive. Use this to revoke an active operator.
comment Only required if the operator is being set to revoked status. Any arbitrary text string, unlimited length.

39.2 Data Returned

Returned information:
A success or error message.

Example Request:

http://development.zonarsystems.net/interface.php?&action=adminoperators&operation=editstatus\&format=xml&target=6997&reqtype=tag&status=2&comment=REVOKED

Example Success Reply,
Example Error Reply

39.3 Related Functions

Other functions to manage operators: