SDS pour l’Informations et la surveillance des données

Examiner l’état des données

Si SDS pour Informations des problèmes avec vos données, cliquez sur Examiner l’état des données.

problèmes avec les données.

L’état des données vous montre jusqu’aux 14 dernières séries ou jusqu’à sept derniers jours.

l’état des données.

Si vos données ont des erreurs, vous pouvez cliquer sur le lien « Télécharger le rapport » sur le côté droit de l’écran.

Priorisation 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 grand nombre d’instances pour le même code d’entité avant de résoudre les autres erreurs. Les erreurs de validation peuvent entraîner de nombreuses erreurs ultérieures pour chaque instance au sein de la même suite de données. Souvent, la correction de ces erreurs de validation d’abord corrigera par la suite de nombreuses erreurs liées à la liste de listes trouvées lors de la validation.

Règles de correspondance et de validation par type de données

Ce tableau indique les règles de correspondance et de validation par type de données et la façon dont les valeurs sont stockées. Ces règles ne s’appliquent pas à la validation et à la gestion des erreurs des profils de synchronisation SDS.

graphique de correspondance et de validation des données.

*Indique que l’enregistrement est unique dans tous les enregistrements. Identificateur global unique, même s’il peut ou non prendre la forme d’un identificateur unique universel (UUID)

** Leading zeros '0' missing on incoming value for Grade Enum, for example '1', will match defined Enum '01' and be stored as '01'. En outre, [] signifie qu’un tableau de plusieurs enums peut être accepté sur un seul enregistrement.

** For list of supported Enums see V2.1 format page

SDS for Informations Validation Rules & Descriptions

