Intégrité et surveillance de la synchronisation

Article
10/31/2024

Tableau de bord accueil

Pendant le traitement des données, School Data Sync (SDS) valide les données en apportant des données correctes dans les données du cache 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 correctes uniquement dans le cache. 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 cache.

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 !

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 cache.

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 cache.

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.

Intégrité de la synchronisation

Vue d’ensemble de l’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.

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
Time	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 Chargement CSV manuel avec School Data Sync.

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

Vue d’ensemble des détails de 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 .

Étapes de détails de synchronisation

Les phases sont un outil qui fournit des insights sur l’exécution sélectionnée à mesure qu’elle passe par chacune des étapes de l’exécution de synchronisation active. Les informations présentées lors de l’actualisation automatique d’une étape sont terminées et une autre commence.

Selon la taille des données, une phase peut être à l’état « en cours d’exécution » pendant une période prolongée.

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

L’association d’un utilisateur à un organization 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.

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 actuelles.
Les données reflètent quand le même enregistrement est présent dans l’exécution suivante.
- SDS conserve la valeur de date (heure) vue pour la première fois, et définit la date de dernière modification (heure) sur actuelle.
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 valeurs de date (heure) et de date de dernière modification (heure) vues pour la première fois.
  - 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.