Informace o šablonách pro import dat do Apple School Managera
K přidání dat do Apple School Managera můžete použít soubory šablon .csv ve formátu Apple nebo OneRoster.
Názvy šablon Apple .csv: Students, Staff, Courses, Classes, Rosters, Locations
Názvy šablon OneRoster .csv: Users, Courses, Classes, Enrollments, Orgs
Název souboru Apple | Název souboru OneRoster | Obsah | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Apple: Obsahuje informace o studentském účtu. OneRoster: Obsahuje informace o účtu studentů, instruktorů a personálu. | |||||||||||
Není k dispozici | Obsahuje informace o účtu personálu, například o vyučujících. | ||||||||||
Obsahuje informace o kurzech. | |||||||||||
Obsahuje informace o třídách a vyučujících (personálu). | |||||||||||
Obsahuje informace o třídách, studentech a umístění (rozpisy). | |||||||||||
Obsahuje informace o umístění (škola či katedra). | |||||||||||
Šablony a spravované účty Apple
Pokud je součástí vašeho formátu spravovaných účtů Apple i nějaké volitelné pole, třeba person_number nebo sis_username, stane se z něj pole povinné. Když ho necháte nevyplněné, nahrávání přes SFTP se nepodaří a nahlásí chybu MANAGED_ID_GENERATION_FAILED.
Příprava šablon
Při přípravě šablon je třeba splnit následující kritéria:
V případě šablon students.csv a staff.csv musí být hodnota person_id pro všechna místa jedinečná.
Důležité: Pokud se při nahrávání přes SFTP pokusíte nahrát nového uživatele a přiřadíte mu person_id, které už je přiřazené jinému uživateli, nový uživatel v Apple School Manageru přepíše stávajícího uživatele. Po dokončení přepsání budete tohoto uživatele moct aktualizovat jedině přes SFTP.
Pokud šablony upravujete, nahraďte ukázková data vašimi vlastními. Neměňte obsah řádku záhlaví v každém souboru. V žádném souboru nevytvářejte duplicitní sloupce. Do vybraných šablon můžete přidávat sloupce.
V každé šabloně musí každý řádek představovat jedinečnou hodnotu. Například v souboru students.csv musí každý řádek představovat jedinečného studujícího. Určité hodnoty pro tohoto studenta nebo studentku mohou zůstat prázdné. Znakové hodnoty – například znak zalomení řádku nebo otazníku uvnitř jména – musí být zapsány pomocí nouzového znaku — zpětného lomítka (\). Například takto: \". Jakékoli zadané identifikátory musí být alfanumerické a mohou obsahovat spojovník (‑).
Pokud vaše hodnota obsahuje mezeru ( ) nebo čárku (,), uzavřete ji do rovných anglických uvozovek ("). Pokud vaše hodnota žádný z těchto speciálních znaků neobsahuje, uvozovky nepoužívejte. Pokud nepoužijete uvozovky tam, kde je to potřeba, nebo použijete zahnuté uvozovky, během procesu nahrávání bude nahlášena chyba.
Hodnoty v souborech musí být odděleny čárkami (,) nebo středníky (;) bez ohledu na to, jak jste soubor vytvořili. Mezi čárku či středník a další hodnotu nevkládejte žádné mezery ani tabulátory. Každý soubor musí být kódován jako UTF‑8. Konec řádku zaznačte UNIXovým kódem pro nový řádek: \n.
Pokud nějaký záznam z dřívějšího nahrání chybí, bude příslušný účet deaktivován a po 120 dnech se automaticky smaže, pokud neplatí následující:
Uživatel má roli, která zakoupila větší množství aplikací nebo knih
Uživatel byl ještě před uplynutím 120denní lhůty ručně smazán
Názvy souborů .csv musí přesně odpovídat původnímu názvu souboru.
Všechny soubory je nutné komprimovat do jednoho archivního souboru (.zip), který se nahraje.
Uvnitř archivního souboru nesmí být žádné soubory uvnitř složek.
Veškeré odkazy cizího klíče na jiné soubory .csv je třeba definovat v odkazovaném souboru.
Limit počtu znaků v šablonách .csv
Některá pole v šablonách .csv mají omezený počet povolených znaků.
Název atributu | Šablony | Limit počtu znaků |
|---|---|---|
Apple: first_name OneRoster: givenName | Apple: Students, Staff OneRoster: Users | 32 |
Apple: middle_name OneRoster: middleName | Apple: Students, Staff OneRoster: Users | 32 |
Apple: last_name OneRoster: familyName | Apple: Students, Staff OneRoster: Users | 64 |
Apple: grade_level OneRoster: grades | Apple: Students OneRoster: Users | 64 |
Apple: email_address OneRoster: email | Apple: Students OneRoster: Users | 256 |
Apple: person_number OneRoster: identifikátor | Apple: Students, Staff OneRoster: Users | 64 |
Apple: person_id OneRoster: sourcedId | Apple: Students, Staff, Classes, Rosters OneRoster: Users, Classes, Enrollments | 256 |
Apple: sis_username OneRoster: username | Apple: Students, Staff OneRoster: Users | 256 |
Apple: class_id OneRoster: sourcedID | Apple: Classes, Rosters OneRoster: Classes, Enrollments | 256 |
Apple: class_number OneRoster: classCode | Apple: Students, Classes OneRoster: Classes | 64 |
Apple: course_id OneRoster: sourcedID | Apple: Courses, Classes OneRoster: Courses, Classes | 256 |
Apple: course_name OneRoster: title | Apple: Courses OneRoster: Courses | 128 |
Apple: course_number OneRoster: courseCode | Apple: Courses OneRoster: Courses | 64 |
Apple: location_name OneRoster: name | Apple: Locations OneRoster: Orgs | 256 |
Apple: location_id OneRoster: sourcedID | Apple: Students, Staff, Courses, Classes, Locations OneRoster: Users, Courses, Classes, Orgs | 256 |