File CSV per School Data SyncCSV files for School Data Sync

È possibile utilizzare file CSV con School Data Sync (SDS) per sincronizzare School Information System (SIS) con Office 365. Se si utilizza questo metodo, sono necessari sei file CSV separati per configurare il profilo di sincronizzazione in SDS. In questo argomento vengono illustrati i file CSV e la relativa formattazione necessaria.You can use CSV (comma separated value) files with School Data Sync (SDS) to synchronize your School Information System (SIS) with Office 365. If you use this method, you'll need six separate CSV files to set up the synchronization profile within SDS. This topic describes the CSV files and their required formatting.

File CSV necessari per School Data SyncRequired CSV files for School Data Sync

Quando si configura SDS tramite file CSV, gli amministratori devono compilare sei singoli file CSV contenenti tutti gli attributi necessari descritti di seguito. È inoltre possibile includere attributi opzionali nei sei file CSV. Per istruzioni dettagliate su come configurare un profilo di sincronizzazione con file CSV in SDS, vedere Come distribuire School Data Sync utilizzando file CSV. Per un set di esempio di file CSV con dati di esempio con valori e formattazione degli attributi di esempio, vedere la Repository GitHub SDS.When configuring SDS using CSV files, administrators must compile six individual CSV files containing all the required attributes detailed below. You may also include any of the optional attributes in the six CSV files as well. For detailed steps for how to setup a sync profile with CSV files in SDS, see How to deploy School Data Sync by using CSV files. For a sample set of CSV files which includes sample data with the appropriate attribute values and formatting, see the SDS GitHub Repository.

Gli attributi necessari per i file CSV variano in base alle opzioni del profilo di sincronizzazione selezionate durante la configurazione guidata del profilo di sincronizzazione SDS. Inoltre, se il tenant di Office 365 si trova nel Regno Unito, esistono alcuni requisiti univoci per i sei file CSV e gli attributi obbligatori in essi contenuti. Vedere la sezione File CSV Regno Unito di questo documento per ulteriori dettaglio sui requisiti del Regno Unito oppure vedere i file di esempio per il Regno Unito nel Repository GitHub SDS..The required attributes for the CSV files will vary based on the sync profile options selected during the SDS sync profile setup wizard. Also, if your Office 365 tenant is based in the UK, there are some unique requirements for the six CSV files and the required attributes they contain. See the UK CSV Files section of this doc for more detail on the UK requirements, or see the UK Sample files located on the SDS GitHub Repository.

Nota

Assicurarsi che i file CSV non contengano caratteri non validi. Inoltre, i file CSV non possono contenere più di 500.000 righe di dati. Se si superano 500.000 righe, è necessario dividere le righe aggiuntive in un altro set di 6 file CSV e creare un profilo di sincronizzazione aggiuntivo per caricarli e sincronizzarli.Make sure your CSV files don't contain invalid characters. Also, CSV files must not contain more than 500,000 rows of data. If you exceed 500K rows, you must split the additional rows into another set of 6 CSV Files, and create an additional sync profile to upload and sync them.

I sei file CSV necessari sono:The six required CSV files are:

Nota

Questi file CSV devono essere denominati esattamente come indicato e devono essere tutti contenuti nella stessa cartella o directory nel computer locale. Nessun altro file deve essere presente in questa directory. Inoltre, ogni nome di attributo visualizzato di seguito per ogni file CSV verrà configurato come intestazione, all'interno di ognuno dei rispettivi file CSV.These CSV files must be named exactly as shown, and all be contained within the same folder or directory on the local machine. No other files should exist in this directory. Also, each attribute name shown below for each CSV file will be configured as a header, within each of the respective CSV files.

Tutti i file CSV devono trovarsi nella stessa directory

School.csvSchool.csv

Il file School.csv deve contenere i seguenti attributi obbligatori. Si tratta di attributi obbligatori minimi necessari per creare e sincronizzare un istituto di istruzione in SDS. Se non si includono questi attributi, il file potrebbe non caricarsi oppure l'istituto di istruzione potrebbe non essere creato o sincronizzato correttamente e un conseguente errore potrebbe essere incluso nel report sugli errori del profilo di sincronizzazione.The School.csv file must contain these required attributes. These are the minimum required attributes required to create and synchronize a School within SDS. If you do not include these attributes, the file may fail to upload or the school will not create or sync properly, and a subsequent error will be included within the sync profile error report.

  • ID SIS- ID SIS dell'istituto di istruzione.SIS ID- SIS ID of the School.

  • Nome- Nome dell'istituto di istruzione.Name- Name of the School.

