Formato di file CSV SDS V1
Importante
CLIENTI DI TRANSIZIONE SDS (versione classica): non tutti i campi sono supportati per inserire i dati nella nuova esperienza SDS in base al formato v1. I dati sono indicati in Formato file CSV SDS v1 nella colonna Obbligatorio. I dati non sono supportati.
Importante
Inoltre, i valori Grade e Course Subject passati devono essere allineati ai codici List of Values (ENUM) corrispondenti. Se necessario, utilizzare Gestione 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 seguenti 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 di seguito. 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 o meno. In caso contrario, il sistema determinerà che i record non sono più attivi e li contrassegnerà come tali.
Obbligatorio: i tre file elencati di seguito devono essere selezionati prima di poter procedere. 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 elencati di seguito, insieme ai tre file precedenti. In caso contrario, non selezionare alcun file con questi nomi.
section.csv
studentenrollment.csv
teacherroster.csv
Facoltativo: non è necessario procedere, ma possono migliorare le esperienze. Se uno dei file seguenti è selezionato, è necessario selezionare anche l'altro 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 | Enum |
| 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". Ciò 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.
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) | Cucinare | Stringa |
| Secondo nome | No | Meredith | Stringa |
| Numero docente | No | 654321 | Stringa |
| Voto | No | 8 | Enum |
| 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". Ciò produce una dipendenza dal file school.csv.
- Tutti gli utenti elencati verranno impostati sul tipo di ruolo "insegnante".
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 | Enum |
| 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". Ciò produce 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 |
- È necessario un riferimento alla sezione associata usando il campo 'ID SIS sezione'. Ciò produce una dipendenza dal file section.csv.
- Ciò richiede un riferimento all'utente associato usando il campo 'SIS ID'. Ciò 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 |
- È necessario un riferimento alla sezione associata usando il campo 'ID SIS sezione'. Ciò produce una dipendenza dal file section.csv.
- Ciò richiede un riferimento all'utente associato usando il campo 'SIS ID'. Ciò 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, o piuttosto dal 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 | Enum |
- Se si sincronizzano anche le relazioni di contatto (tutori), è necessario includere un record nel user.csv.
- È necessario un riferimento all'utente associato usando il campo 'Email'. Ciò produce una dipendenza dal file user.csv.
- Ciò richiede un riferimento all'utente associato usando il campo 'SIS ID'. Ciò 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'.