View the videos before starting the import process. RIGHT CLICK TO OPEN IN A NEW TAB.
Introduction:
Express offers an efficient way to import user data using CSV (Comma-Separated Values) files. This documentation outlines the structure of the CSV file, column order, and headers required for successful import. Additionally, it describes the optional features like password generation, custom attributes, and reportscope customization. The provided use case exemplifies the process with a practical scenario.
CSV Format and Column Headers:
The CSV file must adhere to the following format:
- The primary role for the user created.
- admin
- reportadmin
- assignmentadmin
- proctor
- User Name: Login username. Email is recommended.
- Password (optional): Login password. If not provided, a password will be automatically generated.
- First Name: User’s given name.
- Last Name: User’s surname.
- Email: (optional) Email address (must match the header "Email").
- Custom Attribute (optional): Additional attributes associated with the user.
- Reportscope (optional): Custom header value for restricting data access (e.g., "Teacher").
CSV Import Process:
- Prepare a CSV file according to the specified format and column headers.
- Access the import interface in the application.
- Paste (CTRL + V) the contents of the CSV file into the provided textbox.
- Click on the "Import" button to initiate the import process.
Password Guidelines:
Passwords, if provided, should adhere to the following criteria:
- Length: 8 to 20 characters.
- At least 1 uppercase letter.
- At least 1 lowercase letter.
- At least 1 numeric digit.
Custom Attributes:
Any custom attributes must follow these guidelines:
- Custom attributes can be included as additional columns.
- The header must match the desired attribute name.
-For siteadmin users, the import template should include column “Site,” with reportscope = “Site.”
- Values in the custom attribute columns will be associated with the respective user.
Reportscope Customization:
The "reportscope" field allows customizing access to examinee data for specific roles. For instance, by setting "reportscope" to "Teacher," instructors can access data related to their enrolled students only.
Use Case Example:
Institution A aims to limit instructors to viewing only students in their courses. To achieve this:
- Use the "reportscope" field and set it to "Teacher" for instructors.
- Include relevant user information in the CSV file, following the specified column order and headers.
Example CSV for Teacher:
Role,User Name,Password,First Name,Last Name,Email,teacher,school,reportscope reportadmin,thomsmith01@arlington.com,passwordts1,Thomas,Smith,thomsmith01@arlington.com, tomsmithteacher,arlington,teacher |
Example CSV for Siteadmin:
Role,User Name,Password,First Name,Last Name,Email,Site,reportscope siteadmin,joanlbell01@randel.com,passwordjbel1,Joan,Bell,thomsmith01@randel.com,Randell,Site |
Conclusion:
Express provides a straightforward approach to import user data using CSV files. By adhering to the outlined format, column headers, and optional features like password generation, custom attributes, and reportscope customization, users can efficiently manage their examinee data. The use case demonstrates how these features can be applied in a practical scenario.