Attributi facoltativi per School.csvOptional attributes for School.csv

Il file School.csv potrebbe contenere uno di questi attributi facoltativi. Quando si configura un profilo di sincronizzazione, è possibile aggiungere uno dei seguenti attributi facoltativi, ma ognuno degli attributi selezionati deve essere incluso nel file CSV corrispondente come intestazione di colonna. Questi attributi devono corrispondere esattamente ai nomi descritti di seguito, inclusi ortografia, iniziali maiuscole e sintassi. Anche se SDS non richiede questi campi, tutte le applicazioni che sfruttano i dati sincronizzati di SDS potrebbero usare questi attributi. Assicurarsi di includere uno/tutti gli attributi necessari per un'esperienza ottimale dell'app. Chiedere al fornitore di app dettagli su quali di questi attributi vengono utilizzati all'interno della relativa applicazione. È sempre possibile modificare e aggiungere gli attributi facoltativi in un profilo di sincronizzazione in SDS in un secondo momento, se necessario.The School.csv file may contain any of these optional attributes. When setting up your sync profile you can add any of the optional attributes below but each attribute selected must then be included in the corresponding CSV file as a column header. These attributes must match exactly the names detailed below including spelling, capitalization, and syntax. While SDS doesn't require these fields, any applications that leverage SDS synchronized data may use these attributes. Be sure to include any/all attributes needed for an optimal app experience. Ask the app vendor for details on which of these attributes are used within their respective application. You can always edit and add optional attributes to a sync profile in SDS at a later time, if needed.

  • Numero dell'istituto di istruzioneSchool Number

  • NCES_ID istituto di istruzioneSchool NCES_ID

  • ID statoState ID

  • Voto bassoGrade Low

  • Voto altoGrade High

  • ID SIS presidePrincipal SIS ID

  • Nome del presidePrincipal Name

  • E-mail secondaria del presidePrincipal Secondary Email

  • IndirizzoAddress

  • CittàCity

  • StatoState

  • PaeseCountry

  • CAPZip

  • TelefonoPhone

  • ZonaZone

Nella schermata seguente della configurazione guidata del profilo di sincronizzazione, gli attributi disattivati sono necessari, mentre quelli rimanenti sono opzionali.In the screenshot below from the SDS sync profile setup wizard, the greyed out attributes are required and the remaining attributes shown are optional.

Section.csvSection.csv

Il file Section.csv deve contenere i seguenti attributi obbligatori. Si tratta di attributi obbligatori minimi necessari per creare e sincronizzare una sezione in SDS. Se non si includono questi attributi, il file potrebbe non caricarsi oppure la sezione potrebbe non essere creata o sincronizzata correttamente e un conseguente errore potrebbe essere incluso nel report sugli errori del profilo di sincronizzazione.The Section.csv file must contain these required attributes. These are the minimum required attributes required to create and synchronize a Section within SDS. If you do not include these attributes, the file may fail to upload or the Section will not create or sync properly, and a subsequent error will be included within the sync profile error report.

  • ID SIS- ID SIS della sezione.SIS ID- SIS ID of the Section.

  • ID SIS istituto di istruzione- ID SIS dell'istituto di istruzione.School SIS ID- SIS ID of the School.

  • Nome sezione- Nome della sezione.Section Name- Name of the Section.

Attributi facoltativi per Section.csvOptional attributes for Section.csv

Il file Section.csv potrebbe contenere uno di questi attributi facoltativi. Quando si configura un profilo di sincronizzazione, è possibile aggiungere uno dei seguenti attributi facoltativi, ma ognuno degli attributi selezionati deve essere incluso nel file CSV corrispondente come intestazione di colonna. Questi attributi devono corrispondere esattamente ai nomi descritti di seguito, inclusi ortografia, iniziali maiuscole e sintassi. Anche se SDS non richiede questi campi, tutte le applicazioni che sfruttano i dati sincronizzati di SDS potrebbero usare questi attributi. Assicurarsi di includere uno/tutti gli attributi necessari per un'esperienza ottimale dell'app. Chiedere al fornitore di app dettagli su quali di questi attributi vengono utilizzati all'interno della relativa applicazione. È sempre possibile modificare e aggiungere gli attributi facoltativi in un profilo di sincronizzazione in SDS in un secondo momento, se necessario.The Section.csv file may contain any of these optional attributes. When setting up your sync profile you can add any of the optional attributes below but each attribute selected must then be included in the corresponding CSV file as a column header. These attributes must match exactly the names detailed below including spelling, capitalization, and syntax. While SDS doesn't require these fields, any applications that leverage SDS synchronized data may use these attributes. Be sure to include any/all attributes needed for an optimal app experience. Ask the app vendor for details on which of these attributes are used within their respective application. You can always edit and add optional attributes to a sync profile in SDS at a later time, if needed.

  • Numero sezioneSection Number

  • Termine ID SISTerm SIS ID

  • Nome termineTerm Name

  • Termine StartDateTerm StartDate

  • Termine EndDateTerm EndDate

  • ID SIS corsoCourse SIS ID

  • Nome del corsoCourse Name

  • Numero corsoCourse Number

  • Descrizione del corsoCourse Description

  • Oggetto del corsoCourse Subject

  • PeriodiPeriods

  • StatoStatus

