Format de fichier CSV SDS V2

Fonctionnalités SDS principales 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 pour synchroniser votre système d’information scolaire (SIS) avec Office 365. L’utilisation du format de fichier CSV SDS V2 pour ing bien les catégories de données ci-dessous vous permet d’activer les fonctionnalités SDS principales pour l’approvisionnement. Il vous permet également d’améliorer les expériences pour les produits Microsoft 365 (M365) et les fonctionnalités répertoriées ci-dessous. Le format de fichier CSV SDS V2 continuera à développer les catégories de données qu’il prend en charge.

Notes

Les clients actuels du 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.

csv-file-v2.png.

Lorsque vous utilisez le format SDS V2, les fichiers doivent être correctement formatés. Cet article décrit les exigences de mise en forme et les attributs pris en charge pour une utilisation avec SDS. Vous devez télécharger les 4 fichiers, nommés exactement comme détaillé ci-dessous. Notez que les fichiers et les en-têtes de colonne sont sensibles à la cas. Pour consulter et télécharger un exemple d’ensemble de fichiers CSV SDS V2, voir le référentiel SDS GitHub.

csv-file-v2-1.png.

Chaque fichier CSV doit contenir tous les champs obligatoires en surbrillant en vert ci-dessous. Les champs non mis en surbrillant sont facultatifs. Bien que le contenu de certains attributs puisse être facultatif, les en-têtes de colonne sont obligatoires. En outre, les attributs avec des valeurs Enum définies comme marquées dans la colonne Types ont un ensemble spécifique de valeurs qu’ils supportent. Consultez l’ensemble de valeurs éumées de prise en charge pour chaque attribut enum dans la section suivante.

csv-file-v2-2.png.

csv-file-v2-3.png.

csv-file-v2-4.png.

csv-file-v2-5.png.

Valeurs éumées (enum) pris en charge

Dans le nouveau format SDS V2, il existe plusieurs attributs définis en tant que valeurs éumées, ce qui signifie que vous ne pouvez fournir qu’un ensemble sélectionné de valeurs dans les fichiers CSV. Toute autre valeur que les valeurs spécifiées entraîne une erreur lors du traitement de synchronisation. La section ci-dessous définit les valeurs d’enum pris en charge dans le format SDS V2.

Le users.csv contient l’attribut « role » prend en charge les valeurs d’enum ci-dessous.

csv-file-v2-6.png.

Le users.csv contient l’attribut « grade » et prend en charge les valeurs d’enum ci-dessous.

csv-file-v2-7.png.

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

csv-file-v2-8.png.

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

csv-file-v2-9.png.