Ajouter une règle de traçage (Outils des diagrammes de réseau)

Résumé

Ajoute une règle de diagramme à la séquence de règles spécifiée dans un modèle de diagramme pour exécuter automatiquement un traçage sur un réseau de distribution ou un réseau de traces lors de la génération du diagramme. Les entités de réseau et les objets réseau tracés qui en résultent sont utilisés pour créer le contenu des diagrammes.

Pour en savoir plus sur l’utilisation de la règle de traçage en vue de construire des diagrammes

Attention :

Cet outil est un outil de configuration et d’administration.

Remarque :

Cet outil impacte la cohérence des diagrammes existants basés sur le modèle de diagramme en entrée. Tous les diagrammes existants demeurent incohérents et s’ouvrent avec une icône d’avertissement sur la cohérence jusqu’à leur mise à jour.

Utilisation

Cet outil n’est pas pris en charge en cas d’utilisation d’un service de réseau de distribution ou de traces. Vous devez utiliser un réseau de distribution ou un réseau de traces dans une géodatabase fichier ou mobile, ou une connexion de base de données à un réseau de distribution ou de traces dans une géodatabase d’entreprise. Lorsque vous utilisez une géodatabase d’entreprise, tenez compte des exigences suivantes :
- La valeur du paramètre Input Network (Réseau en entrée) doit provenir d’une connexion à une base de données établie en tant que propriétaire du réseau technique de la base de donnée ou propriétaire du réseau de traces de la base de données.
- Le compte connecté au portail ArcGIS Enterprise doit être celui du propriétaire du réseau de distribution du portail ou du propriétaire du réseau de traces du portail.
- Cet outil doit être connecté à la version par défaut qui est censée être publique et non protégée.
La règle Traçage permet d’exécuter un traçage à partir des entités ou objets de réseau actuellement représentés dans un diagramme, ou à partir de points de début donnés spécifiés en entrée ou à l’aide d’une règle Définir les points de début.

Selon le type de traçage indiqué, des points de début peuvent ou doivent être prédéfinis dans le diagramme pour que la règle de traçage soit appliquée comme suit :
- Pour les types de traçage Connected (Connecté), Subnetwork (Sous-réseau), Upstream (En amont), Downstream (En aval) et Circuit, tous les éléments du réseau de distribution ou du réseau de traçage actuellement représentés dans le diagramme au démarrage de la règle de traçage sont considérés comme les points de départ du traçage, à moins que la création du diagramme commence à partir de localisations de traçage spécifiques indiquées en entrée ou qu’une règle Définir les points de début soit configurée en amont sur le modèle de diagramme pour identifier au préalable des points de départ spécifiques.
- Le type de traçage Path (Chemin) doit avoir un ou plusieurs lieux de début et un ou plusieurs lieux d’arrêt pour fonctionner correctement. Le type de traçage de chemin présente des exigences spécifiques lorsqu’il est utilisé en tant que diagramme Règle de traçage par rapport aux autres types de traçage car les points d’arrêt ne peuvent pas être spécifiés par l’intermédiaire de règles de diagramme. Si vous voulez créer des diagrammes d’après un modèle de diagramme configuré pour appliquer une règle de type de traçage Path (Chemin), l’outil Create Diagram (Créer un diagramme) doit être exécuté avec le paramètre Create diagram from trace locations (Créer un diagramme à partir des localisations de traçage) activé.
  
  Conseil :
  
  Configurer le paramètre Nom d’attribut de réseau du chemin le plus court permet de calculer le chemin le plus court entre les emplacements de départ et d’arrêt spécifiés et d’afficher le chemin le plus court détecté sous forme de diagramme.
Lorsque vous configurez un modèle basé sur une règle Traçage, le traçage est systématiquement réexécuté sur le réseau de distribution ou le réseau de traces à chaque mise à jour du diagramme. Par conséquent, tout diagramme basé sur ce modèle reflète toujours le résultat actuel de la trace réseau lorsqu’il est mis à jour.
À compter de Utility Network version 7, vous pouvez configurer les règles de traçage pour réaliser des opérations de traçage en amont et en aval déterminant le flux à l’aide du sens de numérisation des lignes et l’attribut Flow direction plutôt qu’avec la localisation des contrôleurs de sous-réseau.
À compter de Utility Network version 7 et Trace Network version 4, vous pouvez également configurer des règles de traçage en utilisant les configurations de tracé nommées.
À partir d’ArcGIS Pro 3.6, vous pouvez configurer la règle de traçage pour filtrer les types de ressource en sortie ou le type d’entité en fonction des attributs de réseau ou de la catégorie à renvoyer.
À compter de Utility Network version 8, si votre réseau de distribution existe avec des domaines télécoms, vous pouvez configurer une règle de traçage pour exécuter des tracés de circuit sur un domaine télécom.

