Ingestion de données avec SDS v2.1 CSV

Configurer SDS pour Microsoft 365 Éducation locataire

• locataire Microsoft 365 Éducation

• Besoin d’autorisations d’administrateur général

  Avertissement

  Vous pouvez utiliser des fichiers CSV (valeurs séparées par des virgules) pour synchroniser votre système d’information scolaire (SIS) / système de gestion des étudiants (SMS). SDS prend uniquement en charge le chargement de fichiers CSV au format UTF-8 et conforme RFC. 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. Pour plus d’informations, consultez Format de fichier CSV SDS v2.1.

  Importante

  En vous connectant et en mettant à disposition des données d’établissement avec School Data Sync, vous reconnaissez être autorisé à partager ces données avec Microsoft et vous engagez à respecter les normes de gouvernance des données de votre organization.

Accès SDS et première connexion

Pour accéder au portail Administration SDS, lancez votre navigateur web, accédez à sds.microsoft.com, puis connectez-vous à l’aide de votre compte Microsoft 365 Global Administration.

1. Sélectionnez Démarrage.

   

2. Cliquez sur Continuer.

   

   Prévoyez quelques instants pour que les services s’approvisionnent sur le locataire avant l’étape suivante.

   

3. Sélectionnez Créer un flux entrant et Suivant pour continuer.

   

4. Choisissez votre source de données. Pour SDS CSV 2.1, sélectionnez l’option Se connecter à mes données.

5. Sélectionnez le format. Pour CSV, sélectionnez l’option CSV. À côté de continuer.

   

6. Vous devez fournir le nom de votre SIS/SMS. Sélectionnez également SDS v2.1 CSV. Sélectionnez Suivant pour continuer.

   

7. Sélectionnez Parcourir les fichiers pour présenter la boîte de dialogue Parcourir et sélectionner.

   

   Remarque

   Après le chargement initial lors de la création de votre flux entrant, vous devez toujours fournir le même ensemble de fichiers pour les chargements suivants, indépendamment des modifications apportées aux données dans les fichiers facultatifs ou non. Si ce n’est pas le cas, le système détermine que les enregistrements ne sont plus actifs et les marque comme tels.

8. Accédez à l’emplacement du fichier et sélectionnez les fichiers.

   

   Reportez-vous au format de fichier CSV SDS V2.1.

   Obligatoire : les trois fichiers répertoriés ci-dessous doivent être sélectionnés pour que vous puissiez progresser. 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 : non obligatoire si vous gérez uniquement les utilisateurs. Si vous gérez également des classes et des inscriptions de classes, vous devez fournir les deux fichiers répertoriés ci-dessous, ainsi que les trois fichiers ci-dessus. Si ce n’est pas le cas, ne sélectionnez aucun fichier portant ces noms. Si l’un est sélectionné et que l’autre ne l’est pas, lorsque vous sélectionnez Suivant, un message s’affiche indiquant qu’un de ces fichiers est manquant. Vous devez corriger avant de continuer.

   • classes.csv

   • enrollments.csv

   Facultatif : les fichiers suivants sont facultatifs et sont utilisés pour améliorer les expériences. Non obligatoire, sauf si les fichiers ci-dessus ont des références de données basées sur les notes ci-dessous.

   • academicSessions.csv (si votre roles.csv, classes.csv ou courses.csv contient des données de session universitaires, 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, fournis pour éviter les messages d’erreur lors du traitement des données.)

   • demographics.csv

   • userFlags.csv

   • relationships.csv

9. Une fois que vous avez terminé de sélectionner vos fichiers, sélectionnez Suivant pour continuer. Le système valide les noms des fichiers sélectionnés avant de passer à l’écran suivant. Si aucun fichier requis n’est trouvé, un message s’affiche et vous devez le traiter et le réélectionner.

   

