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.
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.
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.
*Per filtrare solo in base a 'school'
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.
*Sincronizza solo un valore con il provisioning SDS se nel record vengono trovati più valori.
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 |