Sabloninformációk adatok az Apple School Managerbe való importálásához
Az adatok az Apple School Managerhez való hozzáadásához Apple vagy OneRoster által formázott .csv-sablonfájlokat használhat.
A .csv-sablonok neve az Apple-ben: Tanulók, Munkatársak, Tantárgyak, Osztályok, Helyszínek
A .csv-sablonok neve a OneRosterben: Felhasználók, Tantárgyak, Osztályok, Regisztrációk, Szervezetek
Apple-fájlnév | OneRoster-fájlnév | Tartalom | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Apple (Tanulók): A tanulói fiókok adatait tartalmazza. OneRoster (Felhasználók): A tanulói, oktatói és munkatársi fiókok adatait tartalmazza. | |||||||||||
N. a. | (Munkatársak): A munkatársi (például az oktatói) fiókok adatait tartalmazza. | ||||||||||
(Tantárgyak): A tantárgyak adatait tartalmazza. | |||||||||||
(Osztályok): Az osztályokra és az oktatókra (munkatársakra) vonatkozó adatokat tartalmazza. | |||||||||||
(Regisztrációk): Osztályokra, tanulókra és helyszínekre vonatkozó (névsor-) adatokat tartalmaz. | |||||||||||
(Helyszínek): A helyszínre (az iskolára vagy a részlegre) vonatkozó adatokat tartalmaz. | |||||||||||
Sablonok és felügyelt Apple-fiókok
Ha egy opcionális mező – például person_number vagy sis_username – része a felügyelt Apple-fiók formátumnak, akkor az kötelező mező lesz. Ha üresen hagyja, az SFTP-feltöltés nem sikerül a MANAGED_ID_GENERATION_FAILED hiba miatt.
Sablonok készítése
A sablonok készítésekor az alábbi kritériumokat kell betartani:
A tanulói (students.csv) és a munkatársi (staff.csv) sablonoknál a személyazonosítónak (person_id) minden helyszín vonatkozásában egyedinek kell lennie.
Fontos: Ha SFTP segítségével tölt fel egy új felhasználót, és a hozzárendelt person_id már egy másik felhasználóhoz van rendelve, akkor az új felhasználó felülírja a meglévő felhasználót az Apple School Managerben. A felülírás után az adott felhasználót csak SFTP-n keresztül frissítheti.
A sablonok szerkesztésekor a példaként megadott adatokat cserélje le a saját adataira. Egyik fájlban se változtassa meg a fejlécsor tartalmát. Egyik fájlban se szerepeltessen duplikált oszlopot. Hozzáadhat oszlopokat bizonyos sablonokhoz.
Az egyes sablonokban minden egyes sornak egyedi értéket kell képviselnie. A tanulói (students.csv) fájlban például minden egyes sornak egy egyedi tanulót kell képviselnie. Az adott tanulóra vonatkozó bizonyos értékek lehetnek üresek. A literális értékeket – például egy néven belüli sortörést vagy idézőjelet – fordított perjellel (\) le kell védeni. Íme egy példa: \". Minden megadott azonosítónak alfanumerikusnak kell lennie, és tartalmazhat kötőjelet (-).
Ha az érték szóközt ( ) vagy vesszőt (,) tartalmaz, tegye egyenes idézőjelek (") közé. Ha az értékben nem szerepel semmilyen fent említett speciális karakter, ne használjon idézőjeleket. Ha a szükséges helyeken nem használ idézőjeleket, vagy kunkorodó idézőjeleket használ, a feltöltési folyamatban hibák keletkeznek.
A fájlokban szereplő értékeket vesszővel (,) vagy pontosvesszővel (;) kell egymástól elkülöníteni, a fájl létrehozási módjától függetlenül. Ne használjon szóközt vagy tabulátort vessző vagy pontosvessző és az azt követő érték között. Minden fájlt UTF-8-ban kell kódolni. A sor végének jelzéséhez használja a UNIX sortörési kódot \n.
Ha egy bejegyzés hiányzik egy korábbi feltöltésből, a felhasználói fiók inaktiválódik és automatikusan törlődik 120 nap elteltével, kivéve a következő esetekben:
A felhasználó olyan szerepkörrel rendelkezik, amely nagy tételben vásárolt alkalmazásokat vagy könyveket
A felhasználót manuálisan törlik a 120 napos korlát előtt
A .csv-fájlok nevének pontosan egyezniük kell az eredeti fájlok nevével.
A feltöltéshez az összes fájlt egy tömörített (.zip) archív fájlba kell tömöríteni.
A tömörített archív fájlon belül semmilyen fájl nem helyezhető mappába.
A más .csv-fájlokra hivatkozó idegenkulcs-hivatkozásokat a hivatkozott fájlban kell definiálni.
Karakterkorlátok a .csv-sablonokban
A .csv-sablonok egyes mezői korlátozzák a beírható karakterek számát.
Attribútumnév | Sablonok | Karakterkorlát |
|---|---|---|
Apple: first_name OneRoster: givenName | Apple: Tanulók, Munkatársak OneRoster: Felhasználók | 32 |
Apple: middle_name OneRoster: middleName | Apple: Tanulók, Munkatársak OneRoster: Felhasználók | 32 |
Apple: last_name OneRoster: familyName | Apple: Tanulók, Munkatársak OneRoster: Felhasználók | 64 |
Apple: grade_level OneRoster: grades | Apple: Tanulók OneRoster: Felhasználók | 64 |
Apple: email_address OneRoster: email | Apple: Tanulók OneRoster: Felhasználók | 256 |
Apple: person_number OneRoster: identifier | Apple: Tanulók, Munkatársak OneRoster: Felhasználók | 64 |
Apple: person_id OneRoster: sourcedId | Apple: Tanulók, Munkatársak, Osztályok, Névsorok OneRoster: Felhasználók, Osztályok, Regisztrációk | 256 |
Apple: sis_username OneRoster: username | Apple: Tanulók, Munkatársak OneRoster: Felhasználók | 256 |
Apple: class_id OneRoster: sourcedID | Apple: Osztályok, Névsorok OneRoster: Osztályok, Regisztrációk | 256 |
Apple: class_number OneRoster: classCode | Apple: Tanulók, Osztályok OneRoster: Osztályok | 64 |
Apple: course_id OneRoster: sourcedID | Apple: Tantárgyak, Osztályok OneRoster: Tantárgyak, Osztályok | 256 |
Apple: course_name OneRoster: title | Apple: Tantárgyak OneRoster: Tantárgyak | 128 |
Apple: course_number OneRoster: courseCode | Apple: Tantárgyak OneRoster: Tantárgyak | 64 |
Apple: location_name OneRoster: name | Apple: Helyszínek OneRoster: Szervezetek | 256 |
Apple: location_id OneRoster: sourcedID | Apple: Tanulók, Munkatársak, Tantárgyak, Osztályok, Helyszínek OneRoster: Felhasználók, Tantárgyak, Osztályok, Szervezetek | 256 |