Create Driver Management Group

Last updated
Save as PDF

createDriverManagementGroup

Given an Id and description, this web service creates a driver management group. The management group is presently a Performance Monitoring construct only.

void createDriverManagementGroup(String driverManagementGroupId, String driverManagementGroupDescription) throws WSException

driverManagementGroupId: A string of maximum length 10 that contains the unique identifier of the driver management group to be created.
driverManagementGroupDescription: A string of maximum length 50 that contains the description of the driver management group to be created.

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
- Can maintain vehicles and drivers

Sample XML Request

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

<soap:Body>

<createDriverManagementGroup>

<driverManagementGroupId>SOUTHEAST</driverManagementGroupId>

<driverManagementGroupDescription>Southeast Management Group</driverManagementGroupDescription>

</createDriverManagementGroup>

</soap:Body>

Sample XML Response

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

<soapenv:Body>

<p431:createDriverManagementGroupResponse xmlns:p431="http://websvcs.stracswebws"/>

</soapenv:Body>

Exceptions

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