Devices

The Device overview is used to manage the mobile end devices and telematics devices (tablets, smartphones, telematics boxes) deployed in X4fleet. Dispatchers and administrators record new devices here, assign them to a driver or a vehicle and maintain the device details such as IMEI, SIM number and phone number.

If the deployed devices are managed in the Xplanis MDM (SOTI), devices are imported and assigned automatically.

1. Navigation

The device overview is accessible via the main menu under Master Data › Devices. The page is titled Mobile Devices.

2. Device Overview (Table)

The overview shows all devices in a paginated and sortable table. Each row represents one device. By default, 50 rows are displayed per page; the page size can be changed to 100, 250, 500, 1000 or 2000 rows.

Below the column headers there is a filter row that lets you narrow down the list column by column.

Standard Columns

Sorting

Clicking a column header sorts the list in ascending or descending order by that column. By default, the list is sorted in descending order by the Id column.

Deleted Devices

Deleted devices are no longer displayed in the overview. When deleted, a device is not physically removed but merely marked as deleted and hidden from the list.

3. Group Filter

The page has no filter bar of its own for groups. The device list follows the group selected in the X4fleet header. If a different group is selected there, the list is reloaded.

• Only current group: This toggle in the header lets you limit the display to devices of the currently selected group. If the option is deactivated, devices from subordinate groups are also displayed.

4. Adding a Device

A new device is recorded with the Add button in the toolbar.

1. Click the Add button.
2. The Add device dialog opens with an empty device form.
3. Record the device details (see Section 6).
4. Click Save. Cancel closes the dialog without saving.

After saving, the new device appears in the overview. New devices are assigned to the group currently selected in the header.

5. Editing a Device

An existing device can be adjusted at any time.

1. Select the desired device in the table and click Edit (alternatively, double-click the row).
2. The Edit device dialog opens with the loaded device data.
3. Adjust the desired fields.
4. Click Save.

The Edit button is only active when exactly one device is selected. Only one dialog can be open at a time; the dialog can be moved.

6. Device Fields and Assignment

The following details are recorded in the device form:

Between the Driver and Vehicle fields, the form shows the hint OR.

Assignment to Driver or Vehicle

A device can be assigned either to a driver or to a vehicle – the two fields are mutually exclusive:

• If a driver is selected, the Vehicle field is deactivated.
• If a vehicle is selected, the Driver field is deactivated.
• If the selection made is removed again, the respective other field becomes available once more.

Both fields offer autocomplete: while typing, matching drivers or vehicles are suggested for selection.

7. IMEI Check and Duplicate Control

When saving, the entered IMEI is checked on the server side.

• Format check: The IMEI must consist of exactly 15 digits and have a valid check digit. With an invalid IMEI, saving is rejected with a corresponding error message.
• Duplicate check: An IMEI may only be used once within the same group. If the entered IMEI is already assigned to another device in the same group, saving is prevented with a notice about the duplicate.

In these cases, correct the IMEI and save again.

8. Deleting a Device

Devices that are no longer needed can be removed from the overview.

1. Mark one or more devices in the table.
2. Click Remove in the toolbar.
3. Confirm the security prompt Are you sure you want to delete this item?.

The marked devices are removed from the list. Deleting several devices at once is supported.

9. Toolbar, Layout and Templates

The toolbar of the device overview provides tools for editing and for adjusting the table:

• Add / Edit / Remove: Record, edit and delete devices.
• Select all listed / Deselect all: Mark all listed devices or clear the marking.
• Refresh: Reload the list.
• Search: Search the list for a search term.
• Erase filter: Reset the filters that have been set.
• Export: Export the table.
• Add template / Layout settings: Save and manage table templates.
• Settings: Adjust the table view.
• Reset table view to default: Restore the default view of the table.

The column arrangement and width as well as custom fields are saved per user and are retained after logging out.

10. Summary: Available Actions