Nella schermata seguente della configurazione guidata del profilo di sincronizzazione, gli attributi disattivati sono necessari, mentre quelli rimanenti sono opzionali.In the screenshot below from the SDS sync profile setup wizard, the greyed out attributes are required and the remaining attributes shown are optional.

Student.csvStudent.csv

Il file Student.csv deve contenere i seguenti attributi obbligatori. Si tratta di attributi obbligatori minimi necessari per creare e sincronizzare uno studente in SDS. Se non si includono questi attributi, il file potrebbe non caricarsi oppure lo studente potrebbe non essere creato o sincronizzato correttamente e un conseguente errore potrebbe essere incluso nel report sugli errori del profilo di sincronizzazione.The Student.csv file must contain these required attributes. These are the minimum required attributes required to create and synchronize a Student within SDS. If you do not include these attributes, the file may fail to upload or the Student will not create or sync properly, and a subsequent error will be included within the sync profile error report.

  • ID SIS- ID SIS dello studente.SIS ID- SIS ID of the Student.

  • ID SIS istituto di istruzione- ID SIS dell'istituto di istruzioneSchool SIS ID- SIS ID of the School

  • Nome utente - Nome utente dello studenteUsername - Username of the student

Se è stata selezionata l'opzione Crea e sincronizza nuovi utenti durante la configurazione guidata del profilo di sincronizzazione SDS, anche i seguenti 3 attributi sono necessari. Se si sceglie Sincronizza utenti esistenti, i seguenti 3 attributi non sono necessari ed SDS non è in grado di sovrascriverli in Azure che sarà già presente nell'oggetto utente.If you selected the Create and Sync New Users option during the SDS sync profile setup wizard, the 3 attributes below are also required. If you chose Sync Existing Users, these 3 attributes are not required, and SDS cannot overwrite these attributes in Azure which will already be present on the user object.

  • Nome - Digitare il nome dello studente.First Name- First name of the Student.

  • Cognome - Digitare il cognome dello studente.Last Name- Last Name of the Student.

  • Password - Password dello studente. Le password devono rispettare i criteri password degli account utente di Azure AD.Password- Password for the Student. Passwords must adhere to Azure AD user account password policy.

Attributi facoltativi per Student.csvOptional attributes for Student.csv

Il file Student.csv potrebbe contenere uno di questi attributi facoltativi. Quando si configura un profilo di sincronizzazione, è possibile aggiungere uno dei seguenti attributi facoltativi, ma ognuno degli attributi selezionati deve essere incluso nel file CSV corrispondente come intestazione di colonna. Questi attributi devono corrispondere esattamente ai nomi descritti di seguito, inclusi ortografia, iniziali maiuscole e sintassi. Anche se SDS non richiede questi campi, tutte le applicazioni che sfruttano i dati sincronizzati di SDS potrebbero usare questi attributi. Assicurarsi di includere uno/tutti gli attributi necessari per un'esperienza ottimale dell'app. Chiedere al fornitore di app dettagli su quali di questi attributi vengono utilizzati all'interno della relativa applicazione. È sempre possibile modificare e aggiungere gli attributi facoltativi in un profilo di sincronizzazione in SDS in un secondo momento, se necessario.The Student.csv file may contain any of these optional attributes. When setting up your sync profile you can add any of the optional attributes below but each attribute selected must then be included in the corresponding CSV file as a column header. These attributes must match exactly the names detailed below including spelling, capitalization, and syntax. While SDS doesn't require these fields, any applications that leverage SDS synchronized data may use these attributes. Be sure to include any/all attributes needed for an optimal app experience. Ask the app vendor for details on which of these attributes are used within their respective application. You can always edit and add optional attributes to a sync profile in SDS at a later time, if needed.

  • ID statoState ID

  • E-mail secondariaSecondary Email

  • Numero studenteStudent Number

  • VotoGrade

  • StatoStatus

  • Indirizzo postaleMailing Address

  • Città indirizzo postaleMailing City

  • Stato indirizzo postaleMailing State

  • CAP indirizzo postaleMailing Zip

  • Latitudine indirizzo postaleMailing Latitude

  • Longitudine indirizzo postaleMailing Longitude

  • Paese indirizzo postaleMailing Country

  • Indirizzo di residenzaResidence Address

  • Città di residenzaResidence City

  • Stato di residenzaResidence State

  • CAP di residenzaResidence Zip

  • Latitudine indirizzo di residenzaResidence Latitude

  • Longitudine indirizzo di residenzaResidence Longitude

  • Paese di residenzaResidence Country

  • SessoGender

  • Data di nascitaBirthdate

  • Stato ELLELL Status

  • FederalRaceFederalRace

  • Anno di laureaGraduation Year

