Ajouter la configuration de trace (Utility Network)

Disponible avec une licence Standard ou Advanced.

Synthèse

Crée une configuration de trace nommée dans le réseau technique.

Les configurations de traces nommées permettent de configurer et de stocker les propriétés de traces complexes à des fins de réutilisation et de partage. Les configurations de traces stockées dans un réseau technique peuvent également être chargées et exécutées à partir de l’outil Trace ou partagées à des fins de consommation par une carte Web ou une application de terrain.

En savoir plus sur l’ajout d’une configuration de trace

Utilisation

  • Le paramètre Input Utility Network (Réseau de distribution en entrée) doit correspondre à un réseau de distribution de version 5 ou ultérieure.

  • Si une géodatabase d’entreprise est utilisée, le réseau technique en entrée doit provenir d’un service du réseau technique.

  • Le compte connecté au portail est défini comme créateur de la configuration de trace nommée.

    • L’authentification du système d’exploitation est utilisée pour stocker le créateur d’une configuration de trace nommée lors de l’utilisation d’un réseau de distribution dans un déploiement mono-utilisateur.

Paramètres

ÉtiquetteExplicationType de données
Réseau de distribution en entrée

Réseau technique qui contient la nouvelle configuration de trace nommée.

Utility Network; Utility Network Layer
Nom de la configuration de trace

Nom de la configuration de trace nommée.

String
Type de traçage

Spécifie le type de trace à configurer.

  • ConnectéUne trace connectée qui commence à un ou plusieurs points de début et s’étend le long des entités connectées est utilisé. Il s’agit de l’option par défaut.
  • Sous-réseauUn traçage de sous-réseau commençant à un ou plusieurs points de début et s’étendant pour englober le sous-réseau est utilisé.
  • Contrôleurs de sous-réseauxUn traçage des contrôleurs de sous-réseaux localisant les sources et les cuvettes des contrôleurs de sous-réseaux associés à un sous-réseau est utilisé.
  • En amontUn traçage en amont qui découvre les entités en amont depuis un emplacement dans le réseau est utilisé.
  • En avalUn traçage en aval qui découvre les entités en aval depuis un emplacement dans le réseau est utilisé.
  • BouclesLes boucles sont des zones du réseau où la direction du flux est ambiguë. Un traçage de boucle s’étendant vers l’extérieur depuis le point de départ selon la connectivité est utilisé.
  • Plus court cheminUn traçage du chemin le plus court identifiant le chemin le plus court entre deux points de début est utilisé.
  • IsolementUn traçage d’isolement identifiant les entités qui isolent une surface d’un réseau est utilisé.
String
Description
(Facultatif)

Description de la configuration de trace nommée.

String
Balises
(Facultatif)

Ensemble de balises utilisées pour identifier la configuration de trace nommée. Les balises peuvent être utilisées pour la recherche et l’indexation.

String
Réseau de domaine
(Facultatif)

Le nom du réseau du domaine sur lequel la trace sera exécutée. Ce paramètre est obligatoire lors de l’exécution du sous-réseau, des contrôleurs de sous-réseaux, des types de traçage en amont et en aval.

String
Niveau
(Facultatif)

Nom du niveau qui débute le traçage. Ce paramètre est obligatoire lors de l’exécution du sous-réseau, des contrôleurs de sous-réseaux, des types de traçage en amont et en aval.

String
Niveau cible
(Facultatif)

Le nom du niveau cible vers lequel le niveau en entrée s'écoule. Si ce paramètre est manquant pour les traçages en amont ou en aval, ils s’arrêteront lorsqu’ils atteignent la limite du sous-réseau de départ. Ce paramètre peut être utilisé pour permettre à ces traçages de poursuivre en haut ou en bas de la hiérarchie.

String
Nom de sous-réseau
(Facultatif)

Le nom du sous-réseau où le traçage sera exécutée. Ce paramètre peut être utilisé lors de l’exécution d’un type de traçage de sous-réseau. Si un nom de sous-réseau est indiqué, le paramètre Points de début (paramètre starting_points dans Python) n’est pas requis.

String
Nom d’attribut de réseau du chemin le plus court
(Facultatif)

Nom de l’attribut de réseau utilisé pour calculer le chemin le plus court. Lors de l’exécution d’un type de traçage du chemin le plus court, ce chemin est calculé à l’aide d’un attribut de réseau numérique comme la longueur de forme. Les chemins basés sur le coût et la distance peuvent être atteints. Ce paramètre est requis lors de l’exécution d’un traçage de chemin de type Court.

String
Inclure les containers
(Facultatif)

Indique si les entités de conteneur sont incluses dans les résultats de traçage.

  • Coché : les entités de conteneur sont incluses dans les résultats de traçage. Le paramètre Inclure jusqu’au premier conteneur spatial devient actif.
  • Non cochée : les entités de conteneur ne sont pas incluses dans les résultats de traçage. Il s’agit de l’option par défaut.

Boolean
Include Content (Inclure le contenu)
(Facultatif)

Indique si le traçage renvoie le contenu dans les conteneurs, avec les résultats.

  • Coché : le contenu des entités de conteneur est inclus dans les résultats de traçage.
  • Non cochée : le contenu des entités de conteneur n’est pas inclus dans les résultats de traçage. Il s’agit de l’option par défaut.

Boolean
Inclure les structures
(Facultatif)

Indique si les objets et les entités de structure sont inclus dans les résultats de traçage.

  • Activé : les objets et les entités de structure sont inclus dans les résultats de traçage.
  • Désactivé : les objets et les entités de structure ne sont pas inclus dans les résultats de traçage. Il s’agit de l’option par défaut.

Boolean
Inclure les entités d’interruption
(Facultatif)

Indique si les entités d’interruption de capacité à être traversé sont incluses dans les résultats de la recherche de parcours. Les interruptions de traversabilité sont facultatives même si elles ont été prédéfinies dans la définition de sous-réseau. Ce paramètre ne s’applique pas aux entités de dispositif avec des bornes.

  • Coché - Les entités d’interruption de capacité à être traversé sont incluses dans les résultats de la recherche de parcours. Il s’agit de l’option par défaut.
  • Non coché - Les entités d’interruption de capacité à être traversé ne sont pas incluses dans les résultats de la recherche de parcours.

Boolean
Valider la cohérence
(Facultatif)

Indique si une erreur est retournée lorsqu’une zone à valider figure dans les entités traversées. C’est la seule façon de garantir qu’un traçage passe via des entités avec un statut cohérent dans le réseau. Pour supprimer les zones à valider, validez la topologie de réseau.

  • Activé : le parcours retourne une erreur si une zone à valider figure dans les entités traversées. Il s’agit de l’option par défaut.
  • Désactivé : le parcours retourne des résultats, qu’une zone à valider figure ou non dans les entités traversées.

Boolean
Interruptions conditionnelles
(Facultatif)

Définit une interruption conditionnelle de traversabilité sur les entités en fonction d’une comparaison avec un attribut de réseau ou vérifie une chaîne de catégorie. Une interruption conditionnelle utilise un attribut de réseau, un opérateur et un type, ainsi qu’une valeur attributaire. Par exemple, arrêtez un traçage lorsque l’attribut Device Status d’une entité est égal à la valeur spécifique de Open. Lorsqu’une entité remplit ces conditions, le traçage s’arrête. En cas d’utilisation de plusieurs attributs, vous pouvez définir une condition Et ou une condition Ou à l’aide du paramètre Combine using (Combiner en utilisant).

Les composants d’interruptions conditionnelles sont les suivants :

  • Name (Nom) : filtrez selon un attribut de réseau défini dans le système.
  • Operator (Opérateur) : choisissez un des opérateurs.
  • Type (Type) : Choisissez une valeur spécifique ou un attribut de réseau depuis la valeur spécifiée dans le paramètre Name (Nom).
  • Value (Valeur) : indiquez la valeur spécifique du type d’attribut en entrée qui entraînerait l’arrêt en fonction de la valeur de l’opérateur.
  • Combine using (Combiner en utilisant) : définissez cette valeur si vous avez plusieurs attributs à ajouter. Vous pouvez les combiner à l’aide d’une condition Et ou d’une condition Ou.

Les options de valeurs Operator (Opérateur) des interruptions conditionnelles sont les suivantes :

  • Est égal à : l’attribut est égal à la valeur.
  • Est différent de : l’attribut est différent de la valeur.
  • Est supérieur à : l’attribut est supérieur à la valeur.
  • Est supérieur ou égal à : l’attribut est supérieur ou égal à la valeur.
  • Est inférieur à : l’attribut est inférieur à la valeur.
  • Est inférieur ou égal à : l’attribut est inférieur ou égal à la valeur.
  • Includes the values (Inclut les valeurs) : opération Et bit à bit dans laquelle tous les bits de la valeur sont présents dans l’attribut (Et bit à bit == valeur).
  • Does not include the values (N’inclut pas les valeurs) : opération Et bit à bit dans laquelle tous les bits de la valeur ne sont pas présents dans l’attribut (Et bit à bit !== valeur).
  • Includes any (Inclut tout) : opération Et bit à bit dans laquelle au moins un bit de la valeur est présent dans l’attribut (Et bit à bit == Vrai).
  • Does not include any (N’inclut aucune valeur) : opération Et bit à bit dans laquelle aucun des bits de la valeur n’est présent dans l’attribut (Et bit à bit == Faux).

