Utilizzare SFTP per caricare dati relativi a studenti, staff e classi su Apple School Manager

Se al momento Apple School Manager non supporta il tuo Sistema Informativo Studenti (SIS) o se non disponi di un Sistema Informativo Studenti, puoi caricare i dati relativi a studenti, staff e classi su Apple School Manager usando SFTP.

Configurazione del primo upload con SFTP

Compilazione dei file di dati

Aggiornamento dei file

Quando configuri SFTP nella schermata di impostazione assistita per SIS/SFTP, Apple School Manager ti fornisce i modelli di file CSV e le informazioni di accesso a un server SFTP privato. Puoi esportare dati da un Sistema Informativo Studenti (SIS) supportato o creare i file in un'applicazione per fogli di calcolo come Numbers. Prima di eseguire l'esportazione dal tuo SIS, contatta il team del SIS per verificare che il formato sia corretto per Apple School Manager.

L'upload con SFTP richiede un'applicazione di terze parti su macOS. Se non hai installato un client SFTP, puoi trovarne uno nel Mac App Store.

Usa i pulsanti indicati sotto per ottenere assistenza nella configurazione dei file SFTP. Se non hai usato SFTP per caricare i dati in Apple School Manager, devi iniziare dalla sezione relativa alla configurazione del primo upload di SFTP.

Configurazione del primo upload con SFTP

1. Effettua l'accesso a Apple School Manager come amministratore, amministratore di sede o gestore di persone.

2. Fai clic sul tuo nome nella parte inferiore della barra laterale, fai clic su Preferenze, fai clic su Account, fai clic su Sincronizzazione directory, quindi seleziona Attiva nella sezione SIS/SFTP. Devi verificare un dominio

3. Fai clic su Trova studenti, docenti e classi.

   

4. Fai clic su Imposta SFTP.

   

5. Apple School Manager genera un URL, un nome utente e una password da usare quando carichi i file. Usa queste informazioni per configurare il tuo client SFTP.

   

6. Fai clic su Scarica modelli.

7. Leggi le istruzioni per l'uso dei modelli nella sezione "Compilazione dei file di dati".

8. Dopo aver compilato i file di dati, crea un archivio zip che comprenda tutti i sei file. Nel Finder puoi selezionare i file e poi accedere al menu File e scegliere Comprimi 6 elementi. Il nome assegnato all'archivio zip non è importante.

9. Carica il file zip in Apple School Manager. Usa un client SFTP per stabilire la connessione all'URL indicato nella schermata di impostazione assistita di SIS/SFTP. Quando ti vengono richieste le informazioni di accesso, usa il nome utente e la password ricevuti quando hai fatto clic su Imposta SFTP. Copia il file zip nella directory di Dropbox.

10. Fai clic su Continua nella schermata di impostazione assistita di SIS/SFTP. Se nell'upload sono presenti errori, puoi fare riferimento a un log in cui sono riportati i file e le righe che contengono gli errori. Correggi eventuali errori nei file di dati, quindi ripeti i passaggi 8 e 9. Non è necessario rimuovere il file precedente dal server SFTP.

11. Al termine dell'importazione SFTP, fai clic su Rivedi i dati SFTP. Se rilevi errori, fai clic su Annulla. Correggi eventuali errori presenti nei file di dati, quindi ripeti il processo di upload. Se i dati sono precisi e completi, fai clic su Continua.

    

12. In Crea account e classi, scegli un formato dell'ID Apple gestito per studenti, docenti e staff. Fai clic sull'opzione per visualizzare in anteprima account e classi. Se gli ID sono nel formato corretto, fai clic su Crea account e classi. Si possono utilizzare solo domini verificati

    

13. Dopo aver creato gli account, fornisci le informazioni di accesso agli utenti e assegna i ruoli allo staff.

    

Compilazione dei file di dati

Il download dei modelli include sei file CSV: Classes (classi), Courses (corsi), Locations (sedi), Rosters (registri), Students (studenti) e Staff (staff). Se i modelli non sono disponibili in Apple School Manager o se hai smarrito una copia dei modelli originali, puoi scaricarli di nuovo.

Puoi usare il tuo SIS per esportare i dati nel formato descritto dai modelli e da questo articolo oppure puoi modificare i modelli in un programma per fogli di calcolo come Numbers.

Usa le tabelle in questo articolo per assicurarti di inserire le informazioni corrette, quindi salva ogni file senza modificarne il nome.

Formattazione dei valori

Se modifichi i modelli, sostituisci i dati di esempio con i tuoi dati. Non modificare il contenuto delle celle di intestazione dei file. Non aggiungere colonne nei file, eccetto quelle descritte di seguito.

