Administrator

Buzz allows you to batch import large sets of data directly into your domain anywhere you see an Import button in the Admin app. Just click Import and upload a tab-delimited or comma-separated file with your data.

Buzz allows you to set up and edit courses, users, enrollments, and other data by importing a tab-delimited values text file (.txt) or a comma-separated values file (.csv). These file types use plain text and pre-determined (according to the type of imported data) fields to organize data as tables. Review the sections below to learn more about each type of import and the supported fields associated with each.

Although the fields you're required to include in your file vary based on the type of data you're importing (e.g., users, enrollments, courses, etc.,), the formatting rules remain the same. To format a tab-delimited or comma-separated file:

1. On the first line, list the supported fields you want to define, separating each with only a comma (no spaces). Think of these as your table headers. For example, if you wanted to create a course import file that defines the Action, Title, and Course Id fields, your first line would look like this:

Action,Title,Course Id

2. On the next line, provide content about a course for each of the fields you entered on the first line. So, if you want to add a course titled Geometry 1 with course_1 as its course ID, your second like would look like this:

Action,Title,Course Id
Add,Geometry 1,course_1

3. Repeat step two for every course you want to edit with this import.
   • You can indicate that you want no edits made to a field in the middle of a line by entering no content between commas (see line three). If you don't want to make changes to the field at the end of the line, simply leave it out (see line four).
   • You can clear existing data for a field by entering double quotes space double quotes " " in its field (see line five).

Action,Title,Course Id
Add,Geometry 1,course_1
Edit,,course_3
Delete,Geometry 3
Edit," ",course_4

Importing course data allows you to edit many courses in one process.

The table below lists and describes the supported fields you can include in your tab-delimited or comma-separated file when importing course information.

Importing enrollment data allows you to assign many students to specific courses in a single process.

Each enrollment row in the file assigns a user to a course. Users are identified by their User External ID, and courses are identified by their Course External ID. Both fields are set by the administrator and should contain a unique ID for the item. Often the External ID is the ID of the item from an external system.

The following table lists and describes the supported fields you can include in your tab-delimited or comma-separated file when importing enrollments.

Importing objective data allows you to create large sets of objectives in one process.

The following table lists and describes the supported fields you can include in your tab-delimited or comma-separated file when importing objectives.

Importing observer data allows you to edit observer roles in one process.

The following table lists and describes the supported fields you can include in your tab-delimited or comma-separated file when importing observers.

Importing permissions data allows you to update multiple permissions associated with users, entities, roles, and flags.

The table below lists and describes the supported fields you can include in your tab-delimited or comma-separated file when importing permissions information.

For formatting help, see Formatting tab-delimited and comma-separated files for import.

Importing user data allows you to set up many users in one process.

The following table lists and describes the supported fields you can include in your tab-delimited or comma-separated file when importing user data. The third column indicates which fields can be used for editing users.

When working with multiple domains, you sometimes need to specify which domain you want to use for enrollments.

You don't need to specify the domain when:

• Referencing users or courses in the current working domain.
• The id of the item is globally unique, as is the case with internal ids.

You need to specify the domain when:

• You reference users or courses in a different domain than the working domain.

All domain identifiers in this case have a User, Course, or Enrollment prefix. You could, for example, create an enrollment in one domain, with a user from a second domain, and a course from a third domain.

To specify a domain, use one of these fields with the appropriate identifiers with this syntax:

[Type Identifier] [Domain Identifier]

The following example specifies a user in the domain with login prefix myschool, by using the username and login prefix for the user.

UserName,Login Prefix
jsmith,myschool