Get Started with OneRoster v1.1 CSV
What is OneRoster?
“OneRoster is the standard specification for securely sharing class rosters and related data between a student information system (SIS) and any other system, typically a content application or learning information system (LMS). The OneRoster standard supports spreadsheet-style (CSV) export-import as well as direct system exchanges using REST API’s.” -1EdTechGreat Minds supports bulk-formatted OneRoster v1.1 CSV files to roster schools, users, classes, and enrollments.
Districts can use this option if they are able to export bulk-formatted OneRoster v1.1 CSV zip files from their Student Information System (SIS) and then send those files via SFTP to Great Minds.
Supported Files
Great Minds requires the following files: classes.csv, enrollments.csv, orgs.csv, and users.csv. Optional files may be included in the zip file but will not be processed. Each file must contain all columns (required and optional) listed in the order specified by 1EdTech.Click the links to review the file specifications for each file:
- manifest.csv (optional)
- academicSessions.csv (optional)
- classes.csv
- courses.csv (optional)
- demographics.csv (optional)
- enrollments.csv
- orgs.csv
- users.csv
Great Minds can support users with multiple roles through the use of a custom metadata field. In the users.csv file, include the optional "metadata.gm.additionalroles" column. For users that should have an additional role, add the desired additional role into this field: district_admin, school_admin, or teacher. Student users cannot have multiple roles.
Configure SFTP
To send your bulk-formatted OneRoster v1.1 CSV files, you must set up an SFTP connection with Great Minds.Troubleshooting Errors
We first recommend downloading the OneRoster sync reports and resolving any errors listed in the sync report file(s).If you need assistance resolving sync report errors, or have additional questions, please fill out a support ticket or reach out to your Digital Implementation Specialist.