Etiqueter	Explication	Type de données
Réseau en entrée	Réseau de distribution ou de traces contenant le modèle de diagramme à modifier.	Utility Network; Trace Network
Modèle de diagramme en entrée	Nom du modèle de diagramme à modifier.	String
Activé	Précise si la règle est activée lors de la génération et de la mise à jour des diagrammes selon le modèle spécifique. Activé—La règle ajoutée est activée pendant la génération et la mise à jour de n’importe quel diagramme selon le modèle en entrée. Il s’agit de l’option par défaut. Décoché—La règle ajoutée n’est pas activée pendant la génération ou la mise à jour de n’importe quel diagramme selon le modèle en entrée.	Boolean
Type de traçage	Indique le type de traçage à exécuter pour générer le contenu du diagramme. Connecté—Un traçage connecté est exécuté à partir des éléments du réseau de distribution ou de traces qui sont actuellement représentés dans le diagramme lorsque la règle commence et s’étend le long des éléments connectés. Il s’agit de l’option par défaut. Sous-réseau—Un traçage de sous-réseau est exécuté à partir des éléments de réseau de distribution actuellement représentés dans le diagramme lorsque la règle débute et s’étend vers l’extérieur le long des éléments connectés pour trouver les sources ou les cuvettes à partir desquelles elle s’étend vers l’extérieur le long du sous-réseau associé. En amont—Un traçage en amont est exécuté à partir des éléments de réseau de distribution ou de réseau de traçage actuellement représentés dans le diagramme lorsque la règle commence à découvrir des éléments en amont. En aval—Un traçage en aval est exécuté à partir des éléments de réseau de distribution ou de réseau de traçage actuellement représentés dans le diagramme lorsque la règle commence à découvrir des éléments en aval. Plus court chemin—Un traçage du chemin le plus court est exécuté à partir des entités de réseau du réseau de distribution ou de traces qui sont actuellement spécifiées comme points de départ dans le diagramme lorsque la règle commence à découvrir les entités le long du chemin le plus court entre ces points de départ. Le coût du parcours du chemin est déterminé en fonction de l’attribut de réseau défini pour la valeur du paramètre Nom d’attribut de réseau du chemin le plus court, quel que soit la direction de flux. Héritage : Le type de traçage Chemin le plus court est obsolète dans ArcGIS Pro 3.7 et ArcGIS Enterprise 12.1. Bien qu’il continuera d’être proposé et de fonctionner jusqu’à la prochaine version majeure, il est recommandé d’utiliser le type de traçage Chemin pour renvoyer le chemin le plus court. Le type de traçage Chemin offre les mêmes fonctions, qui permettent d’identifier le chemin le plus court, et propose également des fonctionnalités supplémentaires pour rechercher des chemins dans votre réseau. Circuit—Un traçage de circuit est exécuté à partir des éléments du réseau de distribution ou du réseau de traces représentés dans le diagramme lorsque la règle commence. Il renvoie une définition de circuit et des informations de chemin pour les circuits physiques et pour les circuits virtuels. Cette option est prise en charge pour les réseaux de domaine de télécommunications uniquement. Chemin—Un traçage de chemin est exécuté pour identifier les chemins valides entre les points de départ et d’arrêt utilisés comme localisations de traçage en entrée pour la génération de diagrammes.	String
Réseau de domaine (Facultatif)	Nom des classes de réseau sur lesquelles le traçage sera exécuté pour un réseau de distribution. Ce paramètre est requis lors de l’exécution des traçages de sous-réseau, en amont, en aval et de circuit.	String
Niveau (Facultatif)	Nom du tier au niveau duquel le traçage démarrera pour un réseau de distribution. Ce paramètre est facultatif lors de l’exécution de traçages de type connecté. En revanche, il est requis lors de l’exécution de traçages de type sous-réseau, en amont et en aval.	String
Niveau cible (Facultatif)	Nom du tier cible vers lequel le tier en entrée circulera pour un réseau de distribution. 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
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écoché—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’interruptions (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. Activé—Les 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. Décoché—Les entités d’interruption de capacité à être traversé ne sont pas incluses dans les résultats de traçage.	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 du réseau ou une catégorie de réseau, un opérateur et un type, ainsi qu’une valeur d’attribut. 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. Colonnes de la table de valeurs : Name—Filter by any network attribute defined in the system. Operator—Choose from a number of different operators. Is equal to—The attribute is equal to the value. Does not equal—The attribute is not equal to the value. Is greater than—The attribute is greater than the value. Is greater than or equal to—The attribute is greater than or equal to the value. Is less than—The attribute is less than the value. Is less than or equal to—The attribute is less than or equal to the value. Includes the values (bitwise AND equals the value)—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). Does not include the values (bitwise AND does not equal the value)—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). Includes any (bitwise AND equals True)—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). Does not include any (bitwise AND equals False)—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). Type—Choose a specific value or network attribute from the value that is specified with the name. Specific value—Filter by a specific value. Network attribute—Filter by a network attribute. Value—Provide a specific value for the input attribute type that would cause termination based on the operator value. Combine Using—Set this value if you have multiple attributes to add. You can combine them using an And or an Or condition. And—Combine the condition barriers. Or—Use if either condition barrier is met.	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. Colonnes de la table de valeurs : Function—Choose from a number of different calculation functions. Minimum—The minimum of the input values will be used. Maximum—The maximum of the input values will be used. Average—The average of the input values will be used. Count—The number of features will be used. Add—The sum of the values will be used. Subtract—The difference between the values will be used. Subnetwork controllers and loops trace types do not support the subtract function. Attribute—Filter by any network attribute defined in the system. Operator—Choose from a number of different operators. Is equal to—The attribute is equal to the value. Does not equal—The attribute is not equal to the value. Is greater than—The attribute is greater than the value. Is greater than or equal to—The attribute is greater than or equal to the value. Is less than—The attribute is less than the value. Is less than or equal to—The attribute is less than or equal to the value. Includes the values (bitwise AND equals the value)—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). Does not include the values (bitwise AND does not equal the value)—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). Includes any (bitwise AND equals True)—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). Does not include any (bitwise AND equals False)—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). Value—Provide a specific value for the input attribute type that, if discovered, will cause the termination. Use Local Values—Calculate values in each direction as opposed to an overall global value. For example, a function barrier that is calculating the sum of Shape length in which the trace terminates if the value is greater than or equal to 4. In the global case, after you traverse two edges with a value of 2, you will have reached a shape length sum of 4, so the trace stops. If local values are used, the local values along each path change, and the trace continues.	Value Table
Appliquer la traversabilité à (Facultatif)	Spécifie le type de traversabilité qui sera appliqué. La portée de traversabilité indique si la traversabilité est appliquée au niveau des jonctions, des tronçons ou des 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 non les jonctions, les tronçons, voire les deux. Both junctions and edges—La capacité à être traversé s’applique aux jonctions et aux tronçons. Junctions only—La capacité à être traversé s’applique uniquement aux jonctions. Edges only—La capacité à être traversé s’applique uniquement aux tronçons. Jonctions et tronçons—La capacité à être traversé s’applique aux jonctions et aux tronçons. Il s’agit de l’option par défaut. Jonctions uniquement—La capacité à être traversé s’applique uniquement aux jonctions. Tronçons uniquement—La 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. Colonnes de la table de valeurs : Name—Filter by category or any network attribute defined in the system. Operator—Choose from a number of different operators. Is equal to—The attribute is equal to the value. Does not equal—The attribute is not equal to the value. Is greater than—The attribute is greater than the value. Is greater than or equal to—The attribute is greater than or equal to the value. Is less than—The attribute is less than the value. Is less than or equal to—The attribute is less than or equal to the value. Includes the values (bitwise AND equals the value)—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). Does not include the values (bitwise AND does not equal the value)—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). Includes any (bitwise AND equals True)—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). Does not include any (bitwise AND equals False)—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). Type—Choose a specific value or network attribute from the value that is specified with the name. Specific value—Filter by a specific value. Network attribute—Filter by a network attribute. Value—Provide a specific value of the input attribute type that would cause termination based on the operator value. Combine Using—Set this value if you have multiple attributes to add. You can combine them using an And or an Or condition. And—Combine the condition barriers. Or—Use if either condition barrier is met.	Value Table
Filtrer par fonctions d’interruption (Facultatif)	Filtre les résultats du traçage pour une catégorie spécifique. Colonnes de la table de valeurs : Function—Filter by a function. Minimum—The minimum of the input values will be used. Maximum—The maximum of the input values will be used. Average—The average of the input values will be used. Count—The number of features will be used. Add—The sum of the values will be used. Subtract—The difference between the values will be used. Subnetwork controllers and loops trace types do not support the subtract function. Attribute—Filter by a network attribute. Operator—Filter by an operator. Is equal to—The attribute is equal to the value. Does not equal—The attribute is not equal to the value. Is greater than—The attribute is greater than the value. Is greater than or equal to—The attribute is greater than or equal to the value. Is less than—The attribute is less than the value. Is less than or equal to—The attribute is less than or equal to the value. Includes the values (bitwise AND equals the value)—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). Does not include the values (bitwise AND does not equal the value)—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). Includes any (bitwise AND equals True)—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). Does not include any (bitwise AND equals False)—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). Value—Filter by a specific value. Use Local Values—Boolean value to use local variables instead of a global variable.	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, un filtre d’interruption est défini pour arrêter le traçage lorsque le paramètre Device Status (Statut du dispositif) est réglé sur Open (Ouvert), avec la portée de la capacité à être traversé réglée sur les tronçons uniquement, le traçage ne s’interrompt pas même s’il détecte un dispositif ouvert. En effet, le statut du dispositif ne s’applique qu’aux jonctions. En d’autres termes, ce paramètre indique au traçage d’ignorer ou non les jonctions, les tronçons, voire les deux. 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. Jonctions et tronçons—Le filtre s’applique aux jonctions et aux tronçons. Il s’agit de l’option par défaut. Jonctions uniquement—Le filtre s’applique uniquement aux jonctions. 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. Vous pouvez fournir un nombre et un coût, ainsi qu’un ensemble de catégories, un type de ressource ou ces deux éléments. Activé—L’algorithme K voisins les plus proches est utilisé pour renvoyer un certain nombre d’entités comme spécifié dans Count (Total), Cost Network Attribute (Attribut de réseau de coût), Nearest Categories (Catégories les plus proches) ou Nearest Asset Groups/Types (Types/Groupes de ressources les plus proches). Décoché—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 activé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 Filter by nearest (Filtrer par proximité) est activée (par exemple, Longueur de forme).	String
Catégories les plus proches (Facultatif)	Catégories à renvoyer lorsque l’option Filter by nearest (Filtrer par proximité) est cochée (par exemple, Protection).	String
Types/Groupes de ressources les plus proches (Facultatif)	Groupes de ressources et types de ressources à renvoyer lorsque l’option Filter by nearest (Filtrer par proximité) est activée (par exemple, ElectricDistributionDevice/Transformer/Step Down).	String
Propagateurs (Facultatif)	Ce paramètre est accessible uniquement via Python. Colonnes de la table de valeurs : Attribute—Filter by any network attribute defined in the system. Substitution Attribute—Use a substituted value instead of bitset network attribute values. Substitutions are encoded based on the number of bits in the network attribute being propagated. A substitution is a mapping of each bit in phase to another bit. For example, for Phase AC, one substitution could map bit A to B, and bit C to null. In this example, the substitution for 1010 (Phase AC) is 0000-0010-0000-0000 (512). The substitution captures the mapping so you know that Phase A was mapped to B and Phase C was mapped to null, and not the other way around (that is, Phase A was not mapped to null and Phase C was not mapped to B). Function—Choose from a number of calculation functions. Propagated bitwise AND—Compare the values from one feature to the next. Propagated minimum—The minimum value will be used. Propagated maximum—The maximum value will be used. Operator—Choose from a number of operators. Is equal to—The attribute is equal to the value. Does not equal—The attribute is equal to the value. Is greater than—The attribute is greater than the value. Is greater than or equal to—The attribute is greater than or equal to the value. Is less than—The attribute is less than the value. Is less than or equal to—The attribute is less than or equal to the value. Includes the values (bitwise AND equals the value)—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). Does not include the values (bitwise AND does not equal the value)—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). Includes any (bitwise AND equals True)—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). Does not include any (bitwise AND equals False)—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). Value—Provide a specific value for the input attribute type that would cause termination based on the operator value.	Value Table
Description (Facultatif)	Description de la règle.	String
Autoriser la circulation indéterminée (Facultatif)	Indique si les entités du réseau de traçage dont le flux est indéterminé ou non initialisé sont tracées. Ce paramètre est respecté uniquement lors de l’exécution de traçages de type en amont ou en aval. Activé—Les entités du réseau de traçages dont le traçage présente un sens de flux non initialisé ou indéterminé seront incluses. Décoché—Les entités du réseau de traçages dont le traçage présente un sens de flux non initialisé ou indéterminé ne seront pas incluses. Il s’agit de l’option par défaut.	Boolean
Path Direction (Direction du chemin) (Facultatif)	Spécifie la direction du chemin le plus court pour un réseau de traces. Le coût du parcours du chemin est déterminé en fonction de la valeur du paramètre Shortest Path Network Attribut Name (Nom de l’attribut de réseau du chemin le plus court). Ce paramètre est utilisé uniquement lors de l’application du type de traçage Shortest path (Chemin le plus court) à un réseau de traces. No direction (Pas de direction)—Le chemin le plus court relie les deux points de départ, quelle que soit la direction du flux. Il s’agit de l’option par défaut. Upstream path (Chemin en amont)—La direction du chemin le plus court sera en amont entre les deux points de départ. Downstream path (Chemin en aval)—La direction du chemin le plus court sera en aval entre les deux points de départ.	String
Nom d’attribut de réseau du chemin le plus court (Facultatif)	Attribut de réseau à utiliser pour calculer le chemin le plus court en utilisant un traçage de type chemin ou chemin le plus court pour un réseau de distribution ou un réseau de traces. 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
Use Trace Configuration (Utiliser la configuration du tracé) (Facultatif)	Indique si une configuration de tracé nommée existante est utilisée pour définir les propriétés du traçage. Ce paramètre est seulement activé pour Utility Network version 7 et ultérieure. Activé—Une configuration de trace nommée existante est utilisée pour définir les propriétés de la trace. Décoché—Aucune configuration de trace nommée existante n’est utilisée pour définir les propriétés de la trace. Il s’agit de l’option par défaut.	Boolean
Nom de la configuration de trace (Facultatif)	Nom de la configuration de trace nommée existante qui est utilisée pour définir les propriétés de la trace. Ce paramètre n’est actif que si l’option Use Trace Configuration (Utiliser une configuration de trace) est sélectionnée.	String
Utiliser le sens de numérisation (Facultatif)	Indique si les opérations de traçage en amont et en aval déterminent le flux à l’aide du sens de numérisation de la ligne et de l’attribut de direction de flux. Ce paramètre est activé uniquement pour Utility Network version 7 et versions ultérieures lorsque le paramètre Type de traçage est défini sur l’option Upstream (En amont) ou Downstream (En aval). Remarque : Ce paramètre requiert ArcGIS Enterprise 11.3 ou version ultérieure si vous utilisez une géodatabase d’entreprise. Activé—Les opérations de traçage déterminent la direction de flux à l’aide du sens de numérisation de la ligne et l’attribut de direction de flux. Lorsque cette option est activée, les paramètres Domain Network (Réseau de domaine), Tier (Niveau) et Targer Tier (Niveau cible) sont désactivés. Décoché—Les opérations de traçage déterminent la direction de flux en se basant sur l’emplacement des contrôleurs de sous-réseaux. Il s’agit de l’option par défaut.	Boolean
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. Colonnes de la table de valeurs : Name—Filter by network attribute name. Operator—Filter by an operator. Is equal to—The attribute is equal to the value. Does not equal—The attribute is not equal to the value. Is greater than—The attribute is greater than the value. Is greater than or equal to—The attribute is greater than or equal to the value. Is less than—The attribute is less than the value. Is less than or equal to—The attribute is less than or equal to the value. Includes the values (bitwise AND equals the value)—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). Does not include the values (bitwise AND does not equal the value)—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). Includes any (bitwise AND equals True)—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). Does not include any (bitwise AND equals False)—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). Type—Filter by a specific type. Specific value—Filter by a specific value. Network attribute—Filter by a network attribute. Value—Filter by a specific value. Combine Using—Use this parameter to combine multiple conditions. And—Combine the conditions. Or—Use if either condition is met.	Value Table
Num Paths (Nombre de chemins) (Facultatif)	Nombre maximal de chemins renvoyés dans le traçage de chemin ou de circuit. La valeur par défaut est 1. Ce paramètre est actif uniquement lorsque le paramètre Trace Type (Type de traçage) est défini sur Path (Chemin) ou Circuit.	Long
Max Hops (Nombre max. de sauts) (Facultatif)	Nombre maximal de sauts entre les tronçons autorisés dans le chemin ou le circuit, hormis le point de départ. 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. Les bornes sont évaluées comme ayant une longueur unitaire fixe de 2. La valeur par défaut est 100. Ce paramètre est actif uniquement lorsque le paramètre Trace Type (Type de traçage) est défini sur Path (Chemin) ou Circuit.	Long
Inférer la connectivité (Facultatif)	Indique si le traçage de chemin utilisera l’inférence de connectivité pour traverser les associations d’inclusion et identifier un chemin entre la localisation de départ et la localisation d’arrivée spécifiées. Ce paramètre est uniquement pris en charge avec le traçage de chemin dans les réseaux de domaine de télécommunications et permet la détection des chemins entre les sections lorsque les informations de connectivité ne sont pas disponibles explicitement. Pour plus d’informations, voir Inférer la connectivité. Activé—Le traçage de chemin utilisera l’inférence de connectivité pour traverser les associations d’inclusion et identifier un chemin entre la localisation de départ et la localisation d’arrêt spécifiées lorsqu’une connectivité partielle empêche la traversée. Décoché—L’inférence de connectivité ne sera pas utilisée pour identifier un chemin entre la localisation de départ et la localisation d’arrêt spécifiées. Il s’agit de l’option par défaut.	Boolean