Les options de la valeur Type d’interruptions conditionnelles sont les suivantes :

  • Valeur spécifique : filtrez en fonction d’une valeur spécifique.
  • Attribut de réseau : filtrez en fonction d’un attribut de réseau.

Value Table
Interruptions de fonctions
(Facultatif)

Définit l’interruption de traversabilité sur les entités en fonction d’une fonction. Les interruptions fonctionnelles peuvent être utilisées pour effectuer des actions comme limiter la distance que le traçage peut parcourir depuis le point de départ, ou définir une valeur maximale à laquelle arrêter un traçage. Par exemple, la longueur de chaque ligne parcourue est ajoutée à la distance totale parcourue jusqu’ici. Lorsque la distance totale parcourue atteint la valeur spécifiée, le traçage s’arrête.

Les composants d’interruptions de fonctions sont les suivants :

  • Function (Fonction) : choisissez une des fonctions de calcul.
  • Attribute (Attribut) : filtrez par un attribut de réseau défini dans le système.
  • Operator (Opérateur) : choisissez un des opérateurs.
  • Value (Valeur) : valeur spécifique du type d’attribut en entrée qui, en cas d’identification, entraînera l’arrêt.
  • Use Local Values (Utiliser les valeurs locales) : calculez les valeurs dans chaque sens par opposition à une valeur globale générale. Par exemple, une interruption de fonction calcule la somme de Shape length dans laquelle le traçage s’arrête si la valeur est supérieure ou égale à 4. Dans le cas de valeurs globales, lorsque vous avez traversé deux tronçons ayant une valeur égale à 2, vous avez atteint une somme Shape length de 4, et le traçage prend fin. Lorsque des valeurs locales sont utilisées, celles-ci changent le long de chaque chemin et le traçage se poursuit.
    • Coché - Les valeurs locales sont utilisées.
    • Décoché - Les valeurs globales sont utilisées. Il s’agit de l’option par défaut.

Les options de la valeur Function (Fonction) de l’interruption de fonction sont les suivantes :

  • Minimum : minimum des valeurs en entrée.
  • Maximum : maximum des valeurs en entrée.
  • Add (Somme) : somme des valeurs en entrée.
  • Average : la moyenne des valeurs en entrée.
  • Count : le nombre d'entités.
  • Substract : la différence entre les valeurs en entrée.

    Les contrôleurs de sous-réseau et les types de traçages de boucles ne prennent pas en charge la fonction de soustraction.

Considérons, par exemple, une entité de point de début dont la valeur est 20. L’entité suivante a une valeur de 30. Si vous utilisez la fonction Minimum, le résultat est de 20, le maximum est de 30, la somme est de 50, la moyenne est de 25, le nombre est de 2, et la différence est de -10.

Les options de la valeur Operator (Opérateur) de l’interruption de fonction sont les suivantes :

  • Est égal à : l’attribut est égal à la valeur.
  • Est différent de : l’attribut est différent de la valeur.
  • Est supérieur à : l’attribut est supérieur à la valeur.
  • Est supérieur ou égal à : l’attribut est supérieur ou égal à la valeur.
  • Est inférieur à : l’attribut est inférieur à la valeur.
  • Est inférieur ou égal à : l’attribut est inférieur ou égal à la valeur.
  • Includes the values (Inclut les valeurs) : opération Et bit à bit dans laquelle tous les bits de la valeur sont présents dans l’attribut (Et bit à bit == valeur).
  • Does not include the values (N’inclut pas les valeurs) : opération Et bit à bit dans laquelle tous les bits de la valeur ne sont pas présents dans l’attribut (Et bit à bit !== valeur).
  • Includes any (Inclut tout) : opération Et bit à bit dans laquelle au moins un bit de la valeur est présent dans l’attribut (Et bit à bit == Vrai).
  • Does not include any (N’inclut aucune valeur) : opération Et bit à bit dans laquelle aucun des bits de la valeur n’est présent dans l’attribut (Et bit à bit == Faux).

Value Table
Appliquer la traversabilité à
(Facultatif)

Spécifie si la traversabilité est appliquée à des jonctions, des tronçons ou les deux. Si, par exemple, une interruption conditionnelle est définie pour arrêter le parcours lorsque le paramètre Device Status (État du périphérique) est réglé sur Open (Ouvert), avec la portée de capacité à être traversé réglée sur les tronçons uniquement, le parcours ne s’interrompt pas même s’il détecte un dispositif ouvert. En effet, l’état du périphérique ne s’applique qu’aux jonctions. En d’autres termes, ce paramètre indique au traçage d’ignorer ou pas : les jonctions, tronçons, ou les deux à la fois.

  • Jonctions et tronçonsLa capacité à être traversé s’applique aux jonctions et aux tronçons. Il s’agit de l’option par défaut.
  • Jonctions uniquementLa capacité à être traversé s’applique uniquement aux jonctions.
  • Tronçons uniquementLa capacité à être traversé s’applique uniquement aux tronçons.
String
Filtrer par interruptions
(Facultatif)

Spécifie si le traçage s’interrompt pour une catégorie spécifique ou un attribut de réseau. Par exemple, arrêtez une recherche de parcours au niveau des entités qui ont un attribut de statut de cycle de vie égal à une valeur certaine. Ce paramètre est utilisé pour définir une entité de terminaison selon une valeur d’un attribut de réseau défini dans le système. Lorsque plusieurs attributs sont utilisés, vous pouvez utiliser l’option Combine Using (Combiner en utilisant) pour définir une condition And (Et) ou une condition Or (Ou).

Les composants du Filtre d'interruption sont les suivants :

  • Name (Nom) : filtrez par catégorie ou par un attribut de réseau défini dans le système.
  • Operator (Opérateur) : choisissez un des opérateurs.
  • Type (Type) : Choisissez une valeur spécifique ou un attribut de réseau depuis la valeur spécifiée dans le paramètre Name (Nom).
  • Value (Valeur)—Fournit une valeur spécifique du type d’attribut en entrée qui entraînerait l’arrêt en fonction de la valeur de l’opérateur.
  • Combiner avec : définissez cette valeur si vous avez plusieurs attributs à ajouter. Vous pouvez combiner ces attributs à l’aide d’une condition Et ou Ou.

Les options de la valeur Operator (Opérateur) des Filtres d'interruption sont les suivantes :

  • Est égal à : l’attribut est égal à la valeur.
  • Est différent de : l’attribut est différent de la valeur.
  • Est supérieur à : l’attribut est supérieur à la valeur.
  • Est supérieur ou égal à : l’attribut est supérieur ou égal à la valeur.
  • Est inférieur à : l’attribut est inférieur à la valeur.
  • Est inférieur ou égal à : l’attribut est inférieur ou égal à la valeur.
  • Includes the values (Inclut les valeurs) : opération Et bit à bit dans laquelle tous les bits de la valeur sont présents dans l’attribut (Et bit à bit == valeur).
  • Does not include the values (N’inclut pas les valeurs) : opération Et bit à bit dans laquelle tous les bits de la valeur ne sont pas présents dans l’attribut (Et bit à bit !== valeur).
  • Includes any (Inclut tout) : opération Et bit à bit dans laquelle au moins un bit de la valeur est présent dans l’attribut (Et bit à bit == Vrai).
  • Does not include any (N’inclut aucune valeur) : opération Et bit à bit dans laquelle aucun des bits de la valeur n’est présent dans l’attribut (Et bit à bit == Faux).

Les options de la valeur Type des Filtres d'interruption sont les suivantes :

  • Valeur spécifique : filtrez en fonction d’une valeur spécifique.
  • Attribut de réseau : filtrez en fonction d’un attribut de réseau.

Value Table
Filtrer par fonctions d’interruption
(Facultatif)

Filtre les résultats du traçage pour une catégorie spécifique.

Les composants du Filtre par fonctions d'interruption sont les suivants :

  • Function (Fonction) : choisissez une des fonctions de calcul.
  • Attribute (Attribut) : filtrez par un attribut de réseau défini dans le système.
  • Operator (Opérateur) : choisissez un des opérateurs.
  • Value (Valeur)—Fournit une valeur spécifique du type d'attribut en entrée qui, si découverte, entraîne l'arrêt.
  • Use Local Values (Utiliser les valeurs locales) : calcule les valeurs dans chaque direction par opposition à une valeur globale. Considérons, par exemple, une interruption de fonction qui calcule la somme de Longueur de forme à laquelle le traçage s’interrompt si la valeur est supérieure ou égale à 4. Dans le cas général, après avoir traversé deux tronçons d’une valeur de 2, vous avez déjà atteint une somme de longueur de forme égale à 4, de sorte que la trace s’arrête. Si les valeurs locales sont utilisées, les valeurs locales le long de chaque chemin changent, ou la trace continue.
    • Coché - Les valeurs locales sont utilisées.
    • Décoché - Les valeurs globales sont utilisées. Il s’agit de l’option par défaut.

Les options de la valeur Function (Fonction) du filtre des interruptions de fonction sont les suivantes :

  • Minimum : minimum des valeurs en entrée.
  • Maximum : maximum des valeurs en entrée.
  • Ajouter : somme des valeurs.
  • Average (Moyenne) : moyenne des valeurs en entrée.
  • Count (Nombre) : nombre d’entités.
  • Soustraire : différence entre les valeurs. Les contrôleurs de sous-réseau et les types de trace de boucle ne permettent pas d'utiliser la fonction de soustraction.

