Buzz supports the rostering of users, courses, enrollments, and observers through the 1EdTech (formerly IMS) OneRoster specification. The sync makes rostering easy, automated, and secure.
OneRoster is a 1EdTech specification for exchanging data between systems. Commonly, this exchange will happen between the student information system (SIS) and the learning management system (LMS). Buzz supports OneRoster 1.1.
Only Buzz users with the Administrator role in the domain can set up and review SIS sync information.
Configuring your SIS sync consists of:
1. Set up your SIS sync settings
- Open the More menu on the Admin > Domain screen, and select SIS sync.
- If you have not specified sync settings in your domain or want to change them, click Edit settings.
- On the General settings card:
- Choose your Time zone for courses and enrollment dates.
- Provide the Email addresses to which you want sync notifications sent. Notifications are sent after each sync and outline successes and any failures.
- On the Course settings card:
- Check the boxes to automatically:
- Create a base course for each domain in the uploaded file.
- Create a base course for each teacher in the uploaded file.
- Create a teacher base course for each term in the uploaded file.
- Use the dropdown to indicate whether you want to Delete or Do nothing with Un-shared courses (Un-shared courses are courses that exist in Buzz but not in your SIS).
- Check the boxes to automatically:
- On the Enrollment settings card:
- Choose which role in Buzz you want teachers to be given on upload.
- Choose which role in Buzz you want students to be given on upload.
- Use the dropdown to indicate which of the following you want to do with Un-shared enrollments on upload (Un-shared enrollments are enrollments that exist in Buzz but not in your SIS):
- Do nothing
- Mark as inactive
- Mark as withdrawn
- Delete
- Check the box if you want to Ignore start and end dates from the SIS and use them from Buzz.
- On the User settings card, use the dropdown to indicate which of the following you want to do with Un-shared users on upload (Un-shared users are users that exist in Buzz but not in your SIS):
- Do nothing
- Mark as inactive
- Delete
- Save.
Note: Currently, Buzz offers Grade passback as a beta feature that can be enabled and configured here.
Learn more: [Beta] How do I set up Grade passback for my SIS sync (with OneRoster)?
2. Sync your data
Once your settings are configured, you can start your sync by:
Your .zip file must contain the following CSV files for OneRoster integration:
- manifest.csv
- academicSessions.csv
- classes.csv
- courses.csv
- enrollments.csv
- orgs.csv
- users.csv
You can sync anytime you need, but we recommend syncing no more frequently than every 12 hours.
Upload your OneRoster .zip file in Buzz
To upload the .zip file in Buzz:
- Open the More menu on the Admin > Domain screen, and select SIS sync.
- Click Choose file.
- Find and select the .zip file for upload.
- Click Start sync. Your first sync should begin shortly after upload.
- Click the Status screen to check sync successes/failures and review sync history.
If you entered an email address in your SIS Sync settings, you will also receive a confirmation email.
Upload your OneRoster .zip file using FTP
To use FTP to upload the file or upload directly in Buzz, use the following:
- Your username is your userspace/username.
- Your password is your Buzz password
- The FTP location/URL is found in the Data Files screen for your domain.
The Admin > SIS Sync > Status screen displays your sync history along with successes/failures.
If you entered an email address in your SIS Sync settings, you will also receive a confirmation email.
