Field Validation for Driver Module

Overview

This article outlines the required fields and validation rules for each action - Add, Edit, and Delete - in the Driver module. Please refer to the appropriate section based on the type of bulk operation you're performing.

For Add, the following fields are required: Username, First Name, Last Name, and Password.
For Edit, Username is required to identify the driver. All other fields are optional and will only be updated if included.
For Delete, only the Username is required to remove the driver record.

Username is the unique identifier for drivers in bulk upload and should always match the system record.

If the Username is not visible on the Driver or User page, you may use the Email instead—this will be treated as the username during upload if applicable.

Note: For each operation, ensure that all required fields are provided. Optional fields that are omitted will be saved as blank during Add, or will remain unchanged during Edit.

For detailed field-level validation rules, see the table below.

Add Driver

Field	Description	Example	Required/Optional	Validation Rule
Username	Username of the driver.	Zach	Required	Free text.
First Name	First name of the driver.	Brandon	Required	Free text.
Last Name	Last name of the driver.	Ironman Ford 240	Required	Free text.
Vehicle	Vehicle assigned to the driver.	ATI1011	Optional	Must match an existing vehicle in the account.
Email	Email ID of the driver.	zachbrand@gmail.com	Required	Must not already exist in the system.
Employee ID	Unique employee identifier.	8893828221	Optional	Free text.
Phone Number	Contact number of the driver.	+1-8893828221	Optional	Must be a valid phone number.
Password	Password for driver account login.	Zach@12312	Required	Must meet password criteria (e.g., length, characters).
Role	Role assigned to the driver.	Driver Role	Required	Must match a valid role name in the system.
Timezone	Timezone assigned to the driver.	Eastern Time	Required	Must match a valid timezone value in the system.
Driving License	Driver’s license number.	A123-456-789-012	Optional	Free text.
License Date of Issue	Date when the license was issued.	11/8/2023	Optional	Must be a valid date format (MM/DD/YYYY).
License Expiry Date	Date when the license expires.	11/8/2028	Optional	Must be a valid date format (MM/DD/YYYY).
DOT Hours of Service	Indicates if DOT hours of service tracking applies.	Yes	Optional	Accepts "Yes" or "No".
License Issue State	State where the license was issued.	Florida	Optional	Must match a U.S. state from the dropdown.

Edit Driver

Field	Description	Example	Required/Optional	Validation Rule
Username	Existing driver username in the system	zachbrandon@gmail.com	Required	Must exist in the system
New Username	New username to update, if applicable	brandonzach@gmail.com	Optional	Must be unique if provided
First Name	Updated first name of the driver	Zach	Optional	Text only
Last Name	Updated last name of the driver	Brandon	Optional	Text only
Vehicle	Assigned vehicle	ATI1011	Optional	Must match a valid vehicle in system
Email	Updated email	zachb@example.com	Optional	Must be valid email format
Employee Id	Employee identifier	1223	Optional	Must be unique if provided
Phone Number	Updated phone number	+1-8893828221	Optional	Must be a valid number format
Password	New login password	Zach@12312	Optional	Must meet password policy requirements
Role	Role assigned to driver	Driver Role	Optional	Must match valid roles from dropdown
Timezone	Timezone of the driver	Eastern Time	Optional	Must match valid timezone options
Driving License	License number	A123-456-789-012	Optional	Text only
Driving License Date of Issue	Date license was issued	11/08/2023	Optional	Must be valid date format (MM/DD/YYYY)
Driving License Expiry Date	Date license expires	11/08/2028	Optional	Must be valid date format (MM/DD/YYYY)
DOT Hours of Service	Whether DOT HOS applies	Yes	Optional	Must be "Yes" or "No"
Driving License Issue State	State where license was issued	Florida	Optional	Must match valid state from dropdown

Delete Driver

Field	Description	Example	Required/Optional	Validation Rule
Username	Username of the driver to be deleted.	zachbrandon@gmail.com	Required	Must match an existing username in the account.

📥 Related Resources

How to Perform a Bulk Upload