Intégrité et surveillance de la synchronisation

  • Article

Tableau de bord accueil

Pendant le traitement des données, School Data Sync (SDS) valide les données en apportant de bonnes données dans le lac de données et en signalant les données incorrectes. À la fin de chaque exécution de synchronisation, des statistiques sont générées pour faciliter l’intégrité et la surveillance.

Pour déterminer l’intégrité des données, est transmis par le biais de règles de correspondance et de validation des données pour aider à protéger les données requises et facultatives qui ne sont que dans le lac de données. Les données qui ne réussissent pas la validation sont identifiées comme des erreurs ou des avertissements et ne sont pas envoyées au lac de données.

Si aucune erreur ou avertissement n’a été trouvé, le résultat de l’exécution est Terminé. Le tableau de bord d’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 !

Capture d’écran de la bannière sans erreur ou avertissement.

Si des erreurs et des avertissements sont détectés, le résultat de l’exécution est Terminé avec des erreurs.

  • Une erreur est générée lorsqu’une valeur d’un enregistrement pour les données requises n’a pas réussi une règle de validation et/ou de mise en correspondance des données ; l’enregistrement a été supprimé et n’a pas été envoyé au lac de données.

S’il n’y a que des avertissements trouvés, le résultat de l’exécution est Terminé avec des avertissements.

  • L’avertissement est déclenché lorsqu’une valeur d’un enregistrement pour des données facultatives n’a pas réussi une règle de validation et/ou de correspondance des données ; la valeur a été supprimée, mais l’enregistrement a été envoyé au lac de données.

Le tableau de bord accueil informe que « Nous avons détecté des problèmes avec vos données » et vous encourage à examiner l’intégrité de la synchronisation. Pour plus d’informations sur les résultats de l’exécution de synchronisation, sélectionnez Examiner l’intégrité de la synchronisation.

Capture d’écran de la bannière problèmes détectés.

Intégrité de la synchronisation

L’intégrité de la synchronisation est un outil qui vous permet de mieux comprendre l’intégrité de vos données synchronisées et de faciliter les investigations sur les données.

Les modifications apportées aux données se produisent en fonction des modifications de données de l’exécution de synchronisation la plus récente.

Une exécution de synchronisation est le séquencement des configurations de données de connexion et de gestion.

Capture d’écran de l’écran d’intégrité de l’exécution.

L’intégrité de la synchronisation fournit également une représentation historique des 14 dernières exécutions.

  • Démarrage de l’exécution : horodatage au démarrage de l’exécution globale
  • Fin de l’exécution : horodatage à la fin de l’exécution globale
  • Exécuter status : status globale sur tous les flux de données
    • Exécution : exécution active
    • Terminé : terminé sans erreurs ou avertissements
    • Terminé avec des erreurs : terminé, mais des erreurs ont été détectées
    • Terminé avec des avertissements : terminé, mais seuls les avertissements ont été trouvés
    • Échec : exécution annulée par le système ou le client

Pour examiner les données marquées d’un indicateur, vous pouvez sélectionner Télécharger le rapport pour récupérer une copie du rapport.

Le rapport est mis en forme comme suit :

Nom de colonne Description Exemple
Règle Représentation de la règle de validation RequiredDataViolated
ExternalIdentifier ID externe/source de l’entité associée à partir du système source 7B2C8A0B33-F7E5-460B-993A-7257165430F7
Severity Représentation de gravité des données marquées d’un indicateur Erreur de validation, avertissement de validation
EntityCode Représentation de la zone liée à l’erreur Personne, organisation, inscription
FriendlyMessage En fonction des messages d’erreur et d’avertissement Une valeur requise pour {record} est manquante dans le nom du champ : {field} dans la source [{fileName}/{apiEndPoint}] pour créer l’enregistrement.
FlowName Nom du flux entrant ou sortant Entrée entrante de l’API OneRoster
SourceSystemName Nom de la source d’où provient l’enregistrement Contoso SIS
Temps Données / Heure à laquelle l’enregistrement a été identifié pendant le traitement, UTC.  2023-08-21T02 :53 :00Z
  • Pour plus d’informations sur les règles de correspondance et de validation des données, consultez Règles et descriptions de validation.
  • Pour plus d’informations sur la liste de valeurs par défaut prise en charge, consultez Liste de valeurs par défaut.
  • familyName, givenName et email sont requis pour les utilisateurs qui ont des rôles de contact/tuteur.
  • Le téléphone et les sms doivent être inclus dans E.164 et +. (Exemple : +1234567890)

