Informace o šablonách pro import záznamů do Apple School Manageru
Společnost Apple poskytuje šest šablon, které se používají při přidávání dat do vašeho místa:
Studující: Obsahuje informace o studentských účtech.
Personál: Obsahuje informace o personálu, např. vyučujících.
Kurzy: Definuje kurzy.
Třídy: Obsahuje informace o kurzu a vyučujících (personálu).
Rozpisy: Obsahuje informace o třídách, studujících a místech.
Místa: Obsahuje informace o místech.
Šablony a spravovaná Apple ID
Pokud je součástí formátu vašeho spravovaného Apple ID i nějaké volitelné pole, třeba person_number nebo sis_username, stává 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 (to ale neplatí, pokud má tento účet zakoupený nějaký hromadný obsah).
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ů.
Pole | Šablony | Limit počtu znaků |
---|---|---|
first_name | Studující, personál | 32 |
middle_name | Studující, personál | 32 |
last_name | Studující, personál | 64 |
grade_level | Studující | 64 |
email_address | Studující | 256 |
person_number | Studující, personál | 64 |
person_id | Studující, personál, třídy, rozpisy | 256 |
sis_username | Studující, personál | 256 |
class_id | Třídy, rozpisy | 256 |
class_number | Třídy | 64 |
course_id | Kurzy, třídy | 256 |
course_name | Kurzy | 128 |
course_number | Kurzy | 64 |
location_name | Místa | 256 |
location_id | Studující, personál, kurzy, třídy, místa | 256 |