Informazioni sui modelli per l’importazione di record in Apple School Manager
Apple offre 6 modelli da usare per aggiungere dati alla tua sede:
Studenti: contiene informazioni relative agli account per gli studenti.
Staff: contiene informazioni relative agli account per lo staff, ad esempio i docenti.
Corsi: definisce i corsi.
Classi: contiene informazioni relative ai corsi e ai docenti (Staff).
Registri: contiene informazioni su classi, studenti e sedi.
Sedi: contiene informazioni sulle sedi.
Modelli e ID Apple gestiti
Se un campo opzionale come person_number o sis_username fa parte del formato del tuo ID Apple gestito, diventa un campo obbligatorio. Se lo lasci vuoto, il caricamento SFTP non riesce con l’errore MANAGED_ID_GENERATION_FAILED.
Preparare i modelli
Quando prepari un modello, devi soddisfare i seguenti criteri:
Nei modelli students.csv e staff.csv, il valore person_id deve essere univoco per tutte le sedi.
Importante: se usi SFTP per caricare nuovi utenti e il person_id che assegni è già stato assegnato ad altri utenti, l’utente più recente sovrascriverà l’utente esistente in Apple School Manager. Una volta completata la sovrascrittura, potrai aggiornare l’utente solo tramite SFTP.
Se modifichi i modelli, sostituisci i dati dell’esempio con i tuoi. Non modificare i contenuti della riga di intestazione di nessun file. Non creare colonne duplicate in nessun file. Puoi aggiungere colonne a modelli specifici.
Ogni riga di ciascun modello deve contenere un valore univoco. Per esempio, nel file students.csv, ogni riga deve corrispondere a un singolo studente/studentessa. Alcuni valori relativi allo studente/alla studentessa possono essere vuoti. I valori letterali, per esempio un’interruzione di riga o le virgolette all’interno di un nome, devono contenere una sequenza di escape con una barra rovesciata (\). Per esempio: \". Eventuali identificatori inseriti devono essere in formato alfanumerico e possono includere un trattino (-).
Se il tuo valore contiene uno spazio ( ) o una virgola (,), usa le virgolette dritte (") prima e dopo il simbolo. Se il tuo valore non presenta nessuno di questi caratteri speciali, non usare le virgolette. Se non usi le virgolette dove sono necessarie oppure se usi quelle curve, riscontrerai errori in fase di caricamento.
I valori nei tuoi file devono essere separati da virgole (,) o punti e virgola (;), indipendentemente da come hai creato il file. Non usare spazi o tabulazioni tra una virgola o un punto e virgola e il valore successivo. Per ogni file deve essere utilizzata la codifica UTF-8. Per indicare la fine della riga, usa la codifica UNIX per il ritorno a capo \n.
Se manca una voce di un caricamento precedente, l'account viene disattivato ed eliminato automaticamente dopo 120 giorni, a meno che non abbia acquistato contenuti a volume.
I nomi dei file .csv devono corrispondere esattamente al nome del file originale.
Per essere caricati, tutti i file devono essere compressi in un archivio .zip.
Non è possibile inserire alcun file in una cartella nell’archivio .zip.
Tutti i riferimenti a chiavi esterne di altri file .csv devono essere definiti nel file di riferimento.
Limiti di caratteri nei modelli .csv
Alcuni campi dei modelli .csv hanno limiti sui numeri di caratteri consentiti.
Campo | Modelli | Limite di caratteri |
---|---|---|
first_name | Studenti, Staff | 32 |
middle_name | Studenti, Staff | 32 |
last_name | Studenti, Staff | 64 |
grade_level | Studenti | 64 |
email_address | Studenti | 256 |
person_number | Studenti, Staff | 64 |
person_id | Studenti, Staff, Classi, Registri | 256 |
sis_username | Studenti, Staff | 256 |
class_id | Classi, Registri | 256 |
class_number | Classi | 64 |
course_id | Corsi, Classi | 256 |
course_name | Corsi | 128 |
course_number | Corsi | 64 |
location_name | Sedi | 256 |
location_id | Studenti, Staff, Corsi, Classi, Sedi | 256 |