Condividi tramite


Formato di file CSV SDS (versione classica) V2.1

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

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

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.


Screenshot che mostra la panoramica del formato SDS (classico).

I file SDS V2.1 devono essere formattati in modo appropriato. Caricare tutti e cinque i file, denominati esattamente come dettagliati. I file e le intestazioni di colonna fanno distinzione tra maiuscole e minuscole. I file CSV devono essere in formato UTF-8. Per esaminare e scaricare un set di esempi di file CSV SDS V2.1, vedere il repository SDS GitHub.

Screenshot che mostra il confronto tra v2 e v2.1.

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

Screenshot che mostra orgs.csv specifica.

*Per filtrare solo in base a 'school'

Screenshot che mostra users.csv specifica.

Se si creano utenti:

Il campo username richiede che il dominio venga accettato da SDS. Ad esempio, cbean@domain.com.

FamilyName, givenName e posta elettronica sono necessari per gli utenti con ruoli di sorveglianza in relationships.csv. Gli utenti che sono personale, ma anche i contatti, è consigliabile che abbiano due record di utenti elencati, con il record utente contatti associato al proprio indirizzo di posta elettronica privato.

Aspettatevi che telefono e sms siano in E.164. Il provisioning di SDS non genera errori tramite telefono o sms se non è allineato con E.164. La convalida rimuove () -, spazi, punti (.) e mantiene + se è presente nella parte anteriore del valore fornito.

Screenshot che mostra roles.csv specifica.

Screenshot che mostra classes.csv specifica.

*Sincronizza solo un valore con il provisioning SDS se nel record vengono trovati più valori.

Screenshot che mostra enrollments.csv specifica.

Screenshot che mostra academicSessions.csv specifica.

Screenshot che mostra courses.csv specifica.

Screenshot che mostra demographics.csv specifica.

Screenshot che mostra userFlags.csv specifica.

Screenshot che mostra relationships.csv specifica.

Valori enumerati supportati

Nel formato SDS V2.1 sono presenti 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 definisce i valori enumerati supportati nel formato SDS V2.1.

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

Ruoli dell'organizzazione utente    
Studente DocenteAssistente Principal
Proctor Personale SpecialServices
Insegnante Professore Coaching
ItAdmin Strumento ricerche assistente
OfficeStaff Docente Sedia
Infermiera Affiliazione Aggiunta
OccupationalTherapist Alumni Sostituto
Istruttore Advisor Paraprofessionale
PhysicalTherapist Facoltà Amministratore
SpeechTherapist VisionTherapist Altro

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

Tipi di organizzazione    
Scuola MinistryOfEducation LocalAuthority
Reparto Università Area geografica
Quartiere Università Divisione
Locale Campus Provincia
Stato AdultEducation ResearchCenter
Nazionale Comune Programma
DepartmentOfEducation AcademicTrust

Il demographics.csv contiene l'attributo "stato di nascita" e supporta i valori di enumerazione.

Stato    
AK LA OPPURE
AL MA PA
AR MD PR
COME ME PW
AZ MH RI
CA MI M.B
CO MN SD
CT MO TN
DC MP TX
DE SIGNORA UT
FL MONTE VIRGINIA
FM NC VI
GA ND VT
GU NE ZM
CIAO NH WI
IA NJ WV
ID NM WY
IL NV AA
POLLICI NY AE
KS OH AP
KY OK

Il academicSessions.csv contiene l'attributo "type" della sessione accademica e supporta i valori di enumerazione.

Tipi di sessione accademica    
SchoolYear Semestre Termine

Il demographics.csv contiene l'attributo "sex" e supporta i valori di enumerazione.

Sesso    
Uomo Donna NotSelected

Il academicSessions.csv contiene l'attributo "school year" e supporta i valori di enumerazione.

Anno scolastico    
2021 2025 2029
2022 2026 2030
2023 2027 2031
2024 2028

La relationships.csv contiene l'attributo "relationship role" e supporta i valori di enumerazione.

Ruoli di relazione    
Padre Custode Aiutante
Relativo Bambino Amministratore
Medico Altro

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

Ruoli di registrazione    
Studente VisionTherapist Sostituto
Aiutante Paraprofessionale Principal
Proctor DocenteAssistente SpecialServices
Insegnante Professore Advisor
Amministratore Docente Coaching
OccupationalTherapist Affiliazione Assistente
PhysicalTherapist Aggiunta Personale
SpeechTherapist Istruttore

Il Courses.csv contiene l'attributo "subject" della sessione accademica e supporta i valori di enumerazione.

Oggetto del corso Descrizione
01 Lingua e letteratura inglese
02 Matematica
03 Vita e scienze fisiche
04 Scienze sociali e storia
05 Arti visive e dello spettacolo
07 Educazione religiosa e teologia
08 Educazione fisica, sanitaria e della sicurezza
09 Scienza militare
10 Information Technology
11 Comunicazione e tecnologia audio/visiva
12 Business e marketing
13 Produzione
14 Scienze dell'assistenza sanitaria
15 Servizio pubblico, protettivo e pubblico
16 Ospitalità e turismo
17 Architettura e costruzione
18 Agricoltura, alimentazione e risorse naturali
19 Servizi umani
20 Trasporto, distribuzione e logistica
21 Ingegneria e tecnologia
22 Varie
23 Non specifico del soggetto
24 Lingue del mondo

Il userFlags.csv contiene l'attributo "flag" e supporta i valori di enumerazione.

Flag utente Descrizione
FreeLunch Pranzo gratuito
ReducedLunch Pranzo ridotto
Senzatetto Senzatetto
GiftedOrTalented Dotato o talentuoso
504 Sezione 504 Posizionamento
ELL Apprenditore di lingua inglese
LEP Conoscenza limitata della lingua inglese
IEP Servizi speciali per l'istruzione/Piano di istruzione indipendente idoneo

Il demographics.csv contiene l'attributo "ethnicity" e supporta i valori di enumerazione.

Etnicità Descrizione
IspanicOrLatinoEthnicity Etnie ispaniche o latine

Il demographics.csv contiene l'attributo "race" e supporta i valori di enumerazione.

Gara Descrizione
AmericanIndianOrAlaskaNative Indiano americano o nativo dell'Alaska
NativeHawaiianOrOtherPacificIslander Nativo hawaiano o altro isolano del Pacifico
BlackOrAfricanAmerican Nero o afro-americano
DemographicRaceTwoOrMoreRaces Designa più gare
Asiatico Asiatico
Bianco Bianco

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

Il Courses.csv contiene l'attributo "grade" della sessione accademica e supporta i valori di enumerazione.

Voto Descrizione
IT Neonati/bambini piccoli
PR Scuola materna
PK Prekindergarten
TK Asilo di transizione
KG Asilo
01 Prima elementare
02 Secondo grado
03 Terza elementare
04 Quarta elementare
05 Quinta elementare
06 Sesta elementare
07 Settimo grado
08 Ottavo grado
09 Nono grado
10 Decimo grado
11 Undicesima elementare
12 Dodicesimo grado
13 Grado 13
14 Grado 14
PS Postsecondary
UG Non laureato
Altro Altro
PS1 Matricola postsecondaria
PS2 Secondo secondo anno
PS3 Postsecondario junior
PS4 Senior postsecondario
Laurea Laurea
Laureato Laureato
Postgraduate Laurearsi con particolare attenzione alla ricerca
Alumni Alumni
AdultEducation Educazione degli adulti