Field Validation for Group Module

Overview

This article explains the field-level validation rules used when performing a Bulk Upload for the Groups Module. It covers required fields and acceptable values for Add, Edit, and Delete operations.

For Add, Group Name is required.
For Edit, Group Name is required to identify the record. Any additional fields provided will be updated.
For Delete, only Group Name is required.

Group Name serves as the primary identifier during all group-level bulk operations.

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.

Please refer to the validation table below for accepted formats and examples.

Add Group

Field	Description	Example	Required/Optional	Validation Rule
Group	Enter a unique name for the new group.	Chicago section	Required	Must be a unique text value not already used as a group name.
Description	Provide additional details about the group.	This group is for vehicles operating in Chicago.	Optional	Free text.
Administrator	Enter the name of an existing administrator for the group.	John Jackson	Required	Must match an existing administrator name in the system.
Parent Group	Specify the parent group under which this group will be created.	Default Group	Required	Must match an existing group in the system.
Config	Specify the configuration to apply to this group.	Default Configuration	Required	Must match an existing configuration in the system.
Color	Enter a color code in hex format for the group (optional visual marker).	#18a4e1	Optional	Must be a valid hex color code (e.g., #RRGGBB).

Edit Group

Field	Description	Example	Required/Optional	Validation Rule
Group Name	Name of the existing group to update	North-East Region	Required	Must match an existing group name
Updated Group Name	New name for the group	Northeast Ops	Optional	Must be unique if provided
Parent Group	Updated parent group name	United States	Optional	Must match an existing group name if provided
Group Address	Updated group address	456 Broadway St	Optional	Free text
City	Updated city	Boston	Optional	Free text
State	Updated state	MA	Optional	Must be a valid state abbreviation if provided
Zip Code	Updated postal code	02116	Optional	Valid alphanumeric format
Country	Updated country	United States	Optional	Must match predefined countries
Time Zone	Updated time zone	America/New_York	Optional	Must match valid time zone format (`Region/City` )
Phone Number	Updated phone number	+1-617-555-6789	Optional	Must be in valid phone number format
Manager Email	Updated group manager’s email	newmanager@example.com	Optional	Must be in valid email format

Delete Group

Field	Description	Example	Required/Optional	Validation Rule
Group	Enter the name of the group you want to delete.	Chicago section	Required	Must match an existing group name in the system.

📥 Related Resources

How to Perform a Bulk Upload