Change Performance Extract Driver

Last updated
Save as PDF

changeExtractDriver

Change a SensorTRACS performance extract's associated driver.

void changeExtractDriver(AssetIdentifier vehicle, String dataEndTS, String currentDriverId, String newDriverId) throws WSException

vehicle: An AssetIdentifier containing the SCAC and ID of the vehicle whose extract is to be changed.
dataEndTS: A string that contains the extract's timestamp expressed in the following format in GMT timezone: yyyy-mm-ddThh:mm:ssZ.
currentDriverId: A string containing the current driver identifier of the performance extract you wish to change.
newDriverId: A string containing the driver identifier you wish to associate to the performance extract.

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 setup/configuration

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>

<changeExtractDriver>

<vehicle>

<id>A00003</id>

<scac>ABCD</scac>

</vehicle>

<dataEndTS>2008-08-24T14:58:01Z</dataEndTS>

<currentDriverId>000000000</currentDriverId>

<newDriverId>TCLARK</newDriverId>

</changeExtractDriver>

</soap:Body>

Sample XML Response

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

<soapenv:Body>

<changeExtractDriverResponse/>

</soapenv:Body>

Exceptions

001 Unknown Error.
002 Required field not specified.
003 Company not authorized for integration.
004 User is not authorized.
005 Vehicle invalid.
006 Extract Date invalid.
007 Current Driver ID invalid.
008 New Driver ID invalid.
009 No extract found for specified parameters.