Informácie o šablónach na import dát do Apple School Managera
Ak chcete pridať údaje do Apple School Managera, môžete použiť súbory šablón .csv naformátované spoločnosťou Apple alebo OneRoster.
Názvy šablón .csv od spoločnosti Apple: Študenti, Zamestnanci, Kurzy, Triedy, Zoznamy, Pracoviská
Názvy šablón .csv od spoločnosti OneRoster: Používatelia, Kurzy, Triedy, Zápisy, Organizácie
Názov súboru Apple | Názov súboru OneRoster | Obsah | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Apple: Obsahuje informácie o študentských účtoch. OneRoster: Obsahuje informácie o účtoch študentov, vyučujúcich a zamestnancov. | |||||||||||
Nie je k dispozícii | Obsahuje informácie o zamestnaneckých účtoch, napríklad o účtoch vyučujúcich. | ||||||||||
Obsahuje informácie o kurze. | |||||||||||
Obsahuje informácie o triedach a vyučujúcich (personál). | |||||||||||
Obsahuje informácie o triedach, študentoch a pracoviskách (zoznam). | |||||||||||
Obsahuje informácie o pracoviskách (škola alebo oddelenie). | |||||||||||
Š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 chýba záznam zo skoršieho nahrávania, používateľský účet sa deaktivuje a po 120 dňoch sa automaticky odstráni, pokiaľ:
Používateľ má rolu, ktorá hromadne zakúpila aplikácie alebo knihy.
Používateľ sa manuálne odstráni pred limitom 120 dní.
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.
Názov atribútu | Šablóny | Limit počtu znakov |
|---|---|---|
Apple: first_name OneRoster: givenName | Apple: študenti, personál OneRoster: používatelia | 32 |
Apple: middle_name OneRoster: middleName | Apple: študenti, personál OneRoster: používatelia | 32 |
Apple: last_name OneRoster: familyName | Apple: študenti, personál OneRoster: používatelia | 64 |
Apple: grade_level OneRoster: známky | Apple: študenti OneRoster: používatelia | 64 |
Apple: email_address OneRoster: e-mail | Apple: študenti OneRoster: používatelia | 256 |
Apple: person_number OneRoster: identifikátor | Apple: študenti, personál OneRoster: používatelia | 64 |
Apple: person_id OneRoster: sourcedId | Apple: študenti, zamestnanci, triedy/skupiny, zoznamy OneRoster: používatelia, triedy, zápisy | 256 |
Apple: sis_username OneRoster: používateľské meno | Apple: študenti, personál OneRoster: používatelia | 256 |
Apple: class_id OneRoster: sourcedID | Apple: triedy, zoznamy OneRoster: triedy, zápisy | 256 |
Apple: class_number OneRoster: classCode | Apple: študenti, triedy OneRoster: triedy | 64 |
Apple: course_id OneRoster: sourcedID | Apple: kurzy, triedy OneRoster: kurzy, triedy | 256 |
Apple: course_name OneRoster: názov | Apple: kurzy OneRoster: kurzy | 128 |
Apple: course_number OneRoster: courseCode | Apple: kurzy OneRoster: kurzy | 64 |
Apple: location_name OneRoster: názov | Apple: pracoviská OneRoster: Orgs | 256 |
Apple: location_id OneRoster: sourcedID | Apple: žiaci/študenti, zamestnanci, kurzy, triedy/skupiny, pracoviská OneRoster: používatelia, kurzy, triedy, organizácie | 256 |