Format de fichier CSV SDS (classique) v2.1

Fonctionnalités principales de SDS et fonctionnalités Microsoft 365 par méthode d’ingestion

Vous pouvez utiliser des fichiers CSV (valeurs séparées par des virgules) au format SDS V2.1 pour synchroniser votre système d’information scolaire (SIS) avec Office 365. L’utilisation du format de fichier CSV SDS V2.1 pour ingérer les catégories de données vous permet d’éclairer les principales fonctionnalités de SDS pour l’approvisionnement. Il vous permet également d’améliorer les expériences des produits et fonctionnalités Microsoft 365 répertoriés.

Remarque

Les clients actuels au format CSV V2 peuvent continuer à utiliser jusqu’en mai 2022. Nous vous recommandons d’utiliser le format CSV V2.1 avec ses fonctionnalités supplémentaires.

Les fichiers SDS V2.1 doivent être correctement mis en forme. Chargez les cinq fichiers, nommés exactement comme détaillé. Les fichiers et les en-têtes de colonne respectent la casse. Les fichiers CSV doivent être au format UTF-8. Pour consulter et télécharger l’exemple d’ensemble de fichiers CSV SDS V2.1, consultez le référentiel GitHub SDS.

Chaque fichier CSV doit contenir tous les champs obligatoires mis en surbrillance en vert. Les champs non mis en surbrillance sont facultatifs. Bien que le contenu de certains attributs puisse être facultatif, les en-têtes de colonne sont obligatoires. Les attributs avec des valeurs énumérées définies comme marquées dans la colonne Types ont un ensemble spécifique de valeurs qu’ils prennent en charge. L’ensemble de valeurs énumérées pris en charge pour chaque attribut figure dans la section suivante.

*Pour filtrer sur 'school' uniquement

Si vous créez des utilisateurs :

Le champ nom d’utilisateur nécessite que le domaine soit accepté par SDS. Par exemple : cbean@domain.com.

FamilyName, givenName et email sont requis pour les utilisateurs qui ont des rôles de gardien dans relationships.csv. Les utilisateurs qui sont membres du personnel, mais également les contacts, il est recommandé d’avoir deux enregistrements d’utilisateurs répertoriés, avec l’enregistrement utilisateur des contacts associé à leur adresse de messagerie privée.

Attendez-vous à ce que le téléphone et les sms soient en E.164. L’approvisionnement SDS ne génère pas d’erreur de téléphone ou de SMS s’il n’est pas aligné sur E.164. La validation supprime () -, les espaces, les points (.) et conserve + s’il est présent au début de la valeur fournie.

*Synchronise une seule valeur avec le provisionnement SDS si plusieurs valeurs sont trouvées sur l’enregistrement.

Valeurs énumérées prises en charge

Au format SDS V2.1, il existe des attributs définis en tant que valeurs énumérées, ce qui signifie que vous pouvez uniquement fournir un ensemble sélectionné de valeurs dans les fichiers CSV. Tout élément autre que les valeurs spécifiées entraîne une erreur pendant le traitement de la synchronisation. La section définit les valeurs énumérées prises en charge dans le format SDS V2.1.

Le users.csv contient l’attribut « role » et prend en charge les valeurs enum.

Rôles d’organisation d’utilisateur
Étudiant	TeacherAssistant	Directeur
Proctor	Personnel	SpecialServices
Enseignant	Professeur	Accompagnement
ItAdmin	Recherche	assistant
OfficeStaff	Conférencier	Chaise
Infirmière	Affiliation	Adjoint
OccupationalTherapist	Anciens	Substitute
Instructeur	Conseiller	Paraprofessional
PhysicalTherapist	Faculté	Administrateur
SpeechTherapist	VisionTherapist	Autre

Le orgs.csv contient l’attribut « type » et prend en charge les valeurs enum.

Types d’organisation
École	MinistryOfEducation	LocalAuthority
Service	Université	Région
District	Collège	Division
Local	Campus	Province
État	Éducation adulte	ResearchCenter
National	Municipalité	Programme
DepartmentOfEducation	AcademicTrust

Le demographics.csv contient l’attribut « état de naissance » et prend en charge les valeurs enum.

État
AK	LA	OR
AL	MA	PA
AR	MD	PR
AS	MOI	PW
AZ	MH	RI
CA	MI	SC
CO	MN	SD
CT	MO	TN
DC	MP	TX
DE	MS	UT
FL	MT	VA
FM	NC	VI
Disponible	ND	VT
GU	NE	WA
SALUT	NH	WI
IA	NJ	WV
ID	NM	WY
IL	NV	AA
DANS	NY	AE
KS	OH	AP
KY	OK

