• “Download Classlist” button allows you to download the classlist as a formatted csv file with the following fields: Username, FirstName, LastName, Role, Email, GroupName, GroupCode, GroupCategoryName, and Action.
• The “Action” field in the downloaded file will always be blank. It’s added for your convenience so that you can populate it when importing a .csv file (next step).
• If a user has no group enrollments, then there will be at least one line with the user information but a blank GroupName, GroupCode and GroupCategoryName.
• Every group will have at least one line with no Username and only GroupName, GroupCode and GroupCategoryName (all other fields will be blank) at the bottom of the file so that there is an overview of all groups.
• If there is a group category with no groups, there will be at least one line with only GroupCategoryName (all other fields will be blank) at the bottom of the file.
• If a user is enrolled in multiple groups, that user will be listed multiple times; every group enrollment will be on a new line.
• If a user is not visible in the classlist, they will not be shown in the downloaded file either.

Here is an example of Download Classlist output file:

The Import section allows you to customize enrollments in groups by uploading a formatted .csv file.

Here is an Import File Sample that, when imported, will enroll Student 1 into Group 1, unenroll Student 2 from Group 2, and then enroll Student 2 into Group 1.

The import file must meet the following requirements:

• The users that are to be enrolled into groups must already be enrolled in the course itself.
• The group categories must already exist in the course.
• The widget can only understand 2 types of Actions: “Enroll” and “Unenroll”.
• Lines with a blank Action field will be ignored.
• Lines with errors/typos in the Action field will result in an error.
• Actions are case-insensitive, so, e.g., “enroll”, “Enroll” and “ENROLL” will work.
• The files can be partial uploads: If the action field (Enroll/Unenroll) is left blank, the widget will ignore that line, which will result in no action and no error.
• Lines with only GroupName, GroupCode, and GroupCategoryName but with a blank Username will result in no action and no error unless you specify an action (Enroll/Unenroll) in the Action field; in such cases, it will result in an error.
• Lines with only GroupCategoryName will result in no action and no error unless you specify an action (Enroll/Unenroll) in the Action field; in such cases, it will result in an error.
• You can create new groups with the .csv file; if the widget cannot find an existing group with the provided name within the specified category, it will first create a new group and then enroll the user.
• Names of groups that Admin Users try to create must be unique within the course.
• When creating groups, GroupCode field may be left blank as the widget will generate a unique group code.
• Lines that create groups may not have a blank Username.
• Lines that create groups must have the “Enroll” action in the Action field.
• The import file must be a formatted .csv file.
• The import file name must start with “classlist_”.
• You can upload only one file at a time.
• The file size must not exceed 500KB.
• The maximum number of users to be enrolled/unenrolled must not exceed 1000, i.e., the maximum number of rows is 1001.
• The file header must contain the following fields: Username, FirstName, LastName, Role, Email, GroupName, GroupCode, GroupCategoryName, Action.
• The fields that must be valid for the import to work include Username, GroupName, GroupCategoryName and Action (they may not be left blank); other fields are optional.

If any lines result in an error, the widget will generate and download a .csv file where the errors along with their descriptions will be listed in the last column (“Errors”). For example, the action field is "ENROLLL" (triple "L") instead of "ENROLL" (double "L"):

See some examples of errors below.

• The widget only accepts 2 types of Actions: “Enroll” and “Unenroll” (case-insensitive).

• The group category name provided does not exist in the course.

• The group name provided does not exist in the course.

• The username provided does not exist in the course classlist.

• The group with such a name already exists in the course.

• Group that you were trying to create has not been created due to an error.

• Unenrollment action failed.

• Enrollment action failed.

You can create seven different categories in Brightspace:

1. # of Groups - no Auto Enrollment: n groups. This allows you to determine the total number of groups you want to create. You can enter this number under Number of Groups. With this option you can add students to groups yourself.
2. Groups of #: groups with a maximum of n students. This option allows you to indicate the maximum number of students per group (with a limit of 200 students). You enter this number under Number of users. Brightspace then automatically adds students to groups.
3. # of Groups: n groups. This option determines the number of groups you want to create. You can enter this number under Number of Groups. Brightspace then automatically adds students to groups.
4. Groups of # - Self Enrollment: Groups with a maximum of n students. This option allows you to indicate the maximum number of students per group (with a limit of 200 students). You enter this number under Number of users. Students can then choose their own group to register with.
5. # of Groups - Self Enrollment: n groups. This option allows you to determine the total number of groups you want to create. You can enter this number under Number of Groups. Students can then choose their own group to register with.
6. # of Groups, Capacity of # - Self Enrollment: n groups with a maximum of n students. This option allows you to determine the total number of groups you want to create and the maximum number of students per group (with a limit of 200 students per group). You can enter the number of groups under Number of Groups and the number of students per group under Number of Users. Students can then choose their own group to register with.
7. Single user, member-specific groups: personal group per student. This option creates a separate group for each student. You can choose this option if you want to work with blogs or progress reports. Students can then write a blog in a personal and private discussion forum.

With options 2 and 3 you can change the following via Advanced Properties:

• Auto-Enroll New Users: Brightspace automatically adds all students joining the course after the groups are created. (Students are always added to the group with the least number of students; this option ensures that there are no groups without participants.)
• Randomize users in Groups: students are randomly added to a group. If this option is not checked, students will be added in alphabetical order if this option is not checked)

With options 4, 5 and 6 you can change the following via Advanced Properties:

• Set a start date (Start Date) and/or end date (Expiry Date) for the period in which students can register themselves for a group. After the end date, students can no longer join or leave a group. Enter a date or choose Now to start or stop the self-registration immediately.
• Add students who have not enrolled in a group to a group via Allocate unenrolled users. This happens automatically after the end date has passed. Students are randomly added to a group. The group capacity could be ignored depending on the number of groups and students.

The example above uses the fifth option: four groups that students are allowed to self-enroll in (# of Groups - Self Enrollment, Number of Groups: 4). With this option you can set an end date for enrollment and ensure that students are automatically enrolled in a group after the end date (these options can be found under Advanced Properties).

1. Optional: Set a Group prefix (e.g. Sem-). All group names then start with the prefix, followed by a sequence number (for example Sem-1, Sem-2, Sem-3 and Sem-4).
2. Optional: Set a start and end date and time for Self Enrollment.
   • Check Allocate unenrolled users after Self Enrollment Expiry Date if you want students to be automatically assigned to groups after the deadline.
3. You can check one or more of the following options under Additional Options:
   • A Discussion forum and topic.
   • A Locker (a group-specific digital storage space so that a group can share files digitally without the intervention of other students).
   • An Assignment hand-in folder.
4. Click Save. If you have chosen one of the extra options, you will now go to the function that makes it possible to make the chosen options. The groups are created in the background, and you will be notified when it is complete. You will now return to the Manage Groups page.

In addition, when creating new groups, you can choose from which groups or sections you want to restrict enrollments via Restrict Enrollments To. This means that students can only be registered for a group if they are also in the clicked group or section.

In Manage Groups you can:

• See the group categories and groups.
• Create new categories.
• Customize categories and groups.
• See which students are in which group.
• Delete categories and groups.
• Send an email to all students in a specific group.

1. Click the arrow under View Categories to jump to a specific category and view the groups it contains.
2. The number after the name of the category (Workgroups (5)) indicates the number of groups that are in the category. By clicking on the arrow behind the name of the category you can:
   • edit the category (Edit Category). You can use this function to add a discussion topic or locker if you already created the category but didn't do it right away.
   • add a group (Add Group).
   • add students to a group (Enroll Users). This option opens a screen where you can add students from the classlist in groups in this specific category.
   • Delete all groups in a category (Delete)
   • Email all students in groups in this category (Email)
3. If you want to create a new group category (for example for a lecture or a seminar), you can click on New Category and repeat the steps indicated above.
4. Click on the number in the Members column to see which students are in the group.
5. If you want to delete a group or email every member of the group, click the check mark for a particular group and choose the Delete or Email option. When you send an email via this option, all email addresses are in the BCC for privacy reasons.
6. You can edit or add a group's description by clicking on the name of the group in question.

If you want to know more about creating groups, watch this video from the Brightspace supplier D2L. Some screens have a different appearance than the Brightspace environment of Saxion.