Use the OneRoster Classes template in Apple School Manager
Use the OneRoster Classes template to import classes. It must contain the course_id value of each course.
Classes with a manual source continue to sync with your mobile device management (MDM) solution but may no longer appear in the Classroom app. Manual classes can be deleted in Apple School Manager if you want to remove them from syncing.
Important: If a class is removed from the upload, students are removed from the class and the source changes to Manual. If courses were in use in Schoolwork, the class list is removed and a new course must be created for re-enrolment. If classes were in use in Schoolwork, progress data is deleted automatically and is no longer available to the instructor or student.
Value | Description | Example | Required/Unique | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
sourcedID | The number used to uniquely identify this class in your SIS or other database. Use the same sourcedID value to refer to this class in the rosters .csv file. | F9BF05A9-E40B-4CAD-9B4A-2E0C09EDCCC4 | Yes/Yes | ||||||||
courseSourcedID | The sourcedID of the course this class belongs to. | 5A3FAD0C-F725-44A4-9BDF-B7F9FF68EFF4 | Yes/No | ||||||||
schoolSourcedID | The sourcedID of the school or department this class belongs to. | 273FP3VY-F725-44A4-QQWS-B7F9FF68EFF4 | Yes/No | ||||||||
classCode | A number or code that identifies this class in your organisation. Unlike sourcedID, classCode is not used to refer to this class in the rosters .csv file. | 40 | No/No | ||||||||
classType | The type of class. There are two options: “homeroom” and “scheduled”. | homeroom | No/No | ||||||||
title | The name of the class. | Science | No/No | ||||||||
subjects | Subject name (or names) in human readable form. If the subjectCodes attribute is present, then the subjects and subjectCodes lists must have the same length and have order significance. | Science Math | No/No | ||||||||
subjectCodes | The subject code (or codes) in machine readable form. If more than one subject code is needed, use double quotes and separate with commas (per RFC 4180). If the subjects attribute is used, both values must have the same length and order. | Science Math | No/No | ||||||||
title | The name of the class. | Science | No/No | ||||||||
grades | The grade (or grades) for the class. The permitted vocabulary is from Common Education Data Standards (CEDS) version 5. For more information, see Entry Grade Level on the CEDS website. | 06 | No/No | ||||||||
periods | The time slots in the day for the class. If more than one period is needed, use double quotes and separate with commas. | “1,3,5” | No/No | ||||||||
location | Where the class is physically located. | School 120 | No/No | ||||||||
status | The status of the class record. There are two options: “active” or “tobedeleted” | active | No/No | ||||||||
dateLastModified | The date that this class information was last modified. Dates must be expressed using ISO 8601 format (more commonly formatted as YYYY-MM-DD). | 2024-06-26 | No/No |