10. Une fois les noms de fichiers validés, les fichiers sont chargés pour valider la structure des fichiers sélectionnés et sont mis en forme correctement avec les noms d’en-têtes basés sur la spécification CSV SDS v2.1.

    • Si vous recevez le message : Un ou plusieurs des fichiers trouvés ci-dessous ne correspondent pas au format attendu, passez en revue l’écran pour voir si des fichiers ne sont pas mis en forme correctement. Vous devez revenir à l’écran précédent pour resélectionner les fichiers après avoir corrigé les problèmes.

    • Si vous recevez le message : Nous ne pouvons pas trouver un ou plusieurs des fichiers facultatifs, passez en revue l’écran pour voir quels fichiers sont introuvables. Si vous n’attendez pas ce message, vous devez revenir à l’écran précédent pour resélectionner les fichiers. Sinon, sélectionnez Suivant pour continuer.

    

11. Une fois le schéma de fichier validé, SDS effectue une validation rapide des données à partir des fichiers chargés. Les données chargées passent par certaines des règles de correspondance et de validation des données SDS pour aider à identifier les données facultatives requises et fournies. Ce ne sont pas toutes les règles de validation, mais celles qui sont les plus rencontrées.

    

    

    Conseil

    Les résultats de validation des données ne sont pas bloquants pendant les expériences d’intégration ou de chargement csv. Vous avez deux options : quitter et revenir ultérieurement après la correction des données, ou passer à l’étape suivante pour continuer à configurer votre connexion de données et fournir ultérieurement les données corrigées avec les chargements suivants.

12. Pour plus d’informations sur les données signalées pour investigation, sélectionnez Afficher les détails du nom de fichier dans la liste pour explorer des éléments spécifiques.

    Vous serez également en mesure de télécharger un rapport par fichier pour avoir une longueur d’avance sur l’investigation et les correctifs dans le système source.

    Les colonnes de fichiers avec indicateur s’affichent avec la possibilité de développer et d’examiner quelle règle ou quelles règles ont été signalées.

    

    En cliquant sur la règle, vous pouvez voir un autre résumé des 10 premiers enregistrements, par exemple.

    

    Une fois votre investigation terminée, fermez les boîtes de dialogue, puis sélectionnez Suivant.

13. Choisissez votre année scolaire actuelle et indiquez un nom convivial, par exemple 2023 ou 2022 - 2023. (Les caractères doivent être utf8 ou seront automatiquement supprimés).

    Importante

    L’année scolaire est utilisée pour associer des données entrantes afin de générer des données historiques d’une année à l’autre. L’approche est alignée sur une année scolaire et une année civile. Si votre année scolaire s’étend sur une année civile, par exemple, début du 15/08/2022 et se termine le 15/06/2023, la valeur de l’année scolaire à sélectionner est l’année de fin, 2023. Pour plus d’informations, consultez Gestion de l’année scolaire

    Entrez les dates de début et de fin de votre année scolaire.

    Entrez la date à laquelle SDS doit arrêter la synchronisation des données en fonction de l’année scolaire définie pour cette source. Il est le plus courant d’arrêter la synchronisation des données à la date de fin d’année scolaire que vous venez d’entrer.

    Sélectionnez Suivant pour continuer.

    

