File CSV in formato intelligente per SDS

È possibile usare file CSV (valori delimitati da virgole) nel formato Clever per sincronizzare il sistema informativo dell'istituto di istruzione (SIS) con Office 365. L'uso di questo formato di file 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 elencati di seguito.

migliorare le esperienze per i prodotti e le funzionalità di Microsoft 365

Quando si usano file CSV in formato Clever per SDS, i file devono essere formattati in modo appropriato. Questa sezione descrive i requisiti di formattazione per l'uso con SDS. Gli unici campi assolutamente obbligatori sono evidenziati in verde di seguito. Questa operazione si collega anche alle informazioni di esempio nella pagina Esempi di file CSV . I cinque file CSV seguenti devono essere denominati esattamente come descritto di seguito. Il admins.csv non è accettato per l'uso in SDS.

Importante

I file CSV accettati e i file CSV predefiniti esportati presentano alcune differenze. Per caricare questi file CSV e sincronizzarli correttamente, devono seguire il formato elencato qui. Altre informazioni sono disponibili nella parte inferiore di questa pagina. I file CSV devono essere in formato UTF-8.

students.csv

teachers.csv

schools.csv

sections.csv

enrollments.csv

Formato di file CSV

Ogni file CSV deve contenere tutti i campi obbligatori evidenziati in verde di seguito. Ogni file CSV può contenere anche uno dei campi facoltativi elencati. Se i file CSV contengono caratteri non supportati, possono essere sostituiti inline durante la sincronizzazione selezionando l'opzione "Sostituisci caratteri speciali non supportati" all'interno della Configurazione guidata profilo di sincronizzazione SDS. Questo tuttavia non rimuoverà gli "spazi vuoti", che non sono validi. Le tabelle seguenti elencano gli attributi obbligatori e facoltativi in un file in base al file:

Nota

Microsoft consiglia di usare il formato ISO 8601 per tutti i campi delle date nei file CSV SDS, sotto forma di AAAA-MM-GG o AAAAMMGG. SDS prevede di introdurre funzionalità nei prossimi mesi che richiederanno questo formato nei campi Inizio termine e Data di fine indicati di seguito.

  • >Students.csv Data di nascita
  • >Sections.csv termine StartDate
  • >Sections.csv termine EndDate

attributi obbligatori e facoltativi.

attributi obbligatori e facoltativi

Enumerazione corretta

errori e avvisi

sds per l'elaborazione della convalida delle informazioni dettagliate

Differenze tra i file CSV in formato Clever predefiniti e quelli accettati da SDS

Ci sono alcune discrepanze tra i file CSV Clever accettati da SDS e i file CSV predefiniti esportati da Clever che possono causare una certa confusione. Le differenze maggiori sono le colonne per Nome utente e Password nel file Student.csv.

Il campo username è necessario principalmente per i criteri di corrispondenza durante la creazione del profilo. Questo può essere visualizzato nel passaggio 5 su Come distribuire con file CSV in formato Clever.

La colonna username, insieme alla colonna password, viene usata durante la creazione di nuovi utenti per un profilo.

Le altre differenze sono attributi sincronizzati facoltativi. SDS sincronizza gli attributi dell'estensione solo su gruppi e utenti pertinenti elencati in precedenza. Se uno di questi file contiene informazioni aggiuntive, la sincronizzazione continuerà a essere elaborata, ma le informazioni aggiuntive non verranno associate all'utente o al gruppo. Questo comportamento è previsto ed è vero per tutte le sincronizzazioni del profilo CSV.

Esempio: se un file di student.csv è stato caricato con la colonna "Gender" come stabilito nella documentazione clever, SDS continuerà a elaborare il file e sincronizzare altri attributi con gli studenti di destinazione, ma non ci sarà un attributo sincronizzato per genere.