Par exemple, une entité de point de départ a une valeur de 20. L’entité suivante a une valeur de 30. Si vous utilisez la fonction Minimum, le résultat est de 20. Le résultat est de 30 pour Maximum, de 50 pour Add (Ajouter), de 25 pour Average (Moyenne), de 2 pour Count (Nombre) et de -10 pour Substract (Soustraire).

Les options de la valeur Operator (Opérateur) du filtre des interruptions de fonction sont les suivantes :

  • Is equal to (Est égal à) : l’attribut est égal à la valeur.
  • Does not equal (Est différent de) : l’attribut est différent de la valeur.
  • Is greater than (Est supérieur à) : l’attribut est supérieur à la valeur.
  • Is greater than or equal to (Est supérieur ou égal à) : l’attribut est supérieur ou égal à la valeur.
  • Is less than (Est inférieur à) : l’attribut est inférieur à la valeur.
  • Is less than or equal to (Est inférieur ou égal à) : l’attribut est inférieur ou égal à la valeur.
  • Inclut les valeurs : opération Et bit à bit dans laquelle tous les bits de la valeur sont présents dans l’attribut (Et bit à bit == valeur).
  • N’inclut pas les valeurs : opération Et bit à bit dans laquelle tous les bits de la valeur ne sont pas présents dans l’attribut (Et bit à bit !== valeur).
  • Inclut n’importe quelle valeur : opération Et bit à bit dans laquelle au moins un bit de la valeur est présent dans l’attribut (Et bit à bit == Vrai).
  • N’inclut aucune valeur : opération Et bit à bit dans laquelle aucun des bits de la valeur n’est présent dans l’attribut (Et bit à bit == Faux).

Value Table
Appliquer le filtre à
(Facultatif)

Spécifie si le filtre pour une catégorie spécifique est forcé aux jonctions, aux tronçons ou les deux. Si, par exemple, une interruption de filtre est définie pour arrêter la trace lorsque le paramètre Device Status (État du périphérique) est réglé sur Open (Ouvert), avec la portée de capacité à être traversé réglée sur les tronçons uniquement, la trace ne s’interrompt pas même si elle détecte un dispositif ouvert. En effet, l’état du périphérique ne s’applique qu’aux jonctions. En d’autres termes, ce paramètre indique au traçage d’ignorer ou pas : les jonctions, tronçons, ou les deux à la fois.

  • Both junctions and edges (Jonctions et tronçons) : le filtre s’applique aux jonctions et aux tronçons. Il s’agit de l’option par défaut.
  • Junctions only (Jonctions uniquement) : le filtre s’applique uniquement aux jonctions.
  • Edges only (Tronçons uniquement) : le filtre s’applique uniquement aux tronçons.

String
Filtrer en fonction de l’attribut de réseau bitset
(Facultatif)

Nom de l’attribut de réseau à utiliser pour filtrer par bitset. Ce paramètre ne s'applique qu'aux traçages de type en amont, en aval ou boucles. Ce paramètre peut être utilisé pour ajouter une logique spéciale pendant un traçage de telle sorte qu’il reflète davantage les scénarios réels. Par exemple, pour un traçage de boucles, l'attribut de réseau Phases - Courant peut déterminer si la boucle est une véritable boucle électrique (la même phase est énergisée tout autour de la boucle, à savoir, A) et ne renvoie que des boucles électriques réelles pour les résultats du traçage. Exemple d’un traçage en amont : lors du traçage d’un réseau de distribution électrique, précisez un attribut de réseau Phases - Courant, pour que les résultats du traçage n’incluent que les chemins valides spécifiés dans l’attribut de réseau, et pas tous les chemins.

String
Filtrer par proximité
(Facultatif)

Indique si l’algorithme k-nearest neighbors (k voisins les plus proches) est utilisé pour renvoyer plusieurs entités d’un certain type dans une distance donnée. Lorsque ce paramètre est utilisé, vous pouvez préciser un nombre et un coût, ainsi qu’un ensemble de catégories, un type de ressource ou ces deux éléments.

  • Coché : l’algorithme k-nearest neighbors (k voisins les plus proches) est utilisé pour renvoyer un certain nombre d’entités comme indiqué dans les paramètres Count (Nombre), Cost Network Attribute (Attribut de réseau de coût), Nearest Categories (Catégories les plus proches) ou Nearest Asset Groups/Types (Groupes/types d’actifs les plus proches).
  • Non cochée : l’algorithme k-nearest neighbors (k voisins les plus proches) n’est pas utilisé pour filtrer les résultats. Il s’agit de l’option par défaut.

Boolean
Effectif
(Facultatif)

Nombre d’entités à renvoyer lorsque l’option Filter by nearest (Filtrer par proximité) est cochée.

Long
Attribut de réseau de coût
(Facultatif)

Attribut de réseau numérique à utiliser pour calculer la proximité, le coût ou la distance lorsque l’option Filtrer par proximité est cochée (par exemple, Longueur de forme).

String
Catégories les plus proches
(Facultatif)

Catégories à renvoyer lorsque l’option Filtrer par proximité est cochée ; par exemple, Protection.

String
Types/Groupes de ressources les plus proches
(Facultatif)

Groupes d’actifs et types d’actifs à renvoyer lorsque l’option Filter by nearest (Filtrer par proximité) est cochée—par exemple, ElectricDistributionDevice/Transformer/Step Down.

String
Fonctions
(Facultatif)

Fonction(s) de calcul appliquée(s) aux résultats du traçage.

Les composants des fonction sont les suivants :

  • Function (Fonction) : choisissez une des fonctions de calcul.
  • Attribute (Attribut) : filtrez par un attribut de réseau défini dans le système.
  • Filter Name (Nom du filtre) : filtrez les résultats de fonction par nom d’attribut.
  • Filter Operator (Opérateur de filtrage) : choisissez un des opérateurs.
  • Filter Type (Type de filtre) : choisissez un des types de filtre.
  • Filter Value (Valeur de filtrage)—Fournit une valeur spécifique de l’attribut de filtrage en entrée.

Les options de la valeur Fonction sont les suivantes :

  • Minimum : minimum des valeurs en entrée.
  • Maximum : maximum des valeurs en entrée.
  • Add (Somme) : somme des valeurs en entrée.
  • Average (Moyenne) : moyenne des valeurs en entrée.
  • Count (Nombre) : nombre d’entités.
  • Substract (Différence) : différence entre les valeurs en entrée.

    Les contrôleurs de sous-réseau et les types de trace de boucle ne permettent pas d'utiliser la fonction de soustraction.

Par exemple, une entité de point de départ a une valeur de 20. L’entité suivante a une valeur de 30. Si vous utilisez la fonction Minimum, le résultat est de 20, le maximum est de 30, la somme est de 50, la moyenne est de 25, le nombre est de 2, et la différence est de -10.

Les options de valeur de Filter Operator (Opérateur de filtrage) des fonctions sont les suivantes :

  • Is equal to (Est égal à) : l’attribut est égal à la valeur.
  • Does not equal (Est différent de) : l’attribut est différent de la valeur.
  • Is greater than (Est supérieur à) : l’attribut est supérieur à la valeur.
  • Is greater than or equal to (Est supérieur ou égal à) : l’attribut est supérieur ou égal à la valeur.
  • Is less than (Est inférieur à) : l’attribut est inférieur à la valeur.
  • Is less than or equal to (Est inférieur ou égal à) : l’attribut est inférieur ou égal à la valeur.
  • Inclut les valeurs : opération Et bit à bit dans laquelle tous les bits de la valeur sont présents dans l’attribut (Et bit à bit == valeur).
  • Does not include the values (N’inclut pas les valeurs) : opération Et bit à bit dans laquelle tous les bits de la valeur ne sont pas présents dans l’attribut (Et bit à bit !== valeur).
  • Includes any (Inclut tout) : opération Et bit à bit dans laquelle au moins un bit de la valeur est présent dans l’attribut (Et bit à bit == Vrai).
  • Does not include any (N’inclut aucune valeur) : opération Et bit à bit dans laquelle aucun des bits de la valeur n’est présent dans l’attribut (Et bit à bit == Faux).

Les options de valeur de Filter Type (Type de filtrage) des fonctions sont les suivantes :

  • Valeur spécifique : filtrez en fonction d’une valeur spécifique.
  • Attribut de réseau : filtrez en fonction d’un attribut de réseau.

  • MoyenneMoyenne des valeurs en entrée.
  • EffectifNombre d’entités.
  • MaximumMaximum des valeurs en entrée.
  • MinimalMinimum des valeurs en entrée.
  • AjouterLa somme des valeurs.
  • SoustraireLa différence entre les valeurs.Les contrôleurs de sous-réseau et les types de trace de boucle ne permettent pas d'utiliser la fonction de soustraction.
Value Table
Propagateurs
(Facultatif)
  • Est égal àL’attribut est égal à la valeur.
  • Est différent deL’attribut est différent de la valeur.
  • Est supérieur àL’attribut est supérieur à la valeur.
  • Est supérieur ou égal àL’attribut est supérieur ou égal à la valeur.
  • Est inférieur àL’attribut est inférieur à la valeur.
  • Est inférieur ou égal àL’attribut est inférieur ou égal à la valeur.
  • Inclut les valeurs (l’opération Et bit à bit est égale à la valeur)Opération Et bit à bit dans laquelle tous les bits de la valeur sont présents dans l’attribut (Et bit à bit == valeur).
  • N’inclut pas les valeurs (l’opération Et bit à bit n’est pas égale à la valeur)Opération Et bit à bit dans laquelle tous les bits de la valeur ne sont pas présents dans l’attribut (Et bit à bit !== valeur).
  • Inclut tout (l’opération Et bit à bit est égale à Vrai)Opération Et bit à bit dans laquelle au moins un bit de la valeur est présent dans l’attribut (Et bit à bit == Vrai).
  • N’inclut aucune valeur (l’opération Et bit à bit est égale à Faux)Opération Et bit à bit dans laquelle aucun des bits de la valeur n’est présent dans l’attribut (Et bit à bit == Faux).
Value Table
Types de ressources en sortie
(Facultatif)

Filtre les types de ressources en sortie à inclure dans les résultats (par exemple, retourner uniquement les transformateurs aériens).

String
Conditions de sortie
(Facultatif)

Les types des entités renvoyées selon un attribut de réseau ou une catégorie. Par exemple, une trace configurée pour filtrer toutes les entités sauf les entités Dérivation, toute entité tracée à laquelle la catégorie Dérivation n’est pas attribuée, n’est pas incluse dans les résultats. Toute entité tracée qui n’est pas renvoyée dans l’ensemble de sélections résultant.

Les composants des Conditions de sortie sont les suivants :

  • Name (Nom) : filtrez par un attribut de réseau défini dans le système.
  • Operator (Opérateur) : choisissez un des opérateurs.
  • Type (Type) : Choisissez une valeur spécifique ou un attribut de réseau depuis la valeur spécifiée dans le paramètre Name (Nom).
  • Value (Valeur)—Fournit une valeur spécifique du type d’attribut en entrée qui entraînerait l’arrêt en fonction de la valeur de l’opérateur.
  • Combiner avec : définissez cette valeur si vous avez plusieurs attributs à ajouter. Vous pouvez combiner ces attributs à l’aide d’une condition Et ou Ou.

Les options de la valeur Type des Conditions de sortie sont les suivantes :

  • Valeur spécifique : filtrez en fonction d’une valeur spécifique.
  • Attribut de réseau : filtrez en fonction d’un attribut de réseau.

Les options de la valeur Opérateur des Conditions de sortie sont les suivantes :

  • Is equal to (Est égal à) : l’attribut est égal à la valeur.
  • Does not equal (Est différent de) : l’attribut est différent de la valeur.
  • Is greater than (Est supérieur à) : l’attribut est supérieur à la valeur.
  • Est supérieur ou égal à : l’attribut est supérieur ou égal à la valeur.
  • Is less than (Est inférieur à) : l’attribut est inférieur à la valeur.
  • Is less than or equal to (Est inférieur ou égal à) : l’attribut est inférieur ou égal à la valeur.
  • Inclut les valeurs : opération Et bit à bit dans laquelle tous les bits de la valeur sont présents dans l’attribut (Et bit à bit == valeur).
  • N’inclut pas les valeurs : opération Et bit à bit dans laquelle tous les bits de la valeur ne sont pas présents dans l’attribut (Et bit à bit !== valeur).
  • Inclut tout : opération Et bit à bit dans laquelle au moins un bit de la valeur est présent dans l’attribut (Et bit à bit == Vrai).
  • N’inclut aucune valeur : opération Et bit à bit dans laquelle aucun des bits de la valeur n’est présent dans l’attribut (Et bit à bit == Faux).

Value Table
Inclure les entités isolées
(Facultatif)

Indique si les entités isolées sont incluses dans les résultats de traçage. Ce paramètre est utilisé uniquement lors de l’exécution d’un traçage d’isolement.

  • Coché : les entités isolées sont incluses dans les résultats de traçage.
  • Non cochée : les entités isolées ne sont pas incluses dans les résultats de traçage. Il s’agit de l’option par défaut.

Boolean
Ignore Barriers At Starting Points (Ignorer les interruptions aux points de départ)
(Facultatif)

Spécifie si les interruptions dynamiques dans la configuration de trace sont ignorées pour les points de début. Ce paramètre peut être utile lorsque vous effectuez le traçage d’un dispositif de protection en amont et que vous utilisez des périphériques de protection découverts (interruptions) comme points de départ pour rechercher les périphériques de protection en amont suivants.

  • Activé : les interruptions au points de départ sont ignorées dans le traçage.
  • Désactivé : les interruptions au points de départ ne sont pas ignorées dans le traçage. Il s’agit de l’option par défaut.

Boolean
Inclure jusqu’au premier conteneur spatial
(Facultatif)

Indique si les conteneurs retournés seront limités ou non uniquement à ceux rencontrés jusqu’au premier conteneur spatial, et l’incluant, pour chaque élément de réseau dans les résultats de traçage. 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 actif que si l’option Inclure les conteneurs est sélectionnée.

  • Activé : seuls les conteneurs rencontrés jusqu’au premier conteneur spatial, et l’incluant, sont retournés dans les résultats lorsque des associations de contenu imbriquées sont rencontrées le long du chemin de traçage. S’il n’existe aucun conteneur spatial, tous les conteneurs non spatiaux sont inclus dans les résultats d’un élément de réseau donné.
  • Désactivé : tous les conteneurs sont retournés dans les résultats. Il s’agit de l’option par défaut.
Boolean
Type de résultat
(Facultatif)

Spécifie le type de résultat renvoyé par la trace.

  • SélectionLes résultats de la trace sont renvoyés comme un ensemble de sélections des entités de réseau appropriées. Il s’agit de l’option par défaut.
  • Géométrie agrégéeLes résultats de la trace sont agrégés par type de géométrie et stockés dans les classes d’entités multiparties affichées sur les couches de la carte active.
String
Allow Indeterminate Flow (Autoriser le flux indéterminé)
(Facultatif)

Indique si les entités dont le flux est indéterminé sont tracées. Ce paramètre est respecté uniquement lors de l’exécution d’un traçage en amont ou en aval.

  • Activé : les entités dont le flux est indéterminé sont tracées. Il s’agit de l’option par défaut.
  • Désactivé : les entités dont le flux est indéterminé interrompent la traversabilité et ne sont pas tracées.

Boolean
Validate Locatability (Valider la capacité de localisation)
(Facultatif)

Indique si une erreur est renvoyée si une jonction non spatiale ou des objets de tronçon sont rencontrés sans qu’il existe une structure ou un conteneur associé dans la hiérarchie d’association des entités traversées. Cette option garantit que les objets non spatiaux renvoyés par une trace sont associés à des entités spatiales.

  • Activé : la trace renvoie une erreur si une jonction non spatiale ou des objets de tronçon sont rencontrés sans qu’il existe une structure ou un conteneur associé dans la hiérarchie d’association des entités traversées.
  • Désactivé : la trace ne vérifie pas la présence d’objets pouvant être localisés et renvoie des résultats que ce type d’objet soit présent ou non dans la hiérarchie d’associations des entités traversées. Il s’agit de l’option par défaut.

Boolean

Sortie obtenue

ÉtiquetteExplicationType de données
Réseau de distribution en sortie

Réseau de distribution mis à jour.

Utility Network

arcpy.un.AddTraceConfiguration(in_utility_network, trace_config_name, trace_type, {description}, {tags}, {domain_network}, {tier}, {target_tier}, {subnetwork_name}, {shortest_path_network_attribute_name}, {include_containers}, {include_content}, {include_structures}, {include_barriers}, {validate_consistency}, {condition_barriers}, {function_barriers}, {traversability_scope}, {filter_barriers}, {filter_function_barriers}, {filter_scope}, {filter_bitset_network_attribute_name}, {filter_nearest}, {nearest_count}, {nearest_cost_network_attribute}, {nearest_categories}, {nearest_assets}, {functions}, {propagators}, {output_assettypes}, {output_conditions}, {include_isolated_features}, {ignore_barriers_at_starting_points}, {include_up_to_first_spatial_container}, {result_types}, {allow_indeterminate_flow}, {validate_locatability})
NomExplicationType de données
in_utility_network

Réseau technique qui contient la nouvelle configuration de trace nommée.

Utility Network; Utility Network Layer
trace_config_name

Nom de la configuration de trace nommée.

String
trace_type

Spécifie le type de trace à configurer.

  • CONNECTEDUne trace connectée qui commence à un ou plusieurs points de début et s’étend le long des entités connectées est utilisé. Il s’agit de l’option par défaut.
  • SUBNETWORKUn traçage de sous-réseau commençant à un ou plusieurs points de début et s’étendant pour englober le sous-réseau est utilisé.
  • SUBNETWORK_CONTROLLERSUn traçage des contrôleurs de sous-réseaux localisant les sources et les cuvettes des contrôleurs de sous-réseaux associés à un sous-réseau est utilisé.
  • UPSTREAMUn traçage en amont qui découvre les entités en amont depuis un emplacement dans le réseau est utilisé.
  • DOWNSTREAMUn traçage en aval qui découvre les entités en aval depuis un emplacement dans le réseau est utilisé.
  • LOOPSLes boucles sont des zones du réseau où la direction du flux est ambiguë. Un traçage de boucle s’étendant vers l’extérieur depuis le point de départ selon la connectivité est utilisé.
  • SHORTEST_PATHUn traçage du chemin le plus court identifiant le chemin le plus court entre deux points de début est utilisé.
  • ISOLATIONUn traçage d’isolement identifiant les entités qui isolent une surface d’un réseau est utilisé.
String
description
(Facultatif)

Description de la configuration de trace nommée.

String
tags
[tags,...]
(Facultatif)

Ensemble de balises utilisées pour identifier la configuration de trace nommée. Les balises peuvent être utilisées pour la recherche et l’indexation.

String
domain_network
(Facultatif)

Le nom du réseau du domaine sur lequel la trace sera exécutée. Ce paramètre est obligatoire lors de l’exécution du sous-réseau, des contrôleurs de sous-réseaux, des types de traçage en amont et en aval.

String
tier
(Facultatif)

Nom du niveau qui débute le traçage. Ce paramètre est obligatoire lors de l’exécution du sous-réseau, des contrôleurs de sous-réseaux, des types de traçage en amont et en aval.

String
target_tier
(Facultatif)

Le nom du niveau cible vers lequel le niveau en entrée s'écoule. Si ce paramètre est manquant pour les traçages en amont ou en aval, ils s’arrêteront lorsqu’ils atteignent la limite du sous-réseau de départ. Ce paramètre peut être utilisé pour permettre à ces traçages de poursuivre en haut ou en bas de la hiérarchie.

String
subnetwork_name
(Facultatif)

Le nom du sous-réseau où le traçage sera exécutée. Ce paramètre peut être utilisé lors de l’exécution d’un type de traçage de sous-réseau. Si un nom de sous-réseau est indiqué, le paramètre Points de début (paramètre starting_points dans Python) n’est pas requis.

String
shortest_path_network_attribute_name
(Facultatif)

Nom de l’attribut de réseau utilisé pour calculer le chemin le plus court. Lors de l’exécution d’un type de traçage du chemin le plus court, ce chemin est calculé à l’aide d’un attribut de réseau numérique comme la longueur de forme. Les chemins basés sur le coût et la distance peuvent être atteints. Ce paramètre est requis lors de l’exécution d’un traçage de chemin de type Court.

String
include_containers
(Facultatif)

Indique si les entités de conteneur sont incluses dans les résultats de traçage.

  • INCLUDE_CONTAINERSLes entités de conteneur sont incluses dans les résultats de traçage.
  • EXCLUDE_CONTAINERSLes entités de conteneur ne sont pas incluses dans les résultats de traçage. Il s’agit de l’option par défaut.
Boolean
include_content
(Facultatif)

Indique si le traçage renvoie le contenu dans les conteneurs, avec les résultats.

  • INCLUDE_CONTENTLe contenu des entités de conteneur est inclus dans les résultats de traçage.
  • EXCLUDE_CONTENTLe contenu des entités de conteneur n’est pas inclus dans les résultats de traçage. Il s’agit de l’option par défaut.
Boolean
include_structures
(Facultatif)

Indique si les objets et les entités de structure sont inclus dans les résultats de traçage.

  • INCLUDE_STRUCTURESLes objets et les entités de structure sont inclus dans les résultats de traçage.
  • EXCLUDE_STRUCTURESLes objets et les entités de structure ne sont pas inclus dans les résultats de traçage. Il s’agit de l’option par défaut.
Boolean
include_barriers
(Facultatif)

Indique si les entités d’interruption de capacité à être traversé sont incluses dans les résultats de la trace. Les interruptions de traversabilité sont facultatives même si elles ont été prédéfinies dans la définition de sous-réseau. Ce paramètre ne s’applique pas aux entités de dispositif avec des bornes.

  • INCLUDE_BARRIERSLes entités d’interruption de capacité à être traversé sont incluses dans les résultats de traçage. Il s’agit de l’option par défaut.
  • EXCLUDE_BARRIERSLes entités d’interruption de capacité à être traversé ne sont pas incluses dans les résultats de traçage.
Boolean
validate_consistency
(Facultatif)

Indique si une erreur est retournée lorsqu’une zone à valider figure dans les entités traversées. C’est la seule façon de garantir qu’un traçage passe via des entités avec un statut cohérent dans le réseau. Pour supprimer les zones à valider, validez la topologie de réseau.

  • VALIDATE_CONSISTENCYLe parcours retourne une erreur si une zone à valider figure dans les entités traversées. Il s’agit de l’option par défaut.
  • DO_NOT_VALIDATE_CONSISTENCYLe parcours retourne des résultats qu’une zone à valider figure ou non dans les entités traversées.
Boolean
condition_barriers
[[Name, Operator, Type, Value, Combine Using],...]
(Facultatif)

Définit une interruption conditionnelle de traversabilité sur les entités en fonction d’une comparaison avec un attribut de réseau ou vérifie une chaîne de catégorie. Une interruption conditionnelle utilise un attribut de réseau, un opérateur et un type, ainsi qu’une valeur attributaire. Par exemple, arrêtez un traçage lorsque l’attribut Device Status d’une entité est égal à la valeur spécifique de Open. Lorsqu’une entité remplit ces conditions, le traçage s’arrête. En cas d’utilisation de plusieurs attributs, vous pouvez définir une condition Et ou une condition Ou à l’aide du paramètre Combine using (Combiner en utilisant).

Les composants de l'interruption conditionnelle sont les suivants :

  • Name : filtrez par n’importe quel attribut de réseau défini dans le système.
  • Operator : choisissez un des opérateurs.
  • Type : choisissez une valeur spécifique ou un attribut de réseau depuis la valeur spécifiée dans le paramètre name..
  • Value : indiquez la valeur spécifique du type d’attribut en entrée qui entraînerait l’arrêt en fonction de la valeur de l’opérateur.
  • Combine Using : définissez cette valeur si vous avez plusieurs attributs à ajouter. Vous pouvez combiner ces attributs à l’aide d’une condition Et ou Ou.

Les options des valeurs operator d’interruptions conditionnelles sont les suivantes :

  • IS_EQUAL_TOL’attribut est égal à la valeur.
  • DOES_NOT_EQUALL’attribut est différent de la valeur.
  • IS_GREATER_THANL’attribut est supérieur à la valeur.
  • IS_GREATER_THAN_OR_EQUAL_TOL’attribut est supérieur ou égal à la valeur.
  • IS_LESS_THANL’attribut est inférieur à la valeur.
  • IS_LESS_THAN_OR_EQUAL_TOL’attribut est inférieur ou égal à la valeur.
  • INCLUDES_THE_VALUESOpération Et bit à bit dans laquelle tous les bits de la valeur sont présents dans l’attribut (Et bit à bit == valeur).
  • DOES_NOT_INCLUDE_THE_VALUESOpération Et bit à bit dans laquelle tous les bits de la valeur ne sont pas présents dans l’attribut (Et bit à bit !== valeur).
  • INCLUDES_ANYOpération Et bit à bit dans laquelle au moins un bit de la valeur est présent dans l’attribut (Et bit à bit == Vrai).
  • DOES_NOT_INCLUDE_ANYOpération Et bit à bit dans laquelle aucun des bits de la valeur n’est présent dans l’attribut (Et bit à bit == Faux).

En savoir plus sur les opérateurs bit à bit

Les options des valeurs Type d’interruptions conditionnelles sont les suivantes :

  • SPECIFIC_VALUEFiltrez en fonction d’une valeur spécifique.
  • NETWORK_ATTRIBUTEFiltrez en fonction d’un attribut de réseau.

Les options des valeurs Combine Using d’interruptions conditionnelles sont les suivantes :

  • ANDCombinez les interruptions conditionnelles.
  • ORUtilisez ce paramètre si l’une des interruptions conditionnelles est satisfaite.

En savoir plus sur l’utilisation de plusieurs expressions conditionnelles

Value Table
function_barriers
[[Function, Attribute, Operator, Value, Use Local Values],...]
(Facultatif)

Définit l’interruption de traversabilité sur les entités en fonction d’une fonction. Les interruptions fonctionnelles peuvent être utilisées pour effectuer des actions comme limiter la distance que le traçage peut parcourir depuis le point de départ, ou définir une valeur maximale à laquelle arrêter un traçage. Par exemple, la longueur de chaque ligne parcourue est ajoutée à la distance totale parcourue jusqu’ici. Lorsque la distance totale parcourue atteint la valeur spécifiée, le traçage s’arrête.

Les composants de l'interruption fonctionnelle sont les suivants :

  • Function : choisissez une des fonctions de calcul.
  • Attribute : filtrez par n’importe quel attribut de réseau défini dans le système.
  • Operator : choisissez un des opérateurs.
  • Value : fournit une valeur spécifique du type d’attribut en entrée qui, si découverte, entraîne l’arrêt.
  • Use Local Values : calcule les valeurs dans chaque direction, par opposition à une valeur globale générale. Considérons, par exemple, une interruption de fonction qui calcule la somme de Longueur de forme à laquelle le traçage s’interrompt si la valeur est supérieure ou égale à 4. Dans le cas général, après avoir traversé deux tronçons d’une valeur de 2, vous avez déjà atteint une somme de longueur de forme égale à 4, de sorte que la trace s’arrête. Si les valeurs locales sont utilisées, les valeurs locales le long de chaque chemin changent, et la trace continue.

