Skip to main content
Omnitracs Knowledge Base

Change Driver Management Group

changeDriverManagementGroup

Change a driver's performance management group on the Services Portal.  The performance management group is presently a Performance Monitoring construct only.

void changeDriverManagementGroup(String driverId, String driverManagementGroup) throws WSException

  • driverId: A string containing the identifier of the driver to be changed.
  • driverManagementGroup: A string that contains the identifier of the performance management group to which the driver belongs.  Blanks are valid and indicate that the driver is not part of a management group.

 

Authorization Requirements

 

The credentials supplied with this method call (as specified in the accompanying WS-Security header) must be authorized to the following application(s) and their associated role-based permissions.

Required Application Licenses
- Remote Integration

Required User Permissions
- Can use Performance Monitoring
- Can maintain vehicles and drivers

Customer integrators are authorized to their own company's data only.

 

Sample XML Request

 

Only the SOAP body is shown. To see a sample SOAP Envelope and Header, click here.

<soap:Body>

   <changeDriverManagementGroup>

      <driverId>JADAMS</driverId>

      <driverManagementGroup>CASUAL</driverManagementGroup>

   </changeDriverManagementGroup>

</soap:Body>

 

Sample XML Response

 

An empty response conveys success. If there was an error, an exception would have been thrown.

<soapenv:Body>

   <changeDriverManagementGroupResponse/>

</soapenv:Body>

 

Exceptions

 

001 Unknown Error.
002 Required field not specified.
003 Company not authorized for access through integration.
004 User is not authorized.
005 Driver ID invalid.
006 Driver Management Group invalid.

  • Was this article helpful?