Informații privind șabloanele pentru importarea datelor în Apple School Manager
Pentru a adăuga date în Apple School Manager, puteți folosi fișiere .csv șablon în format Apple sau OneRoster.
Numele fișierelor .csv șablon de la Apple: Studenți, Personal, Cursuri, Clase, Liste componență, Sedii
Numele fișierelor .csv șablon de la OneRoster: Utilizatori, Cursuri, Clase, Înscrieri, Organizații
Nume fișier Apple | Nume fișiere OneRoster | Conținut | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Apple: conține informații privind conturile studenților. OneRoster: conține informații privind conturile studenților, instructorilor și ale personalului. | |||||||||||
N/A | Conține informații privind conturile membrilor personalului, cum ar fi instructorii. | ||||||||||
Conține informații despre cursuri. | |||||||||||
Conține informații despre clase și instructori (personal). | |||||||||||
Conține informații despre clase, studenți și sedii (liste de componență). | |||||||||||
Conține informații despre sedii (școală sau departament). | |||||||||||
Șabloane și conturi Apple gestionate
Dacă un câmp opțional, cum ar fi person_number sau sis_username, face parte din formatul dvs. cont Apple gestionat, acesta devine un câmp obligatoriu. Dacă îl lăsați necompletat, încărcarea SFTP eșuează cu eroarea MANAGED_ID_GENERATION_FAILED.
Pregătirea șabloanelor
Atunci când pregătiți un șablon, trebuie să îndepliniți următoarele criterii:
Structură
Numele fișierelor .csv trebuie să corespundă întocmai numelui de fișier original.
Nu schimbați numele rândului de antet în niciun fișier.
Nu ștergeți o coloană, chiar dacă aceasta este goală.
Puteți adăuga coloane la șabloanele studenți, membrii de personal și clase.
În fiecare șablon, fiecare rând trebuie să reprezinte o valoare unică. De exemplu, în fișierul students.csv, fiecare rând trebuie să corespundă unui singur student.
Pentru șabloanele students.csv și staff.csv, id_persoană trebuie să fie unic pentru toate sediile.
Important: Dacă utilizați SFTP pentru încărcarea unui utilizator nou și id_persoană pe care îl alocați este deja alocat altui utilizator, noul utilizator suprascrie utilizatorul existent în Apple School Manager. După ce suprascrierea este finalizată, puteți actualiza acel utilizator numai prin SFTP.
Anumite valori pot fi lăsate necompletate. De exemplu, în fișierul students.csv, al doilea prenume poate fi lăsat necompletat.
Înlocuiți datele folosite ca exemplu cu propriile date.
Formatare
Valorile literale, precum paragrafele sau ghilimelele din interiorul unui nume, trebuie să fie precedate de bare oblice inverse (\). Iată un exemplu: \". Orice identificatori introduși trebuie să fie alfanumerici și pot include cratime (-).
Dacă valoarea dvs. conține un spațiu ( ) sau o virgulă (,), încadrați semnul respectiv cu ghilimele drepte ("). Dacă valoarea dvs. nu conține niciunul dintre aceste caractere speciale, nu utilizați ghilimele. Dacă nu utilizați ghilimele atunci când acestea sunt necesare sau dacă utilizați ghilimele cursive, procesul de încărcare va genera erori.
Valorile din fișierele dvs. trebuie separate prin virgulă (,) sau punct și virgulă (;), indiferent de modul în care ați creat fișierul. Nu utilizați spații sau tabulatori între virgulă sau punct și virgulă și valoarea care urmează după semnul respectiv. Fiecare fișier trebuie criptat ca UTF-8. Pentru a reprezenta capătul liniei, utilizați criptarea linie nouă UNIX \n.
Toate referințele cu cheie externă la alte fișiere .csv trebuie definite în fișierul de referință.
Încărcare
În cazul în care lipsește o intrare dintr-o încărcare anterioară, contul de utilizator este dezactivat și șters automat după 120 de zile, cu excepția următoarelor situații:
Utilizatorul deține un rol care a achiziționat aplicații sau cărți angro
Utilizatorul este șters manual înainte de limita de 120 de zile
Toate fișierele trebuie comprimate într-o singură arhivă zip înainte de încărcare.
Niciun fișier din cadrul arhivei zip nu trebuie amplasat într-un director.
Limite de caractere în șabloanele .csv
Unele câmpuri din șabloanele .csv au limite în ceea ce privește numărul de caractere permise.
Numele atributului | Şabloane | Limită de caractere |
|---|---|---|
Apple: first_name OneRoster: givenName | Apple: Studenți, personal OneRoster: Utilizatori | 32 |
Apple: middle_name OneRoster: middleName | Apple: Studenți, personal OneRoster: Utilizatori | 32 |
Apple: last_name OneRoster: familyName | Apple: Studenți, personal OneRoster: Utilizatori | 64 |
Apple: grade_level OneRoster: note | Apple: Studenți OneRoster: Utilizatori | 64 |
Apple: email_address OneRoster: e-mail | Apple: Studenți OneRoster: Utilizatori | 256 |
Apple: person_number OneRoster: identificator | Apple: Studenți, personal OneRoster: Utilizatori | 64 |
Apple: id_persoană OneRoster: sourcedId | Appple: Studenți, Personal, Clase, Liste de componență OneRoster: Utilizatori, Clase, Înscrieri | 256 |
Apple: sis_username OneRoster: username | Apple: Studenți, personal OneRoster: Utilizatori | 256 |
Apple: id_clasă OneRoster: sourcedID | Apple: Clase, Liste de componență OneRoster: Clase, Înscrieri | 256 |
Apple: class_number OneRoster: classCode | Apple: Studenți, Clase OneRoster: Clase | 64 |
Apple: course_id OneRoster: sourcedID | Apple: Cursuri, Clase OneRoster: Cursuri, Clase | 256 |
Apple: course_name OneRoster: title | Apple: Cursuri OneRoster: Cursuri | 128 |
Apple: course_number OneRoster: courseCode | Apple: Cursuri OneRoster: Cursuri | 64 |
Apple: nume_sediu OneRoster: name | Apple: Sedii OneRoster: Organizații | 256 |
Apple: id_sediu OneRoster: sourcedID | Apple: Studenți, personal, cursuri, clase, sedii OneRoster: Utilizatori, Cursuri, Clase, Organizații | 256 |