Conseil

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

Avertissement

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

Hiérarchisation des erreurs pour la correction

Lors de la résolution des erreurs, nous vous recommandons de hiérarchiser les erreurs de validation avec le plus d’instances pour le même code d’entité avant la résolution des autres erreurs.

Les erreurs de validation peuvent entraîner de nombreuses erreurs ultérieures pour chaque instance dans la même exécution de données. Souvent, la correction de ces erreurs de validation commence par corriger de nombreuses erreurs liées à la liste qui se trouvent lors de la validation.

Détails de la vue d’intégrité de la synchronisation

Pour afficher les statistiques de l’exécution, vous pouvez sélectionner Afficher les détails pour ouvrir un menu volant et afficher les détails de l’exécution. Les statistiques de l’exécution sont affichées sous l’onglet Vue d’ensemble .

Capture d’écran du panneau volant détails de l’exécution.

Pour mieux comprendre à partir de quelle étape les erreurs et les avertissements ont pu être déclenchés, sélectionnez l’onglet Étapes . Les informations sont réparties dans les étapes suivantes, en fonction de ce que gérer les configurations de données ont été activées.

  • Données d’établissement

  • Utilisateurs Microsoft 365

  • Groupes Microsoft 365

  • Microsoft IT Groupes

  • Dernières status

    • Terminé : terminé sans erreurs ou avertissements
    • Terminé avec des erreurs : terminé, mais des erreurs ont été détectées
    • Terminé avec des avertissements : terminé, mais seuls les avertissements ont été trouvés
    • Échec : exécution annulée par le système ou le client

Remarque

Pour plus d’informations, consultez Institutional et Run Statistics on statistics found on Run details.

Comment SDS détermine les données présentes et définit les status actives

Remarque

Pour plus d’informations sur la configuration de l’année scolaire, consultez Gestion de l’année scolaire

L’association d’un utilisateur à une session (par exemple, Année universitaire) est basée sur son rôle, lié à un organization.

L’association d’un utilisateur à une classe est basée sur son rôle lié à une inscription, qui inclut également un lien vers une session.

En fonction des données connectées, ces règles sont utilisées pour déterminer la connaissance de l’enregistrement et de son status de session dans le magasin de données.

  • Les données reflètent lorsqu’un nouvel enregistrement est présenté pour la première fois.
    • SDS définit la date de première consultation (heure) et la date de dernière modification (heure) comme étant actuelles et, le cas échéant, elle marque l’enregistrement comme « est actif dans la session » comme vrai.
  • Les données reflètent quand le même enregistrement est présent dans l’exécution suivante.
    • SDS conserve la première valeur de date (heure) vue, définit la date de dernière modification (heure) sur actuelle et laisse « est actif dans la session » sur true.
  • Les données se reflètent lorsque le même enregistrement n’est pas présent dans une exécution ultérieure.
    • SDS conserve les premières valeurs de date (heure) et de date de dernière modification (heure) et, le cas échéant, marque l’enregistrement comme « est actif dans la session » sur false.
      • Des exceptions se produisent lorsque des organisations, des personnes (utilisateurs) et des enregistrements de session persistent au fil du temps et ne sont pas inactivés.
      • Il existe des mises à jour propagées pour « inactivés ». Par exemple, si un enregistrement utilisateur n’est pas présent, le système conserve les valeurs de date (heure) et de date de dernière modification (heure) existantes. Le système définit « est actif dans la session » sur false pour les enregistrements d’organisation/rôle et d’inscription des utilisateurs.

Remarque

Pour plus d’informations sur la gestion des données, consultez Vue d’ensemble de la validation et de l’intégrité des données sur SDS.