Nom de la règle Description de la règle Type de règle Action de règle Exemple de message convivial
Erreur d’application interne
Une erreur inattendue est survenue.
Erreur catastrophique
Arrête l’analyse des données
Une erreur d’application s’est produite lors de la tentative de traitement : {error}
Fichier in trouvé
Un fichier requis est in trouver.
Erreur catastrophique
Arrête l’analyse des données
Impossible de trouver {expectedFileName} dans le chemin d’accès : {Path}. Vérifiez le chemin d’accès de {Name} pour vous assurer que {expectedFileName} existe ou que le nom du fichier est {expectedFileName} et ré-exécutez la synchronisation.
Opération annulée
Un problème s’est produit lors de l’analyse des données qui a nécessité son annulation.
Erreur catastrophique
Arrête l’analyse des données
L’opération a été annulée avec le message : {cancelMessage}
L’en-tête n’existe pas
Pour vous assurer qu’un fichier correctement mis en forme est envoyé pour traitement qui contient les en-têtes de fichier définis.
Erreur catastrophique
Arrête l’analyse des données
Impossible de trouver {expectedHeaderName} dans {fileName}. Veuillez corriger l’extraction pour ajouter ou vérifier qu’il est lu en tant que {expectedHeaderName}. Télécharger correction des fichiers et ré-exécuter la synchronisation.
Colonne dupliquée dans l’en-tête
Pour vous assurer qu’un fichier correctement mis en forme est envoyé pour traitement qui contient l’en-tête de fichier défini et non plusieurs d’un ou plusieurs en-têtes.
Erreur catastrophique
Arrête l’analyse des données
Deux ou plusieurs {expectedHeaderName} ont été trouvés dans {fileName}. Veuillez corriger l’extraction, charger les fichiers corrigés et ré-exécuter la synchronisation.
Mappage des références croisées in trouvé
Valide que les données liées sont trouvées dans les données associées fournies (exemple : organisation manquante pour un utilisateur, section manquante pour les inscriptions).
Erreur de validation
Supprime l’enregistrement de la publication
Un enregistrement {entityType} est in trouver pour {record} [if file: in {fileName}]. Confirmez que {entityType} sourcedId et {record} sourcedId sont corrects ou mettez à jour les données dans le système source et ré-exécutez la synchronisation.
Mappage de référence croisée facultatif in trouvé
Valide que les données liées sont trouvées dans les données associées fournies (exemple : organisation manquante pour un utilisateur, section manquante pour les inscriptions).
Avertissement de validation
Supprime la valeur de l’enregistrement, envoie l’enregistrement pour publication
Une valeur de référence facultative non valide {value} dans le champ {field} pour {entityType} a été trouvée pour {record} et la valeur a été abandonnée de l’enregistrement pour poursuivre le traitement. Confirmez que {entityType} sourcedId et {record} sourcedId sont corrects ou mettez à jour les données dans le système source et ré-exécutez la synchronisation.
Erreur de format d’heure de date
Pour vous assurer que les valeurs de données transmises ont le format approprié (ISO8601).
Erreur de validation
Supprime l’enregistrement de la publication
Le {record} dans {field} [if file: in {fileName}] a une date qui n’est pas au format approprié : 'AAAA-MM-J_J_J’ai.
Données requises manquantes
Pour détecter la valeur manquante dans un champ obligatoire pour un enregistrement.
Erreur de validation
Supprime l’enregistrement de la publication
Une valeur requise pour {record} est manquante dans le nom du champ : {field} [if file: in {fileName}] pour créer l’enregistrement.
Erreur de valeur de format
Pour vous assurer que les données transmises dans un champ correspond à la mise en forme définie. Consultez également les règles de correspondance et de validation par type de données.
Erreur de validation
Supprime l’enregistrement de la publication
Le {record} trouvé dans {field} [if file: in {fileName}] n’a pas de valeur correctement mise en forme pour {field}.
Erreur d’parse
Pour nous assurer que pour chaque enregistrement, nous sommes en mesure d’associer les données dans la colonne correcte. Les enregistrements peuvent être marqués en raison de virgules simples, de retours chariot trouvés ou de guillemets manquants.
Erreur de validation
Supprime l’enregistrement de la publication
Impossible d’analyse [si api: {apiEndpoint}] [if file: in {fileName}] to find data in columns. Assurez-vous que le délimiteur dans le fichier est une virgule unique (,) et que les retours chariot dans les champs ne sont pas autorisés. Les champs contenant des virgules et des guillemets doivent être entre guillemets doubles. Si des guillemets doubles sont utilisés pour entourer un champ, un guillemet double apparaissant à l’intérieur du champ doit être précédé d’un autre guillemet double.
Contrainte de données unique violée
Pour vous assurer qu’il n’y a pas au moins deux enregistrements trouvés avec le même ID source (ID SIS, orgSourceId).
Avertissement de validation
Supprime la valeur de l’enregistrement, envoie l’enregistrement pour publication
Au moins deux enregistrements existent pour {record} [if file: in {fileName}] avec le même sourcedId {entityType}.
Contrainte de longueur de champ maximale enfreinte
Pour vous assurer que les données transmises ne dépassent pas la longueur du champ, ce qui entraîne l’absence de données.
Erreur de validation
Supprime l’enregistrement de la publication
La valeur fournie pour {field} dans {record} dépasse la longueur maximale prise en charge des caractères {length}.
Code de référence non valide ou manquant
Identifie si aucune valeur de référence [Enum] transmise pour un enregistrement n’est associée à l’enregistrement.
Erreur de validation
Supprime l’enregistrement de la publication
La valeur {refValue} pour {field} dans {record} n’est pas trouvée dans {refCodeEntity}. Veuillez corriger le système source.
Données facultatives manquantes valeur requise correspondante
Pour s’assurer que si un enregistrement passe une valeur pour des données facultatives, toutes les données associées supplémentaires qui nécessitent maintenant une valeur sont également fournies.
Avertissement de validation
Supprime la valeur de l’enregistrement, envoie l’enregistrement pour publication
Une valeur a été fournie dans un champ facultatif pour {record} mais il manque une valeur correspondante dans le champ associé pour publier correctement les données.
Référence circulaire
Pour vous assurer que si un enregistrement a une association parente, aucune référence circulaire n’a été fournie.
Avertissement de validation
Supprime la valeur de l’enregistrement, envoie l’enregistrement pour publication
{entityType} {entityId} est lié dans une référence circulaire avec {entityType}(s) {entityList}. La valeur de {entityParentIdField} est abandonnée de l’enregistrement pour poursuivre le traitement.
Identificateur de mappage utilisateur in trouvé
Pour vous assurer qu’une valeur existe en fonction des règles de correspondance utilisateur configurées.
Erreur de validation
Supprime l’enregistrement de la publication
Identificateur de mappage utilisateur {identifierType} in trouvé pour l’utilisateur {record}.
Mappage utilisateur de plusieurs correspondances trouvées
Si plusieurs Azure Active Directory sont trouvés comme une correspondance pour cet utilisateur, seul le premier compte AAD sera utilisé pour la correspondance. Les correspondances supplémentaires seront abandonnées.
Erreur de validation
Supprime la publication des enregistrements secondaires
L’utilisateur {record} avec l’identificateur de mappage {identifierType}={value} a trouvé plusieurs correspondances dans Azure Active Directory. Seule la première correspondance trouvée sera utilisée, voir Azure Active Directory ObjectId {AadObjectId}.
Correspondances conflictuelles de mappage d’utilisateur trouvées
Pour empêcher l’association automatisée d’un autre utilisateur à un compte existant et Azure Active Directory correspondance.
Erreur de validation
Supprime l’enregistrement de la publication
L’utilisateur {record} avec l’identificateur de mappage {identifierType}={value} est mis en correspondance avec un objet mappé Azure Active Directory ObjectId {AadObjectId}. La correspondance existante trouvée sera utilisée et cette correspondance sera ignorée.
Erreur générale de publication de données
Lors de l’envoi de l’enregistrement, une erreur a été renvoyée.
Erreur de validation
Supprime l’enregistrement de la publication
Impossible d’ajouter {record} en raison de {error}. Vérifiez ou mettez à jour le système source à corriger.

