Format de fichier CSV SDS v2.1

Vous pouvez utiliser des fichiers CSV (valeurs séparées par des virgules) au format School Data Sync (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. Le format de fichier CSV SDS V2.1 continue d’étendre les catégories de données qu’il prend en charge.

Si vous utilisez le format SDS V2.1, les fichiers doivent être correctement mis en forme. Chargez les fichiers, nommés exactement comme détaillé. Les en-têtes de colonne respectent la casse. Les fichiers CSV doivent être au format UTF-8 et conformes RFC. De plus, nous n’acceptons pas les sauts de ligne dans les données entrantes. Pour consulter et télécharger l’exemple d’ensemble de fichiers CSV SDS V2.1, consultez le référentiel GitHub SDS.

Obligatoire : les trois fichiers suivants doivent être fournis. Si vous gérez uniquement les utilisateurs et non les classes, vous devez uniquement fournir ces fichiers. 

• orgs.csv

• users.csv

• roles.csv

Facultatif/Obligatoire : les deux fichiers suivants ne sont pas obligatoires si vous gérez uniquement les utilisateurs. Si vous gérez également des classes et des inscriptions de classes, vous devez fournir ces deux fichiers répertoriés, ainsi que les trois fichiers.

• classes.csv

• enrollments.csv

Facultatif : les fichiers suivants sont facultatifs et sont utilisés pour améliorer les expériences. Ces fichiers ne sont pas obligatoires, sauf si les fichiers mentionnés précédemment ont des références de données basées sur les notes. 

• academicSessions.csv (Si votre roles.csv, classes.csv ou courses.csv contient des données de session universitaires, les données correspondantes doivent être fournies pour éviter les messages d’erreur lors du traitement des données.)

• courses.csv (Si vos données classes.csv contiennent des liens vers des cours, les données correspondantes doivent être fournies pour éviter les messages d’erreur lors du traitement des données.)

• demographics.csv

• userFlags.csv

• relationships.csv

Chaque fichier CSV doit contenir des données pour les champs indiqués « Oui » sous « Obligatoire », les champs notés « Non » sont des données « Facultatifs ». Les en-têtes de champ marqués comme « Obligatoire » doivent exister dans les fichiers fournis, sinon ils ne seront pas acceptés. Les en-têtes de champ marqués comme « Facultatif » ne doivent pas nécessairement être présents dans les fichiers si les données facultatives correspondantes ne sont pas passées.

Les champs avec des valeurs énumérées définies comme marquées dans la colonne « Types de données » ont un ensemble spécifique de valeurs qu’ils prennent en charge. L’ensemble de valeurs par défaut pris en charge pour les champs Enum consultez Liste de valeurs par défaut.

orgs.csv

users.csv

• familyName et givenName sont requis pour les utilisateurs si vous utilisez l’option « Créer des utilisateurs sans correspondance ».
• familyName, givenName et email sont requis pour les utilisateurs si vous utilisez l’option « Associations de contacts étudiants » pour les utilisateurs qui ont un rôle de relation de contact dans relationships.csv. Pour les utilisateurs qui sont membres du personnel et également des contacts, nous recommandons qu’ils aient deux enregistrements utilisateur répertoriés, avec l’enregistrement utilisateur des contacts associé à leur adresse e-mail privée.
• Attendez-vous à ce que les champs téléphone et SMS soient mis en forme en fonction de la norme E.164. Le caractère plus est remplacé par le numéro de téléphone ou le caractère plus est suivi de l’indicatif du pays, de l’indicatif régional, du préfixe téléphonique et du numéro de ligne.
• password n’est plus utilisé pour fournir le mot de passe par défaut pour la création de nouveaux utilisateurs.

roles.csv

• Nécessite une référence à l’utilisateur associé à l’aide du champ « userSourcedId » et génère une dépendance sur le fichier users.csv.
• Nécessite une référence à l’organisation associée à l’aide du champ « orgSourcedId » et génère une dépendance sur le fichier orgs.csv.
• En cas de réussite : cela nécessite une référence aux termes associés (sessions universitaires) à l’aide du champ « sessionSourcedId » et génère une dépendance par rapport au fichier academicSessions.csv.
• isPrimary indique si ce rôle est le rôle principal (true) ou secondaire (false) pour cette organisation. Si vous passez plusieurs rôles, pour le même utilisateur et la même organisation, il DOIT y avoir un seul rôle principal défini sur (true) pour chaque organisation.
• Valeurs de date à fournir au format ISO8601.
• Zéros « 0 » non significatifs manquants sur la valeur entrante pour l’ENUM de niveau de grade, par exemple, « 1 » correspond à la liste de valeurs définie (ENUM) « 01 » et est stocké sous la forme « 01 ».

classes.csv

• Cela nécessite une référence à l’école (organisation) associée à l’aide du champ « orgSourcedId » et génère une dépendance sur le fichier orgs.csv.
• En cas de réussite : cela nécessite une référence aux termes associés (sessions universitaires) à l’aide du champ « sessionSourcedIds » et génère une dépendance sur le fichier academicSessions.csv.
• Si elle est réussie : si une classe est associée à plusieurs sessions au cours de la même année scolaire, par exemple semestre d’automne et semestre de printemps, vous pouvez fournir les deux sourcesdId pour les sessions de l’enregistrement. Les valeurs doivent être combinées en une seule chaîne avec les valeurs entourées de guillemets et séparées par des virgules.
  • L’association à plusieurs sessionSourcedIds est stockée uniquement dans Data Lake.
  • L’attribut d’extension de groupe Microsoft 365 pour les ID de session ne prend pas en charge plusieurs associations.
• Si elle est réussie : cela nécessite une référence au cours associé à l’aide du champ « courseSourcedId » et génère une dépendance sur le fichier courses.csv.

enrollments.csv

• Cela nécessite une référence à la classe associée à l’aide du champ « classSourcedId » et génère une dépendance sur le fichier classes.csv.
• Cela nécessite une référence à l’utilisateur associé à l’aide du champ « userSourcedId » et génère une dépendance sur le fichier users.csv.

academicSessions.csv

• Attendez-vous à ce que les valeurs de date soient fournies au format ISO8601.

courses.csv

• Cela nécessite une référence au organization (org) associé à l’aide du champ orgSourcedId et génère une dépendance sur le fichier orgs.csv.
• En cas de réussite : cela nécessite une référence à l’enregistrement de l’année de session académique associé à l’aide du champ « schoolYearSourcedId » où le type = schoolYear. Cela produit une dépendance sur le fichier academicSessions.csv.
• Zéros « 0 » non significatifs manquants sur la valeur entrante pour l’ENUM de niveau de grade, par exemple, « 1 » correspond à la liste de valeurs définie (ENUM) « 01 » et est stocké sous la forme « 01 ».

relationships.csv

• Si vous synchronisez également les relations de contact (tuteurs), vous devez inclure un enregistrement pour celles-ci dans le users.csv.
• Cela nécessite une référence à l’utilisateur associé à l’aide du champ « userSourcedId » et génère une dépendance sur le fichier users.csv.
• Cela nécessite une référence à l’utilisateur associé à l’aide du champ « relationshipUserSourcedId » et génère une dépendance sur le fichier users.csv.
• En outre, familyName, givenName et email sont requis pour les utilisateurs qui ont des rôles relation de contact.

demographics.csv

• Cela nécessite une référence à l’utilisateur associé à l’aide du champ « userSourcedId » et génère une dépendance sur le fichier users.csv.
• Le mappage de valeurs multiples à « raceCodes » doit être combiné en une seule chaîne avec les valeurs entourées de guillemets et séparées par des virgules.

userFlags.csv

• Cela nécessite une référence à l’utilisateur associé à l’aide du champ « userSourcedId » et génère une dépendance sur le fichier users.csv.