Get Driver Management Group

Last updated
Save as PDF

getDriverManagementGroup

Given a driver Id, this web service returns the driver's management group. The management group is presently a Performance Monitoring construct only.

String getDriverManagementGroup(String driverId) throws WSException

driver: A string containing a unique driver identifier whose management group should be returned.

Returns a null string on exceptions; otherwise returns a string that contains the identifier of the 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
- Performance Monitoring

Required User Permissions
- Can use Performance Monitoring

Sample XML Request

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

<soap:Body>

<getDriverManagementGroup>

<driverId>ASMITH</driverId>

</getDriverManagementGroup>

</soap:Body>

Sample XML Response

<soapenv:Body>

<getDriverManagementGroupResponse>

<driverManagementGroup>SOUTHEAST</driverManagementGroup>

</getDriverManagementGroupResponse>

</soapenv:Body>

Exceptions

001 Unknown Error.
003 Company not authorized for integration.
004 User not authorized.
005 Invalid driver id.