Champ vers les types de données pour tous les formats CSV non-V2/2.1

Ce tableau montre comment la date trouvée dans les différents formats est traitée lors du traitement vers SDS pour Informations concernant l’association de type de données.

graphique d’association de types de données.

*Les données du fichier CSV OneRoster, de l’API PowerSchool et de l’API OneRoster sont converties au format CSV SDS v1 avant le traitement de l’approvisionnement. Le format converti est ce qui est envoyé à SDS pour Informations si activé.

**S’il n’est pas répertorié ici, il est traité comme une chaîne.

Pour obtenir la liste des énumérations prise en charge pour l’objet des cours et des notes, voir la page format V2.1 ( Énumération prise en charge.

Données qui ne sont pas synchronisées avec SDS pour Informations

Données qui ne sont pas synchronisées avec SDS pour Informations graphique.

*Les données du fichier CSV OneRoster, de l’API PowerSchool et de l’API OneRoster sont converties au format CSV SDS v1 avant le traitement de l’approvisionnement. Le format converti est ce qui est envoyé à SDS pour Informations si activé.

**Données de la section | Les champs de termes sont supprimés en raison d’incohérences dans les implémentations trouvées entre les clients.

Détermination de la sensibilisation aux données et de l’état actif

L’association d’un utilisateur à une session (année scolaire) est basée sur son rôle, lié à une organisation.

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 entrantes, ces règles sont utilisées pour déterminer la connaissance de l’enregistrement et de son état de session dans le magasin de données.

  • Les données sont reflétées lorsqu’un nouvel enregistrement est présenté pour la première fois.

    • SDS pour Informations définira la date de première vue (heure) et la date de dernière modification (heure) à jour, et si nécessaire, il marquera l’enregistrement comme « est actif dans la session » comme étant vrai.
  • Les données sont reflétées lorsque le même enregistrement est présent lors de la suite.

    • SDS pour Informations conservera la première valeur de date (heure) vue, définira la date de dernière modification (heure) sur actuelle et le laisser « est actif dans la session » pour être vrai.
  • Les données sont reflétées lorsque le même enregistrement n’est pas présent lors d’une suite.

    • SDS pour Informations conserve les valeurs de date (heure) de première vue et de date de dernière modification et, le cas échéant, marque l’enregistrement comme « est actif dans la session » sur false.

      • Des exceptions se produisent lorsque les organisations, les personnes (utilisateurs) et les enregistrements de session persistent au fil du temps et ne sont pas désactivés.

      • Il y aura des mises à jour de déploiement pour « inactivé ». Par exemple, si un enregistrement d’utilisateur n’est pas présent, le système conserve les valeurs de date (heure) de première vue (heure) et de date (heure) de dernière modification existantes. Le système définira « est actif dans la session » sur False pour les enregistrements d’organisation/rôle et d’inscription des utilisateurs.

Statistiques de données

Page d’accueil

Après chaque analyse de données, les statistiques suivantes sont générées et affichées sur la page d’accueil.

  • Informations relatives à l'| État de synchronisation : si des erreurs ou des avertissements sont trouvés, vous verrez le nombre total de chaque suite résultant de la dernière série de données.

    • Une erreur signifie qu’un enregistrement n’a pas réussi la validation et que l’intégralité de l’enregistrement a été supprimée avant d’être traitée, après validation. Si un enregistrement n’a pas pu être traitée après la validation, le nombre inclura également cet enregistrement.
    • Un avertissement signifie qu’une ou plusieurs parties des données de l’enregistrement n’ont pas réussi la validation. Le champ qui avait les données de l’enregistrement a été supprimé, mais le reste de l’enregistrement et les données validées restent avant le traitement après validation.

État de synchronisation et d’état des données.

  • Données institutionnal | Année scolaire:
    • Affiche l’année scolaire actuellement configurée pour le flux entrant. Si SDS est votre système source, vous verrez également la liste des profils de synchronisation SDS liés associés au flux entrant qui relie les données à l’année scolaire affichée.

Données et enregistrements institutionnalisé.

  • Données institutionnal | Enregistrements de l’établissement:
    • Affiche le nombre de données actives trouvées et d’enregistrements qui ont été validés, pour les catégories suivantes :

      • Organisations: nombre d’organisations qui ont des rôles d’utilisateurs actifs associés à l’organisation.
      • Utilisateurs: nombre d’utilisateurs qui ont un rôle d’utilisateur actif associé à une organisation. Si un utilisateur a plusieurs associations de rôles à la même organisation ou à des organisations différentes, le nombre peut être représenté pour chaque occurrence où cela est vrai.
      • Classes: nombre de classes qui ont un rôle d’inscription utilisateur actif associé à une classe.
      • Inscriptions : nombre d’inscriptions actives dont le rôle d’inscription utilisateur actif est lié aux classes.

données institutionnaliser.

  • Données institutionnal | Nombre total d’utilisateurs AAD:
    • Affiche le nombre d’utilisateurs qui ont un rôle actif associé à une organisation et qui ont été mis en correspondance avec AAD. La répartition affiche la répartition entre les rôles d’étudiants, les rôles du personnel et les différences en fonction des associations de rôles organisationnels. En sélectionnant la barre de répartition des divisions pour l’un des groupes, le nombre correspondant s’affiche.

données institutionnaliser.

Santé des données

Une fois chaque donnée exécuté, les statistiques suivantes sont générées et affichées sur la page d’état des données en fonction de chaque suite. Pour afficher les statistiques d’exécuter associées, vous pouvez développer l’exécuter de flux de données souhaité.

l’état des données.

  • Données sources: affiche le nombre total d’enregistrements trouvés dans les données sources avant validation avancée. Si vous utilisez SDS comme source (en tirant les données de vos profils de synchronisation SDS provisionnables) et que plusieurs profils de synchronisation fournissent le même enregistrement, comme le même enregistrement scolaire pour les organisations, le nombre est compté pour chaque instance trouvée.

    • Organisations: nombre d’organisations trouvées. Les fichiers CSV non-V2 afficheront les enregistrements scolaires et les fichiers V2 afficheront tous les enregistrements organisationnels.
    • Utilisateurs: nombre d’utilisateurs trouvés.
    • Classes: nombre de classes trouvées.
    • Inscriptions : nombre d’inscriptions trouvées.
  • Données transformées: affiche le nombre total d’enregistrements trouvés après l’exécution de la validation des données pour les statistiques suivantes. Pour obtenir les statistiques institutionnaliser basées sur les enregistrements qui ont réussi la validation des données et qui sont actifs, voir ci-dessus pour plus d’informations sous la page d’accueil.

    • Erreurs: pour tout enregistrement qui n’a pas réussi la validation et l’intégralité de l’enregistrement a été supprimé avant le traitement après validation. Si, pour une raison quelconque, un enregistrement n’a pas pu être traitée après la validation, le nombre inclut également ces enregistrements.
    • Avertissements: pour tout enregistrement où une ou plusieurs parties des données de l’enregistrement n’ont pas été validées, où le champ qui avait les données de l’enregistrement a été supprimé, mais le reste de l’enregistrement et les données validées sont restés avant le traitement après validation.
    • Utilisateurs associés: nombre d’utilisateurs qui ont un rôle actif associé à une organisation et qui ont été mis en correspondance avec AAD.
    • Utilisateurs sans correspondance: nombre d’utilisateurs qui ont un rôle actif associé à une organisation et aucune correspondance n’a été trouvée pour un utilisateur dans AAD.

Format de fichier SDS CSV V2.1

Comment déployer SDS à l’aide de fichiers CSV SDS V2.1