Batch Import Devices/Users from a CSV file

Batch Import is a tool that allows creating users in batches, saving time and effort for the administrator of the application.

Importing users in batches, will usually require these generic steps:

1. Define a CSV file for each user group (eg: one CSV file for importing Operators, another CSV file for each device brand/model of device you want to import).

2. Define the User Type > Devices

3. Import the CSV file using Batch Import.

Enable Batch Import privileges

1. Go to your application properties in Site Admin

2. Enable the Privileges and Features > Admin > _BatchUserImport privilege.

User Type

The batch user import is based on User Types; therefore, before importing users a User Type needs to be defined. This can be done with the User type Editor.

1. Open the User Type Editor.

mceclip0.png

2. Specify a default device type to import.

mceclip0.png

3. Save the User Type.

 

Importing users

Prepare the CSV file

The CSV file for the type Device, needs to have a minimum of 2 fields: username and IMEI.

username,IMEI
User1,999111999111
User2,999111999112

Username: The username of the user that is being imported. This username should be unique in the server.
IMEI: The IMEI corresponding to the device that is being imported. IMEI number should be unique in the server.

Batch import

1. Access Batch Import Users from the Vehicles panel options.

mceclip1.png

2. Select which User Type you want to import. In this example, we'll use Device.

3. When the import is completed, you'll see the results on the screen:

mceclip1.png

 

Additional notes:

  • These steps have to be repeated for each group of devices of different brand/model. Keep in mind that you'll have to separate CSV files for each group.
  • Accumulator and Custom Field names are case sensitive.
  • A user can only be imported once, therefore, if the same file is imported twice, no extra users will be created. There is no undo for this function.