Informácie o šablónach na import záznamov do Apple School Managera
Spoločnosť Apple poskytuje šesť šablón, ktoré sa používajú pri pridávaní údajov do pracoviska:
Students (žiaci/študenti): Obsahuje informácie o študentských účtoch.
Staff (zamestnanci): Obsahuje informácie o zamestnaneckých účtoch, napríklad o účtoch vyučujúcich.
Courses (kurzy): Definuje kurzy.
Classes (triedy/skupiny): Obsahuje informácie o kurzoch a vyučujúcich (zamestnancoch).
Rosters (zoznamy): Obsahuje informácie o triedach/skupinách, žiakoch/študentoch a pracoviskách.
Locations (pracoviská): Obsahuje informácie o pracoviskách.
Šablóny a spravované účty Apple ID
Ak je voliteľné pole, napríklad person_number alebo sis_username, súčasťou formátu vášho spravovaného Apple ID, stáva sa z neho povinné pole. Ak ich necháte nevyplnené, nahrávanie cez SFTP zlyhá a zobrazí sa chyba MANAGED_ID_GENERATION_FAILED.
Príprava šablón
Pri príprave šablón musíte dodržať nasledujúce kritériá:
V šablónach students.csv a staff.csv musí byť hodnota person_id jedinečná pre všetky pracoviská.
Dôležité: Ak sa pri nahrávaní cez SFTP pokúsite nahrať nového používateľa a priradíte mu hodnotu person_id, ktorá už je priradená inému používateľovi, nový používateľ v Apple School Manageri prepíše existujúceho používateľa. Po dokončení prepísania budete daného používateľa môcť aktualizovať iba cez SFTP.
Ak šablóny upravujete, nahraďte ukážkové údaje vlastnými. Obsah riadka s nadpisom v jednotlivých súboroch nemeňte. V žiadnom súbore nevytvárajte duplicitné stĺpce. Do vybraných šablón môžete pridávať stĺpce.
V jednotlivých šablónach musí každý riadok reprezentovať jedinečnú hodnotu. Napríklad v súbore students.csv musí každý riadok reprezentovať jedinečného žiaka/študenta. Niektoré hodnoty daného žiaka alebo študenta môžete ponechať prázdne. Ak meno obsahuje literárne hodnoty, napríklad koniec riadka alebo otáznik, musíte ich zachovať escapovaním pomocou spätnej lomky (\). Napríklad takto: \". Všetky zadané identifikátory musia byť alfanumerické a môžu obsahovať spojovník (-).
Ak hodnota obsahuje medzeru ( ) alebo čiarku (,), vložte ju do anglických úvodzoviek ("). Ak hodnota žiadny z týchto špeciálnych znakov neobsahuje, úvodzovky nepoužívajte. Ak úvodzovky nepoužijete tam, kde sú potrebné, alebo ak použijete oblé úvodzovky, dôjde pri procese nahrávania k chybám.
Hodnoty v súboroch musia byť oddelené čiarkami (,) alebo bodkočiarkami (;) bez ohľadu na to, ako ste súbor vytvorili. Medzi čiarky alebo bodkočiarky a hodnoty, ktoré po nich nasledujú, nevkladajte žiadne medzery ani tabulátory. Každý súbor musí mať kódovanie UTF-8. Koniec riadka označíte kódom nového riadka \n systému UNIX.
Ak nejaký záznam zo skoršieho nahrania chýba, bude príslušný účet deaktivovaný a po 120 dňoch sa automaticky vymaže (to však neplatí, pokiaľ má daný účet zakúpený nejaký hromadný obsah).
Názvy súborov .csv by mali presne zodpovedať pôvodným názvom súborov.
Ak chcete súbory nahrať, musíte ich všetky skomprimovať do jedného archívu (.zip).
V jednotlivých priečinkoch archívneho súboru nesmú byť žiadne súbory.
Všetky odkazy s cudzím kľúčom na ďalšie súbory .csv musia byť definované v odkazovanom súbore.
Limit počtu znakov v šablónach .csv
Do niektorých polí v šablónach .csv je možné zadať iba obmedzený počet čísel alebo znakov.
Pole | Šablóny | Limit počtu znakov |
---|---|---|
first_name | Žiaci/študenti, zamestnanci | 32 |
middle_name | Žiaci/študenti, zamestnanci | 32 |
last_name | Žiaci/študenti, zamestnanci | 64 |
grade_level | Žiaci/študenti | 64 |
email_address | Žiaci/študenti | 256 |
person_number | Žiaci/študenti, zamestnanci | 64 |
person_id | Žiaci/študenti, zamestnanci, triedy/skupiny, zoznamy | 256 |
sis_username | Žiaci/študenti, zamestnanci | 256 |
class_id | Triedy/skupiny, zoznamy | 256 |
class_number | Triedy | 64 |
course_id | Kurzy, triedy/skupiny | 256 |
course_name | Kurzy | 128 |
course_number | Kurzy | 64 |
location_name | Pracoviská | 256 |
location_id | Žiaci/študenti, zamestnanci, kurzy, triedy/skupiny, pracoviská | 256 |