Sortie dérivée

Etiqueter	Explication	Type de données
Réseau en sortie	Le réseau technique ou réseau de traces mis à jour.	Utility Network; Trace Network
Modèle de diagramme en sortie	Nom du modèle de diagramme.	String

arcpy.nd.AddTraceRule(in_utility_network, template_name, is_active, trace_type, {domain_network}, {tier}, {target_tier}, {include_structures}, {include_barriers}, {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}, {propagators}, {description}, {allow_indeterminate_flow}, {path_direction}, {path_network_weight_name}, {use_trace_config}, {trace_config_name}, {use_digitized_direction}, {output_assettypes}, {output_conditions}, {num_paths}, {max_hops}, {infer_connectivity})

Nom	Explication	Type de données
in_utility_network	Réseau de distribution ou de traces contenant le modèle de diagramme à modifier.	Utility Network; Trace Network
template_name	Nom du modèle de diagramme à modifier.	String
is_active	Précise si la règle est activée lors de la génération et de la mise à jour des diagrammes selon le modèle spécifique. `ACTIVE`—La règle ajoutée est activée pendant la génération et la mise à jour de n’importe quel diagramme selon le modèle en entrée. Il s’agit de l’option par défaut. `INACTIVE`—La règle ajoutée n’est pas activée pendant la génération ou la mise à jour de n’importe quel diagramme selon le modèle en entrée.	Boolean
trace_type	Indique le type de traçage à exécuter pour générer le contenu du diagramme. `CONNECTED`—Un traçage connecté est exécuté à partir des éléments du réseau de distribution ou de traces qui sont actuellement représentés dans le diagramme lorsque la règle commence et s’étend le long des éléments connectés. Il s’agit de l’option par défaut. `SUBNETWORK`—Un traçage de sous-réseau est exécuté à partir des éléments de réseau de distribution actuellement représentés dans le diagramme lorsque la règle débute et s’étend vers l’extérieur le long des éléments connectés pour trouver les sources ou les cuvettes à partir desquelles elle s’étend vers l’extérieur le long du sous-réseau associé. `UPSTREAM`—Un traçage en amont est exécuté à partir des éléments de réseau de distribution ou de réseau de traçage actuellement représentés dans le diagramme lorsque la règle commence à découvrir des éléments en amont. `DOWNSTREAM`—Un traçage en aval est exécuté à partir des éléments de réseau de distribution ou de réseau de traçage actuellement représentés dans le diagramme lorsque la règle commence à découvrir des éléments en aval. `SHORTEST_PATH`—Un traçage du chemin le plus court est exécuté à partir des entités de réseau du réseau de distribution ou de traces qui sont actuellement spécifiées comme points de départ dans le diagramme lorsque la règle commence à découvrir les entités le long du chemin le plus court entre ces points de départ. Le coût du parcours du chemin est déterminé en fonction de l’attribut de réseau défini pour la valeur du paramètre `path_network_weight_name`, quel que soit la direction de flux. Héritage : Le type de traçage `SHORTEST_PATH` est obsolète dans ArcGIS Pro 3.7 et ArcGIS Enterprise 12.1. Bien qu’il continuera d’être proposé et de fonctionner jusqu’à la prochaine version majeure, il est recommandé d’utiliser le type de traçage `PATH` pour renvoyer le chemin le plus court. Le type de traçage `PATH` offre les mêmes fonctions, qui permettent d’identifier le chemin le plus court, et propose également des fonctionnalités supplémentaires pour rechercher des chemins dans votre réseau. `CIRCUIT`—Un traçage de circuit est exécuté à partir des éléments du réseau de distribution ou du réseau de traces représentés dans le diagramme lorsque la règle commence. Il renvoie une définition de circuit et des informations de chemin pour les circuits physiques et pour les circuits virtuels. Cette option est prise en charge pour les réseaux de domaine de télécommunications uniquement. `PATH`—Un traçage de chemin est exécuté pour identifier les chemins valides entre les points de départ et d’arrêt utilisés comme localisations de traçage en entrée pour la génération de diagrammes.	String
domain_network (Facultatif)	Nom des classes de réseau sur lesquelles le traçage sera exécuté pour un réseau de distribution. Ce paramètre est requis lors de l’exécution des traçages de sous-réseau, en amont, en aval et de circuit.	String
tier (Facultatif)	Nom du tier au niveau duquel le traçage démarrera pour un réseau de distribution. Ce paramètre est facultatif lors de l’exécution de traçages de type connecté. En revanche, il est requis lors de l’exécution de traçages de type sous-réseau, en amont et en aval.	String
target_tier (Facultatif)	Nom du tier cible vers lequel le tier en entrée circulera pour un réseau de distribution. 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
include_structures (Facultatif)	Indique si les objets et les entités de structure sont inclus dans les résultats de traçage. `INCLUDE_STRUCTURES`—Les objets et les entités de structure sont inclus dans les résultats de traçage. `EXCLUDE_STRUCTURES`—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
include_barriers (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. `INCLUDE_BARRIERS`—Les 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_BARRIERS`—Les entités d’interruption de capacité à être traversé ne sont pas incluses dans les résultats de traçage.	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 du réseau ou une catégorie de réseau, un opérateur et un type, ainsi qu’une valeur d’attribut. 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. Colonnes de la table de valeurs : `Name`—Filter by any network attribute defined in the system. `Operator`—Choose from a number of different operators. `IS_EQUAL_TO`—The attribute is equal to the value. `DOES_NOT_EQUAL`—The attribute is not equal to the value. `IS_GREATER_THAN`—The attribute is greater than the value. `IS_GREATER_THAN_OR_EQUAL_TO`—The attribute is greater than or equal to the value. `IS_LESS_THAN`—The attribute is less than the value. `IS_LESS_THAN_OR_EQUAL_TO`—The attribute is less than or equal to the value. `INCLUDES_THE_VALUES`—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). `DOES_NOT_INCLUDE_THE_VALUES`—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). `INCLUDES_ANY`—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). `DOES_NOT_INCLUDE_ANY`—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). `Type`—Choose a specific value or network attribute from the value that is specified with the name. `SPECIFIC_VALUE`—Filter by a specific value. `NETWORK_ATTRIBUTE`—Filter by a network attribute. `Value`—Provide a specific value for the input attribute type that would cause termination based on the operator value. `Combine Using`—Set this value if you have multiple attributes to add. You can combine them using an And or an Or condition. `AND`—Combine the condition barriers. `OR`—Use if either condition barrier is met.	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. Colonnes de la table de valeurs : `Function`—Choose from a number of different calculation functions. `MIN`—The minimum of the input values will be used. `MAX`—The maximum of the input values will be used. `AVERAGE`—The average of the input values will be used. `COUNT`—The number of features will be used. `ADD`—The sum of the values will be used. `SUBTRACT`—The difference between the values will be used. Subnetwork controllers and loops trace types do not support the subtract function. `Attribute`—Filter by any network attribute defined in the system. `Operator`—Choose from a number of different operators. `IS_EQUAL_TO`—The attribute is equal to the value. `DOES_NOT_EQUAL`—The attribute is not equal to the value. `IS_GREATER_THAN`—The attribute is greater than the value. `IS_GREATER_THAN_OR_EQUAL_TO`—The attribute is greater than or equal to the value. `IS_LESS_THAN`—The attribute is less than the value. `IS_LESS_THAN_OR_EQUAL_TO`—The attribute is less than or equal to the value. `INCLUDES_THE_VALUES`—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). `DOES_NOT_INCLUDE_THE_VALUES`—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). `INCLUDES_ANY`—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). `DOES_NOT_INCLUDE_ANY`—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). `Value`—Provide a specific value for the input attribute type that, if discovered, will cause the termination. `Use Local Values`—Calculate values in each direction as opposed to an overall global value. For example, a function barrier that is calculating the sum of Shape length in which the trace terminates if the value is greater than or equal to 4. In the global case, after you traverse two edges with a value of 2, you will have reached a shape length sum of 4, so the trace stops. If local values are used, the local values along each path change, and the trace continues.	Value Table
traversability_scope (Facultatif)	Spécifie le type de traversabilité qui sera appliqué. La portée de traversabilité indique si la traversabilité est appliquée au niveau des jonctions, des tronçons ou des 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 non les jonctions, les tronçons, voire les deux. `BOTH_JUNCTIONS_AND_EDGES`—La capacité à être traversé s’applique aux jonctions et aux tronçons. Il s’agit de l’option par défaut. `JUNCTIONS_ONLY`—La capacité à être traversé s’applique uniquement aux jonctions. `EDGES_ONLY`—La capacité à être traversé s’applique uniquement aux tronçons.	String
filter_barriers [[Name, Operator, Type, Value, Combine Using],...] (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. Colonnes de la table de valeurs : `Name`—Filter by category or any network attribute defined in the system. `Operator`—Choose from a number of different operators. `IS_EQUAL_TO`—The attribute is equal to the value. `DOES_NOT_EQUAL`—The attribute is not equal to the value. `IS_GREATER_THAN`—The attribute is greater than the value. `IS_GREATER_THAN_OR_EQUAL_TO`—The attribute is greater than or equal to the value. `IS_LESS_THAN`—The attribute is less than the value. `IS_LESS_THAN_OR_EQUAL_TO`—The attribute is less than or equal to the value. `INCLUDES_THE_VALUES`—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). `DOES_NOT_INCLUDE_THE_VALUES`—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). `INCLUDES_ANY`—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). `DOES_NOT_INCLUDE_ANY`—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). `Type`—Choose a specific value or network attribute from the value that is specified with the name. `SPECIFIC_VALUE`—Filter by a specific value. `NETWORK_ATTRIBUTE`—Filter by a network attribute. `Value`—Provide a specific value of the input attribute type that would cause termination based on the operator value. `Combine Using`—Set this value if you have multiple attributes to add. You can combine them using an And or an Or condition. `AND`—Combine the condition barriers. `OR`—Use if either condition barrier is met.	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. Colonnes de la table de valeurs : `Function`—Filter by a function. `MIN`—The minimum of the input values will be used. `MAX`—The maximum of the input values will be used. `AVERAGE`—The average of the input values will be used. `COUNT`—The number of features will be used. `ADD`—The sum of the values will be used. `SUBTRACT`—The difference between the values will be used. Subnetwork controllers and loops trace types do not support the subtract function. `Attribute`—Filter by a network attribute. `Operator`—Filter by an operator. `IS_EQUAL_TO`—The attribute is equal to the value. `DOES_NOT_EQUAL`—The attribute is not equal to the value. `IS_GREATER_THAN`—The attribute is greater than the value. `IS_GREATER_THAN_OR_EQUAL_TO`—The attribute is greater than or equal to the value. `IS_LESS_THAN`—The attribute is less than the value. `IS_LESS_THAN_OR_EQUAL_TO`—The attribute is less than or equal to the value. `INCLUDES_THE_VALUES`—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). `DOES_NOT_INCLUDE_THE_VALUES`—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). `INCLUDES_ANY`—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). `DOES_NOT_INCLUDE_ANY`—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). `Value`—Filter by a specific value. `Use Local Values`—Boolean value to use local variables instead of a global variable.	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, un filtre d’interruption est défini pour arrêter le traçage lorsque le paramètre Device Status (Statut du dispositif) est réglé sur Open (Ouvert), avec la portée de la capacité à être traversé réglée sur les tronçons uniquement, le traçage ne s’interrompt pas même s’il détecte un dispositif ouvert. En effet, le statut du dispositif ne s’applique qu’aux jonctions. En d’autres termes, ce paramètre indique au traçage d’ignorer ou non les jonctions, les tronçons, voire les deux. `BOTH_JUNCTIONS_AND_EDGES`—Le filtre s’applique aux jonctions et aux tronçons. Il s’agit de l’option par défaut. `JUNCTIONS_ONLY`—Le filtre s’applique uniquement aux jonctions. `EDGES_ONLY`—Le 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. Vous pouvez fournir un nombre et un coût, ainsi qu’un ensemble de catégories, un type de ressource ou ces deux éléments. `FILTER_BY_NEAREST`—L’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_FILTER`—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
nearest_count (Facultatif)	Nombre d’entités renvoyées lorsque `filter_nearest` est définie sur `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 défini sur `FILTER_BY_NEAREST` (par exemple, Longueur de forme).	String
nearest_categories [nearest_categories,...] (Facultatif)	Catégories à renvoyer lorsque `filter_nearest` est définie sur `FILTER_BY_NEAREST` (par exemple, Protection).	String
nearest_assets [nearest_assets,...] (Facultatif)	Groupes de ressources et types de ressources à renvoyer lorsque `filter_nearest` est défini sur `FILTER_BY_NEAREST` (par exemple, ElectricDistributionDevice/Transformer/Step Down).	String
propagators [[Attribute, Substitution Attribute, Function, Operator, Value],...] (Facultatif)	Spécifie les attributs de réseau à propager, ainsi que la manière dont cette propagation doit être effectuée pendant un traçage dans un réseau de domaine traditionnel. 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. Colonnes de la table de valeurs : `Attribute`—Filter by any network attribute defined in the system. `Substitution Attribute`—Use a substituted value instead of bitset network attribute values. Substitutions are encoded based on the number of bits in the network attribute being propagated. A substitution is a mapping of each bit in phase to another bit. For example, for Phase AC, one substitution could map bit A to B, and bit C to null. In this example, the substitution for 1010 (Phase AC) is 0000-0010-0000-0000 (512). The substitution captures the mapping so you know that Phase A was mapped to B and Phase C was mapped to null, and not the other way around (that is, Phase A was not mapped to null and Phase C was not mapped to B). `Function`—Choose from a number of calculation functions. `PROPAGATED_BITWISE_AND`—Compare the values from one feature to the next. `PROPAGATED_MIN`—The minimum value will be used. `PROPAGATED_MAX`—The maximum value will be used. `Operator`—Choose from a number of operators. `IS_EQUAL_TO`—The attribute is equal to the value. `DOES_NOT_EQUAL`—The attribute is equal to the value. `IS_GREATER_THAN`—The attribute is greater than the value. `IS_GREATER_THAN_OR_EQUAL_TO`—The attribute is greater than or equal to the value. `IS_LESS_THAN`—The attribute is less than the value. `IS_LESS_THAN_OR_EQUAL_TO`—The attribute is less than or equal to the value. `INCLUDES_THE_VALUES`—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). `DOES_NOT_INCLUDE_THE_VALUES`—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). `INCLUDES_ANY`—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). `DOES_NOT_INCLUDE_ANY`—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). `Value`—Provide a specific value for the input attribute type that would cause termination based on the operator value.	Value Table
description (Facultatif)	Description de la règle.	String
allow_indeterminate_flow (Facultatif)	Indique si les entités du réseau de traçage dont le flux est indéterminé ou non initialisé sont tracées. Ce paramètre est respecté uniquement lors de l’exécution de traçages de type en amont ou en aval. `TRACE_INDETERMINATE_FLOW`—Les entités du réseau de traçages dont le traçage présente un sens de flux non initialisé ou indéterminé seront incluses. `IGNORE_INDETERMINATE_FLOW`—Les entités du réseau de traçages dont le traçage présente un sens de flux non initialisé ou indéterminé ne seront pas incluses. Il s’agit de l’option par défaut.	Boolean
path_direction (Facultatif)	Spécifie la direction du chemin le plus court pour un réseau de traces. Le coût du parcours du chemin est déterminé en fonction de la valeur du paramètre `path_network_weight_name`. Ce paramètre est utilisé uniquement lors de l’application du type de traçage `SHORTEST_PATH` à un réseau de traces. `NO_DIRECTION`—Le chemin le plus court relie les deux points de départ, quelle que soit la direction du flux. Il s’agit de l’option par défaut. `PATH_UPSTREAM`—La direction du chemin le plus court sera en amont entre les deux points de départ. `PATH_DOWNSTREAM`—La direction du chemin le plus court sera en aval entre les deux points de départ.	String
path_network_weight_name (Facultatif)	Attribut de réseau à utiliser pour calculer le chemin le plus court en utilisant un traçage de type chemin ou chemin le plus court pour un réseau de distribution ou un réseau de traces. 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
use_trace_config (Facultatif)	Indique si une configuration de tracé nommée existante est utilisée pour définir les propriétés du traçage. Ce paramètre est seulement activé pour Utility Network version 7 et ultérieure. `USE_TRACE_CONFIGURATION`—Une configuration de trace nommée existante est utilisée pour définir les propriétés de la trace. `DO_NOT_USE_TRACE_CONFIGURATION`—Aucune configuration de trace nommée existante n’est utilisée pour définir les propriétés de la trace. Il s’agit de l’option par défaut.	Boolean
trace_config_name (Facultatif)	Nom de la configuration de trace nommée existante qui est utilisée pour définir les propriétés de la trace. Ce paramètre n’est activé que lorsque le paramètre `use_trace_config` est défini sur `USE_TRACE_CONFIGURATION`.	String
use_digitized_direction (Facultatif)	Indique si les opérations de traçage en amont et attribut déterminent le flux à l’aide du sens de numérisation de la ligne et l’attribut `Flow direction`. Ce paramètre n’est activé que pour Utility Network version 7 et ultérieure lorsque le paramètre `trace_type` est défini sur l’option `UPSTREAM` ou `DOWNSTREAM`. Remarque : Ce paramètre requiert ArcGIS Enterprise 11.3 ou version ultérieure si vous utilisez une géodatabase d’entreprise. `USE_DIGITIZED_DIRECTION`—Les opérations de traçage déterminent la direction de flux à l’aide du sens de numérisation de la ligne et l’attribut de direction de flux. Grâce à cette option, les paramètres `domain_network`, `tier` et `target_tier` sont ignorés. `IGNORE_DIGITIZED_DIRECTION`—Les opérations de traçage déterminent la direction de flux en se basant sur l’emplacement des contrôleurs de sous-réseaux. Il s’agit de l’option par défaut.	Boolean
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. Colonnes de la table de valeurs : `Name`—Filter by network attribute name. `Operator`—Filter by an operator. `IS_EQUAL_TO`—The attribute is equal to the value. `DOES_NOT_EQUAL`—The attribute is not equal to the value. `IS_GREATER_THAN`—The attribute is greater than the value. `IS_GREATER_THAN_OR_EQUAL_TO`—The attribute is greater than or equal to the value. `IS_LESS_THAN`—The attribute is less than the value. `IS_LESS_THAN_OR_EQUAL_TO`—The attribute is less than or equal to the value. `INCLUDES_THE_VALUES`—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). `DOES_NOT_INCLUDE_THE_VALUES`—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). `INCLUDES_ANY`—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). `DOES_NOT_INCLUDE_ANY`—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). `Type`—Filter by a specific type. `SPECIFIC_VALUE`—Filter by a specific value. `NETWORK_ATTRIBUTE`—Filter by a network attribute. `Value`—Filter by a specific value. `Combine Using`—Use this parameter to combine multiple conditions. `AND`—Combine the conditions. `OR`—Use if either condition is met.	Value Table
num_paths (Facultatif)	Nombre maximal de chemins renvoyés dans le traçage de chemin ou de circuit. La valeur par défaut est 1. Ce paramètre est actif uniquement lorsque le paramètre trace_type est défini sur `PATH` ou `CIRCUIT`.	Long
max_hops (Facultatif)	Nombre maximal de sauts entre les tronçons autorisés dans le chemin ou le circuit, hormis le point de départ. 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. Les bornes sont évaluées comme ayant une longueur unitaire fixe de 2. La valeur par défaut est 100. Ce paramètre n’est valide que si le paramètre `trace_type` est défini sur `PATH` ou `CIRCUIT`.	Long
infer_connectivity (Facultatif)	Indique si le traçage de chemin utilisera l’inférence de connectivité pour traverser les associations d’inclusion et identifier un chemin entre la localisation de départ et la localisation d’arrivée spécifiées. Ce paramètre est uniquement pris en charge avec le traçage de chemin dans les réseaux de domaine de télécommunications et permet la détection des chemins entre les sections lorsque les informations de connectivité ne sont pas disponibles explicitement. Pour plus d’informations, voir Inférer la connectivité. `INFER_CONNECTIVITY`—Le traçage de chemin utilisera l’inférence de connectivité pour traverser les associations d’inclusion et identifier un chemin entre la localisation de départ et la localisation d’arrêt spécifiées lorsqu’une connectivité partielle empêche la traversée. `DO_NOT_INFER_CONNECTIVITY`—L’inférence de connectivité ne sera pas utilisée pour identifier un chemin entre la localisation de départ et la localisation d’arrêt spécifiées. Il s’agit de l’option par défaut.	Boolean

Sortie dérivée

Nom	Explication	Type de données
out_utility_network	Le réseau technique ou réseau de traces mis à jour.	Utility Network; Trace Network
out_template_name	Nom du modèle de diagramme.	String

Exemple de code

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

Ajoutez une règle de traçage au modèle MyTemplate1 existant dans un réseau donné pour générer les diagrammes depuis le traçage sur les sous-réseaux au sein du niveau Moyenne tension du domaine ElectricDistribution.

import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DiagramTemplate = "MyTemplate1"

arcpy.nd.AddTraceRule(input_Network, input_DiagramTemplate, "ACTIVE",
                      "SUBNETWORK", "ElectricDistribution", "Medium Voltage",
                      "Low Voltage Mesh")

Environnements

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

Informations de licence

Basic: Non
Standard: Oui
Advanced: Oui

Ajouter une règle de traçage (Outils des diagrammes de réseau)

Résumé

Attention :

Remarque :

Utilisation

Conseil :

Paramètres

Héritage :

Remarque :

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes