Folosirea SFTP pentru încărcarea datelor despre studenți, personal și clase în Apple School Manager

Dacă sistemul de informații despre studenți (SIS) nu este în prezent acceptat de Apple School Manager sau dacă nu ai un sistem de informații despre studenți, poți încărca date despre studenți, personal și clase în Apple School Manager folosind SFTP.

Atunci când configurezi SFTP în Asistentul de configurare, Apple School Manager îți dă fișiere șablon CSV și informații de acces pentru un server SFTP privat. Poți să exporți date din SIS sau să creezi fișierele într-o aplicație de calcul tabelar precum Numbers.

Încărcarea SFTP necesită o aplicație terță în macOS. Dacă nu ai instalat un client SFTP, poți găsi unul în Mac App Store.

Folosește butoanele de mai jos pentru a obține ajutor pentru configurarea fișierelor SFTP. Dacă nu ai folosit SFTP pentru a încărca date în Apple School Manager, trebuie să începi cu secțiunea Configurarea primei încărcări SFTP.

Configurarea primei încărcări SFTP

  1. Autentifică-te în Apple School Manager ca Administrator, Coordonator de centru sau Coordonator de persoane.
  2. Dacă este prima oară când te autentifici, va apărea Asistentul de configurare. Dacă Asistentul de configurare nu apare, fă clic pe numele tău în colțul din dreapta-sus. Alege Asistent de configurare.
  3. Fă clic la Găsiți studenți, membri de personal și clase.
  4. Fă clic pe Configurați SFTP.
  5. Apple School Manager generează un URL, un nume utilizator și o parolă pentru utilizare la încărcarea de fișiere. Folosește aceste informații pentru a configura clientul SFTP.
  6. Fă clic pe Descărcați șabloane.
  7. Citește instrucțiunile de utilizare a șabloanelor din secțiunea „Completarea fișierelor de date”.
  8. După ce fișierele de date sunt completate, creează o arhivă zip a tuturor celor șase fișiere. Selectează fișierele în Finder, apoi accesează meniul Fișier și alege Comprimă 6 elemente. Nu contează ce nume dai arhivei zip.
  9. Încarcă fișierul zip în Apple School Manager. Folosește un client SFTP pentru a te conecta la URL-ul arătat în Asistentul de configurare. Când ți se solicită informații de autentificare, utilizează numele de utilizator și parola pe care le-ai primit atunci când ai făcut clic pe Configurați SFTP. Copiază fișierul zip în directorul Dropbox.
  10. Fă clic pe Continuați în Asistentul de configurare. Dacă încărcarea are erori, poți examina un jurnal care identifică fișierele și liniile care conțin erori. Corectează toate erorile din fișierele de date, apoi repetă pașii 8 și 9. Nu este necesar să elimini fișierul anterior de pe serverul SFTP.
  11. După terminarea importului SFTP, fă clic pe Revizuiți datele SFTP. Dacă găsești erori, fă clic pe Anulați. Corectează toate erorile din fișierele de date, apoi repetă procesul de încărcare. Dacă datele sunt corecte și complete, fă clic pe Continuați.
  12. Sub Creați conturi și clase, alege un format de ID Apple gestionat pentru studenți, instructori și membri de personal. Fă clic pe Previzualizați conturile și clasele. După ce ID-urile sunt în formatul corect, fă clic pe Creați conturi și clase.
  13. După crearea conturilor, distribuie informații de autentificare utilizatorilor și atribuie roluri membrilor de personal.

Completarea fișierelor de date

Descărcarea de șabloane include șase fișiere cu valori separate prin virgulă (CSV) pentru Clase, Cursuri, Sedii, Liste, Studenți și Membri de personal. Dacă șabloanele nu sunt disponibile în Apple School Manager sau ai pierdut o copie a șabloanelor originale, poți să descarci șabloanele din nou.

Poți utiliza SIS pentru a exporta date în formatul descris de șabloane și în acest articol sau poți edita șabloanele într-un program de calcul tabelar precum Numbers.