Nella schermata seguente della configurazione guidata del profilo di sincronizzazione, gli attributi disattivati sono necessari, mentre quelli rimanenti sono opzionali.In the screenshot below from the SDS sync profile setup wizard, the greyed out attributes are required and the remaining attributes shown are optional.

Teacher.csvTeacher.csv

Il file Teacher.csv deve contenere i seguenti attributi obbligatori. Si tratta di attributi obbligatori minimi necessari per creare e sincronizzare un docente in SDS. Se non si includono questi attributi, il file potrebbe non caricarsi oppure il docente potrebbe non essere creato o sincronizzato correttamente e un conseguente errore potrebbe essere incluso nel report sugli errori del profilo di sincronizzazione.The Teacher.csv file must contain these required attributes. These are the minimum required attributes required to create and synchronize a Teacher within SDS. If you do not include these attributes, the file may fail to upload or the Teacher will not create or sync properly, and a subsequent error will be included within the sync profile error report.

  • ID SIS- ID SIS del docente.SIS ID- SIS ID of the Teacher.

  • ID SIS istituto di istruzione- ID SIS dell'istituto di istruzione.School SIS ID- SIS ID of the School.

  • Nome utente - Nome utente del docenteUsername - Username of the Teacher

Se è stata selezionata l'opzione Crea e sincronizza nuovi utenti durante la configurazione guidata del profilo di sincronizzazione SDS, anche i seguenti 3 attributi sono necessari. Se si sceglie Sincronizza utenti esistenti, i seguenti 3 attributi non sono necessari ed SDS non è in grado di sovrascriverli in Azure che sarà già presente nell'oggetto utente.If you selected the Create and Sync New Users option during the SDS sync profile setup wizard, the 3 attributes below are also required. If you chose Sync Existing Users, these 3 attributes are not required, and SDS cannot overwrite these attributes in Azure which will already be present on the user object.

  • Nome - Digitare il nome del docente.First Name- First Name of the Teacher.

  • Cognome - Digitare il cognome del docenteLast Name -Last Name of the Teacher

  • Password Password per il docente. Le password devono rispettare i criteri password degli account utente di Azure AD.Password- Password for the Teacher. Passwords must adhere to Azure AD user account password policy.

Attributi facoltativi del file Teacher.csvOptional attributes for Teacher.csv

Il file Teacher.csv potrebbe contenere uno di questi attributi facoltativi. Quando si configura un profilo di sincronizzazione, è possibile aggiungere uno dei seguenti attributi facoltativi, ma ognuno degli attributi selezionati deve essere incluso nel file CSV corrispondente come intestazione di colonna. Questi attributi devono corrispondere esattamente ai nomi descritti di seguito, inclusi ortografia, iniziali maiuscole e sintassi. Anche se SDS non richiede questi campi, tutte le applicazioni che sfruttano i dati sincronizzati di SDS potrebbero usare questi attributi. Assicurarsi di includere uno/tutti gli attributi necessari per un'esperienza ottimale dell'app. Chiedere al fornitore di app dettagli su quali di questi attributi vengono utilizzati all'interno della relativa applicazione. È sempre possibile modificare e aggiungere gli attributi facoltativi in un profilo di sincronizzazione in SDS in un secondo momento, se necessario.The Teacher.csv file may contain any of these optional attributes. When setting up your sync profile you can add any of the optional attributes below but each attribute selected must then be included in the corresponding CSV file as a column header. These attributes must match exactly the names detailed below including spelling, capitalization, and syntax. While SDS doesn't require these fields, any applications that leverage SDS synchronized data may use these attributes. Be sure to include any/all attributes needed for an optimal app experience. Ask the app vendor for details on which of these attributes are used within their respective application. You can always edit and add optional attributes to a sync profile in SDS at a later time, if needed.

  • ID statoState ID

  • Numero docenteTeacher Number

  • StatoStatus

  • E-mail secondariaSecondary Email

  • TitoloTitle

  • QualificaQualification

