Driver->Update
Update (Driver Function)
This function updates one or more currently existing driver records within the HOS database.
XML Request
For multiple driver records, each driver must have its own <DriverData> tag. The Update function takes the following input parameters:
| Parameter | Type | Description |
|---|---|---|
| DriverId | String | The driver ID for the driver being updated. |
| UpdateDriverId | String | The new driver ID. Must be at least 4 characters. |
| Password | String | The driver's password |
| LastName | String | The driver's last name. Must be at least 2 characters. |
| FirstName | String | The driver's first name. Must be at least 2 characters. |
| DepotId | Short | The ID of the depot to which the driver belongs |
| DriverGroup | String | The group that the driver belongs to; if more than one, provide each string on a new line within the <DriverGroup> tag |
| DefaultRuleSet | Enum | The default driving rule set for this driver: USA, Canada, or Canada north of the 60th parallel; possible values are USA, CANMain, CANNorth, USACalifornia, USAFlorida, USATexas, USAAlaska |
| USDefaultDutyCycle | Enum | The driver's default duty cycle for a U.S. rule set; possible values are None (if a Canadian rule set is used), SevenDay, EightDay |
| CANDefaultDutyCycle | Enum | The driver's default duty cycle for a Canadian rule set; possible values are None (if a U.S. rule set is used), SevenDay, FourteenDay |
<soap:Body>
<Update xmlns="http://www.qualcomm.com">
<updateParams>
<Driver>
<DriverId>string</DriverId>
<UpdateDriverId>string</UpdateDriverId>
<Password>string</Password>
<LastName>string</LastName>
<FirstName>string</FirstName>
<DepotId>short</DepotId>
<DriverGroup>
<string>string</string>
<string>string</string>
</DriverGroup>
<DefaultRuleSet>USA or CANMain or CANNorth or USACalifornia or USAFlorida or USATexas or USAAlaska</DefaultRuleSet>
<USDefaultDutyCycle>None or SevenDay or EightDay</USDefaultDutyCycle>
<CANDefaultDutyCycle>None or SevenDay or FourteenDay</CANDefaultDutyCycle>
</Driver>
</updateParams>
</Update>
</soap:Body>
XML Response
The return result contains the Boolean parameter <UpdateResult>, which indicates whether the update was successful (true) or not (false).
<soap:Body>
<UpdateResponse xmlns="http://www.qualcomm.com">
<UpdateResult>
<IsUpdated>boolean</IsUpdated>
</UpdateResult>
</UpdateResponse>
</soap:Body>