Buzz supports roster syncing with ClassLink through the 1EdTech (formerly IMS) OneRoster specification. The sync makes rostering easy and secure. Review all of Buzz's 1EdTech certifications.
OneRoster is a 1EdTech specification for exchanging data between systems. Buzz supports OneRoster 1.1.
Only Buzz users with the Administrator role in the domain can set up and review SIS sync information.
Setting up an SIS sync requires working in both Buzz and ClassLink at the same time, so it's best to have both systems open while doing it.
This article covers how to configure your ClassLink rostering sync:
- In Classlink: Add Agilix Buzz to your ClassLink Roster Service and specify Permissions
- In Buzz: Set up your Buzz SIS sync settings
- In Buzz and ClassLink: Configure SFTP or REST API rostering
This article references many of the steps outlined in ClassLink's article: Adding Applications & Modifying Permissions
1. In Classlink: Add Agilix Buzz to your ClassLink Roster Service and specify Permissions
First, you need to add Agilix Buzz to your approved Apps in ClassLink.
- Open the Apps tab in your toolbar.
- Click + Add.
- In the Name field, search for Agilix Buzz.
- Click the + Add button.
Note: Because Agilix Buzz is a certified ClassLink vendor, you don't need to enable the Show Development Apps toggle.
- With Buzz added, you can define vendor permissions. Permissions specify how much access Buzz can have to your data. Roster Server offers three permission types:
- Rule-Based, ClassLink's recommended permission type, lets you choose permissions based on roster data.
- Full sends all student and staff data to the application.
- Legacy Custom builds dependencies from orgs and courses.
2. In Buzz: Set up your Buzz SIS sync settings
Now, you need to set up your SIS sync settings in Buzz.
To do this, follow the Set up your SIS sync settings instructions in this article: How do I sync with Student Information Systems (SIS) in Buzz?
Note: When setting up a ClassLink sync, leave the boxes in the SIS settings [beta] card unchecked. They will be configured by your Agilix representative if needed. (This means you can skip Steps 3 & 4 in the Set up your SIS sync settings instructions.)
3. In Buzz and ClassLink: Configure SFTP or REST API rostering
Now that ClassLink and Buzz are set up, you can configure your rostering to sync in one of two ways:
3.1. SFTP in ClassLink: Export CSV files for SFTP
In order to export and import your CSV files in ClassLink using SFTP, you need some information from Buzz:
- Your username is your userspace/username.
- Your password is your Buzz password.
- You can find your FTP configuration details in the Domain settings > SIS sync > FTP instructions screen for your domain.
Now you're ready to export your CSV files from ClassLink. To do so, follow ClassLink's directions: Exporting Data With SFTP> Setting up SFTP, using the information provided above to complete the relevant fields.
Once you've finished exporting from ClassLink, the sync should begin almost immediately at which point you can review the sync Status report.
3.2. REST API in ClassLink: Contact your Agilix representative
If you want to sync your data using the REST API, follow ClassLink's directions: Using the REST API. Contact your Agilix representative to acquire the information you need in completing this sync setup (please include a link to this article in your request).
When it's complete, you can review the sync Status report.
For use by Agilix support: Internal-only support article.