User Group Import via the Data Loader

In this topic, we focus on importing user group data in bulk.  For information about creating and managing user groups in the User Manager, please see Configure and Manage User Groups.

To import user group data, your user role must have unrestricted access to the User Group Data Loader feature in System Roles (Manage Features > User Manager Features).

Create the CSV File

To create the CSV import file:

  1. Go to Manage Center > Users > Group and Organization > User Group Data Loader.
  2. Download the CSV file template. 

Prepare the File for Import

Once you have created the CSV import file, you prepare it for import by entering the necessary values in the fields. Please User Group Data Loader Field Reference for detailed information about the fields. The following fields are mandatory when adding or removing users:

  • Action
  • GroupName
  • UserID

Note that CSV files are likely to be opened by Microsoft Excel if it is installed on your system. If you encounter any problems with importing a CSV file into the LMS, it could be caused by Microsoft Excel applying extra formatting to the file. Alternatively, you can edit CSV files in a text editor instead of Microsoft Excel. The data should conform to the formatting required by the template as specified in the corresponding CSV Formatting Help.

If the values for text area fields include punctuation, these fields must be enclosed in double quotation marks (" "). Do not include commas or semicolons in other fields as they could be interpreted as a field delimiter (depending on your choice of delimiter at import).

Import User Group Data

To import user group data via the User Group Data Loader

  1. Go to Manage Center > Users > Group and Organization > User Group Data Loader.
  2. Click + Import CSV file.
  3. Click Choose File to select the CSV file to upload.
  4. If your CSV file was saved with a specific file encoding the LMS can automatically detect it, otherwise you can select it from the list.
  5. Select the delimiter used to separate fields in your CSV file. This can be a comma or a semicolon.
  6. To allow the data loader to create a new user group from the import, click the Create any new user groups found in the CSV file checkbox.
  7. Click Preview. The contents of the CSV file are shown in the Data Loader page so that you can review the data before importing the file.
  8. Click Upload to import the CSV file. The Summary Report shows how many records in the file were imported successfully and how many failed.
  9. If any records failed to import, you can go back to the User Group Data Loader page and click the CSV Error Report link for the failed import. The error report downloads to your desktop as a copy of the imported file that includes the error message.