Le academicSessions.csv contient l’attribut « type » de session universitaire et prend en charge les valeurs d’énumération.

Types de sessions universitaires
SchoolYear	Semestre	Terme

La demographics.csv contient l’attribut « sex » et prend en charge les valeurs enum.

Sexe
Mâle	Femelle	Non sélectionné

Le academicSessions.csv contient l’attribut « année scolaire » et prend en charge les valeurs enum.

Année scolaire
2021	2025	2029
2022	2026	2030
2023	2027	2031
2024	2028

Le relationships.csv contient l’attribut « rôle de relation » et prend en charge les valeurs d’énumération.

Rôles de relation
Parent	Gardien	Aide
Relative	Enfant	Administrateur
Médecin	Autre

Le enrollments.csv contient l’attribut « role » et prend en charge les valeurs enum.

Rôles d’inscription
Étudiant	VisionTherapist	Substitute
Aide	Paraprofessional	Directeur
Proctor	TeacherAssistant	SpecialServices
Enseignant	Professeur	Conseiller
Administrateur	Conférencier	Accompagnement
OccupationalTherapist	Affiliation	Assistant
PhysicalTherapist	Adjoint	Personnel
SpeechTherapist	Instructeur

Le Courses.csv contient l’attribut « sujet » de la session académique et prend en charge les valeurs enum.

Course Subject	Description
01	Langue et littérature anglaises
02	Mathématiques
03	Sciences de la vie et physique
04	Sciences sociales et histoire
05	Arts visuels et de la scène
07	Enseignement religieux et théologie
08	Éducation physique, santé et sécurité
09	Science militaire
10	Technologies de l’information
11	Communication et technologie audio/visuelle
12	Affaires et marketing
13	Production
14	Sciences de la santé
15	Services publics, de protection et gouvernementaux
16	Hôtellerie et tourisme
17	Architecture et construction
18	Agriculture, alimentation et ressources naturelles
19	Services à la personne
20	Transport, distribution et logistique
21	Ingénierie et technologie
22	Divers
23	Non spécifique à l’objet
24	Langues du monde

Le userFlags.csv contient l’attribut « flag » et prend en charge les valeurs enum.

Indicateurs utilisateur	Description
FreeLunch	Déjeuner gratuit
ReducedLunch	Déjeuner réduit
Sans-abri	Sans-abri
GiftedOrTalented	Doué ou talentueux
504	Article 504 Placement
ELL	Apprenant de l’anglais
LEP	Maîtrise limitée de l’anglais
IEP	Services d’éducation spécialisée / Programme d’éducation indépendant éligible

Le demographics.csv contient l’attribut « ethnicity » et prend en charge les valeurs enum.

Ethnicité	Description
HispanicOrLatinoEthnicity	Ethnicité hispanique ou latino-américaine

Le demographics.csv contient l’attribut « race » et prend en charge les valeurs enum.

Course	Description
AmericanIndianOrAlaskaNative	Indien d’Amérique ou natif de l’Alaska
NativeHawaiianOrOtherPacificIslander	Natif d’Hawaïen ou d’autres îles du Pacifique
BlackOrAfricanAmerican	Noir ou afro-américain
DemographicRaceTwoOrMoreRaces	Désigne plusieurs races
Asiatique	Asiatique
Blanc	Blanc

Le roles.csv contient l’attribut « grade » et prend en charge les valeurs d’énumération.

Le Courses.csv contient l’attribut « grade » de la session universitaire et prend en charge les valeurs d’énumération.

Grade	Description
Professionnels de l’informatique	Nourrisson/tout-petit
PR	Préscolaire
PK	Prekindergarten
TK	Jardin d’enfants de transition
KG	Maternelle
01	Première année
02	Deuxième année
03	Ce2
04	Cm1
05	Cm2
06	Sixième
07	Cinquième
08	Quatrième
09	Troisième
10	Seconde
11	11ème année
12	12ème année
13	13e année
14	14e année
PS	Postsecondary
UG	Non classé
Autre	Autre
PS1	Frais d’études postsecondaires
PS2	Deuxième année d’études postsecondaires
PS3	Études postsecondaires juniors
PS4	Niveau d’études postsecondaires
Premier cycle	Premier cycle
Diplômé	Diplômé
Troisième cycle	Diplômé en mettant l’accent sur la recherche
Anciens	Anciens
Éducation adulte	Éducation des adultes