In ciascun modello, ogni riga deve rappresentare un valore univoco. Ad esempio, in students.csv, ogni riga deve corrispondere a un unico studente. Alcuni valori per tale studente possono essere vuoti. I valori letterali come un'interruzione di riga o le virgolette all'interno di un nome devono essere identificati dal carattere di escape barra inversa (\), ad esempio (\"). Tutti gli identificatori devono essere alfanumerici e possono includere il simbolo "-".

Se il valore contiene uno spazio ( ) o una virgola (,), racchiudilo tra virgolette semplici ("). Se il valore non contiene nessuno di questi caratteri speciali, non usare le virgolette. Se non usi le virgolette dove sono necessarie o se usi le virgolette inglesi, si verificheranno errori nel processo di upload.

I valori nei file devono essere separati da virgole (,) o punti e virgola (;), indipendentemente dal modo in cui hai creato il file. Non usare spazi o segni di tabulazione tra una virgola o un punto e virgola e il valore successivo. Ciascun file deve essere codificato come UTF-8 e usare ritorni a capo Unix (\n).

Se un campo facoltativo come person_number (numero persona) o sis_username (nome utente sis) fa parte del formato del tuo ID Apple gestito, tale campo diventa obbligatorio. Se lo lasci vuoto, la procedura di upload non andrà a buon fine e verrà visualizzato l'errore MANAGED_ID_GENERATION_FAILED (Generazione ID gestito non riuscita).

File Locations

Devi definire almeno una sede nel file Locations. Non puoi usare SFTP per creare account per studenti o membri dello staff nella sede centrale.

File Students

Se usi SFTP per caricare una nuova persona e l'identificatore person_id che assegni esiste già in Apple School Manager, la nuova persona sovrascriverà l'utente esistente in Apple School Manager. Una volta completata la sovrascrittura, potrai aggiornare l'utente solo tramite SFTP.

Assegnare più sedi

Puoi assegnare più sedi a uno studente aggiungendo altre colonne dedicate nel file Students. Puoi aggiungere fino a 998 colonne per le sedi, denominate location_id_2 (ID sede 2), location_id_3 (ID sede 3) e così via, fino a location_id_999 (ID sede 999). Se lo desideri, per ogni studente puoi inserire un altro location_id (ID sede) in ciascuna di queste colonne. Deve corrispondere all'identificatore location_id nel file Locations. Se questo valore non corrisponde a un valore nel file Locations, si verificheranno problemi nel processo di upload.

File Staff

Se usi SFTP per caricare una nuova persona e l'identificatore person_id che assegni esiste già in Apple School Manager, la nuova persona sovrascriverà l'utente esistente in Apple School Manager. Una volta completata la sovrascrittura, potrai aggiornare l'utente solo tramite SFTP. A tutto lo staff viene applicato il formato standard per le password (8 o più caratteri alfanumerici).

Assegnare più sedi

Puoi assegnare più sedi a un membro dello staff aggiungendo altre colonne dedicate nel file Staff. Puoi aggiungere fino a 998 colonne per le sedi, denominate location_id_2 (ID sede 2), location_id_3 (ID sede 3) e così via, fino a location_id_999 (ID sede 999). Se lo desideri, per ogni membro dello staff puoi inserire un altro location_id (ID sede) in ciascuna di queste colonne. Deve corrispondere all'identificatore location_id nel file Locations. Se questo valore non corrisponde a un valore nel file Locations, si verificheranno problemi nel processo di upload.

File Courses

File Classes

Assegnare più docenti

Puoi assegnare più di tre docenti a una classe aggiungendo altre colonne dedicate nel file Classes. Puoi aggiungere fino a 12 colonne per i docenti, denominate instructor_id_4 (ID docente 4), instructor_id_5 (ID docente 5) e così via, fino a instructor_id_15 (ID docente 15). Se lo desideri, per ogni classe puoi inserire un altro person_id per il docente. Deve corrispondere al relativo identificatore person_id usato nel file Staff.

File Rosters

Aggiornamento dei file

Quando desideri aggiungere o modificare studenti, staff e classi, modifica i tuoi file di dati e carica le nuove copie. Quando carichi i file, devi caricare tutti i sei file; ogni file deve contenere l'elenco completo di ogni categoria e non solo gli elementi che intendi aggiungere. Puoi controllare le informazioni dell'account SFTP selezionando Impostazioni > Fonte dati.

Dopo il primo upload, verranno creati automaticamente nuovi account e classi al momento degli upload successivi. Se sono presenti degli errori, Apple School Manager ti invierà un'email.

Se manca una voce da un upload precedente

Se manca una voce da un upload precedente, l'account viene disattivato ed eliminato automaticamente dopo 120 giorni, a meno che con l'account non siano stati acquistati contenuti a volume.

Se vengono rimossi un corso o una classe

Se un corso o una classe vengono rimossi dall'upload, gli studenti vengono rimossi dalla classe e la fonte cambia in Manuale. Se i corsi erano in uso in Schoolwork, l'elenco viene rimosso e deve essere creato un nuovo corso per la nuova iscrizione. Se le lezioni erano in uso in Schoolwork, i dati sui progressi vengono eliminati automaticamente e non sono più disponibili per l'insegnante o lo studente.

I corsi e le classi con una fonte manuale continuano a sincronizzarsi con la tua soluzione MDM, ma potrebbero non essere più visualizzati nell'app Classroom. È possibile eliminare le classi in modalità manuale in Apple School Manager se desideri rimuoverle dalla sincronizzazione.