14. Sélectionnez les options de règle d’identité utilisateur. Effectuez vos sélections pour les rôles de personnel et d’étudiant.

    Remarque

    La correspondance utilisateur est effectuée avec le flux entrant et n’écrit ni ne met à jour les objets utilisateur dans Microsoft Entra ID. La correspondance est effectuée et stockée dans le lac de données Éducation. Pour plus d’informations, consultez Microsoft 365 Gérer les utilisateurs sur l’écriture du lien de correspondance avec le flux sortant.

    • Attribut de la source : attribut utilisateur basé sur les données provenant de votre SIS/SMS.
      • Les options sources disponibles sont Nom d’utilisateur, Email et ActiveDirectory MatchId.
    • Attribut à mettre en correspondance : propriété utilisateur dans Microsoft Entra ID à mettre en correspondance.
      • Les options de correspondance Microsoft Entra ID disponibles sont UserPrincipalName et Mail.
    • (FACULTATIF) Si vos données utilisateur n’incluent pas la valeur @domain , sélectionnez un domaine dans la liste.

    Avertissement

    La sélection d’un domaine est facultative et ne doit être utilisée que si les données entrantes basées sur l’attribut sélectionné à partir de la source n’incluent pas la valeur @domain . SDS n’case activée pas et ne s’ajoute pas si la valeur est manquante sur un enregistrement. SDS ajoute la sélection de domaine à tous les enregistrements, ce qui peut entraîner des @domain@domain et ne pas trouver de correspondances dans ces instances pour le mappage utilisateur existant avec les utilisateurs dans Microsoft Entra ID.

    Attention

    Si les utilisateurs SIS/SMS, par exemple les utilisateurs du groupe de rôles personnel, peuvent être associés à @domain1 ou @domain2 ou @domain3 vous devez avoir un @domain inclus dans les données sources, en fonction de l’attribut sélectionné dans la sélection de la source (exemple : prefix@domain). Cela est nécessaire pour que votre attribut corresponde à : UserPrincipalName ou Mail pour trouver le bon Microsoft Entra’utilisateur avec lequel correspondre.

    Dans le instance qu’un utilisateur a plusieurs rôles, les règles suivantes sont utilisées pour déterminer les règles de correspondance du personnel ou des étudiants qui doivent être utilisées entre l’enregistrement utilisateur et l’objet utilisateur Microsoft Entra.

    • Si isPrimary est défini pour tous les rôles d’étudiant, même s’il existe une association à un rôle de personnel, la correspondance est établie en fonction du rôle d’étudiant.

    • Si isPrimary est défini pour n’importe quel rôle de personnel, même s’il existe une association à un rôle d’étudiant, la correspondance est établie en fonction du rôle du personnel.

    • Si isPrimary est défini pour le rôle d’enseignant et d’étudiant, la correspondance est établie en fonction du rôle du personnel.

    • Si isPrimary n’est défini pour aucun rôle, en particulier avec une combinaison de rôles de personnel et d’étudiant, la correspondance est basée sur le rôle du personnel.

    Importante

    Lors de la configuration du flux Gérer les utilisateurs de Microsoft 365, ces règles sont utilisées si l’option est activée pour Créer des utilisateurs sans correspondance, afin de définir la construction de la propriété Microsoft Entra UserPrincipalName.

    Une fois que vous êtes satisfait de vos sélections, sélectionnez Suivant pour continuer.

    

15. Examiner les informations présentées dans Vérifier et créer. Si tout semble correct, sélectionnez le bouton Créer . Si ce n’est pas le cas, vous pouvez revenir à correct.

    

    

16. Votre flux de données entrant a été créé et la première exécution est en attente, sélectionnez le bouton Terminé . Revenez en arrière pour voir la status de votre première exécution.

    

    

    Conseil

    Vous pouvez configurer votre configuration Gérer les données immédiatement après avoir défini votre configuration de données Connect, pendant la première exécution active ou ultérieurement une fois la première exécution terminée.

17. Pour case activée sur la status de l’exécution, revenez à la page Du tableau de bord Accueil.

    S’il n’y a aucun problème avec vos données, le tableau de bord Accueil indique « Aucune erreur de données ou avertissement trouvé » et « Nous n’avons rencontré aucune erreur de données ou avertissement lors de votre dernière exécution. Poursuivez l’excellent travail !

    Si des problèmes sont détectés avec vos données, le tableau de bord Accueil indique que « Nous avons détecté des problèmes avec vos données » et vous encourage à examiner l’intégrité de la synchronisation.

    Remarque

    Pour charger manuellement les modifications après votre première exécution pour mettre à jour les modifications à partir de vos données sources , consultez Mettre à jour les données sources avec SDS CSV

    Le nombre maximal de chargements, avec une exécution correspondante, est de six fois par jour calendaire. Après six fois par jour si vous chargez, il ne sera exécuté que jusqu’à deux fois plus en fonction de la cadence d’exécution automatisée de SDS toutes les 12 heures.