Condividi tramite


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 456789 ID univoco
Nome 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 123456 ID univoco
ID SIS dell'istituto di istruzione 456789 ID univoco
Username 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 654321 ID univoco
ID SIS dell'istituto di istruzione 456789 ID univoco
Username 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 334455 ID univoco
ID SIS dell'istituto di istruzione 456789 ID univoco
Nome sezione 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 334455 ID univoco
SIS ID 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 334455 ID univoco
SIS ID 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 jsmith@outlook.com Posta elettronica
Nome John Stringa
Cognome 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 123456 ID univoco
Posta elettronica 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'.