Nella schermata seguente della configurazione guidata del profilo di sincronizzazione, gli attributi disattivati sono necessari, mentre quelli blu sono opzionali.In the screenshot below from the SDS sync profile setup wizard, the greyed out attributes are required and the remaining attributes shown in blue are optional.

StudentEnrollment.csvStudentEnrollment.csv

Il file StudentEnrollment.csv deve contenere i seguenti attributi obbligatori. Si tratta di attributi obbligatori minimi necessari per aggiungere uno studente a una sezione in SDS. Se non si includono questi attributi, il file potrebbe non caricarsi oppure il mapping student enrollment potrebbe non essere creato o sincronizzato correttamente e un conseguente errore potrebbe essere incluso nel report sugli errori del profilo di sincronizzazione.The StudentEnrollment.csv file must contain these required attributes. These are the minimum required attributes needed to add a student to a section within SDS. If you do not include these attributes, the file may fail to upload or the Studentenrollment mapping will not create or sync properly, and a subsequent error will be included within the sync profile error report.

  • ID SIS sezione- ID SIS della sezione.Section SIS ID- SIS ID of the Section.

  • ID SIS- ID SIS dello studente.SIS ID- SIS ID of the Student.

TeacherRoster.csvTeacherRoster.csv

Il file TeacherRoster.csv deve contenere i seguenti attributi obbligatori. Si tratta di attributi obbligatori minimi necessari per aggiungere un docente a una sezione in SDS. Se non si includono questi attributi, il file potrebbe non caricarsi oppure il mapping TeacherRoster potrebbe non essere creato o sincronizzato correttamente e un conseguente errore potrebbe essere incluso nel report sugli errori del profilo di sincronizzazione.The TeacherRoster.csv file must contain these required attributes. These are the minimum required attributes needed to add a Teacher to a Section within SDS. If you do not include these attributes, the file may fail to upload or the TeacherRoster mapping will not create or sync properly, and a subsequent error will be included within the sync profile error report.

  • ID SIS sezione- ID SIS della sezione.Section SIS ID- SIS ID of the Section.

  • ID SIS- ID SIS del docente.SIS ID- SIS ID of the Teacher.

File CSV Regno UnitoUK CSV Files

Se su sta abilitando School Data Sync utilizzando file CSV per un tenant di Office 365 nel Regno Unito, esistono alcune differenze tra gli attributi obbligatori descritti sopra e quelli obbligatori per i file CSV con base nel Regno Unito. Il seguente riepilogo indica tutti gli attributi obbligatori per i file CSV con base nel Regno Unito. Tutti gli attributi facoltativi indicati in precedenza rimangono invariati sotto lo schema del Regno Unito.If enabling School Data Sync using CSV files for an Office 365 tenant based in the UK, there are a few differences between the required attributes noted above, and the required attributes for the UK based CSV files. The summary below details all the required attributes for UK based CSV files. All optional attributes noted above remain the same under the UK schema.

School.csvSchool.csv

  • Numero DfE -Numero DfE dell'istituto di istruzioneDfE number - DfE Number of the School

  • Nome- Nome dell'istituto di istruzioneName - Name of the School

Section.csvSection.csv

  • ID - ID della sezioneID - ID of the Section

  • Numero DfE istituto di istruzione - Numero DfE dell'istituto di istruzioneSchool DfE number - DfE Number of the School

  • Nome sezione- Nome della sezioneSection Name - Name of the Section

Student.csvStudent.csv

  • ID - ID dello studenteID - ID of the Student

  • Numero DfE istituto di istruzione - Numero DfE dell'istituto di istruzioneSchool DfE number - DfE Number of the School

  • Nome utente - Nome utente dello studenteUsername - Username of the Student

Teacher.csvTeacher.csv

  • ID - ID del docenteID - ID of the Teacher

  • Numero DfE istituto di istruzione - Numero DfE dell'istituto di istruzioneSchool DfE number - DfE Number of the School

  • Nome utente - Nome utente del docenteUsername - Username of the Teacher

StudentEnrollment.csvStudentEnrollment.csv

  • ID sezione - ID della sezioneSection ID - ID of the Section

  • ID- ID SIS del docenteID - SIS ID of the Teacher

TeacherRoster.csvTeacherRoster.csv

  • ID sezione - ID della sezioneSection ID - ID of the Section

  • ID - ID del docenteID - ID of the Teacher

Panoramica di School Data SyncOverview of School Data Sync

Come implementare School Data Sync tramite file CSVHow to deploy School Data Sync by using CSV files