A sablonokkal kapcsolatos tudnivalók a bejegyzések Apple School Managerbe való importálásához
Az Apple hat sablont biztosít a helyszínekhez történő adathozzáadás céljára:
Students (Tanulók): A tanulói fiókok adatait tartalmazza.
Staff (Munkatársak): A munkatársi (például az oktatói) fiókok adatait tartalmazza.
Courses (Tantárgyak): A tantárgyakat ismerteti.
Classes (Osztályok): A tantárgyakra és az oktatókra (munkatársakra) vonatkozó adatokat tartalmazza.
Rosters (Névsorok): Osztályokra, tanulókra és helyszínekre vonatkozó adatokat tartalmaz.
Locations (Helyszínek): A helyszínek adatait tartalmazza.
Sablonok és felügyelt Apple ID-k
Ha egy opcionális mező – például person_number vagy sis_username – része a felügyelt Apple ID-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 csak az adott felhasználót frissítheti SFTP-n keresztül.
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 fiók inaktiválódik és automatikusan törlődik 120 nap elteltével, hacsak a fiók mennyiségi tartalmat nem vásárolt.
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.
Mező | Sablonok | Karakterkorlát |
---|---|---|
first_name | Tanulók, Munkatársak | 32 |
middle_name | Tanulók, Munkatársak | 32 |
last_name | Tanulók, Munkatársak | 64 |
grade_level | Tanuló | 64 |
email_address | Tanuló | 256 |
person_number | Tanulók, Munkatársak | 64 |
person_id | Tanulók, Munkatársak, Osztályok, Névsorok | 256 |
sis_username | Tanulók, Munkatársak | 256 |
class_id | Osztályok, Névsorok | 256 |
class_number | Osztályok | 64 |
course_id | Tantárgyak, Osztályok | 256 |
course_name | Tantárgyak | 128 |
course_number | Tantárgyak | 64 |
location_name | Helyszínek | 256 |
location_id | Tanulók, Munkatársak, Tantárgyak, Osztályok, Helyszínek | 256 |