Documentation

Managing Groups

Groups help you organize devices into logical categories. For example, you might create groups for different vehicle types (buses, vans), locations (North Region, South Region), or purposes (School Routes, Corporate).

When viewing reports or tracking, you can filter by group to focus on specific subsets of your fleet.

Viewing Groups

The Groups table displays the following columns:

• Name: The group name
• Sync Status: Real-time connection status with visual indicators
• Actions: Edit, View Devices, and Delete options

On mobile devices, the Sync Status column is automatically hidden for better readability.

Understanding Sync Status

Groups sync with the tracking server in real-time:

• Syncing: Spinning icon indicates sync in progress (yellow)
• Synced: Check icon confirms successful synchronization (green)
• Failed: Error icon indicates sync failed - click to retry (red)

Sync status updates automatically without refreshing the page.

Searching for Groups

Use the search field to find groups. The search works across group name and sync status. Results update as you type.

Adding a Group

1. Click the Add Group button.
2. Fill in the group details:

Form Fields

• Name (Required): Enter a descriptive name for the group (e.g., "School Buses", "North Region")
• Parent Group (Optional): Select an existing group to create a hierarchical structure

3. Click Create Group.

Creating Hierarchical Groups

You can nest groups within other groups to create a tree structure. For example:

• Vehicles
  • Buses
    • School Buses
    • Charter Buses
  • Vans

To create a nested group, select an existing group as the Parent Group when creating a new group. Child groups inherit the parent relationship and can have their own children.

Editing a Group

1. Find the group in the table.
2. Click the actions menu (three dots) in that row.
3. Select Edit.
4. Update the name or parent group.
5. Click Update Group.

Viewing Devices in a Group

1. Find the group in the table.
2. Click the actions menu (three dots) in that row.
3. Select View Devices.

This navigates to the Devices page filtered to show only devices in that group.

Deleting a Group

1. Find the group in the table.
2. Click the actions menu (three dots) in that row.
3. Select Delete.
4. Confirm the deletion.

Note: Deleting a group does not delete the devices in it. Those devices will simply no longer be assigned to a group.

Retry Sync

If a group shows "Failed" sync status:

1. Click the sync status button to retry

The group will attempt to sync again with the tracking server.

Assigning Devices to Groups

You assign devices to groups when adding or editing a device:

1. Go to Devices.
2. Add or edit a device.
3. In the Details tab, select a group from the Group dropdown.
4. Save the device.

Filtering by Group

Once you have groups set up, you can filter devices by group:

1. Go to the Devices page.
2. Click the Group column header dropdown.
3. Select a specific group to filter.

This helps you focus on specific subsets of your fleet.

Pagination

The table displays 10 groups per page. Use the pagination controls at the bottom to navigate:

• First and Last page buttons
• Previous and Next page buttons
• Current page indicator showing "Showing X to Y of Z"

Permissions

You need the appropriate permissions to add, edit, or delete groups:

• Create: Requires group:create permission
• Edit: Requires group:update permission
• Delete: Requires group:delete permission

If these options are not visible, contact your administrator to request access.