Note: This article includes some beta features; we welcome your feedback as you test it out. If you encounter complications, please contact your SIS administrator and/or Agilix account manager to verify correct implementation and usage.
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. Review all of Buzz's 1EdTech certifications.
Only Buzz users with the Administrator role in the domain can set up and review SIS sync information.
Configuring and testing your SIS sync consists of:
These steps are covered below.
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 SIS settings [Beta] card, you can check the Allow rostering from the SIS box to use the OneRoster REST API to sync your data. To do this, you must provide the following values:
- SIS name (enter the name of the SIS).
- API Base URL (acquire from your SIS).
-
Authentication method:
- If you select Key and secret, provide:
- API Key (acquire from your SIS).
- API Secret (acquire from your SIS).
- API Token URL (optional, acquire from your SIS).
- If you select Access token, you need only to provide the Access token (acquire from your SIS).
- If you select Key and secret, provide:
If you are syncing with the ClassLink or PowerSchool SIS, do not check the Allow rostering from the SIS or Allow grades to be sent to SIS boxes during your configuration (Steps 3 &4).
Learn more:
- How do I set up ClassLink SIS sync in my Buzz domain? (an Agilix representative can help configure these options after you complete your steps).
- How do I set up PowerSchool SIS sync in my Buzz domain? (these options are not currently supported for PowerSchool syncs).
- You can also check the Allow grades to be sent to SIS to enable Grade passback [Beta].
- 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 were previously shared with and created in Buzz, but are no longer being shared).
- 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 were previously shared with and created in Buzz, but are no longer being shared):
- 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 were previously shared with and created in Buzz, but are no longer being shared):
- Do nothing
- Mark as inactive
- Delete
- Save.
2. Sync your data
Once you have set up your SIS sync settings, there are two ways to sync your OneRoster data in Buzz:
-
Using OneRoster's REST APIs, which enables direct system exchanges.
- API sync with Buzz [Beta]
- Using spreadsheet-style (CSV), which supports file importing. With this approach, you can do either of the following:
2.1. Use API sync [Beta]
Note: To sync using OneRoster's REST APIs, you must check the Allow rostering from the SIS box and complete the associated fields described in Step 3, above.
To use OneRoster REST APIs for direct system exchanges:
- Select the API sync tab on the SIS sync screen.
- Check the Validation-only mode box if you want to test for errors and get status messages before updating anything (recommended).
- Click Start API sync.
- Review sync Status report.
When you're satisfied with the Status, uncheck the Validation-only mode box and click Start API sync to start syncing.
Best practices
- You can sync anytime you need, but we recommend syncing no more frequently than every 12 hours.
- You can schedule the API sync to occur daily by reaching out to Agilix Support.
2.2. Use File sync
To upload OneRoster CSVs directly to Buzz, you may need to compress them in a .zip file. The .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
To upload the .zip file in Buzz:
- Select the File sync tab on the SIS sync screen.
- Click Choose file, and find and select the .zip file for upload.
- Check the Validation-only mode box if you want to test for errors and get status messages before updating anything (recommended).
- Click Start file sync. Your first sync should begin shortly after upload.
- Review sync Status report.
When you're satisfied with the Status, uncheck the Validation-only mode box and click Start file sync to start syncing.
Best practices
- You can sync anytime you need, but we recommend syncing no more frequently than every 12 hours.
- You can schedule the API sync to occur daily by reaching out to Agilix Support.
2.3. Use FTP
To upload OneRoster CSVs using FTP, FTPES, or SFTP, you may need to compress them in a .zip file. The .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
Buzz provides instructions (pictured) on how to use the FTP import.
- Your username is your userspace/username.
- Your password is your Buzz password
- The FTP location/URL is found in the FTP instructions screen for your domain.
The sync should begin almost immediately after importing, at which point you can review the sync Status report.
Best practices
- You can sync anytime you need, but we recommend syncing no more frequently than every 12 hours.
- You can schedule the API sync to occur daily by reaching out to Agilix Support.
3. Review sync Status
The Admin > SIS Sync > Status screen displays:
- Your sync history.
- Details, including successes/failures.
If you entered an email address in your SIS Sync settings, you will also receive a confirmation email.