Formato di file CSV SDS V2

Funzionalità SDS principali e funzionalità di Microsoft 365 tramite metodo di inserimento

È possibile usare file CSV (valori delimitati da virgole) nel formato SDS V2 per sincronizzare il sistema informativo dell'istituto di istruzione (SIS) con Office 365. L'uso del formato di file CSV SDS V2 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 (Microsoft 365) elencati di seguito. Il formato di file CSV SDS V2 continuerà a espandere le categorie di dati supportate.

Nota

Gli attuali clienti in formato CSV V2 possono continuare a usare fino a maggio 2022. È consigliabile usare il formato CSV V2.1 con le funzionalità aggiuntive.

Quando si usa il formato SDS V2, i file devono essere formattati in modo appropriato. Questo articolo descrive i requisiti di formattazione e gli attributi supportati per l'uso con SDS. È necessario caricare tutti e quattro i file, denominati esattamente come descritto di seguito. I file e le intestazioni di colonna fanno distinzione tra maiuscole e minuscole. Per esaminare e scaricare un set di esempi di file CSV SDS V2, vedere il repository GitHub SDS.

Ogni file CSV deve contenere tutti i campi obbligatori evidenziati in verde di seguito. I campi non evidenziati sono facoltativi. Anche se il contenuto di determinati attributi può essere facoltativo, le intestazioni di colonna sono necessarie. Inoltre, gli attributi con valori Enum definiti come contrassegnati nella colonna Tipi hanno un set specifico di valori supportati. Vedere il set di supporto di valori enumerati per ogni attributo di enumerazione nella sezione successiva.

Valori enumerati (Enum) supportati

Nel nuovo formato SDS V2 sono presenti diversi attributi definiti come valori enumerati, il che significa che è possibile fornire solo un set selezionato di valori all'interno dei file CSV. Qualsiasi valore diverso da quello specificato genererà un errore durante l'elaborazione della sincronizzazione. La sezione seguente definisce i valori di enumerazione supportati nel formato SDS V2.

Il users.csv contiene l'attributo "role" supporta i valori di enumerazione riportati di seguito.

Il users.csv contiene l'attributo "grade" e supporta i valori di enumerazione seguenti.

Il orgs.csv contiene l'attributo "type" e supporta i valori di enumerazione riportati di seguito.

Il enrollments.csv contiene l'attributo "role" e supporta i valori di enumerazione riportati di seguito.