Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Importante
Clienti di TRANSIZIONE classica di School Data Sync (SDS): non tutti i campi sono supportati per inserire i dati nella nuova esperienza SDS in base al formato v1. È possibile trovarli annotati in Formato file CSV SDS v1 nella colonna Obbligatorio? come dati non supportati.
Importante
Inoltre, i valori Grade e Course Subject passati devono essere allineati ai codici List of Values (ENUM) corrispondenti. Se necessario, usare Gestione dell'elenco di valori per espandere i valori Grade e Course Subject per supportare i valori di codice non supportati per impostazione predefinita.
È possibile usare file CSV (valori delimitati da virgole) nel formato SDS V1 per sincronizzare il sistema informativo dell'istituto di istruzione (SIS) con Office 365. L'uso del formato di file CSV SDS V1 per inserire le categorie di dati consente di illuminare le funzionalità SDS di base per il provisioning. Consente inoltre di migliorare le esperienze per i prodotti e le funzionalità di Microsoft 365.
Se si usa il formato SDS V1, i file devono essere formattati in modo appropriato. Caricare i file, denominati esattamente come descritto in questo articolo. Le intestazioni di colonna fanno distinzione tra maiuscole e minuscole. I file CSV devono essere in formato UTF-8 e conformi a RFC. Inoltre, non si accettano interruzioni di riga nei dati in ingresso. Per esaminare e scaricare un set di esempi di file CSV SDS V1, vedere il repository GitHub SDS.
Importante
Dopo il caricamento iniziale durante la creazione del flusso in ingresso, è necessario fornire sempre lo stesso set di file per i caricamenti successivi, indipendentemente dalle modifiche apportate ai dati nei file facoltativi. In caso contrario, il sistema determina che i record non sono più attivi e li contrassegna come tali.
Obbligatorio: prima di poter procedere, è necessario selezionare i tre file seguenti. Se si gestiscono solo utenti e non classi, è sufficiente fornire questi file.
school.csv
student.csv
teacher.csv
Facoltativo/Obbligatorio: non obbligatorio se si gestiscono solo utenti. Se si gestiscono anche classi e registrazioni di classi, è necessario fornire i tre file seguenti, insieme ai tre file menzionati in precedenza. In caso contrario, non selezionare alcun file con questi nomi.
section.csv
studentenrollment.csv
teacherroster.csv
Facoltativo: i file seguenti non sono necessari per continuare, ma potrebbero migliorare le esperienze. Se è selezionato uno dei file seguenti, è necessario selezionare anche l'altro file per continuare.
user.csv
guardianrelationship.csv (richiede record utente e studente per compilare l'associazione di contatti).
Ogni file CSV deve contenere dati per i campi annotati 'Sì' in 'Obbligatorio', i campi annotati 'No' sono dati 'Facoltativi'. Le intestazioni di campo contrassegnate come "Obbligatorio" devono esistere nei file forniti o non verranno accettate. Le intestazioni di campo contrassegnate come "Facoltativo" non devono essere presenti nei file se non vengono passati i dati facoltativi corrispondenti.
I campi con valori enumerati definiti come contrassegnati nella colonna 'Tipi di dati' hanno un set specifico di valori supportati. Il set supportato di valori predefiniti per i campi Enum vedere Elenco predefinito di valori.
school.csv
| Campo | Obbligatorio? | Esempio | Tipo di dati |
|---|---|---|---|
| SIS ID | Sì | 456789 | ID univoco |
| Nome | Sì | Contoso High School | Stringa |
| NCES_ID istituto di istruzione | No | 456789 | Stringa |
| Numero dell'istituto di istruzione | dati non supportati | ||
| Voto basso | dati non supportati | ||
| Voto alto | dati non supportati | ||
| ID stato | dati non supportati | ||
| ID SIS preside | dati non supportati | ||
| Nome entità | dati non supportati | ||
| E-mail secondaria del preside | dati non supportati | ||
| Indirizzo | dati non supportati | ||
| Città | dati non supportati | ||
| Stato | dati non supportati | ||
| CAP | dati non supportati | ||
| Paese | dati non supportati | ||
| Telefono | dati non supportati | ||
| Area | dati non supportati |
- Tutte le organizzazioni elencate verranno impostate sul tipo di organizzazione "school".
student.csv
| Campo | Obbligatorio? | Esempio | Tipo di dati |
|---|---|---|---|
| SIS ID | Sì | 123456 | ID univoco |
| ID SIS dell'istituto di istruzione | Sì | 456789 | ID univoco |
| Username | Sì | jsmith@contoso.edu | Stringa |
| Nome | Sì (solo se si creano utenti) | John | Stringa |
| Cognome | Sì (solo se si creano utenti) | Smith | Stringa |
| Secondo nome | No | William | Stringa |
| E-mail secondaria | No | jsmith@contoso.edu | Posta elettronica |
| Numero studente | No | 123456 | Stringa |
| Voto | No | 8 | Enumerazione |
| Data di nascita | No | 2009-12-19 | Data |
| Stato | dati non supportati | ||
| Password | dati non supportati | ||
| Anno di laurea | dati non supportati | ||
| ID stato | dati non supportati |
- Richiede un riferimento all'istituto di istruzione associato usando il campo "ID SIS dell'istituto di istruzione" e produce una dipendenza dal file school.csv.
- Tutti gli utenti elencati verranno impostati sul tipo di ruolo 'student'.
- Si prevede che i valori di data vengano forniti in formato ISO8601.
- Gli zeri iniziali '0' mancanti nel valore in ingresso per L'ENUM livello di livello, ad esempio '1', corrisponderanno all'elenco definito di valori (ENUM) '01' e verranno archiviati come '01'.
teacher.csv
| Campo | Obbligatorio? | Esempio | Tipo di dati |
|---|---|---|---|
| SIS ID | Sì | 654321 | ID univoco |
| ID SIS dell'istituto di istruzione | Sì | 456789 | ID univoco |
| Username | Sì | jcook@contoso.edu | Stringa |
| Nome | Sì (solo se si creano utenti) | Jane | Stringa |
| Cognome | Sì (solo se si creano utenti) | Cuoco | Stringa |
| Secondo nome | No | Meredith | Stringa |
| Numero docente | No | 654321 | Stringa |
| Voto | No | 8 | Enumerazione |
| E-mail secondaria | No | jcook@contoso.edu | Posta elettronica |
| Stato | dati non supportati | ||
| Password | dati non supportati | ||
| Titolo | dati non supportati | ||
| ID stato | dati non supportati | ||
| Qualifica | dati non supportati |
- Richiede un riferimento all'istituto di istruzione associato usando il campo "ID SIS dell'istituto di istruzione", generando una dipendenza dal file school.csv.
- Tutti gli utenti elencati verranno impostati sul tipo di ruolo "insegnante".
- Zeri iniziali '0' mancanti nel valore in ingresso per Grade Level ENUM. Ad esempio, '1' corrisponderà all'elenco definito di valori (ENUM) '01' e verrà archiviato come '01'.
section.csv
| Campo | Obbligatorio? | Esempio | Tipo di dati |
|---|---|---|---|
| SIS ID | Sì | 334455 | ID univoco |
| ID SIS dell'istituto di istruzione | Sì | 456789 | ID univoco |
| Nome sezione | Sì | Periodo 1 - Storia del mondo | Stringa |
| Numero sezione | No | 334466 | Stringa |
| ID SIS corso | No | 123456789 | ID univoco |
| Nome del corso | No | Storia del mondo 10 | Stringa |
| Numero corso | No | 123456789 | Stringa |
| Descrizione del corso | No | Storia del mondo | Stringa |
| Oggetto del corso | No | 54999 | Enumerazione |
| Termine ID SIS | dati non supportati | ||
| Nome termine | dati non supportati | ||
| Termine StartDate | dati non supportati | ||
| Termine EndDate | dati non supportati | ||
| Stato | dati non supportati | ||
| Periodi | dati non supportati |
- Richiede un riferimento all'istituto di istruzione associato usando il campo "ID SIS dell'istituto di istruzione", generando una dipendenza dal file school.csv.
- Se sono necessarie informazioni sul termine, è consigliabile passare al formato CSV SDS v2.1 e fornire anche academicSessions.csv file.
studentenrollment.csv
| Campo | Obbligatorio? | Esempio | Tipo di dati |
|---|---|---|---|
| ID SIS della sezione | Sì | 334455 | ID univoco |
| SIS ID | Sì | 123456 | ID univoco |
- Ciò richiede un riferimento alla sezione associata usando il campo 'SECTION SIS ID' e produce una dipendenza dal file section.csv.
- Ciò richiede un riferimento all'utente associato usando il campo "SIS ID" e produce una dipendenza dal file student.csv.
teacherroster.csv
| Campo | Obbligatorio? | Esempio | Tipo di dati |
|---|---|---|---|
| ID SIS della sezione | Sì | 334455 | ID univoco |
| SIS ID | Sì | 654321 | ID univoco |
- Ciò richiede un riferimento alla sezione associata usando il campo 'SECTION SIS ID' e produce una dipendenza dal file section.csv.
- Ciò richiede un riferimento all'utente associato usando il campo "SIS ID" e produce una dipendenza dal file teacher.csv.
user.csv
| Campo | Obbligatorio? | Esempio | Tipo di dati |
|---|---|---|---|
| Posta elettronica | Sì | jsmith@outlook.com | Posta elettronica |
| Nome | Sì | John | Stringa |
| Cognome | Sì | Smith | Stringa |
| Telefono | No | +1234567890 | Telefono |
| SIS ID | No | P_123456 | ID univoco |
- Se si sincronizzano anche le relazioni di contatto (tutori), è necessario includere un record nel user.csv.
- Si prevede che il campo telefono venga formattato in base allo standard E.164 in cui il carattere più viene usato e completato dal numero di telefono oppure il carattere più seguito da codice paese, prefisso di area, prefisso telefonico e numero di riga.
guardianrelationship.csv
| Campo | Obbligatorio? | Esempio | Tipo di dati |
|---|---|---|---|
| SIS ID | Sì | 123456 | ID univoco |
| Posta elettronica | Sì | jsmith@outlook.com | Posta elettronica |
| Ruolo | No | Padre | Enumerazione |
- Se si sincronizzano anche le relazioni di contatto (tutori), è necessario includere un record nel user.csv.
- Ciò richiede un riferimento all'utente associato usando il campo "Email" e produce una dipendenza dal file user.csv.
- Ciò richiede un riferimento all'utente associato usando il campo "SIS ID" e produce una dipendenza dal file student.csv.
- Se il valore del ruolo non viene fornito, il valore della relazione viene omesso per impostazione predefinita su 'userContact'.