Status Operational Status

Edit an Existing Operator (Driver)

  • Last edited on

 Use this call to alter the attributes of an operator object.

Request Data

Required Information
Name Description
action adminoperators
operation edit
format xml
target The operator to modify. If specified a reqtype (request type) must be specified as well.
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.
fname Operator's first name. An arbitrary text string of up to 32 characters in length. Must be specified.
lname Operator's last name. An arbitrary text string of up to 32 characters in length. Must be specified.
location The location that the operator is assigned to.
pin Must be set to a 4 digit number. This parameter lets users edit an operator's PIN, which is mandatory for logging into a tablet.
Optional Information
logvers
  • 1 This is the standard output.
  • 2 New required fields:
      • driverpassword will error if not included or less than 1 character.
      • Will need Synthetic Login enabled on the account.

Note: Previously this did not have a logvers field. If omitted it will default to previous behavior, or that can be explicitly specified by using 'logvers=1'.
empnum Operator's employee number. An arbitrary text string of up to 20 characters in length. If not specified an empty string will be used.
cdl Operator's Commercial Drivers License number. An arbitrary text string of up to 20 characters in length. If not specified an empty string will be used.
exsid External System Identifier. An arbitrary text string of up to 40 characters in length. This must be unique per operator. If not specified an empty string will be used.
tag Zonar Systems™ RFID tag number of the operator. A non zero 32 bit integer quantity. If specified this must be unique.

Example Request

https://omi.zonarsystems.net/interface.php?customer=zzo2544&username=zonar&password=secret.pw.2019&customer=zzo2544&action=adminoperators&operation=edit&format=xml&fname=John&lname=Smith&tag=2112&location=Seattle&target=2112&reqtype=tag&pin=1111

Data Returned

Returned information: A success or error message.

Example Success Reply

<success ver="1">
  <action>adminoperators</action>
</success>

Example Error Reply

<?xml version="1.0"?>
<error ver="1.0">
 <action>adminoperators</action>
 <code>107</code>
 <message>No target supplied for operator.</message>
</error>

 

Driver Management