Folosește tabelele din acest articol pentru a te asigura că introduci informațiile corecte, apoi salvează fiecare fișier fără a-i schimba numele.

Formatarea valorilor

Dacă editezi șabloanele, înlocuiește datele exemplificative cu datele proprii. Nu modifica conținutul celulelor de antet din fiecare fișier. Nu adăugi coloane în niciun fișier, cu excepția cazurilor descrise mai jos.

În fiecare șablon, fiecare rând trebuie să reprezinte o valoare unică. De exemplu, în fișierul students.csv, fiecare rând trebuie să fie un student unic. Anumite valori pentru studentul respectiv pot fi goale. Valorile literale, cum ar fi un caracter linie nouă sau ghilimele dintr-un nume trebuie precedate de un caracter linie oblică inversă (\), de exemplu, (\”). Orice identificatori introduși trebuie să fie alfanumerici și pot include un caracter „-”.

Dacă valoarea conține un spațiu ( ) sau o virgulă (,), folosește ghilimele drepte (") în jurul acesteia. Dacă valoarea are niciunul dintre aceste caractere speciale, nu folosi ghilimele. Dacă nu folosești ghilimele unde acestea sunt necesare sau dacă utilizezi folosești tipografice, procesul de încărcare va returna erori.

Valorile din fișiere trebuie să fie separate prin virgulă (,) sau punct și virgulă (;), indiferent de modul în care ai creat fișierul. Nu folosi spații sau tabulatori între virgulă sau punct și virgulă și valoarea care urmează. Fiecare fișier trebuie să fie codificat UTF-8 și să utilizeze caractere de linie nouă Unix (\n). 

Dacă un câmp opțional, cum ar fi person_number sau sis_username, este parte a formatului ID-ului tău Apple gestionat, acesta devine un câmp obligatoriu. Dacă îl lași necompletat, încărcarea nu va reuși și va fi generată eroarea MANAGED_ID_GENERATION_FAILED.

Fișier Sedii

location_id Un identificator unic compus din cifre și/sau litere care nu conține spații. Obligatoriu
location_name Numele sediului.  Obligatoriu

Trebuie să definești cel puțin un sediu în fișierul Sedii. Nu poți utiliza SFTP pentru a crea conturi de student sau de membru de personal în locația principală a „sediului”.

Fișier Studenți

Dacă folosești SFTP pentru a încărca o persoană nouă și valoarea person_id pe care o atribui există deja în Apple School Manager, persoana nouă suprascrie utilizatorul existent în Apple School Manager. După finalizarea suprascrierii poți actualiza respectivul utilizator numai prin SFTP. 

 

person_id

Identificatorul unic pentru un anumit student. Valoarea person_id trebuie să corespundă identificatorului unic din SIS (dacă este disponibil). Valoarea person_id este identificatorul unic pentru student în Apple School Manager. Folosește această valoare pentru a referi studentul din fișierul Liste și instructorii din fișierul Clase. 

Obligatoriu
person_number Altă valoare care poate identifica un student în școală. Aceasta poate fi un număr de identificare a studentului.  Opțional
first_name Prenumele studentului. Obligatoriu
middle_name Al doilea nume al studentului. Opțional
last_name Numele de familie al studentului. Obligatoriu
grade_level Nivelul notelor studentului Opțional
email_address* O adresă de e-mail asociată studentului. Opțional
sis_username Numele de utilizator asociat studentului în sistemul tău SIS.  Opțional
password_policy Folosește câmpul password_policy pentru a specifica o politică privind parola pentru fiecare student. Câmpul password_policy trebuie să aibă cifra 4, cifra 6, cifra 8 sau trebuie lăsat necompletat. Dacă selectezi cifra 8, politica privind parola va fi una standard (cel puțin 8 caractere alfanumerice). Această valoare are prioritate față de politica legată de parole a sediului și orice politică legată de parole pe care ai configurat-o anterior pentru studentul respectiv. Dacă lași câmpul password_policy necompletat, se va utiliza politica implicită a sediului privind parola pentru un student nou și nu se va efectua nicio modificare în cazul studenților existenți. Opțional
location_id Valoarea location_id pentru student. Aceasta trebuie să corespundă unui location_id din fișierul Sedii. Dacă această intrare nu corespunde niciunei intrări din fișierul Sedii, vor apărea probleme în procesul de încărcare. Obligatoriu

* Dacă autentificarea federativă este activată, este necesară o adresă de e-mail. Dacă adresa de e-mail se află într-un domeniu federativ, contul de utilizator va fi federativ.

Atribuirea mai multor sedii

Poți să atribui mai multe sedii unui student, prin adăugarea mai multor coloane legate de sediu la fișierul cu studenți. Poți să mai adaugi până la 14 coloane de sedii denumite location_id_2, location_id_3,... location_id_15. Opțional, pentru fiecare student, poți să introduci un alt parametru location_id (ID sediu) în fiecare dintre aceste coloane. Aceasta trebuie să corespundă unui location_id din fișierul Sedii. Dacă această intrare nu corespunde niciunei intrări din fișierul Sedii, vor apărea probleme în procesul de încărcare.

Fișier membru personal

Dacă folosești SFTP pentru a încărca o persoană nouă și valoarea person_id pe care o atribui există deja în Apple School Manager, persoana nouă va suprascrie utilizatorul existent în Apple School Manager. După finalizarea suprascrierii poți actualiza utilizatorul respectiv numai prin SFTP. Toți membrii personalului respectă politica standard privind parolele (cel puțin 8 caractere alfanumerice).

person_id

Identificatorul unic pentru un anumit membru al personalului. Această valoare person_id trebuie să corespundă identificatorului unic din SIS (dacă este disponibil). Acest parametru person_id (ID personal) este identificatorul unic asociat membrului personalului în Apple School Manager. Folosește această valoare pentru a consulta instructorii din fișierul cu clase. 

Obligatoriu
person_number O altă valoare care ar putea identifica un membru al personalului din școala ta. Aceasta ar putea reprezenta un număr de ecuson al membrului personalului.  Opțional
first_name Prenumele membrului personalului. Obligatoriu
middle_name A doilea nume al membrului personalului. Opțional
last_name Numele de familie al membrului personalului. Obligatoriu
email_address* O adresă de e-mail pentru acest membru al personalului.  Opțional
sis_username Numele de utilizator al membrului personalului în sistemul tău SIS. Opțional
location_id Parametrul location_id (ID sediu) asociat membrului personalului. Aceasta trebuie să corespundă unui location_id din fișierul Sedii. Dacă această intrare nu corespunde niciunei intrări din fișierul Sedii, vor apărea probleme în procesul de încărcare. Obligatoriu

* Dacă autentificarea federativă este activată, este necesară o adresă de e-mail. Dacă adresa de e-mail se află într-un domeniu federativ, contul de utilizator va fi federativ.

Atribuirea mai multor sedii

Poți să atribui mai multe sedii unui membru al personalului, prin adăugarea mai multor coloane legate de sediu într-un fișier cu membrii personalului. Poți să mai adaugi până la 14 coloane de sedii denumite location_id_2, location_id_3,... location_id_15. Opțional, pentru fiecare membru al personalului, poți să introduci un alt parametru location_id (ID sediu) în fiecare dintre aceste coloane. Aceasta trebuie să corespundă unui location_id din fișierul Sedii. Dacă această intrare nu corespunde niciunei intrări din fișierul Sedii, vor apărea probleme în procesul de încărcare.

Fișierul cu cursuri

course_id Un identificator unic pentru curs. Acesta trebuie să corespundă parametrului course_id (ID curs) din fișierul cu cursuri.   Obligatoriu
course_number Un număr asociat cursului. Acest număr ar putea fi numărul cursului din sistemul tău SIS sau ghidul programei. Opțional
course_name Numele cursului. Opțional
location_id Parametrul location_id (ID sediu) asociat cursului. Aceasta trebuie să corespundă unui location_id din fișierul Sedii. Dacă această intrare nu corespunde niciunei intrări din fișierul Sedii, vor apărea probleme în procesul de încărcare.
Obligatoriu

Fișierul cu clase

class_id Un identificator unic pentru clasă.    Obligatoriu
class_number Un număr sau un cod care identifică această clasă în cadrul instituției tale. Spre deosebire de parametrul class_id (ID clasă), parametrul class_number (Număr clasă) nu se utilizează pentru a face referire la această clasă în cadrul listelor de componență CSV.  Opțional
course_id Parametrul course_id (ID curs) al cursului căreia aparține această clasă. Acesta trebuie să corespundă unui parametru course_id (ID curs) din fișierul cu cursuri. Obligatoriu
instructor_id Valoarea person_id pentru instructor. Aceasta trebuie să corespundă valorii person_id folosite în fișierul Membri de personal. Opțional
instructor_id_2 Valoarea person_id pentru instructor. Aceasta trebuie să corespundă valorii person_id folosite în fișierul Membri de personal. Opțional
instructor_id_3 Valoarea person_id pentru instructor. Aceasta trebuie să corespundă valorii person_id folosite în fișierul Membri de personal. Opțional
location_id Parametrul location_id (ID sediu) asociat clasei. Acesta trebuie să corespundă cu parametrul location_id (ID sediu) din fișierul cu sedii. Dacă această intrare nu corespunde niciunei intrări din fișierul Sedii, vor apărea probleme în procesul de încărcare. Obligatoriu

Atribuirea mai multor instructori

Poți să atribui mai mult de trei instructori unei clase prin adăugarea mai multor coloane pentru instructori în fișierul cu clase. Poți să adaugi până la 12 coloane suplimentare pentru instructori, denumite instructor_id_4, instructor_id_5, până la instructor_id_15. Opțional, pentru fiecare clasă, poți să introduci un alt parametru person_id (ID personal) pentru instructor. Aceasta trebuie să corespundă valorii person_id folosite în fișierul Membri de personal.

Fișierul cu liste de componență

roster_id Un identificator unic pentru lista de componență în sistemul tău SIS sau într-o altă bază de date pentru cursuri (dacă este disponibilă).  Obligatoriu
class_id Un identificator alfanumeric unic pentru clasă. Acesta trebuie să corespundă unui parametru class_id (ID clasă) din fișierul cu clase.
Obligatoriu
student_id O valoare person_id pentru un singur student.  Obligatoriu

Fișierul cu listele de componență se utilizează pentru adăugarea studenților la clasele cărora sunt atribuiți. Fiecare linie din fișier trebuie să aibă un parametru roster_id (ID listă de componență) unic și trebuie să conțină un singur parametru class_id (ID clasă) și un singur parametru person_id (ID personal).

Actualizarea fișierelor

Când dorești să adaugi sau să editezi studenți, membri ai personalului și clase, editează fișierele de date și încarcă noile copii. De fiecare dată când încarci fișiere, trebuie să încarci toate cele șase fișiere, și fiecare fișier trebuie să conțină lista completă pentru fiecare categorie, nu doar articolele pe care intenționezi să le adaugi.

După prima încărcare, noile conturi și noile clase vor fi create în mod automat în momentul încărcării. Dacă lipsește o intrare dintr-o încărcare anterioară, aceasta va fi dezactivată în Apple School Manager. Dacă există erori, Apple School Manager îți va trimite un e-mail.

Informaţiile despre produsele care nu sunt fabricate de Apple sau despre site-urile web independente care nu sunt controlate sau testate de Apple sunt furnizate fără recomandare sau aprobare. Apple nu îşi asumă nicio responsabilitate în ceea ce priveşte selectarea, funcţionarea sau utilizarea site-urilor web sau produselor de la terţi. Apple nu face niciun fel de declaraţii privind acurateţea sau fiabilitatea site-urilor web terţe. La utilizarea Internetului, riscurile sunt inerente. Contactează distribuitorul pentru informaţii suplimentare. Alte nume de companii şi produse pot fi mărci comerciale ale proprietarilor respectivi.

Data publicării: