Acest articol a fost arhivat şi nu mai este actualizat de Apple.

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

Dacă Progresul studentului nu este în prezent compatibil cu Apple School Manager sau dacă nu ai o soluție de tip Progresul studentului, poți încărca date despre studenți, personal și clase în Apple School Manager folosind SFTP.

Configurarea primei încărcări SFTP

Completarea fișierelor de date

Actualizarea fișierelor

Atunci când configurezi SFTP în Asistentul SIS/SFTP, 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 dintr-un SIS acceptat

Încărcarea SFTP necesită o aplicație terță în macOS. Dacă nu ai un client SFTP instalat, 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. Fă clic pe numele tău în partea de jos a barei laterale, apoi pe Preferințe, pe Conturi, pe Sincronizare registru și selectează Activați în secțiunea SIS/SFTP. Trebuie să verifici un domeniu

  3. Fă clic pe Găsiți studenți, instructori și clase.

    Nu există text alternativ pentru imagine
  4. Fă clic pe Configurați SFTP.

    Nu există text alternativ pentru imagine
  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.

    Nu există text alternativ pentru imagine
  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 Comprimați 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 afișat în Asistentul SIS/SFTP. 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 SIS/SFTP. 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.

    Nu există text alternativ pentru imagine
  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. Numai domenii confirmate

    No alt supplied for Image
  13. După crearea conturilor, distribuie informații de autentificare utilizatorilor și atribuie roluri membrilor de personal.

    Nu există text alternativ pentru imagine

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 dacă 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ă 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 998 de coloane de sedii denumite location_id_2, location_id_3 până la location_id_999. 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 respectivul utilizator 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ă 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 998 de coloane de sedii denumite location_id_2, location_id_3 până la location_id_999. 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 organizația ta. 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. Poți vedea informațiile despre contul SFTP alegând Configurări > Sursă de date.

Dacă deconectezi conexiunea SFTP din Apple School Manager, conturile și clasele tale se schimbă în starea Manual. Pentru a rezolva acest lucru, restaurează conexiunea SFTP și realizează o nouă încărcare.

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

Dacă lipsește o înregistrare dintr-o încărcare anterioară

Dacă lipsește o înregistrare dintr-o încărcare anterioară, contul este dezactivat și șters automat după 120 de zile, cu excepția cazului în care contul a achiziționat conținut în volum.

Dacă se elimină un curs sau o clasă

Dacă din încărcare se elimină un curs sau o clasă, studenții sunt eliminați din clasă și sursa trece la starea Manual. În cazul în care cursurile erau în uz în Teme școlare, registrul este eliminat și trebuie creat un nou curs pentru reînscriere. În cazul în care clasele erau în uz în Teme școlare, datele privind progresul sunt șterse automat și nu mai sunt disponibile pentru profesor sau student.

Cursurile și clasele cu sursa setată la starea Manual continuă să se sincronizeze cu soluția ta MDM, însă este posibil să nu mai apară în aplicația Sală de clasă. Clasele cu starea Manual pot fi șterse din Apple School Manager, dacă vrei să le elimini de la sincronizare.

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. Contactează furnizorul acestor produse pentru a obține mai multe informații.

Data publicării: