Analyser et traiter les erreurs

Le jeu d’outils Migration dans la boîte à outils Migration contient trois outils qui permettent un traitement simplifié pour la migration des données existantes dans un réseau de distribution afin de prendre en charge les processus de mise à jour et de traçage élémentaires.

L’outil Analyser les données du réseau évalue un réseau de distribution en entrée pour identifier les types courants d’incohérences topologiques courantes, notamment les lignes auto-sécantes, les points empilés et toute connectivité non valide. L’outil génère une géodatabase mobile en sortie, qui contient diverses tables et classes d’entités décrivant les types d’erreur identifiés dans vos données. Vous pouvez utiliser ces tables et classes d’entités en sortie pour comprendre les scénarios d’erreur et définir les actions à effectuer pour chaque type d’erreur. La table Error Resolutions en sortie peut être mise à jour et utilisée pour traiter des scénarios d’erreur en tant qu’entrée pour l’outil Appliquer la résolution des erreurs.

En savoir plus sur la migration vers le réseau de distribution

Conditions requises

Les conditions requises suivantes doivent être remplies pour analyser les données du réseau et identifier les types d’erreur courants :

  • La topologie du réseau peut être activée ou désactivée.
  • Si une géodatabase d’entreprise est utilisée, les conditions suivantes doivent être remplies :

Analyser les données du réseau pour identifier les erreurs

Pour analyser les données du réseau afin d’identifier les types d’erreur courants, procédez comme suit :

  1. Dans l’onglet Analysis (Analyse), dans le groupe Geoprocessing (Géotraitement), cliquez sur Tools (Outils) Outils pour ouvrir la fenêtre Geoprocessing (Géotraitement).
  2. Dans la fenêtre Geoprocessing (Géotraitement), recherchez et sélectionnez Analyze Network Data (Analyser les données du réseau).
  3. Pour le paramètre Input Utility Network (Réseau de distribution en entrée), spécifiez un réseau de distribution.

    Les réseaux de distribution issus d’un service d’entités ne sont pas pris en charge.

  4. Pour le paramètre Output Location (Emplacement en sortie), indiquez le chemin d’accès au dossier qui contiendra la géodatabase mobile en sortie.
  5. Pour le paramètre Output Name (Nom en sortie), spécifiez le nom pour la géodatabase mobile en sortie.

    Le nom par défaut est AnalysisResults.

    Cette opération crée un dossier contenant une géodatabase mobile dont le nom est celui indiqué dans le dossier spécifié pour le paramètre Output Location (Emplacement en sortie).

  6. Pour le paramètre Set default resolution actions (Définir les actions de résolution par défaut), indiquez si les valeurs attributaires Action par défaut seront renseignées dans la table Error Resolutions pour les types d’erreur spécifiés.

    Vous pouvez modifier toute valeur d’action sur l’erreur renseignée par l’outil. Les erreurs ne présentent pas toutes une action sur l’erreur par défaut prédéfinie.

    • Activé : les types d’erreur suivants seront renseignés avec l’action de résolution par défaut dans le champ Action de la table Error Resolutions en sortie :
      • Longueur de forme vide : supprimer la ligne de la classe d’entités.
      • Ligne auto-sécante : supprimer tout sauf le premier sommet.
      • Sommets en double : supprimer tout sauf le premier sommet.
      • Points empilés : supprimer tout sauf le premier sommet.
    • Désactivé : aucun type d’erreur ne sera renseigné avec les actions sur l’erreur par défaut dans la table Error Resolutions en sortie. Il s’agit de l’option par défaut.
  7. Cliquez sur Run (Exécuter).

L’outil Analyser les données du réseau s’exécute et crée une géodatabase mobile à l’emplacement en sortie spécifié. Les classes d’entités Error Summary et Error Locations ainsi que la table Error Resolutions sont ajoutées à la carte active à l’aide d’un groupe de couches.

Table et classe d’entités en sortie

La géodatabase mobile créée par l’outil Analyser les données du réseau contient les tables et classes d’entités suivantes :

  • ErrorLocations : classe d’entités ponctuelles décrivant les différents emplacements dans le réseau où des erreurs ont été identifiées.
  • ErrorSummary : classe d’entités ponctuelles synthétisant toutes les combinaisons uniques d’erreurs dans le réseau à l’aide d’une entité multi-parties.
  • ErrorRecords : table contenant des informations sur toutes les entités présentes à chaque localisation d’erreur, ainsi que le type d’erreur associé.
  • ErrorResolution : table utilisée pour décrire la résolution souhaitée pour chaque groupe d’erreurs. Elle est utilisée comme entrée dans l’outil Appliquer la résolution des erreurs.

Le dossier contenant la géodatabase mobile contient également une couche (.lyrx) et un fichier .csv pouvant être utilisés pour comprendre et résoudre les erreurs.

  • Groupe de couches symbolisant les erreurs trouvées dans le réseau de distribution en entrée. Le nom de ce groupe de couches correspond au nom fourni pour le paramètre Output Name (Nom en sortie) lors de l’exécution de l’outil Analyser les données du réseau. Cette couche utilise d’autres tables et classes d’entités dans la géodatabase mobile pour faciliter la visualisation des erreurs sur la carte.
  • RuleCandidates : fichier .csv qui communique des règles de réseau de distribution potentielles pouvant être ajoutées pour résoudre les erreurs.

Les tables et classes d’entités dans la sortie peuvent être superposées à un réseau de distribution à l’aide du groupe de couches afin de fournir un contexte et de faciliter la visualisation des diverses erreurs rencontrées. Les sections ci-dessous décrivent les diverses classes en sortie et leur structure.

Classes d’entités Error Summary (Synthèse des erreurs) et Error Locations (Localisations des erreurs)

Les classes d’entités ponctuelles Error Locations et Error Summary fournissent différentes informations sur les erreurs identifiées dans le réseau de distribution en entrée. La classe d’entités Error Summary contient des géométries multi-points qui agrègent toutes les entités similaires dans la classe d’entités Error Locations avec un type d’analyse et une valeur de code d’erreur partagés pour fournir une vue d’ensemble des différents types d’erreur présents dans le réseau de distribution, par classe, groupe de ressources et type de ressource.

La classe d’entités Error Locations contient une entité ponctuelle pour chaque localisation présentant une erreur. Ainsi, vous pouvez passer en revue chaque localisation représentée par l’entité multi-point Error Summary. Lorsque vous sélectionnez une entité de localisation, les enregistrements associés sont également sélectionnés dans la table Error Records.

Remarque :

La sélection d’un enregistrement dans la classe d’entités Error Locations entraîne l’ajout de la classe d’entités source à la carte si elle n’est pas déjà présente, ainsi que la sélection des entités associées. Cette relation utilise un chemin d’accès absolu aux données source. La relation doit être mise à jour si les données source sont déplacées.

La classe d’entités Error Summary contient les champs attributaires suivants :

Nom du champAlias du champDescription

OBJECTID

ID d’objet

ID d’objet pour l’entité multi-point de synthèse des erreurs.

ErrorCode

Code d’erreur

Code d’erreur pour le type d’erreur synthétisé.

AnalysisTypes

Types d’analyse

Classe d’entités, groupes de ressources et types de ressource présents à cette localisation. Sont incluses l’entité qui présente l’erreur et les entités coïncidentes.

Conseil :

Dans Options, définissez le paramètre Row Height (Hauteur de ligne) sur Triple dans l’onglet Table pour améliorer la lisibilité de ce champ.

TypesInError

Types présentant des erreurs

Classe d’entités, groupe de ressources et type de ressource des entités présentant des erreurs.

SourceName

Couches sources

Classe d’entités des entités présentant des erreurs.

AssetGroupName

Groupes de ressources

Groupe de ressources des entités présentant des erreurs.

AssetTypeName

Types de ressource

Type de ressource des entités présentant des erreurs.

Occurrences

Occurrences

Nombre d’entités Error Locations constituant la géométrie multi-point pour chaque combinaison unique de Analysis types et Error code.

ResolutionKey

Clé de résolution

Clé relationnelle utilisée pour lier la classe d’entités Error Summary à la table Error Resolution. La sélection d’une entité multi-point dans la classe Error Summary sélectionne les enregistrements associés dans la table Error Resolution.

Forme

Forme

Localisation des entités.

La classe d’entités Error Locations contient les champs attributaires suivants :

Nom du champAlias du champDescription

OBJECTID

ID d’objet

ID d’objet de chaque erreur dans le réseau de distribution.

ErrorCode

Code d’erreur

Code d’erreur associé à l’entité présentant une erreur.

AnalysisTypes

Types d’analyse

Classe d’entités, groupes de ressources et types de ressource présents à cette localisation. Sont incluses l’entité qui présente l’erreur et les entités coïncidentes.

ResolutionKey

Clé de résolution

FORME

Forme

Localisation de l’entité.

Table des enregistrements d’erreur

La table Error Records contient des informations détaillées sur les entités associées à chaque erreur répertoriée dans la table Error Locations. Le groupe de couches ajouté à la carte contient un sous-ensemble d’enregistrements de cette table pour chaque classe d’entités contenant des erreurs filtrées à l’aide d’un ensemble de définition. Il peut être utile de consulter cette table lors de l’évaluation de la contribution d’autres entités à la condition d’erreur signalée.

La table Error Records contient les champs attributaires suivants :

Nom du champAlias du champDescription

OBJECTID

ID d’objet

ID d’objet de l’enregistrement d’erreur.

LocationKey

Clé de localisation

Valeur de la clé de localisation pour les enregistrements d’erreur. Elle correspond à l’ID d’objet pour l’entité dans la classe d’entités Error Locations.

ErrorCode

Code d’erreur

Code d’erreur associé à l’entité présentant une erreur.

AnalysisTypes

Types d’analyse

Classe d’entités, groupes de ressources et types de ressource présents à cette localisation. Sont incluses l’entité qui présente l’erreur et les entités coïncidentes.

ClassGroupType

Type d'entité

Classe d’entités, groupe de ressources et type de ressource de l’entité associée.

SourceID

Couche source

Classe d’entités associée à l’enregistrement d’erreur.

SourceOID

ID d’entité

ID d’objet de l’entité associée à l’erreur.

Table Error Resolutions (Résolution des erreurs)

La table Error Resolutions est une table modifiable utilisée pour définir les actions correctives à effectuer pour les erreurs identifiées par l’outil Analyser les données du réseau. La table modifiée est ensuite utilisée comme entrée dans l’outil Appliquer la résolution des erreurs pour mettre à jour les entités et corriger les scénarios d’erreur.

La table Error Resolutions contient les colonnes suivantes :

Nom du champAlias du champDescription

OBJECTID

ID d’objet

ID d’objet de l’enregistrement de résolution.

ErrorCode

Code d’erreur

Code d’erreur associé à l’entité présentant une erreur.

AnalysisTypes

Types d’analyse

Classe d’entités, groupes de ressources et types de ressource présents à cette localisation. Sont incluses l’entité qui présente l’erreur et les entités coïncidentes.

Conseil :

Dans Options, définissez le paramètre Row Height (Hauteur de ligne) sur Triple dans l’onglet Table pour améliorer la lisibilité de ce champ.

ResolutionKey

Clé de résolution

Clé relationnelle associée à la classe d’entités Error Summary.

GroupPosition

Position du groupe

Séquence de la ligne dans le groupe des types d’analyse.

ClassGroupType

Type d'entité

Classe d’entités, groupe de ressources et type de ressource des entités présentant des erreurs.

SourceNames

Couche source

Classe d’entités associée à l’enregistrement d’erreur.

AssetGroupNames

Groupe de ressources

Groupe de ressources de l’entité associée à l’enregistrement d’erreur.

AssetTypeNames

Type de ressource

Type de ressource de l’entité associée à l’enregistrement d’erreur.

ErrorContext

Contextuel

Indiqe si l’enregistrement référence une entité présentant une erreur ou une entité coïncidente fournie pour le contexte.

ErrorAction

Opération

Action corrective à effectuer pour résoudre le type d’erreur. Les valeurs sont les suivantes :

  • Do nothing (Ne rien faire) : aucune action n’est effectuée pour résoudre l’erreur. Il s’agit de l’option par défaut.
  • Update all (Mettre à jour tout) : met à jour les sommets ou les entités à la localisation.
  • Update all but first (Mettre à jour tout sauf le premier) : met à jour tous les sommets ou toutes les entités sauf le ou la première à la localisation.
  • Delete all (Supprimer tout) : supprime tous les sommets ou toutes les entités à la localisation.
  • Delete all but first (Supprimer tout sauf le premier) : supprime tous les sommets ou toutes les entités sauf le ou la première à la localisation.
  • Créer : créer une nouvelle entité. Lorsque cette action est sélectionnée, vous devez spécifier le type d’entité qui sera créé à l’aide du champ attributaire Create/Update type (Type à créer/mettre à jour).

DeltaX

Delta X

Valeur de décalage appliquée à la coordonnée X de la géométrie d’un point ou du sommet d’une ligne. Cette valeur est valide uniquement pour une action de mise à jour ou de création.

DeltaY

Delta Y

Valeur de décalage appliquée à la coordonnée Y de la géométrie d’un point ou du sommet d’une ligne. Cette valeur est valide uniquement pour une action de mise à jour ou de création.

DeltaZ

Delta Z

Valeur de décalage appliquée à la coordonnée Z de la géométrie d’un point ou du sommet d’une ligne. Cette valeur est valide uniquement pour une action de mise à jour ou de création.

DeltaStep

Décalage delta

Lorsque plusieurs entités sont présentes à la même localisation, ce paramètre définit la valeur de décalage appliquée aux champs delta (X, Y, Z) pour chaque entité suivante. Cette valeur est valide uniquement pour une action de mise à jour ou de création.

ActionClassGroupType

Type à créer/mettre à jour

Spécifie un groupe de ressources et un type de ressource à utiliser lors de la création d’une nouvelle entité ou de la mise à jour d’une entité existante.

Types d’erreur identifiés à l’aide de l’outil

Alors que l’outil Analyser les données du réseau n’a pas été conçu pour identifier toutes les erreurs, il détecte tout de même les erreurs de réseau de distribution courantes suivantes et les renvoie dans le champ attributaire Error codes des classes d’entités Error Summary et Error Locations et de la table Error Resolutions. La table ci-dessous présente les codes d’erreur identifiés par l’outil, l’ID d’erreur associé, une description du scénario d’erreur et l’action (le cas échéant) qui peut être appliquée pour résoudre l’erreur dans la table Error Resolutions.

Remarque :
Une solution automatisée n’est pas forcément disponible pour tous les types d’erreur.

En savoir plus sur les bonnes pratiques pour la correction des erreurs de connectivité dans un réseau de distribution

Code d’erreurID d’erreur associéDescriptionAction sur l’erreur disponible

Géométrie vide

1

La géométrie de l’entité de réseau est vide. Cette erreur peut survenir lorsque la longueur d’une entité linéaire est nulle ou proche de zéro.

Supprimer tout/Supprimer tout sauf le premier

Longueur de forme

5

La longueur de l’entité linéaire est comprise dans la tolérance. Cette erreur peut survenir lorsque la longueur d’une entité linéaire est nulle ou proche de zéro.

Supprimer tout/Supprimer tout sauf le premier (sommet)

Règle manquante

8

Une connectivité existe entre deux entités alors qu’aucune règle permettant la connectivité n’a été établie

N/D

Connectivité ambiguë

9

La connectivité peut être ambiguë lorsque plusieurs règles sont disponibles pour une connexion potentielle. Cette erreur peut également survenir si plusieurs dispositifs sont présents à l’extrémité d’une ligne.

N/D

Jonction manquante

10

Une connectivité non valide existe car des entités linéaires sont connectées entre différents groupes de ressources et types de ressource sans entité de dispositif ou de jonction intermédiaire.

Créer

Règle de connectivité de tronçon

13

Cette erreur peut survenir lorsqu’une ligne présente une connectivité qui ne respecte pas sa règle de connectivité de tronçon. Par exemple, une entité linéaire qui autorise uniquement la connectivité d’extrémité possède une entité ponctuelle ou une autre entité linéaire placée à mi-portée.

N/D

Ligne auto-sécante

20

Cette erreur peut survenir si une entité linéaire forme une boucle et se superpose sur elle-même à l’intersection de deux sommets.

Supprimer tout/Supprimer tout sauf le premier (sommet)

Sommets en double

21

Une entité de réseau linéaire comporte plusieurs sommets situés à la même localisation x,y,z ou dans la tolérance de réseau.

Supprimer tout/Supprimer tout sauf le premier (sommet)

Points empilés

25

Deux points ou plus coïncident géométriquement ou se trouvent dans la tolérance de réseau. Par exemple, un point de service et un régulateur de tension ont les mêmes coordonnées x, y, z.

Supprimer tout/Supprimer tout sauf le premier (sommet)

Borne non valide

36

L’entité linéaire possède une borne non valide. Cette erreur survient lorsque l’attribut d’ID de borne d’origine ou d’ID de borne de destination pour une ligne n’est pas valide pour l’un des dispositifs connectés.

N/D

Borne de dispositif à mi-portée

38

Les dispositifs qui présentent plusieurs bornes ne peuvent pas être à mi-portée le long d’une ligne. Cette erreur survient lorsqu’une borne de dispositif est dessinée à mi-portée sur une ligne.

N/D

Définir les actions de résolution des erreurs

La table Error Resolutions est utilisée pour définir les actions correctives à effectuer pour les diverses erreurs identifiées par l’outil Analyser les données du réseau. Le processus suivant permettant de traiter une erreur de ligne auto-sécante montre comment vous pouvez utiliser la table Error Resolutions avec les autres classes de la géodatabase mobile pour comprendre les erreurs dans un réseau de distribution et définir des actions pour les résoudre :

  1. Ajoutez le réseau de distribution et toutes les classes associées à une carte active.
  2. Ajoutez le groupe de couches (.lyrx) contenant la classe d’entités Error Summary, la classe d’entités Error Locations, la table Error Records et la table Error Resolutions.

    Par défaut, il se trouve dans le dossier spécifié dans le paramètre Output Name (Nom en sortie) lorsque l’outil Analyser les données du réseau a été exécuté.

  3. Cliquez avec le bouton droit de la souris sur la classe d’entités Error Summary dans la fenêtre Contents (Contenu), puis cliquez sur Attributes (Attributs).

    La table attributaire pour la classe d’entités Error Summary est ouverte.

  4. Identifiez un enregistrement avec le champ Error code de Self-intersecting line et sélectionnez la ligne.

    L’entité multi-point Error Summary et les lignes associées dans la table Error Resolutions sont sélectionnées.

  5. Cliquez avec le bouton droit de la souris sur la ligne sélectionnée dans la table attributaire Error Summary, puis cliquez sur Zoom to (Zoom sur).

    Un zoom est appliqué à la carte pour afficher tous les enregistrements de synthèse associés à l’erreur.

  6. Vous pouvez réviser chaque entité de synthèse individuellement pour mieux comprendre le scénario d’erreur en utilisant les entités Error Locations (Localisations d’erreur) et la table Error Records (Enregistrements d’erreur) associées.
  7. Cliquez avec le bouton droit de la souris sur la table Error Resolutions dans la fenêtre Contents (Contenu), puis cliquez sur Open (Ouvrir).

    La table attributaire pour la table Error Resolutions est ouverte.

  8. Filtrez la table Error Resolutions avec Show Selected Records (Afficher les enregistrements sélectionnés).
  9. Pour les enregistrements sélectionnés, identifiez l’enregistrement dont la valeur pour Context (Contexte) est Error et révisez la valeur attributaire Action.

    Si vous avez sélectionné le paramètre Set default resolution actions (Définir les actions de résolution par défaut) lors de l’exécution de l’outil Analyser les données du réseau, l’action de résolution par défaut Delete all but first a déjà été spécifiée pour le champ. Autrement, sélectionnez cette valeur dans la liste déroulante du champ. Cette action indique à l’outil Appliquer la résolution des erreurs qu’il doit tout supprimer sauf le premier sommet pour la ligne à la localisation d’intersection.

  10. Sur le ruban, dans le groupe Manage Edits (Gérer les mises à jour), cliquez sur Save (Enregistrer) pour enregistrer vos mises à jour.

Des actions de résolution ont été définies pour les erreurs identifiées par l’outil Analyser les données du réseau. Vous pouvez utiliser la table Error Resolutions comme entrée de l’outil Appliquer la résolution des erreurs pour mettre à jour les données du réseau de distribution et résoudre les erreurs.

En savoir plus sur l’application de la résolution des erreurs