Używanie szablonu danych rejestracji OneRoster w usłudze Apple School Manager
Szablon danych rejestracji OneRoster służy do importowania list uczestników zajęć przy użyciu SFTP. W ramach organizacji każda wartość sourcedID musi być unikatowa — w każdym wierszu każdego szablonu sourcedID każdej lokalizacji. Jeśli na przykład szablon danych rejestracji OneRoster zawiera dane 600 uczestników, oznacza to, że zawiera 600 wierszy unikatowych wartości sourcedID, wartość sourcedID każdego uczestnika oraz powiązaną z uczestnikiem wartość sourcedID.
Musi również zawierać wartość class sourcedID kursu i przynajmniej jedną wartość student sourcedID. Dodatkowych uczestników należy dodać w osobnych wierszach. Na przykład dodanie 10 uczestników oznacza dodanie 10 wierszy, po jednym na każdego uczestnika.
Wartość | Opis | Przykład | Wymagana/Unikatowa | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
sourcedID | Liczba używana do unikatowego określenia tej rejestracji w systemie SIS lub w innej bazie danych. | BE8FF4CC-5BE2-47C6-9C42-6CDADB9072F8 | Tak/Tak | ||||||||
status | Status rekordu rejestracji. Istnieją dwie opcje: „active” lub „tobedeleted”. | active | Nie/Nie | ||||||||
dateLastModified | Data ostatniej modyfikacji informacji o tej rejestracji. Daty muszą być zapisywane w formacie ISO 8601 (najczęściej zapisywanym w formie RRRR-MM-DD). | 2024-06-26 | Nie/Nie | ||||||||
classSourcedID | Wartość sourcedID klasy. | F9BF05A9-E40B-4CAD-9B4A-2E0C09EDCCC4 | Tak/Nie | ||||||||
schoolSourcedID | Wartość sourcedID szkoły lub zespołu szkół, do których jest przydzielona ta klasa. | DF48675-8307-446A-BAA9-EDEA567493D3 | Nie/Nie | ||||||||
userSourcedID | Wartość sourcedID uczestnika zajęć w klasie lub prowadzącego, który prowadzi zajęcia w klasie. | AE4A6BB3-8D97-446A-BAA9-EDEA567453D3 | Tak/Nie | ||||||||
role | Rola tej osoby. Istnieją dwie opcje: „student” i „teacher”. | student | Tak/Nie | ||||||||
primary | Dotyczy tylko użytkowników z rolą „teacher”. Istnieją dwie opcje: „true” i „false”. Tylko jeden użytkownik powinien zostać wyznaczony jako primary teacher (główny nauczyciel) dla klasy w okresie zdefiniowanym przez daty rozpoczęcia i zakończenia. | TRUE | Nie/Nie | ||||||||
beginDate | Data rozpoczęcia rejestracji. Data ta musi być zgodna z powiązaną sesją akademicką (semestrem) określoną dla danej klasy. | 2026-08-22 | Nie/Nie | ||||||||
endDate | Data zakończenia rejestracji (ekskluzywna). Data ta musi być zgodna z powiązaną sesją akademicką (semestrem) określoną dla danej klasy. | 2027-05-30 | Nie/Nie | ||||||||