Les valeurs des options function d’interruptions de fonctions sont les suivantes :

  • AVERAGEMoyenne des valeurs en entrée.
  • COUNTNombre d’entités.
  • MAXMaximum des valeurs en entrée.
  • MINMinimum des valeurs en entrée.
  • ADDLa somme des valeurs.
  • SUBTRACTLa différence entre les valeurs. Les contrôleurs de sous-réseau et les types de trace de boucle ne permettent pas d'utiliser la fonction de soustraction.

Les valeurs des options operator d’interruptions de fonctions sont les suivantes :

  • IS_EQUAL_TOLe résultat de la fonction est égal à la valeur.
  • DOES_NOT_EQUALLe résultat de la fonction est différent de la valeur.
  • IS_GREATER_THANLe résultat de la fonction est supérieur à la valeur.
  • IS_GREATER_THAN_OR_EQUAL_TOLe résultat de la fonction est supérieur ou égal à la valeur.
  • IS_LESS_THANLe résultat de la fonction est inférieur à la valeur.
  • IS_LESS_THAN_OR_EQUAL_TOLe résultat de la fonction est inférieur ou égal à la valeur.
  • INCLUDES_THE_VALUESOpération Et bit à bit dans laquelle tous les bits de la valeur sont présents dans l’attribut (Et bit à bit == valeur).
  • DOES_NOT_INCLUDE_THE_VALUESOpération Et bit à bit dans laquelle tous les bits de la valeur ne sont pas présents dans l’attribut (Et bit à bit !== valeur).
  • INCLUDES_ANYOpération Et bit à bit dans laquelle au moins un bit de la valeur est présent dans l’attribut (Et bit à bit == Vrai).
  • DOES_NOT_INCLUDE_ANYOpération Et bit à bit dans laquelle aucun des bits de la valeur n’est présent dans l’attribut (Et bit à bit == Faux).

En savoir plus sur les opérateurs bit à bit

Les options d’interruption de fonctions de Use Local Values sont les suivantes :

  • TRUELes valeurs locales sont utilisées.
  • FALSELes valeurs globales sont utilisées. Il s’agit de l’option par défaut.
Value Table
traversability_scope
(Facultatif)

Spécifie si la traversabilité est appliquée à des jonctions, des tronçons ou les deux. Si, par exemple, une interruption conditionnelle est définie pour arrêter le parcours lorsque le paramètre Device Status (État du périphérique) est réglé sur Open (Ouvert), avec la portée de capacité à être traversé réglée sur les tronçons uniquement, le parcours ne s’interrompt pas même s’il détecte un dispositif ouvert. En effet, l’état du périphérique ne s’applique qu’aux jonctions. En d’autres termes, ce paramètre indique au traçage d’ignorer ou pas : les jonctions, tronçons, ou les deux à la fois.

  • BOTH_JUNCTIONS_AND_EDGESLa capacité à être traversé s’applique aux jonctions et aux tronçons. Il s’agit de l’option par défaut.
  • JUNCTIONS_ONLYLa capacité à être traversé s’applique uniquement aux jonctions.
  • EDGES_ONLYLa capacité à être traversé s’applique uniquement aux tronçons.
String
filter_barriers
[[Name, Operator, Type, Value, Combine Using],...]
(Facultatif)

Spécifie si un traçage s’interrompt pour une catégorie spécifique ou un attribut de réseau. Par exemple, arrêtez une recherche de parcours au niveau des entités qui ont un attribut de statut de cycle de vie égal à une valeur certaine. Ce paramètre est utilisé pour définir une entité de terminaison selon une valeur d’un attribut de réseau défini dans le système. Si vous utilisez plusieurs attributs, vous pouvez utiliser l’option Combine Using pour définir une condition Et ou Ou.

Les composants du Filtre d'interruption sont les suivants :

  • Name : filtrez par catégorie ou par attribut de réseau défini dans le système.
  • Operator : choisissez un des opérateurs.
  • Type : choisissez une valeur spécifique ou un attribut de réseau depuis la valeur spécifiée dans le paramètre name.
  • Value : fournit une valeur spécifique du type d’attribut en entrée qui entraînerait l’arrêt en fonction de la valeur de l’opérateur.
  • Combine Using : définissez cette valeur si vous avez plusieurs attributs à ajouter. Vous pouvez combiner ces attributs à l’aide d’une condition Et ou Ou.

Les options des valeurs operator des filtres par interruptions sont les suivantes :

  • IS_EQUAL_TOL’attribut est égal à la valeur.
  • DOES_NOT_EQUALL’attribut est différent de la valeur.
  • IS_GREATER_THANL’attribut est supérieur à la valeur.
  • IS_GREATER_THAN_OR_EQUAL_TOL’attribut est supérieur ou égal à la valeur.
  • IS_LESS_THANL’attribut est inférieur à la valeur.
  • IS_LESS_THAN_OR_EQUAL_TOL’attribut est inférieur ou égal à la valeur.
  • INCLUDES_THE_VALUESOpération Et bit à bit dans laquelle tous les bits de la valeur sont présents dans l’attribut (Et bit à bit == valeur).
  • DOES NOT INCLUDE_THE_VALUESOpération Et bit à bit dans laquelle tous les bits de la valeur ne sont pas présents dans l’attribut (Et bit à bit !== valeur).
  • INCLUDES_ANYOpération Et bit à bit dans laquelle au moins un bit de la valeur est présent dans l’attribut (Et bit à bit == Vrai).
  • DOES_NOT_INLCUDE_ANYOpération Et bit à bit dans laquelle aucun des bits de la valeur n’est présent dans l’attribut (Et bit à bit == Faux).

En savoir plus sur les opérateurs bit à bit

Les options des valeurs Type des filtres par interruptions sont les suivantes :

  • SPECIFIC_VALUEFiltrez en fonction d’une valeur spécifique.
  • NETWORK_ATTRIBUTEFiltrez en fonction d’un attribut de réseau.

Les options des valeurs Combine Using des filtres par interruptions sont les suivantes :

  • ANDCombinez les interruptions conditionnelles.
  • ORUtilisez ce paramètre si l’une des interruptions conditionnelles est satisfaite.

En savoir plus sur l’utilisation de plusieurs expressions conditionnelles

Value Table
filter_function_barriers
[[Function, Attribute, Operator, Value, Use Local Values],...]
(Facultatif)

Filtre les résultats du traçage pour une catégorie spécifique.

Les composants du Filtre par fonctions d'interruption sont les suivants :

  • Function : choisissez une des fonctions de calcul.
  • Attribute : filtrez par n’importe quel attribut de réseau défini dans le système.
  • Operator : choisissez un des opérateurs.
  • Value : fournit une valeur spécifique du type d’attribut en entrée qui, si découverte, entraîne l’arrêt.
  • Use Local Values : calcule les valeurs dans chaque direction, par opposition à une valeur globale générale. Par exemple, pour une interruption de fonction calculant la somme de Longueur de forme dans laquelle le traçage s’interrompt si la valeur est supérieure ou égale à 4. Dans le cas général, après avoir traversé deux tronçons d’une valeur de 2, vous avez déjà atteint une somme de longueur de forme égale à 4, de sorte que la trace s’arrête. Si les valeurs locales sont utilisées, les valeurs locales le long de chaque chemin changent, ou la trace continue.

Les options de la valeur function du filtre des interruptions de fonction sont les suivantes :

  • AVERAGEMoyenne des valeurs en entrée.
  • COUNTNombre d’entités.
  • MAXMaximum des valeurs en entrée.
  • MINMinimum des valeurs en entrée.
  • ADDLa somme des valeurs.
  • SUBTRACTLa différence entre les valeurs. Les contrôleurs de sous-réseau et les types de trace de boucle ne permettent pas d'utiliser la fonction de soustraction.

Les options de la valeur operator du filtre des interruptions de fonction sont les suivantes :

  • IS_EQUAL_TOL’attribut est égal à la valeur.
  • DOES_NOT_EQUALL’attribut est différent de la valeur.
  • IS_GREATER_THANL’attribut est supérieur à la valeur.
  • IS_GREATER_THAN_OR_EQUAL_TOL’attribut est supérieur ou égal à la valeur.
  • IS_LESS_THANL’attribut est inférieur à la valeur.
  • IS_LESS_THAN_OR_EQUAL_TOL’attribut est inférieur ou égal à la valeur.
  • INCLUDES_THE_VALUESOpération Et bit à bit dans laquelle tous les bits de la valeur sont présents dans l’attribut (Et bit à bit == valeur).
  • DOES_NOT_INCLUDE_THE_VALUESOpération Et bit à bit dans laquelle tous les bits de la valeur ne sont pas présents dans l’attribut (Et bit à bit !== valeur).
  • INCLUDES_ANYOpération Et bit à bit dans laquelle au moins un bit de la valeur est présent dans l’attribut (Et bit à bit == Vrai).
  • DOES_NOT_INCLUDE_ANYOpération Et bit à bit dans laquelle aucun des bits de la valeur n’est présent dans l’attribut (Et bit à bit == Faux).

En savoir plus sur les opérateurs bit à bit

Les options d’interruption de fonctions de Use Local Values sont les suivantes :

  • TRUELes valeurs locales sont utilisées.
  • FALSELes valeurs globales sont utilisées. Il s’agit de l’option par défaut.
Value Table
filter_scope
(Facultatif)

Spécifie si le filtre pour une catégorie spécifique est forcé aux jonctions, aux tronçons ou les deux. Si, par exemple, une interruption de filtre est définie pour arrêter la trace lorsque le paramètre Device Status (État du périphérique) est réglé sur Open (Ouvert), avec la portée de capacité à être traversé réglée sur les tronçons uniquement, la trace ne s’interrompt pas même si elle détecte un dispositif ouvert. En effet, l’état du périphérique ne s’applique qu’aux jonctions. En d’autres termes, ce paramètre indique au traçage d’ignorer ou pas : les jonctions, tronçons, ou les deux à la fois.

  • BOTH_JUNCTIONS_AND_EDGESLe filtre s’applique aux jonctions et aux tronçons. Il s’agit de l’option par défaut.
  • JUNCTIONS_ONLYLe filtre s’applique uniquement aux jonctions.
  • EDGES_ONLYLe filtre s’applique uniquement aux tronçons.
String
filter_bitset_network_attribute_name
(Facultatif)

Nom de l’attribut de réseau à utiliser pour filtrer par bitset. Ce paramètre ne s'applique qu'aux traçages de type en amont, en aval ou boucles. Ce paramètre peut être utilisé pour ajouter une logique spéciale pendant un traçage de telle sorte qu’il reflète davantage les scénarios réels. Par exemple, pour un traçage de boucles, l'attribut de réseau Phases - Courant peut déterminer si la boucle est une véritable boucle électrique (la même phase est énergisée tout autour de la boucle, à savoir, A) et ne renvoie que des boucles électriques réelles pour les résultats du traçage. Exemple d’un traçage en amont : lors du traçage d’un réseau de distribution électrique, précisez un attribut de réseau Phases - Courant, pour que les résultats du traçage n’incluent que les chemins valides spécifiés dans l’attribut de réseau, et pas tous les chemins.

String
filter_nearest
(Facultatif)

Indique si l’algorithme k-nearest neighbors (k voisins les plus proches) est utilisé pour renvoyer plusieurs entités d’un certain type dans une distance donnée. Lorsque ce paramètre est utilisé, vous pouvez préciser un nombre et un coût, ainsi qu’un ensemble de catégories, un type de ressource ou ces deux éléments.

  • FILTER_BY_NEARESTL’algorithme k voisins les plus proches est utilisé pour renvoyer un certain nombre d’entités comme spécifié dans les paramètres nearest_count, nearest_cost_network_attribute, nearest_categories ou nearest_assets.
  • DO_NOT_FILTERL’algorithme k-nearest neighbors (k voisins les plus proches) n’est pas utilisé pour filtrer les résultats. Il s’agit de l’option par défaut.
Boolean
nearest_count
(Facultatif)

Nombre d’entités à renvoyer lorsque filter_nearest a pour valeur FILTER_BY_NEAREST.

Long
nearest_cost_network_attribute
(Facultatif)

Attribut de réseau numérique à utiliser pour calculer la proximité, le coût ou la distance lorsque filter_nearest est FILTER_BY_NEAREST (par exemple, Longueur de forme).

String
nearest_categories
[nearest_categories,...]
(Facultatif)

Catégories à renvoyer lorsque filter_nearest est FILTER_BY_NEAREST ; par exemple, Protection.

String
nearest_assets
[nearest_assets,...]
(Facultatif)

Groupes d’actifs et types d’actifs à renvoyer lorsque filter_nearest est FILTER_BY_NEAREST (par exemple, ElectricDistributionDevice/Transformer/Step Down).

String
functions
[[Function, Attribute, Filter Name, Filter Operator, Filter Type, Filter Value],...]
(Facultatif)

Applique une fonction de calcul aux résultats de la trace.

Les composants des fonction sont les suivants :

  • Function : choisissez une des fonctions de calcul.
  • Attribute : filtrez par n’importe quel attribut de réseau défini dans le système.
  • Filter Name : filtrez les résultats de fonction par nom d’attribut.
  • Filter Operator : choisissez un des opérateurs.
  • Filter Type : choisissez un nombre de types de filtre.
  • Filter Value : fournit une valeur spécifique de l’attribut de filtrage en entrée.

Les options de la valeur Function des fonctions sont les suivantes :

  • AVERAGEMoyenne des valeurs en entrée.
  • COUNTNombre d’entités.
  • MAXMaximum des valeurs en entrée.
  • MINMinimum des valeurs en entrée.
  • ADDLa somme des valeurs.
  • SUBTRACTLa différence entre les valeurs.Les contrôleurs de sous-réseau et les types de trace de boucle ne permettent pas d'utiliser la fonction de soustraction.

Par exemple, une entité de point de départ a une valeur de 20. L’entité suivante a une valeur de 30. Si vous utilisez la fonction MINIMUM, le résultat est 20, avec MAXIMUM, 30, avec ADD, 50, avec AVERAGE, 25, avec COUNT, 2 et avec SUBTRACT, -10.

Les options de la valeur Filter Operator sont les suivantes :

  • IS_EQUAL_TOL’attribut est égal à la valeur.
  • DOES_NOT_EQUALL’attribut est différent de la valeur.
  • IS_GREATER_THANL’attribut est supérieur à la valeur.
  • IS_GREATER_THAN_OR_EQUAL_TOL’attribut est supérieur ou égal à la valeur.
  • IS_LESS_THANL’attribut est inférieur à la valeur.
  • IS_LESS_THAN_OR_EQUAL_TOL’attribut est inférieur ou égal à la valeur.
  • INCLUDES_THE_VALUESOpération Et bit à bit dans laquelle tous les bits de la valeur sont présents dans l’attribut (Et bit à bit == valeur).
  • DOES_NOT_INCLUDE_THE_VALUESOpération Et bit à bit dans laquelle tous les bits de la valeur ne sont pas présents dans l’attribut (Et bit à bit !== valeur).
  • INCLUDES_ANYOpération Et bit à bit dans laquelle au moins un bit de la valeur est présent dans l’attribut (Et bit à bit == Vrai).
  • DOES_NOT_INCLUDE_ANYOpération Et bit à bit dans laquelle aucun des bits de la valeur n’est présent dans l’attribut (Et bit à bit == Faux).

En savoir plus sur les opérateurs bit à bit

Les options de la valeur Filter Type des fonctions sont les suivantes :

  • SPECIFIC_VALUEFiltrez en fonction d’une valeur spécifique.
  • NETWORK_ATTRIBUTEFiltrez en fonction d’un attribut de réseau.
Value Table
propagators
[[Attribute, Substitution Attribute, Function, Operator, Value],...]
(Facultatif)

Spécifie les attributs de réseau à propager ainsi que la façon dont cette propagation devra être effectuée pendant un traçage. Les attributs de classe propagés désignent les valeurs clés sur les contrôleurs de sous-réseau qui sont distribuées au reste des entités dans le sous-réseau. Par exemple, dans un modèle de distribution électrique, vous pouvez propager la valeur de phase.

Les composants de propagateurs sont les suivants :

  • Attribute : filtrez par un attribut de réseau défini dans le système.
  • Substitution Attribute : utilisez une valeur substituée au lieu de valeurs attributaires de réseau bitset. Les substitutions sont encodées selon le nombre de bits dans l'attribut de réseau en cours de propagation. Une substitution est un appariement de chaque bit en phase avec un autre bit. Par exemple, pour la phase AC, une substitution peut apparier le bit A au bit B et le bit C à la valeur nulle. Dans cet exemple, la substitution pour 1010 (Phase AC) est 0000-0010-0000-0000 (512). La substitution capture l’appariement ; vous savez ainsi que la phase A est appariée à B et que la phase C est appariée à la valeur nulle et non l’inverse (c’est-à-dire que la phase A n’est pas appariée à la valeur nulle et la phase C n’est pas appariée à B).
  • Function : choisissez une des fonctions de calcul.
  • Operator : choisissez un des opérateurs.
  • Value : indiquez la valeur spécifique du type d’attribut en entrée qui entraînerait l’arrêt en fonction de la valeur de l’opérateur.

Les options de la valeur function des propagateurs sont les suivantes :

  • PROPAGATED_BITWISE_ANDComparez les valeurs entre une entité et la suivante.
  • PROPAGATED_MINObtenez la valeur minimale.
  • PROPAGATED_MAXObtenez la valeur maximale.

Les options de la valeur operator des propagateurs sont les suivantes :

  • IS_EQUAL_TOL’attribut est égal à la valeur.
  • DOES_NOT_EQUALL’attribut est différent de la valeur.
  • IS_GREATER_THANL’attribut est supérieur à la valeur.
  • IS_GREATER_THAN_OR_EQUAL_TOL’attribut est supérieur ou égal à la valeur.
  • IS_LESS_THANL’attribut est inférieur à la valeur.
  • IS_LESS_THAN_OR_EQUAL_TOL’attribut est inférieur ou égal à la valeur.
  • INCLUDES_THE_VALUESOpération Et bit à bit dans laquelle tous les bits de la valeur sont présents dans l’attribut (Et bit à bit == valeur).
  • DOES_NOT_INCLUDE_THE_VALUESOpération Et bit à bit dans laquelle tous les bits de la valeur ne sont pas présents dans l’attribut (Et bit à bit !== valeur).
  • INCLUDES_ANYOpération Et bit à bit dans laquelle au moins un bit de la valeur est présent dans l’attribut (Et bit à bit == Vrai).
  • DOES_NOT_INCLUDE_ANYOpération Et bit à bit dans laquelle aucun des bits de la valeur n’est présent dans l’attribut (Et bit à bit == Faux).

En savoir plus sur les opérateurs bit à bit

Remarque :

Ce paramètre est uniquement disponible via Python.

Value Table
output_assettypes
[output_assettypes,...]
(Facultatif)

Filtre les types de ressources en sortie à inclure dans les résultats (par exemple, retourner uniquement les transformateurs aériens).

String
output_conditions
[[Name, Operator, Type, Value, Combine Using],...]
(Facultatif)

Les types des entités renvoyées selon un attribut de réseau ou une catégorie. Par exemple, une trace configurée pour filtrer toutes les entités sauf les entités Dérivation, toute entité tracée à laquelle la catégorie Dérivation n’est pas attribuée, n’est pas incluse dans les résultats. Toute entité tracée qui n’est pas renvoyée dans l’ensemble de sélections résultant. Si vous utilisez plusieurs attributs, vous pouvez utiliser l’option Combine Using pour définir une condition Et ou Ou.

Les composants des Conditions de sortie sont les suivants :

  • Name : filtrez par n’importe quel attribut de réseau défini dans le système.
  • Operator : choisissez un des opérateurs.
  • Type : choisissez une valeur spécifique ou un attribut de réseau depuis la valeur spécifiée dans le paramètre name.
  • Value : fournit une valeur spécifique du type d’attribut en entrée qui entraînerait l’arrêt en fonction de la valeur de l’opérateur.
  • Combine Using : définissez cette valeur si vous avez plusieurs attributs à ajouter. Vous pouvez combiner ces attributs à l’aide d’une condition Et ou Ou.

Les options de la valeur operator sont les suivantes :

  • IS_EQUAL_TOL’attribut est égal à la valeur.
  • DOES_NOT_EQUALL’attribut est différent de la valeur.
  • IS_GREATER_THANL’attribut est supérieur à la valeur.
  • IS_GREATER_THAN_OR_EQUAL_TOL’attribut est supérieur ou égal à la valeur.
  • IS_LESS_THANL’attribut est inférieur à la valeur.
  • IS_LESS_THAN_OR_EQUAL_TOL’attribut est inférieur ou égal à la valeur.
  • INCLUDES_THE_VALUESOpération Et bit à bit dans laquelle tous les bits de la valeur sont présents dans l’attribut (Et bit à bit == valeur).
  • DOES_NOT_INCLUDE_THE_VALUESOpération Et bit à bit dans laquelle tous les bits de la valeur ne sont pas présents dans l’attribut (Et bit à bit !== valeur).
  • INCLUDES_ANYOpération Et bit à bit dans laquelle au moins un bit de la valeur est présent dans l’attribut (Et bit à bit == Vrai).
  • DOES_NOT_INCLUDE_ANYOpération Et bit à bit dans laquelle aucun des bits de la valeur n’est présent dans l’attribut (Et bit à bit == Faux).

En savoir plus sur les opérateurs bit à bit

Les options de la valeur Type des conditions de sortie sont les suivantes :

  • SPECIFIC_VALUEFiltrez en fonction d’une valeur spécifique.
  • NETWORK_ATTRIBUTEFiltrez en fonction d’un attribut de réseau.

Les options de la valeur Combine Using sont les suivantes :

  • ANDCombinez les conditions.
  • ORUtilisez ce paramètre si l’une des conditions est satisfaite.

En savoir plus sur l’utilisation de plusieurs expressions conditionnelles

Value Table
include_isolated_features
(Facultatif)

Indique si les entités isolées sont incluses dans les résultats de traçage. Ce paramètre est utilisé uniquement lors de l’exécution d’un traçage d’isolement.

  • INCLUDE_ISOLATED_FEATURESLes entités isolées sont incluses dans les résultats de traçage.
  • EXCLUDE_ISOLATED_FEATURESLes entités isolées ne sont pas incluses dans les résultats de traçage. Il s’agit de l’option par défaut.
Remarque :

Ce type de traçage d’isolement requiert ArcGIS Enterprise 10.7 ou version ultérieure si vous utilisez une géodatabase d’entreprise.

Boolean
ignore_barriers_at_starting_points
(Facultatif)

Spécifie si les interruptions dynamiques dans la configuration de trace sont ignorées pour les points de début. Ce paramètre peut être utile lorsque vous effectuez le traçage d’un dispositif de protection en amont et que vous utilisez des périphériques de protection découverts (interruptions) comme points de départ pour rechercher les périphériques de protection en amont suivants.

  • IGNORE_BARRIERS_AT_STARTING_POINTSLes interruptions au points de départ sont ignorées dans le traçage.
  • DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTSLes interruptions au points de départ ne sont pas ignorées dans le traçage. Il s’agit de l’option par défaut.
Boolean
include_up_to_first_spatial_container
(Facultatif)

Indique si les conteneurs retournés seront limités ou non uniquement à ceux rencontrés jusqu’au premier conteneur spatial, et l’incluant, pour chaque élément de réseau dans les résultats de traçage. 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 activé que si Include Containers est INCLUDE_CONTAINERS.

  • INCLUDE_UP_TO_FIRST_SPATIAL_CONTAINERSeuls les conteneurs rencontrés jusqu’au premier conteneur spatial, et l’incluant, figurent dans les résultats lorsque des associations de contenu imbriquées sont rencontrées le long du chemin de traçage. S’il n’existe aucun conteneur spatial, tous les conteneurs non spatiaux sont inclus dans les résultats d’un élément de réseau donné.
  • DO_NOT_INCLUDE_UP_TO_FIRST_SPATIAL_CONTAINERTous les conteneurs sont retournés dans les résultats. Il s’agit de l’option par défaut.
Boolean
result_types
[result_types,...]
(Facultatif)

Spécifie le type de résultat renvoyé par la trace.

  • SELECTIONLes résultats de la trace sont renvoyés comme un ensemble de sélections des entités de réseau appropriées. Il s’agit de l’option par défaut.
  • AGGREGATED_GEOMETRYLes résultats de la trace sont agrégés par type de géométrie et stockés dans les classes d’entités multiparties affichées sur les couches de la carte active.
String
allow_indeterminate_flow
(Facultatif)

Indique si les entités dont le flux est indéterminé sont tracées. Ce paramètre est respecté uniquement lors de l’exécution d’un traçage en amont ou en aval.

  • TRACE_INDETERMINATE_FLOWLes entités dont le flux est indéterminé sont tracées. Il s’agit de l’option par défaut.
  • IGNORE_INDETERMINATE_FLOWLes entités dont le flux est indéterminé interrompent la traversabilité et ne sont pas tracées.
Boolean
validate_locatability
(Facultatif)

Indique si une erreur est renvoyée si une jonction non spatiale ou des objets de tronçon sont rencontrés sans qu’il existe une structure ou un conteneur associé dans la hiérarchie d’association des entités traversées. Cette option garantit que les objets non spatiaux renvoyés par une trace sont associés à des entités spatiales.

  • VALIDATE_LOCATABILITYLa trace renvoie une erreur si une jonction non spatiale ou des objets de tronçon sont rencontrés sans qu’il existe une structure ou un conteneur associé dans la hiérarchie d’association des entités traversées.
  • DO_NOT_VALIDATE_LOCATABILITYLa trace ne vérifie pas la présence d’objets pouvant être localisés et renvoie des résultats que ce type d’objet soit présent ou non dans la hiérarchie d’associations des entités traversées. Il s’agit de l’option par défaut.
Boolean

Sortie obtenue

NomExplicationType de données
out_utility_network

Réseau de distribution mis à jour.

Utility Network

Exemple de code

Exemple d’utilisation de l’outil AddTraceConfiguration (fenêtre Python)

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction AddTraceConfiguration.

import arcpy
arcpy.AddTraceConfiguration_un(
        r"SampleUNService\Elec Utility Network", "Upstream_RMT002", "UPSTREAM", 
        "Upstream trace on RMT002", "Upstream;RMT002", "ElectricDistribution", 
        "Medium Voltage", '', '', '', "EXCLUDE_CONTAINERS", "EXCLUDE_CONTENT", 
        "EXCLUDE_STRUCTURES", "INCLUDE_BARRIERS", "VALIDATE_CONSISTENCY", None, 
        None, "BOTH_JUNCTIONS_AND_EDGES", None, None, "BOTH_JUNCTIONS_AND_EDGES", 
        '', "DO_NOT_FILTER", None, '', None, None, None, None, None, None, 
        "EXCLUDE_ISOLATED_FEATURES", "DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTS", 
        "DO_NOT_INCLUDE_UP_TO_FIRST_SPATIAL_CONTAINER", None, 
        "TRACE_INDETERMINATE_FLOW", "DO_NOT_VALIDATE_LOCATABILITY")

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence

  • Basic: Non
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes