Configurer un traçage
Le traçage d’un réseau de distribution permet de répondre aux questions concernant l’état de votre réseau à tout moment. Pour tracer un réseau de distribution, utilisez l’outil Traçage ou accédez à une configuration de tracé nommée à l’aide de la fenêtre Trace (Traçage).
Le réseau de distribution fournit divers types de traçage principal. Certains types de traçage intègrent la définition du sous-réseau, tandis que d’autres reposent sur les propriétés du circuit ou ne prennent en compte ni l’un ni l’autre. Pour affiner les résultats, il est possible d’ajuster chaque type de traçage en spécifiant des configurations supplémentaires dans l’outil Traçage ou Ajouter la configuration du tracé. Examinez chaque type de traçage ci-dessous pour en savoir plus.
Les traçages basés sur un sous-réseau qui utilisent la définition de sous-réseau de la configuration de traçage sont pris en charge uniquement avec les réseaux de domaine traditionnels. Il s’agit des traçages suivants :
Les traçages de réseau qui ne s’appuient pas sur la définition de sous-réseau sont pris en charge avec les réseaux de domaine traditionnels et avec les réseaux de domaine de télécommunications. Il s’agit des traçages suivants :
Les traçages de circuit qui s’appuient sur la présence des propriétés de circuit sont pris en charge uniquement avec les réseaux de domaine de télécommunications.
Remarque :
Les traçages en amont et en aval n’utilisent pas la définition de sous-réseau lorsque le paramètre Use Digitized Direction (Utiliser le sens de numérisation) est activé. Ils peuvent être utilisés avec les réseaux de domaine traditionnels et les réseaux de domaine de télécommunications.
Outre ces types de traçage, l’outil Trace (Traçage) comprend également un ensemble complet de configurations avancées qui permettent d’affiner chaque type de traçage fourni. Ces configurations vous permettent d’établir la traversabilité, de distinguer quelles entités ou quels objets doivent être renvoyés, et de configurer les calculs à exécuter. ModelBuilder peut être utilisé pour enregistrer des configurations complexes et pour réduire le nombre de paramètres présentés sur l’interface de l’outil de modèles. Les configurations de traçage nommées permettent de créer et d’enregistrer des traçages complexes à partager dans une organisation. Cela vous permet ainsi qu’à autrui d’exécuter à nouveau des traçages avancés en quelques clics seulement.
La définition de configurations de tracé de sous-réseau dans la définition de sous-réseau permet le remplissage automatique de l’outil Traçage lors de l’exécution d’un tracé pour un niveau spécifique. Cela concerne les parcours basés sur un sous-réseau. Par exemple, vous souhaitez peut-être toujours que vos traçages de sous-réseau s’arrêtent aux dispositifs de protection pour indiquer la fin du chargeur et calculer la charge totale de chaque chargeur, mais vous ne souhaitez probablement pas définir ces paramètres chaque fois que vous exécutez un traçage basé sur un sous-réseau. C’est la raison pour laquelle il est possible de définir une définition de sous-réseau standard pour tous les sous-réseaux d’un niveau. Une définition de sous-réseau est définie par l’administrateur lors de la création d’un niveau. Lorsque le niveau est spécifié dans l’outil Traçage, les paramètres avancés sont renseignés automatiquement avec la définition de tracé de sous-réseau définie pour le niveau d’entrée. Les paramètres de configuration de traçage renseignés peuvent être remplacés manuellement dans l’outil avant d’exécuter le traçage.
Lors de la configuration d’un traçage, vous pouvez modifier ou ajouter la configuration de traçage de sous-réseau. Vous pouvez par exemple contrôler les types d’entités et d’objets tracés (diamètre de canalisation supérieure à 6 pouces), choisir les types d’entités réseau à renvoyer (toutes les vannes ouvertes) et réaliser des calculs à l’aide des attributs de réseau (somme de la longueur des lignes de phase AB).
Chaque composant de configuration disponible pour les traçages dans les réseaux de domaine traditionnels et les réseaux de domaine de télécommunications est examiné dans les sections suivantes. Reportez-vous à l’outil Traçage pour prendre connaissances des options des paramètres et des instructions d’utilisation.
Exécuter un traçage de manière asynchrone
Le paramètre Run in asynchronous mode on the server (Exécuter en mode asynchrone sur le serveur) permet de traiter des opérations de traçage de manière asynchrone par l’intermédiaire du service de géotraitement UtilityNetworkTools. Cette option est disponible uniquement si vous utilisez un réseau de distribution dans un déploiement d’entreprise. Les opérations de traçage sont traitées de manière synchrone par défaut.
|
Option de configuration |
Description |
|---|---|
|
Run in asynchronous mode on the server (Exécuter en mode asynchrone sur le serveur) |
|
Définir la région du traçage
Pour l’outil Traçage, vous devez indiquer où le traçage est autorisé à se déplacer dans votre réseau. Le fait de définir une zone traçable aide à garantir que la part prévue du réseau est tracée.
Lorsque vous utilisez un réseau de domaine traditionnel, quatre informations permettent d’indiquer l’étendue d’une zone traçable : le réseau de domaine, le niveau, le niveau cible et le sous-réseau. Les traçages ne présentent pas tous ces paramètres. Le type de traçage détermine les informations requises.
La zone traçable est définie pour prendre en charge la gestion des sous-réseaux et limiter la traversée vers d’autres niveaux pour certains types de traçage. La spécification du réseau de domaine dans Domain Network (Réseau de domaine) limite un traçage à ce réseau de domaine uniquement. Tous les traçages basés sur un sous-réseau nécessitent la configuration d’un réseau de domaine. Certains traçages requièrent la spécification d’un niveau et d’un sous-réseau facultatif, alors que d’autres nécessitent la définition d’un niveau et d’un niveau cible (en amont et en aval). Un niveau cible vous permet de tracer plusieurs niveaux dans un réseau de domaine.
Le paramètre Tier (Niveau) dans l’outil Traçage est utilisé pour limiter le traçage à un niveau particulier. Vous pouvez également l’utiliser pour renseigner automatiquement les paramètres de configuration du traçage avec les valeurs définies pour la définition de sous-réseau. Lorsque des points de départ sont spécifiés en conjonction avec le paramètre Tier (Niveau), ils doivent se trouver dans le niveau spécifié. Le paramètre Target Tier (Niveau cible) est utilisé pour les traçages en amont et en aval et indique la limite du réseau traçable. Un traçage peut traverser le niveau cible, mais ne va pas au-delà.
En cas de traçage sur plusieurs niveaux, les paramètres de configuration du traçage sont chargés pour le niveau initial. Les paramètres de configuration du traçage suivants sont chargés pour chaque nouveau tier rencontré par le traçage :
Traversability scope (Portée de traversabilité)
Condition barriers (Interruptions conditionnelles)
Function barriers (Interruptions de fonctions)
Propagateurs
Pour les traçages de sous-réseau, fournir une valeur Subnetwork Name (Nom de sous-réseau) vous permet de préciser le sous-réseau à tracer sans utiliser de point de début. Avec cette approche, le ou les contrôleurs du sous-réseau spécifié sont utilisés comme point de début du traçage.
Si vous utilisez un réseau de domaine de télécommunications, le traçage de circuit requiert que vous spécifiiez la valeur Domain Network (Réseau de domaine) et un nom de circuit facultatif pour restreindre le traçage.
Inclure les conteneurs, le contenu, les structures et les interruptions dans les résultats
Cet ensemble d’options configurables dans l’outil Trace (Traçage) permet de configurer les entités de réseau qui sont comprises dans les résultats en fonction du rôle d’association ou du statut de l’interruption. Les entités d’association peuvent être notamment des conteneurs, du contenu et des structures. Par défaut, tout est renvoyé dans les résultats d’un traçage, à l’exception des conteneurs, de leur contenu et des structures.
Include Containers (Inclure les conteneurs)
Le paramètre Include Containers (Inclure les conteneurs) indique si les entités du réseau de conteneurs sont incluses dans les résultats d’un traçage. Tous les conteneurs des entités de contenu et des objets qui sont tracés font également partie des résultats de la trace. Cette configuration peut également être utilisée pour tracer un réseau de structure et renvoyer, par exemple, les fourreaux souterrains qui contiennent d’autres entités de réseau.
|
Option de configuration |
Description |
|---|---|
|
Include Containers (Inclure les conteneurs) |
|
Include up to First Spatial Container (Inclure jusqu’au premier conteneur spatial)
Indique de limiter ou non les conteneurs retournés dans les résultats de traçage pour n’inclure que ceux jusqu’au premier conteneur spatial, et l’incluant, pour chaque élément de réseau. Si aucun conteneur spatial n’est rencontré mais que des conteneurs non spatiaux sont présents pour un élément de réseau donné, tous les conteneurs non spatiaux sont inclus dans les résultats. Ce paramètre n’est disponible que si l’option Include Containers (Inclure les conteneurs) est activée.
|
Option de configuration |
Description |
|---|---|
|
Include up to First Spatial Container (Inclure jusqu’au premier conteneur spatial) |
|
Include Content (Inclure le contenu)
Le paramètre Include Content (Inclure le contenu) indique si le contenu des entités du conteneur est inclus dans les résultats d’un traçage. Pour différencier les différents types de conteneurs, utilisez un filtre Output (Sortie) pour filtrer les résultats de traçage.
|
Option de configuration |
Description |
|---|---|
|
Include Content (Inclure le contenu) |
|
Include Structures (Inclure les structures)
Le paramètre Include Structures (Inclure les structures) indique si les entités de structure sont incluses dans les résultats lorsque le entités de dépendance sont tracées. Cette fonction est utile pour les tâches qui consistent à signaler des actifs structurels.
|
Option de configuration |
Description |
|---|---|
|
Include Structures (Inclure les structures) |
|
Include Barrier Features (Inclure les entités d’interruption)
Le paramètre Include Barrier Features (Inclure les entités d’interruption) indique si les entités et les objets qui servent d’interruptions sont inclus dans les résultats d’un traçage. Cela englobe les entités d’interruption définies dans l’onglet Barriers (Interruptions) de la fenêtre Trace (Traçage), ainsi que les interruptions configurées dynamiquement : interruptions conditionnelles, interruptions fonctionnelles, interruptions de filtre et interruptions de fonction de filtre. La définition de sous-réseau peut servir à configurer l’éventuelle inclusion des interruptions dans les résultats du traçage, dans le cadre de la configuration du traçage de sous-réseau avec les réseaux de domaine traditionnels.
Lors du traçage d’un chemin, l’inclusion d’entités d’interruption dans le résultat permet de rechercher des chemins dans les cas où un point d’arrêt est placé sur une entité d’interruption.
Remarque :
L’ensemble de sélection renvoyé par un traçage peut afficher des résultats inattendus lorsque des interruptions sont placées sur des entités tronçon présentant une connectivité à mi-portée et que l’option Include Barrier Features (Inclure les entités d’interruption) est désactivée. Si une partie de l’entité est renvoyée par le parcours, l’entité intégrale est sélectionnée et affichée dans le résultat de parcours.
|
Option de configuration |
Description |
|---|---|
|
Include Barrier Features (Inclure les entités d’interruption) |
Remarque :Les types de traçages basés sur le sous-réseau sont également influencés par ce paramètre dans la configuration des traces du sous-réseau du niveau. |
Remarque :
L’option de configuration Include Barrier Features (Inclure les entités d’interruption) ne s’applique pas aux entités dotées de bornes.
Ignore Barriers At Starting Points (Ignorer les interruptions aux points de départ)
Le paramètre Ignore Barriers At Starting Points (Ignorer les interruptions aux points de début) indique si les interruptions de la configuration de traçage doivent être prises en compte si elles sont détectées aux points de départ. Cela peut être utile lorsque vous effectuez un parcours de dispositifs de protection en amont et que vous utilisez les dispositifs de protection (interruptions) détectés comme points de début pour rechercher les dispositifs de protection en amont suivants.
|
Option de configuration |
Description |
|---|---|
|
Ignore Barriers At Starting Points (Ignorer les interruptions aux points de départ) |
|
Configurer le flux des ressources
Il est primordial de comprendre le mode de déplacement des ressources sur un tronçon du réseau lors de la réalisation de traçages directionnels dans le réseau de distribution. Par défaut, les opérations de traçage dans un réseau de domaine traditionnel déterminent le flux en se basant sur la localisation des contrôleurs de sous-réseau. Par ailleurs, si vous utilisez un modèle qui s’appuie sur le sens de numérisation des lignes pour déterminer le sens de flux des ressources dans le réseau, vous pouvez utiliser le paramètre Use Digitized Direction (Utiliser le sens de numérisation) pour effectuer des traçages en amont et en aval. N’utilisez pas cette option si vous modélisez le flux à l’aide de contrôleurs de sous-réseau.
Quand l’option Use Digitized Direction (Utiliser le sens de numérisation) est sélectionnée, les paramètres Domain Network (Réseau de domaine), Tier (Niveau) et Target Tier (Niveau cible) sont masqués dans l’outil et ignorés. Ce paramètre est disponible et actif uniquement avec les réseaux de distribution en version 7 et versions ultérieures si le paramètre Trace Type (Type de traçage) est défini sur Upstream (En amont) ou Downstream (En aval). Ce paramètre est requis pour exécuter un traçage directionnel avec un réseau de domaine de télécommunications.
Remarque :
Les sens de flux dérivés des contrôleurs de sous-réseau et renvoyés dans le fichier .json à l’aide du paramètre Include flow directions (Inclure les sens de flux) avec les options de type de résultat Connectivity (Connectivité), Elements (Éléments) et Features (Entités) ne sont pas liés à l’attribut de sens de flux utilisé par le paramètre Use Digitized Direction (Utiliser le sens de numérisation). Le paramètre Include flow directions (Inclure les sens de flux) est destiné à être utilisé avec des traces basées sur des sous-réseaux où le flux est modélisé à l’aide de contrôleurs de sous-réseau, tandis que le paramètre Use Digitized Direction (Utiliser le sens de numérisation) est destiné à être utilisé avec le traçage en amont et en aval dans des modèles qui s’appuient sur le sens de numérisation des lignes pour déterminer le sens dans laquelle les ressources circulent dans le réseau.
|
Option de configuration |
Description |
|---|---|
|
Use Digitized Direction (Utiliser le sens de numérisation) |
|
Garantir la cohérence du réseau
Une zone cohérente d’un réseau ne présente aucune zone à valider. La validation de la topologie de réseau est la seule façon de garantir qu’une trace lit les dernières informations concernant votre réseau via la topologie de réseau. Pour certains types de traçage, les sous-réseaux ou les circuits que vous tracez doivent également être validés.
L’option Validate Consistency (Valider la cohérence) de l’outil Traçage permet de vérifier la cohérence des résultats de traçage avec la topologie de réseau. Lorsque l’option Validate Consistency (Valider la cohérence) est définie sur vrai, l’opération de traçage échoue si des zones à valider sectionnent le chemin de traçage. Dans ce cas, une erreur incluant le nom de classe et l’ID global des entités ou des objets à valider dans le chemin de traçage est renvoyée, comme illustré dans l’exemple ci-dessous :
ERROR 002041: One or more dirty areas were discovered.
[[ElectricDistributionLine: {C0060506-AG17-4B64-B2E0-9162BE613C05}]]
Failed to execute (Trace).
Les cas de figure suivants ne génèrent pas d’erreur par rapport aux incohérences dans les résultats de traçage :
Zones à valider des entités nouvellement créées.
Zones à valider des conteneurs ou des structures associés lorsque les options Include Containers (Inclure des conteneurs) ou Include Structures (Inclure des structures) sont désactivées.
Pour nettoyer et supprimer les zones à valider, validez la topologie de réseau.
Exécuter un traçage sans que la case Validate Consistency (Valider la cohérence) ne soit cochée peut générer des résultats de traçage inattendus. Pour un exemple, étudiez le scénario suivant : une entité est supprimée d’un réseau, ce qui interrompt l’unique chemin reliant l’emplacement A à l’emplacement B. Une zone à valider est créée pour l’entité supprimée, mais avant de valider la topologie de réseau, un traçage est exécuté afin de rechercher les entités connectées à partir de l’emplacement A, en décochant l’option Validate Consistency (Valider la cohérence). Dans ce scénario, le traçage atteint l’emplacement B et l’exécution de l’outil se termine sans avertissement. L’emplacement B a été atteint car la suppression de l’entité connectant A et B n’a pas été répercutée dans la topologie de réseau par l’exécution d’une opération de validation.
Si l’option Validate Consistency (Valider la cohérence) est cochée dans l’exemple illustré ci-avant, lorsque le traçage atteint la zone à valider qui signale l’entité supprimée, il échoue et une erreur est renvoyée pour indiquer qu’une zone à valider a été trouvée. Une fois que la topologie a été validée pour la zone en cours de traçage, le traçage ne peut pas atteindre l’emplacement B car l’entité supprimée est désormais reflétée dans la topologie de réseau. Tant que la topologie de réseau n’est pas validée pour toute l’étendue de la zone à tracer, il est probable que d’autres zones à valider soient détectées.
Même si les informations de la topologie de réseau sont à jour pour la zone traçable, les sous-réseaux peuvent être à valider. Vérifiez que les sous-réseaux traçables sont également mis à jour. Pour en savoir plus, reportez-vous à la rubrique Mettre à jour un sous-réseau.
|
Option de configuration |
Description |
|---|---|
|
Validate Consistency (Valider la cohérence) |
Lorsque cette option est cochée, le tracé échoue et l’outil renvoie une erreur si des zones à valider intersectent le chemin du tracé. Si cette option n’est pas cochée, les zones à valider sont ignorées. Cette option est activée par défaut. |
Garantir la localisation d’objets non spatiaux
Les associations permettent de localiser et de représenter visuellement des objets jonction et tronçon non spatiaux sur une carte. Si un objet non spatial est structurellement joint à une entité spatiale ou participe en tant que contenu d’une entité spatiale, il est considéré comme étant un objet localisable. Si vous supprimez cette association, cela peut rendre l’objet de jointure ou de tronçon non localisable. L’option Validate Locatability (Valider la localisation) des outils Trace (Traçage) et Set Subnetwork Definition (Configurer la définition de sous-réseau) permet d’identifier des objets sans recours à une association d’inclusion ou de dépendance dans leur hiérarchie d’associations.
Si l’option Validate Locatability (Valider la capacité de localisation) est sélectionnée, l’opération de traçage échoue et une erreur apparaît si des objets non localisables sont identifiés dans le chemin d’un traçage. Dans ce cas, l’outil renvoie une erreur incluant le nom de classe et l’ID global des objets non localisables dans le chemin du tracé, comme illustré dans l’exemple ci-dessous :
ERROR 003326: Unlocatable objects discovered.
[[GasDistributionJunctionObject: {4F860903-PK17-5c15-Y2W0-3512BP436C00}]]
Failed to execute (Trace).
Vous pouvez utiliser la fenêtre Modify Associations (Modifier des associations) pour créer les associations permettant de considérer un objet comme localisable.
Pour en savoir plus, reportez-vous à la rubrique Capacité de localisation.
|
Option de configuration |
Description |
|---|---|
|
Validate Locatability (Valider la localisation) |
Lorsque cette option est activée, le tracé échoue et l’outil renvoie une erreur si des objets non localisables sont identifiés. Si cette option n’est pas activée, la présence d’objets non localisables n’est pas vérifiée. Cette option est décochée par défaut. |
Contrôler ce qui est tracé
Les interruptions et les points d’arrêt sont utilisés pendant un traçage pour représenter un emplacement d’arrêt. Avec les interruptions, les entités de réseau au-delà de cet emplacement ne sont pas tracées, que les points d’arrêt définissent la destination d’un chemin ou que le traçage du chemin prenne fin. Les résultats d’un traçage n’incluent pas les entités de réseau au-delà d’une interruption ou d’un point d’arrêt, mais peuvent éventuellement inclure l’interruption elle-même. D’autres paramètres, tels que Allow Indeterminate Flow (Autoriser la circulation indéterminée), Infer Connectivity (Inférer la connectivité) et ceux figurant dans la section Traversability (Traversabilité) permettent de définir la traversabilité des chemins de réseau.
Allow Indeterminate Flow (Autoriser le flux indéterminé)
Lors d’un traçage en amont, en aval ou d’isolement, il est parfois impossible de déterminer une direction de flux spécifique. Lors de la modélisation de la direction du flux à l’aide de contrôleurs de sous-réseau dans un réseau de domaine traditionnel, les scénarios impliquant des boucles sont définis comme indéterminés. De même, si vous utilisez le paramètre Use Digitized Direction (Utiliser le sens de numérisation) pour réaliser un traçage en amont ou en aval, les lignes ou les objets tronçon qui comportent un attribut Flow direction défini sur Indeterminate sont également définis comme étant indéterminés.
Par défaut, les entités et les objets à circulation indéterminée sont inclus dans les résultats du traçage et le paramètre Allow Indeterminate Flow (Autoriser la circulation indéterminée) est activé. Si cette option est désactivée, ces entités de réseau à circulation indéterminée interrompent la capacité à être traversé et ne sont pas incluses dans les résultats de la trace. Ce paramètre n’est respecté que lors de l’exécution d’un traçage en amont, en aval ou d’isolement.
|
Option de configuration |
Description |
|---|---|
|
Allow Indeterminate Flow (Autoriser le flux indéterminé) |
|
Infer Connectivity (Inférer la connectivité)
Lors de la réalisation d’un traçage de chemin dans un réseau de domaine de télécommunications, il peut arriver qu’il n’existe pas de connectivité explicite entre un emplacement de départ et un emplacement d’arrêt. Le paramètre Infer Connectivity (Inférer la connectivité) peut être utilisé dans ce type de situation pour rechercher des chemins et modéliser des circuits à l’aide de l’inférence de connectivité lorsqu’il manque certaines informations relatives à la connectivité.
Certaines organisations peuvent préférer ne pas modéliser physiquement chaque entité de leur réseau, par exemple les câbles de brassage qui relient les ports dans un panneau de brassage. Dans ces cas, la connectivité existe et doit être inférée, même si elle n’est pas explicitement modélisée. Les catégories de réseau Unit Container (Conteneur d’unités) et Unit Identifiable (Identifiable par unité) peuvent être attribuées à des types de ressources pour prendre en charge l’inférence de connectivité via la hiérarchie d’inclusion d’une entité lorsque la connectivité physique n’est pas représentée.
Dans l’exemple suivant, l’inférence de connectivité est utilisée pour découvrir un chemin entre le port 3 de la borne de ligne optique (OLT) et le port 3 de la borne de réseau optique (ONT). Aucune connectivité explicite n’étant modélisée entre les ports sur le panneau de distribution de fibre optique (FDP), les ports sont attribués à la catégorie Unit Identifiable (Identifiable par unité) et le panneau de distribution de fibre optique se voit attribuer la catégorie Unit Container (Conteneur d’unités). Lorsque le traçage du chemin s’exécute avec l’option Infer Connectivity (Inférer la connectivité) activée, tous les ports du panneau de distribution de fibre optique dont la valence est de 1 sont évalués pour déterminer si un chemin existe jusqu’à l’emplacement d’arrêt spécifié.
Remarque :
Les objets jonction identifiables par unité sans tronçon connecté sont évalués lorsqu’ils sont définis comme localisation d’arrêt d’un traçage de chemin.

|
Option de configuration |
Description |
|---|---|
|
Infer Connectivity (Inférer la connectivité) |
|
Traversability (Traversabilité)
La section Traversability (Traversabilité) de l’outil Trace (Traçage) inclut les interruptions conditionnelles et les interruptions de fonctions permettant de contrôler la capacité d’un traçage à être traversé. Les interruptions conditionnelles sont des expressions basées sur les attributs ou les catégories de réseau et permettant de définir où un traçage doit s’arrêter. Les interruptions de fonctions définissent à quel endroit un traçage doit s’arrêter lorsqu’une condition est remplie.
La portée de la capacité à être traversé est également contrôlée par le paramètre correspondant Apply Traversability To (Appliquer la capacité à être traversé à) de l’outil Trace (Traçage). Ce paramètre indique si la traversabilité est appliquée aux jonctions et aux tronçons, uniquement aux jonctions ou uniquement aux tronçons. Par exemple, si la capacité à être traversé est appliquée uniquement aux jonctions et qu’un tronçon remplit la condition spécifiée dans une interruption conditionnelle, le tracé ne s’arrête pas au tronçon en raison de la portée de la capacité à être traversé.
Pour en savoir plus, reportez-vous à la rubrique Barrières.
Configurer les fonctions
Une fonction est une propriété de configuration de trace qui vous permet d’exécuter des calculs sur les attributs de réseau associés aux entités de réseau tracées (par exemple, la somme de la longueur de tous les câbles tracés). Vous pouvez spécifier plusieurs fonctions pour un traçage.
De plus, un nom de fonction facultatif (Function Name [Nom de la fonction]) et un filtre d’attribut (Filter Name [Nom du filtre], Filter Operator [Opérateur de filtre], Filter Type [Type de filtre] et Filter Value [Valeur de filtre]) peuvent être ajoutés à chaque fonction. Les noms de fonction fournissent un alias permettant de décrire et de contextualiser la sortie de la fonction. Lorsque les noms de filtre attributaire sont spécifiés, la fonction n’est appliquée qu’aux entités de réseau qui satisfont au filtre attributaire. Les filtres sur les fonctions permettent d’introduire une exigence conditionnelle. Par exemple, ajoutez la longueur de toutes les lignes où l’attribut Phases Current comprend les valeurs A, B et C.
Remarque :
Les configurations de tracé utilisant des attributs de réseau avec des fonctions (Add [Ajouter], Average [Moyenne], Count [Total], Max, Min et Subtract [Soustraire]) renvoient des résultats répartis selon les tronçons. Par exemple, l’utilisation d’une fonction au sein d’un traçage de type connecté pour totaliser l’attribut shape length renvoie un total selon les entités de tronçons individuelles et non selon la ligne entière. Reportez-vous à la rubrique Attributs de réseau répartis pour plus d'informations.
Contrôler ce qui est renvoyé
Pour contrôler les éléments renvoyés dans les résultats d’un traçage, des paramètres tels que Num Paths (Nombre de chemins), Max Hops (Nombre max. de sauts) et Result Types (Types de résultats) sont utilisés avec des filtres en sortie pour contrôler les éléments renvoyés dans le cadre d’une opération de traçage.
Nombre de chemins et nombre maximal de sauts
Lorsque vous effectuez un traçage de circuit ou de chemin, deux paramètres limitent le nombre de chemins traversés et permettent de définir comment les chemins valides sont identifiés et renvoyés. Le paramètre Num Paths (Nombre de chemins) spécifie le nombre maximal de chemins à renvoyer entre un ensemble donné d’emplacements de départ et d’arrêt. Si le nombre de chemins détectés dépasse le nombre spécifié de chemins, la priorité est donnée aux chemins avec le nombre minimum de sauts. La valeur par défaut est 1.
Lorsqu’un traçage de chemin est configuré à l’aide du paramètre Shortest Path Network Attribute Name (Nom d’attribut de réseau du chemin le plus court) et d’une valeur de paramètre Num Paths (Nombre de chemins) égale à 1, le chemin le plus court peut être renvoyé. Pour en savoir plus, reportez-vous à la rubrique Renvoyer le chemin le plus court.
Le paramètre Max Hops (Nombre max. de sauts) spécifie le nombre maximal de sauts autorisés entre les tronçons d’un chemin, à l’exception du point de départ. Au cours d’un traçage, tous les tronçons et toutes les associations de connectivité jonction-jonction sont évalués comme ayant une longueur unitaire fixe de 1 sur la traversée, alors que les bornes de dispositif sont évaluées comme ayant une longueur unitaire fixe de 2. La valeur par défaut est 100.
La valeur par défaut des paramètres Max Hops (Nombre max. de sauts) peut être configurée pour un réseau de domaine de télécommunications dans l’outil Traçage ou dans le cadre des propriétés du circuit, tandis que le paramètre Num Paths (Nombre de chemins) n’est configurable que dans la configuration de tracé à l’aide de l’outil Traçage. Le diagramme ci-dessous illustre un exemple de traçage de chemin entre des points de départ dans OLT et des points d’arrêt dans FDP et ONT. Dans cet exemple, Num Paths (Nombre de chemins) a pour valeur 3 et Max Hops (Nombre max. de sauts), 5. Les chemins valides sont renvoyés entre OLT1 et ONT1, ainsi qu’entre OLT4 et FDP4. Un chemin supplémentaire entre OLT1 et ONT1 via FDP1 et FDP 3 n’est pas renvoyé car cela nécessiterait sept sauts entre les points de départ et d’arrêt pour définir le chemin.

Ces paramètres ne sont appliqués que si le type de traçage est Path (Chemin) ou Circuit.
Filtres en sortie
En sortie, chaque entité de réseau trouvée lors d’un traçage est contrôlée pour déterminer si elle répond aux critères spécifiés dans le filtre. C’est le cas, par exemple, lors d’un traçage qui renvoie tous les dispositifs de protection en amont à partir d’un point de début dans un réseau électrique.
Deux types de filtres Output (Sortie) sont disponibles avec l’outil Traçage : Output Asset Types (Types d’actifs en sortie) et Output Conditions (Conditions en sortie).
Un filtre Output Asset Types (Types d’actifs en sortie) permet d’inclure uniquement les types d’actifs spécifiés dans les résultats du parcours. Par exemple, un filtre de type d’actif en sortie serait appliqué à un rapport de signalement de poteaux dans un réseau électrique pour que seuls les poteaux figurent dans les résultats.
Le filtre Output Conditions (Conditions en sortie) prend en charge les catégories de réseau et les attributs de réseau. C’est le cas, par exemple, d’une condition en sortie dans laquelle un nom de catégorie de réseau spécifique est utilisé pour renvoyer tous les dispositifs d’isolement dans un réseau de distribution de gaz. Toutes les entités et tous les objets auxquels la catégorie de réseau Isolating (Isolement) est attribuée sont renvoyés. Un traçage effectué dans un réseau de distribution de gaz peut renvoyer les dispositifs suivants : vannes de fermeture d’urgence, robinets de dérivation, vannes de service, vannes d’arrêt immédiat. Les entités et les objets qui ne possèdent pas cette catégorie de réseau sont tout de même tracés, mais ils ne sont pas inclus dans les résultats.
Les attributs de réseau résident dans la topologie du réseau et sont associés à un champ d’une classe de réseau ou de plusieurs. Dans une condition en sortie, le nom de l’attribut de réseau, un opérateur et une valeur valide pour l’attribut de réseau sont spécifiés. Par exemple, dans le cas d’une fuite dans un réseau de distribution d’eau, un attribut de réseau est utilisé pour renvoyer les canalisations à pincer. La classe Line possède alors un champ nommé Pinchable. Ce champ est associé à un attribut de réseau nommé Pinchable (À pincer). Le paramètre Output Conditions (Conditions en sortie) est configuré de manière à rechercher les classes dont la valeur de l’attribut de réseau Pinchable (À pincer) est True. Les résultats du traçage incluent les entités et les objets d’une classe comportant ce champ avec la valeur True, ainsi que les entités de réseau des classes ne possédant pas le champ Pinchable.
Étant donné le comportement des attributs de réseau dans les conditions en sortie, il est nécessaire d’utiliser un filtre Types d’actifs en sortie pour que seules les canalisations à pincer soient renvoyées. Par exemple, dans la configuration Gas Utility Network (réseau de distribution de gaz) fournie par Esri, la classe PipelineLine comporte un groupe d’actifs Distribution Pipe (Canalisation de distribution), dans lequel le type d’actif Plastic PE (Plastique PE) est spécifié. Avec les deux filtres, IsPinchable = True AND AssetType = Plastic PE, seules les canalisations en plastique PE à pincer figurent dans les résultats du traçage.
Vous pouvez associer plusieurs valeurs de Output Conditions (Conditions en sortie) à appliquer avec le paramètre Combine Using (Combiner en utilisant). Les deux types de sortie peuvent être utilisés et il est possible de configurer plusieurs types de sortie. Associer des types en sortie vous permet par exemple de renvoyer toutes les canalisations en plastique PE à pincer de 12 pouces qui dépassent 80 PSI.
En savoir plus sur l’utilisation de plusieurs expressions conditionnelles
Type de résultat
Le paramètre facultatif Result Types (Type de résultat) permet de spécifier une ou plusieurs options pour contrôler le type de résultat renvoyé par l’opération de traçage.
Le type de résultat Selection (Sélection) crée un ensemble de sélection tandis que l’option Aggregated Geometry (Géométrie agrégée) génère des géométries en sortie. Connectivity (Connectivité) renvoie un diagramme de connectivité des entités de réseau connectées par coïncidence géométrique ou associations de connectivité. Le type de résultat Elements (Éléments) renvoie des informations basées sur les entités et l’option Features (Entités) étend cette fonctionnalité en permettant également d’inclure les attributs de réseau, les valeurs de champ et la géométrie. Le type de résultat Containment and attachment associations (Associations d’inclusion et de dépendance structurelle) renvoie des entités liées au résultat du traçage via des associations d’inclusion et de dépendance structurelle, et l’option Related records (Enregistrements associés) renvoie les valeurs de champ d’attribut provenant d’objets associés, le tout dans un fichier .json en sortie .
Les options de type de résultat Connectivity (Connectivité), Elements (Éléments) et Features (Entités) peuvent être utilisées pour renvoyer des sens de flux dérivés des contrôleurs de sous-réseau pour les lignes, les objets tronçon, les tronçons internes des dispositifs avec bornes et les associations de connectivité dans le résultat dans un fichier .json lors de l’exécution d’un traçage de sous-réseau, en amont ou en aval.
Le type de résultat Circuits peut être utilisé pour renvoyer les informations de définition du circuit et de connectivité du chemin d’un circuit dans un fichier .json lors de l’exécution d’un traçage de circuit sur un réseau de domaine de télécommunications.
|
Le paramètre |
Options |
|---|---|
|
Result Types (Type de résultat) |
Remarque :Lorsque vous utilisez des géodatabases d’entreprise, les conditions suivantes doivent être remplies :
|
Lorsque l’option Selection (Sélection) est sélectionnée pour le type de résultat, un paramètre Selection Type (Type de sélection) supplémentaire est fourni pour définir la manière dont la sélection sera appliquée et l’action à effectuer s’il existe déjà une sélection.
|
Le paramètre |
Options |
|---|---|
|
Selection Type (Type de sélection) |
|
L’option Aggregated Geometry (Géométrie agrégée) permet aux résultats de traçage d’être renvoyés en tant que géométrie multi-parties dans une classe d’entités. Cette opération respecte la localisation des points de départ, des points d’arrêt et des interruptions placées à mi-portée sur les entités linéaires et les objets tronçons pour renvoyer des résultats d’entités partiels.
Examinez les images ci-après pour comparer les différences entre les options de type de résultat de sélection et de géométrie agrégée dans un traçage en aval. Le réseau ci-dessous contient cinq entités linéaires (f1, f2, f3, f4 et f5) constituées de neuf éléments tronçons (e1, e2, e3, etc.).
Dans cet exemple, qui comprend des entités d’interruption, le résultat de sélection renvoie sept entités ponctuelles et cinq entités linéaires consistant en neuf éléments tronçons (f1e1,e2,e3, f2e1,e2 et f5e1,e2). Le résultat de géométrie agrégée renvoie les mêmes entités mais exclut les éléments tronçons f1e1,e2 et f5::e2.

Lorsqu’une interruption est placée le long d’un tronçon avec l’option de configuration Include Barrier Features (Inclure les entités d’interruption) cochée, le traçage s’arrête à l’entité d’interruption et renvoie la géométrie d’entité partielle pour le tronçon dans les résultats de traçage. Si l’option Include Barrier Features (Inclure les entités d’interruption) n’est pas cochée, le traçage s’arrête à la fin de ligne ou la jonction précédente rencontrée avec une connectivité à mi-portée.
Les exemples ci-dessous présentent la différence dans les résultats de traçage lorsque l’option Include Barrier Features (Inclure les entités d’interruption) est utilisée pour inclure ou exclure des entités d’interruption dans les résultats de traçage. Dans cet exemple, le point de début et l’interruption sont placés le long d’un tronçon. Avec cette option activée, le résultat de sélection renvoie six entités ponctuelles et cinq entités linéaires consistant en neuf éléments tronçons (f1e1,e2,e3, f2e1,e2, f3e1, f4e1 et f5e1,e2). Le résultat de type géométrie agrégée renvoie les mêmes cinq entités linéaires, mais exclut les éléments de tronçon f1e1 et f5::e2. La géométrie partielle est renvoyée pour l’élément de tronçon f1 e2. Le résultat de sélection ne changerait pas si vous deviez exclure les entités d’interruption avec l’option Include Barrier Features (Inclure les entités d’interruption) non cochée ; toutefois, les résultats de géométrie agrégée excluraient en plus f1e2.

Lorsque l’option Aggregated Geometry (Géométrie agrégée) est sélectionnée pour le type de résultat, des paramètres supplémentaires sont fournis pour définir le comportement en sortie du traçage :
Clear All Previous Trace Results (Effacer tous les résultats du traçage précédents)
Synthesize Geometries (Synthétiser les géométries)
Trace Name (Nom du tracé)
Aggregated Points (Points agrégés)
Aggregated Lines (Lignes agrégées)
Aggregated Polygons (Polygones agrégés)
La case à cocher Clear All Previous Trace Results (Effacer tous les résultats de traçage précédents) fournit une option pour tronquer le contenu des classes d’entités choisies pour stocker la géométrie agrégée ou lui ajouter des éléments.
|
Paramètre |
Options |
|---|---|
|
Clear All Previous Trace Results (Effacer tous les résultats du traçage précédents) |
|
Le paramètre Synthesize Geometries (Synthétiser les géométries) permet de visualiser le chemin des associations et les objets tronçons traversés au cours d’un traçage en synthétisant la géométrie dans la sortie de géométrie agrégée.
Il existe deux façons de synthétiser la géométrie d’un objet de tronçon. Lorsqu’un objet de tronçon constitue le contenu d’une ligne, la géométrie est inférée à partir du conteneur spatial. Lorsqu’un objet de tronçon a une inclusion non spatiale alors que cela n’est pas possible, la géométrie est synthétisée entre les extrémités de l’objet de tronçon.
En savoir plus sur la synthèse de la géométrie pour les objets tronçon dans un traçage
Lors de l’utilisation des associations, la géométrie est synthétisée entre les points de terminaison de l’association. Lorsqu’un objet de tronçon ou un conteneur de point de terminaison de l’association n’est pas spatial, sa localisation est dérivée de la première entité spatiale de la hiérarchie d’inclusion.
En savoir plus sur la synthèse de la géométrie de l’association dans un traçage
|
Le paramètre |
Options |
|---|---|
|
Synthesize Geometries (Synthétiser les géométries) |
Remarque :Ce paramètre requiert ArcGIS Enterprise 11.3 ou une version ultérieure si vous utilisez une géodatabase d’entreprise. |
Le paramètre facultatif Trace Name (Nom de la trace) permet de créer un identifiant de chaîne pour l’opération de traçage qui facilite l’identification des résultats de trace. S’il est utilisé avec la case du paramètre Clear All Previous Trace Results (Effacer tous les résultats de traçage précédents) décochée, il permet d’exécuter plusieurs opérations de traçage et de comparer les résultats dans les classes d’entités de la géométrie agrégée en sortie.
Les paramètres Aggregated Points (Points agrégés), Aggregated Lines (Lignes agrégées) et Aggregated Polygons (Polygones agrégés) permettent de spécifier des classes d’entités pour le stockage de la géométrie résultante agrégée. Par défaut, chaque paramètre est renseigné avec une classe d’entités générée par le système et stockée dans la géodatabase par défaut du projet.
Trace_Results_Aggregated_Lines: classe d’entités linéairesTrace_Results_Aggregated_Points: classe d’entités multi-pointsTrace_Results_Aggregated_Polygons: classe d’entités surfaciques
Ces classes d’entités sont automatiquement créées si elles n’existent pas. Il est également possible d’utiliser des classes d’entités existantes pour stocker la géométrie agrégée. Si une classe d’entités autre que la classe d’entités par défaut est utilisée, elle doit contenir une chaîne TRACENAME et correspondre au type de géométrie de la sortie.
La génération de géométrie en sortie avec les résultats d’entité partielle offre une représentation plus précise du traçage et permet de comparer et de réutiliser les résultats de traçage pour d’autres tâches.
Attention :
La désactivation de l’option de géotraitement Allow geoprocessing tools to overwrite existing datasets (Autoriser les outils de géotraitement à remplacer les jeux de données existants) peut générer des problèmes de validation d’outil si les classes d’entités en sortie pour le type de résultat Aggregated Geometry (Géométrie agrégée) existent dans la géodatabase par défaut du projet. Pour résoudre ce problème, activez l’option de géotraitement ou renommez les classes d’entités ponctuelles, linéaires et surfaciques agrégées dans la géodatabase par défaut du projet.
L’option de type de résultat Connectivity (Connectivité) renvoie des résultats du traçage sous forme d’un graphe de connectivité des entités de réseau connectées via la coïncidence géométrique ou des associations de connectivité. Si cette option est sélectionnée, la connectivité est restituée dans un fichier .json à l’emplacement spécifié, qui peut être analysé et importé dans d’autres systèmes pour créer votre propre diagramme de représentation des données. Les informations de connectivité sont uniquement renvoyées pour les entités de réseau qui sont elles-mêmes renvoyées par le traçage. Le fichier .json en sortie contient les informations suivantes qui s’appliquent à toutes les entités de réseau traversées sous connectivity :
fromNetworkSourceIdfromGlobalIdfromObjectIdfromTerminalIdviaNetworkSourceIdviaGlobalIdviaObjectIdviaPositionFromviaPositionTotoNetworkSourceIdtoGlobalIdtoObjectIdtoTerminalId
Informations renvoyées avec Include geometry (Inclure la géométrie) (absentes pour les objets jonction et tronçon) :
viaGeometryfromGeometrytoGeometry
Informations renvoyées avec Include domain descriptions (Inclure des descriptions de domaine) :
viaNetworkSourceNamefromNetworkSourceNamefromTerminalNametoNetworkSourceNamefromTerminalName
Informations renvoyées avec Include flow directions (Inclure les sens de flux) pour les lignes, les objets tronçon, les tronçons internes des dispositifs avec bornes, ainsi que les associations de connectivité avec les traçages de sous-réseau, en amont et en aval :
flowDirection
L’option de type de résultat Elements (Éléments) renvoie les résultats du traçage sous forme d’informations basées sur les entités dans le fichier .json spécifié en sortie. Ce dernier peut être utilisé en entrée pour procéder à une autre analyse. Le fichier .json en sortie contient les informations suivantes qui s’appliquent à toutes les entités de réseau traversées sous elements :
networkSourceIdglobalIdobjectIdassetGroupCodeassetTypeCode
Des informations supplémentaires sont renvoyées pour les entités ponctuelles et les objets de jonction :
terminalId
Des informations supplémentaires sont renvoyées pour les entités linéaires et les objets de tronçon :
positionFrompositionTo
Informations renvoyées avec Include flow directions (Inclure les sens de flux) pour les lignes, les objets tronçon, les tronçons internes des dispositifs avec bornes, ainsi que les associations de connectivité avec les traçages de sous-réseau, en amont et en aval :
flowDirection
L’option de type de résultat Features (Entités) renvoie les résultats du traçage sous forme d’informations basées sur les entités dans le fichier .json en sortie spécifié. Similaire à l’option Elements (Éléments), cette option permet d’inclure des informations supplémentaires dans la sortie à utiliser avec d’autres applications comme la géométrie des entités, les informations sur les attributs de réseau et les valeurs des champs attributaires. Le fichier .json en sortie contient les informations renvoyées par l’option Elements (Éléments) ci-avant pour toutes les entités de réseau traversées sous featureElements, ainsi que les informations supplémentaires suivantes :
Informations renvoyées avec Include geometry (Inclure la géométrie) (absentes pour les objets jonction et tronçon) :
geometry
Informations renvoyées avec Include domain descriptions (Inclure des descriptions de domaine) :
networkSourceNameassetGroupNameassetTypeNamenetworkAttributeDescriptions(si l’option Result Network Attributes [Attributs de réseau générés] est spécifiée)Des informations supplémentaires sont renvoyées pour les entités ponctuelles et les objets de jonction :
terminalName
Informations renvoyées avec Include flow directions (Inclure les sens de flux) pour les lignes, les objets tronçon, les tronçons internes des dispositifs avec bornes, ainsi que les associations de connectivité avec les traçages de sous-réseau, en amont et en aval :
flowDirection
Informations renvoyées avec Include propagated values (Inclure les valeurs propagées) lors de l’exécution d’un traçage basé sur un sous-réseau. Le fichier .json en sortie contient les informations suivantes qui s’appliquent à toutes les entités de réseau traversées sous propagatedValues lorsque les informations sur l’attribut propagé sont disponibles :
attributeNamepropagatedValuedescription
Informations renvoyées avec Result Network Attributes (Attributs de réseau générés) :
networkAttributeValues
Informations renvoyées avec Result Fields (Champ de résultats) :
fieldValues
L’option des types de résultat Containment and attachment associations (Associations de dépendances structurelles et d’inclusion) renvoie des informations sur l’association pour les entités de réseau traversées associées via des associations d’inclusion et de dépendances structurelles dans le fichier .json en sortie spécifié. Le fichier .json en sortie contient les informations suivantes qui s’appliquent à toutes les entités de réseau traversées sous associations :
associationTypefromNetworkSourceIdfromGlobalIdfromTerminalIdtoNetworkSourceIdtoGlobalIdtoTerminalId
Informations renvoyées avec Include domain descriptions (Inclure des descriptions de domaine) :
fromNetworkSourceNamefromTerminalNametoNetworkSourceNametoTerminalName
L’option de type de résultats Related records (Enregistrements associés) renvoie des valeurs de champ issues d’une classe d’objets associés dans un fichier .json en sortie spécifié lorsque les classes du réseau de distribution font partie d’une classe de relations avec d’autres entités ou objets. Le fichier .json en sortie contient les informations suivantes qui s’appliquent à toutes les entités de réseau traversées sous relatedRecords :
networkSourceIdglobalIdrelationshipClassesoriginLayerOrTableIddestinationLayerOrTableIdnamerelationshipsoutFieldsnamevalue
Le type de résultat Circuits peut être utilisé pour renvoyer la définition du circuit vers un fichier .json en sortie. En cas d’utilisation avec les paramètres Include geometry (Inclure la géométrie) et Synthesize Geometries (Synthétiser les géométries), la géométrie pour la connectivité du chemin est également incluse. Le fichier .json en sortie contient les informations de définition de circuit suivantes qui s’appliquent à toutes les entités de réseau traversées sous circuits.
Informations renvoyées avec Include geometry (Inclure la géométrie) :
geometryRemarque :
La géométrie n’est pas présente pour les tables et les objets non spatiaux, sauf en cas d’utilisation avec les options Synthesize Geometries (Synthétiser les géométries) et Circuits du paramètre de type de résultat.
Informations renvoyées avec Include domain descriptions (Inclure des descriptions de domaine) :
networkSourceNamedescription
Des paramètres supplémentaires sont activés lorsque certaines options Result Types (Types de résultat) sont sélectionnées :
Si l’option Connectivity (Connectivité), Elements (Éléments), Features (Entités), Containment and attachment associations (Associations de dépendance et d’inclusion), Related records (Enregistrements associés) ou Circuits est sélectionnée, un paramètre Output JSON (JSON en sortie) supplémentaire est fourni pour indiquer l’emplacement du fichier
.jsonen sortie.Si l’option Features (Entités), Connectivity (Connectivité), Containment and attachment associations (Associations de dépendances structurelles et d’inclusion) ou Related records (Enregistrements associés) est sélectionnée, un paramètre Include domain descriptions (Inclure des descriptions de domaine) supplémentaire est fourni pour inclure des descriptions de domaine pour les entités de réseau traversées.
Si l’option Connectivity (Connectivité), Features (Entités) ou Related records (Enregistrements associés) est sélectionnée, un paramètre Include geometry (Inclure la géométrie) supplémentaire est fourni pour la géométrie des entités en sortie pour les entités de réseau traversées.
Si l’option Features (Entités) est sélectionnée, les paramètres Result Network Attributes (Attributs de réseau générés) et Result Fields (Champs de résultat) sont fournis en plus pour générer des informations sur les attributs de réseau en sortie et des informations sur le niveau de champ pour les entités de réseau traversées.
Lorsque l’option Connectivity (Connectivité), Elements (Éléments) ou Features (Entités) est sélectionnée, le paramètre supplémentaire Include flow directions (Inclure les sens de flux) permet d’inclure les sens de flux dérivés des contrôleurs de sous-réseau pour les entités traversées lors de l’exécution d’un traçage de sous-réseau, en amont ou en aval.
Lorsque l’option Related records (Enregistrements associés) est sélectionnée, le paramètre Related Record Fields (Champs d’enregistrement associé) est fourni pour spécifier la classe de relations et le champ issus de la classe d’objets associés dont les valeurs seront renvoyées dans les résultats.
Lorsque l’option Circuits est sélectionnée, le paramètre Include Geometry (Inclure la géométrie) est fourni pour la géométrie en sortie des entités qui incluent le chemin du circuit. Pour les circuits contenant des objets jonction et tronçon non spatiaux, le paramètre Synthesize Geometries (Synthétiser les géométries) est également fourni pour synthétiser le chemin des objets tronçon qui sont traversés pendant le traçage. Il existe deux façons de synthétiser la géométrie d’un objet tronçon. Lorsqu’un objet de tronçon constitue le contenu d’une ligne, la géométrie est inférée à partir du conteneur spatial. Lorsqu’un objet de tronçon a une inclusion non spatiale, les informations de géométrie sont synthétisées entre les extrémités de l’objet tronçon. Pour en savoir plus sur le fichier
.jsonen sortie créé par l’option de type de résultat Circuits, reportez-vous à la rubrique Syntaxe de réponse JSON de traçage.
Si l’option Connectivity (Connectivité), Elements (Éléments), Features (Entités), Containment and attachment associations (Associations de dépendances structurelles et d’inclusion) ou Related records (Enregistrements associés) est sélectionnée, le fichier .json en sortie inclut un élément sourceMapping à la fin du fichier. Cet élément vous permet de consulter le nom de couche associé à chaque networkSourceId.
"sourceMapping": {
"1": "UN_6_Associations",
"2": "UN_6_SystemJunctions",
"4": "Structure Junction",
"5": "Structure Line",
"6": "Structure Boundary",
"7": "Structure Junction Object",
"8": "Structure Edge Object",
"9": "Electric Distribution Device",
"10": "Electric Distribution Line",
"11": "Electric Distribution Assembly",
"12": "Electric Distribution Junction",
"13": "Electric Distribution SubnetLine",
"14": "Electric Distribution Junction Object",
"15": "Electric Distribution Edge Object"
},
Utiliser des opérateurs bit à bit
La configuration du parcours mobilise un ensemble commun d’opérateurs qui permettent de définir des interruptions, des filtres, des fonctions et des sorties pour les résultats du parcours. Les opérateurs standard servent à déterminer par une évaluation si les attributs d’entités sont égaux, inférieurs ou supérieurs à une valeur.
Les opérateurs bit à bit utilisent les bits pour déduire la valeur binaire d’une valeur entière donnée. Ces opérateurs puissants et polyvalents sont plus couramment sollicités pour des applications avancées de traçage. La structure de traçage est compatible avec ces bits indépendamment de la signification que l’utilisateur leur attribue dans la paire de valeurs précodées du domaine.
Les opérateurs bit à bit utilisés dans la configuration de traçage incluent ce qui suit :
Includes the values (Inclut les valeurs) : opération Et bit à bit dans laquelle tous les bits de la valeur fournie sont présents dans l’attribut (Et bit à bit == valeur).
- Si vous utilisez cet opérateur, tous les bits inclus dans la valeur de configuration doivent également être présents dans la valeur d’attribut de réseau pour que la valeur soit Vrai.
Does not include the values (N’inclut pas les valeurs) : opération Et bit à bit dans laquelle les bits de la valeur fournie ne sont pas tous présents dans l’attribut (Et bit à bit !== valeur).
- Si vous utilisez cet opérateur, la valeur est Vrai uniquement si l’attribut de réseau n’inclut pas tous les bits présents dans la valeur de configuration.
Includes any (Inclut l’un quelconque) : opération Et bit à bit dans laquelle au moins un bit de la valeur fournie est présent dans l’attribut (Et bit à bit == Vrai).
- Si vous utilisez cet opérateur, tout bit présent dans la valeur de configuration et qui est également présent dans l’attribut de réseau génère la valeur Vrai.
Does not include any (N’inclut aucun) : opération Et bit à bit dans laquelle aucun des bits de la valeur fournie n’est présent dans l’attribut (Et bit à bit == Faux).
- Si vous utilisez cet opérateur, la valeur est Vrai uniquement si aucun des bits présents dans la valeur de configuration n’est présent dans la valeur d’attribut de réseau.
Pour la modélisation de la phase dans un réseau électrique, le jeu de données peut être configuré de sorte qu’il utilise la valeur binaire de l’entier spécifié pour le code de domaine. Un ensemble de valeurs est configuré pour chaque combinaison de phases autorisée dans un domaine de valeurs précodées et affecté aux attributs qui utilisent une phase. Pour une utilisation dans la configuration du tracé, un attribut de réseau est ensuite configuré et affecté au champ de phase.
Le tableau ci-après explique comment modéliser une phase à l’aide de ces valeurs binaires. La valeur décimale est stockée comme code et la valeur de phase est utilisée pour la description dans le domaine de valeurs précodées. Chaque valeur décimale correspond à une valeur binaire évaluée. La colonne des valeurs binaires dans le tableau contient la représentation binaire de chaque valeur décimale. Les opérateurs bit à bit déconstruisent un attribut et déterminent si chacune de ses parties obéit à la logique opérationnelle.
|
Valeur binaire |
Code (valeur décimale) |
Description (valeur de phase) |
|---|---|---|
|
001 |
1 |
C |
|
010 |
2 |
B |
|
100 |
4 |
A |
|
011 |
3 |
BC |
|
101 |
5 |
AC |
|
110 |
6 |
AB |
|
111 |
7 |
ABC |
Par exemple, pour recenser toutes les entités de réseau d’un sous-réseau dont la valeur Phases Current inclut A, un tracé du sous-réseau est effectué dans un réseau de domaine de distribution électrique. Le point de départ est un point de service dont la valeur Phases Current est A (100), et la configuration de tracé suivante est spécifiée comme filtre d’interruption.
L’interruption de filtre est configurée de façon à exclure des résultats du parcours les entités et les objets qui n’incluent pas la phase A. Pour que les entités d’interruption ne soient pas incluses dans les résultats du traçage, l’option de configuration de traçage Include Barrier Features (Inclure les entités d’interruption) est définie sur False (Faux). Les résultats du tracé incluent les entités de sous-réseau dont la valeur Phases Current est A ou dont la valeur Phases Current inclut A. Toute entité de sous-réseau rencontrée dont la valeur Phases Current n’inclut pas A est considérée comme une interruption et n’est pas incluse dans le résultat.
Filter Barriers
Name: Phases Current
Operator: Does not include any (Bitwise AND equals False)
Type: Specific value
Value: 4 //code for A (100)
Le tableau ci-après illustre des scénarios dans lesquels un opérateur bit à bit a pour valeur Vrai et sert d’interruption dans un traçage. Prenez, par exemple, un scénario dans lequel le champ Phase d’un dispositif contient la valeur d’attribut de réseau AB (110) et où la valeur comparée depuis la configuration de tracé est ABC (111).
Si vous utilisez l’opérateur
Includes the values, la valeur est Faux et l’opérateur n’agit pas en tant qu’interruption car les bits ne sont pas tous présents dans la valeur d’attribut de réseau. Bit C (001) n’est pas présent dans AB (110).Si vous utilisez l’opérateur
Includes anypour la même configuration, la valeur est Vrai car certains bits de la valeur de configuration sont présents dans l’attribut de réseau. Bit A (100) et Bit B (010) sont présents dans ABC (111).Si vous utilisez l’opérateur
Does not include the values, la valeur est également Vrai car la valeur d’attribut de réseau AB (110) n’inclut pas le bit C (001), même si A (100) et B (010) sont présents.Enfin, si vous utilisez l’opérateur
Does not include anyavec cet exemple de configuration, la valeur est Faux si la valeur d’attribut de réseau est AB (110) car la valeur de configuration contient les bits A (100) et B (010) correspondants. Pour que la valeur soit Vrai, A (100), B (010) et C (001) doivent être absents.
|
Valeur d’attribut de réseau |
Valeur de configuration |
Inclut les valeurs |
Inclut un(e) |
N’inclut pas les valeurs |
N’inclut aucun |
|---|---|---|---|---|---|
|
ABC (111) |
A (100) |
True |
True |
False |
False |
|
AC (101) |
BC (011) |
False |
True |
True |
False |
|
C (001) |
B (010) |
False |
False |
True |
True |
|
AB (110) |
ABC (111) |
False |
True |
True |
False |
Effectuer des calculs sur les entités de réseau tracées
Les réseaux techniques incluent une fonctionnalité avancée dénommée propagation des attributs qui est utilisée lorsqu’un sous-réseau est mis à jour, exporté, ou tracé. La propagation d’attributs exploite la topologie de réseau pour calculer les valeurs à partir d’une source à travers des éléments connectés d’un sous-réseau dans le sens du flux.
Les valeurs propagées sont écrites dans les entités en aval des contrôleurs de sous-réseau lors de la mise à jour du sous-réseau et peuvent être configurées comme interruptions conditionnelles lors de l’exécution de traçages basés sur le sous-réseau.
Remarque :
La propagation des attributs est ignorée lors d’un traçage en amont ou en aval utilisant le sens de numérisation pour modéliser le flux des ressources dans le réseau.
Inclure les valeurs propagées
Lors de l’exécution d’un traçage basé sur un sous-réseau, les valeurs propagées des entités traversées peuvent être renvoyées dans un fichier .json en sortie en tant que propagatedValues à l’aide de l’option de type de résultat Features (Entités) et du paramètre Include propagated values (Inclure les valeurs propagées). Cela permet de renvoyer les valeurs propagées à la demande à l’aide d’un traçage sans avoir à effectuer une de mise à jour du sous-réseau.
|
Option de configuration |
Description |
|---|---|
|
Include propagated values (Inclure les valeurs propagées) |
|
La substitution d’attribut permet au réseau de distribution de changer la manière dont les valeurs sont propagées en permettant à une entité de transposer dynamiquement les valeurs à mesure du traçage du réseau. Pour traiter la substitution d’attribut, configurez un attribut de réseau de substitution pour un champ de base de données. La substitution est un type d’attribut de réseau dont la valeur est utilisée pour calculer la valeur propagée pour les entités, avec la catégorie de substitution d’attribut affectée à son type de ressource. La valeur de substitution obtenue est ensuite utilisée pour calculer la valeur pour l’entité connectée suivante. La propagation d’attribut doit être configurée pour que la substitution d’attribut puisse être utilisée.
Pour en savoir plus, reportez-vous à la rubrique Propagation des attributs et à la rubrique Substitution des attributs.
Charger des configurations de tracé nommées
Les configurations de traçage nommées permettent de créer des traçages complexes à des fins de partage et de réutilisation. L’outil Traçage vous permet de charger une configuration de traçage nommée existante pour définir les propriétés d’un traçage. Cela simplifie l’expérience utilisateur associée au traçage et assure une cohérence via la réutilisation des traçages courants dans une organisation.
|
Paramètre |
Options |
|---|---|
|
Use Trace Configuration (Utiliser la configuration de tracé) |
|
Un paramètre Trace Configuration Name (Nom de la configuration du tracé) est fourni pour spécifier le nom de la configuration du tracé à utiliser pour définir les propriétés du tracé. Ce paramètre n’est disponible que si l’option Use Trace configuration (Utiliser la configuration du tracé) est activée.
Remarque :
Vous pouvez également utiliser l’onglet Named Configurations (Configurations nommées) de la fenêtre Trace (Traçage) pour exécuter un traçage à l’aide d’une configuration de tracé nommée déjà configurée.