Format de fichier CSV SDS v2

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

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.

Lorsque vous utilisez le format SDS V2, les fichiers doivent être correctement mis en forme. Cet article décrit les exigences de mise en forme et les attributs pris en charge pour une utilisation avec SDS. Vous devez charger les quatre fichiers, nommés exactement comme indiqué ci-dessous. Les fichiers et les en-têtes de colonne respectent la casse. Pour consulter et télécharger l’exemple d’ensemble de fichiers CSV SDS V2, consultez le référentiel GitHub SDS.

Chaque fichier CSV doit contenir tous les champs obligatoires mis en surbrillance en vert ci-dessous. 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. 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 prennent en charge. Consultez l’ensemble de valeurs énumérées de prise en charge pour chaque attribut enum dans la section suivante.

Valeurs énumérées (Enum) prises en charge

Dans le nouveau format SDS V2, plusieurs attributs sont 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 ci-dessous définit les valeurs d’énumération prises en charge dans le format SDS V2.

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

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

La orgs.csv contient l’attribut « type » et prend en charge les valeurs d’énumération ci-dessous.

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