| Nom | Explication | Type de données |
in_utility_network | Réseau de distribution qui contient la nouvelle configuration de tracé nommée. | Utility Network; Utility Network Layer |
trace_config_name | Nom de la configuration de tracé nommée. | String |
trace_type | Spécifie le type de traçage à utiliser. - CONNECTED—Un traçage connecté qui commence à un ou plusieurs points de départ et s’étend le long des entités connectées est utilisé. Il s’agit de l’option par défaut.
- SUBNETWORK—Un tracé de sous-réseau qui commence à un ou plusieurs points de départ et s’étend pour englober le sous-réseau est utilisé. Ce type de traçage est pris en charge pour les réseaux de domaine traditionnels uniquement.
- SUBNETWORK_CONTROLLERS—Un tracé des contrôleurs de sous-réseaux qui localise les sources et les cuvettes des contrôleurs de sous-réseaux associés à un sous-réseau est utilisé. Ce type de traçage est pris en charge pour les réseaux de domaine traditionnels uniquement.
- UPSTREAM—Un traçage en amont qui découvre les entités en amont d’une localisation dans le réseau est utilisé. Ce type de traçage est pris en charge pour les réseaux de domaine traditionnels uniquement, sauf si l’option Use Digitized Direction (Utiliser le sens de numérisation) est activée.
- DOWNSTREAM—Un traçage en aval qui découvre les entités en aval d’une localisation dans le réseau est utilisé. Ce type de traçage est pris en charge pour les réseaux de domaine traditionnels uniquement, sauf si l’option Use Digitized Direction (Utiliser le sens de numérisation) est activée.
- LOOPS—Un traçage des boucles qui s’étend vers l’extérieur à partir du point de départ en fonction de la connectivité est utilisé. Les boucles sont des zones du réseau où la direction du flux est ambiguë.
- SHORTEST_PATH—Un traçage du chemin le plus court qui identifie le chemin le plus court entre deux points de départ est utilisé.
- ISOLATION—Un traçage d’isolement identifiant les entités qui isolent une surface d’un réseau est utilisé. Ce type de traçage est pris en charge pour les réseaux de domaine traditionnels uniquement.
| String |
description (Facultatif) | Description de la configuration de tracé nommée. | String |
tags [tags,...] (Facultatif) | Ensemble de balises utilisé pour identifier la configuration de tracé 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 auquel débute le tracé. 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) | Nom du niveau cible vers lequel le niveau en entrée circule dans un tracé directionnel. Si ce paramètre n’est pas spécifié pour les traçages en amont et en aval, ceux-ci s’arrêtent une fois qu’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 le nom d’un sous-réseau est spécifié, le paramètre starting_points n’est pas requis. | String |
shortest_path_network_attribute_name (Facultatif) | 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_CONTAINERS—Les entités de conteneur sont incluses dans les résultats de traçage.
- EXCLUDE_CONTAINERS—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 (Facultatif) | Indique si le contenu des entités de conteneur est inclus dans les résultats de traçage. - INCLUDE_CONTENT—Le contenu des entités de conteneur est inclus dans les résultats de traçage.
- EXCLUDE_CONTENT—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 |
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 traçage. 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 |
validate_consistency (Facultatif) | Indique si une erreur est renvoyée lorsque des zones à valider figurent dans les entités renvoyé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_CONSISTENCY—Le traçage renvoie une erreur si des zones à valider figurent dans les entités renvoyées.
- DO_NOT_VALIDATE_CONSISTENCY—Le traçage renvoie des résultats que des zones à valider figurent ou non dans l’une des entités renvoyées. Il s’agit de l’option par défaut.
| 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. 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 selon n’importe quel attribut de réseau défini dans le système ou spécifiez Catégorie pour utiliser une catégorie de réseau.
- Operator : choisissez un des opérateurs.
- Type : spécifiez Specific value ou Network attribute pour le type de valeur du paramètre Name qui sert d’interruption. Le paramètre Type doit avoir pour valeur Specific value lorsque le paramètre Name est défini sur Category.
- Value : fournit une valeur spécifique de l’attribut ou de la catégorie 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 conditions à ajouter. Vous pouvez les combiner à l’aide d’une condition Et ou Ou.
Les options des valeurs operator d’interruptions conditionnelles sont les suivantes : - IS_EQUAL_TO—L’attribut est égal à la valeur.
- DOES_NOT_EQUAL—L’attribut est différent de la valeur.
- IS_GREATER_THAN—L’attribut est supérieur à la valeur.
- IS_GREATER_THAN_OR_EQUAL_TO—L’attribut est supérieur ou égal à la valeur.
- IS_LESS_THAN—L’attribut est inférieur à la valeur.
- IS_LESS_THAN_OR_EQUAL_TO—L’attribut est inférieur ou égal à la valeur.
- INCLUDES_THE_VALUES—Opération AND (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—Opération AND (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—Opération AND (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—Opération AND (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_VALUE—Filtrez en fonction d’une valeur ou d’une catégorie de réseau spécifique.
- NETWORK_ATTRIBUTE—Filtrez en fonction d’un attribut de réseau.
Les options des valeurs Combine Using d’interruptions conditionnelles sont les suivantes : - AND—Combinez les interruptions conditionnelles.
- OR—Utilisez 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 d’interruptions de fonctions sont les suivants : - Function : choisissez l’une des fonctions de calcul.
- Attribute : procédez à un filtrage en fonction d’un attribut de réseau défini dans le système.
- Operator : choisissez l’un des opérateurs.
- Value : indiquez la valeur spécifique du type d’attribut en entrée qui, si elle est trouvée, va entraîner l’arrêt.
- Use Local Values : calcule les valeurs dans chaque sens, 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 le traçage s’arrête. Lorsque des valeurs locales sont utilisées, celles-ci changent le long de chaque chemin et le traçage se poursuit.
Les options des valeurs Function de l’interruption de fonction sont les suivantes : - AVERAGE—La moyenne des valeurs en entrée est calculée.
- COUNT—Le nombre d’entités est identifié.
- MAX—Le nombre maximum de valeurs en entrée est identifié.
- MIN—Le nombre minimum de valeurs en entrée est identifié.
- ADD—La somme des valeurs en entrée est calculée.
- SUBTRACT—La différence entre les valeurs en entrée est calculée. Les contrôleurs de sous-réseau et les types de traçage de boucles ne prennent pas en charge la fonction de soustraction.
Les options des valeurs operator de l’interruption de fonction sont les suivantes : - IS_EQUAL_TO—Le résultat de la fonction est égal à la valeur.
- DOES_NOT_EQUAL—Le résultat de la fonction est différent de la valeur.
- IS_GREATER_THAN—Le résultat de la fonction est supérieur à la valeur.
- IS_GREATER_THAN_OR_EQUAL_TO—Le résultat de la fonction est supérieur ou égal à la valeur.
- IS_LESS_THAN—Le résultat de la fonction est inférieur à la valeur.
- IS_LESS_THAN_OR_EQUAL_TO—Le résultat de la fonction est inférieur ou égal à la valeur.
- INCLUDES_THE_VALUES—Opération AND (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—Opération AND (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—Opération AND (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—Opération AND (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 Use Local Values d’interruption de fonction sont les suivantes : - TRUE—Les valeurs locales sont utilisées.
- FALSE—Les valeurs globales sont utilisées. Il s’agit de l’option par défaut.
| Value Table |
traversability_scope (Facultatif) | Spécifie si la traversabilité (capacité à être traversé) est appliquée aux jonctions, aux tronçons ou aux 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 traversabilité s’applique aux jonctions et aux tronçons. Il s’agit de l’option par défaut.
- JUNCTIONS_ONLY—La traversabilité s’applique uniquement aux jonctions.
- EDGES_ONLY—La traversabilité 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 And (Et) ou une condition Or (Ou).
Les composants du Filtre d'interruption sont les suivants : - Name : filtrez par catégorie ou en fonction de n’importe quel attribut de réseau défini dans le système.
- Operator : choisissez l’un des opérateurs.
- Type : choisissez une valeur spécifique ou un attribut de réseau à partir de 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 voulez ajouter plusieurs attributs. Vous pouvez les combiner avec une condition And (Et) ou une condition Or (Ou).
Les options des valeurs Operator des filtres d’interruption sont les suivantes : - IS_EQUAL_TO—L’attribut est égal à la valeur.
- DOES_NOT_EQUAL—L’attribut est différent de la valeur.
- IS_GREATER_THAN—L’attribut est supérieur à la valeur.
- IS_GREATER_THAN_OR_EQUAL_TO—L’attribut est supérieur ou égal à la valeur.
- IS_LESS_THAN—L’attribut est inférieur à la valeur.
- IS_LESS_THAN_OR_EQUAL_TO—L’attribut est inférieur ou égal à la valeur.
- INCLUDES_THE_VALUES—Opération AND (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—Opération AND (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—Opération AND (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—Opération AND (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 d’interruption sont les suivantes : - SPECIFIC_VALUE—Filtrez en fonction d’une valeur spécifique.
- NETWORK_ATTRIBUTE—Filtrez en fonction d’un attribut de réseau.
Les options des valeurs Combine Using des filtres d’interruption sont les suivantes : - AND—Combinez les interruptions conditionnelles.
- OR—Utilisez 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 l’une des fonctions de calcul.
- Attribute : procédez à un filtrage en fonction d’un attribut de réseau défini dans le système.
- Operator : choisissez l’un des opérateurs.
- Value : indiquez la valeur spécifique du type d’attribut en entrée qui, si elle est trouvée, va entraîner l’arrêt.
- Use Local Values : calcule les valeurs dans chaque sens, 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 le traçage 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 des valeurs Function des filtres par fonctions d’interruption sont les suivantes : - AVERAGE—La moyenne des valeurs en entrée est calculée.
- COUNT—Le nombre d’entités est identifié.
- MAX—Le nombre maximum de valeurs en entrée est identifié.
- MIN—Le nombre minimum de valeurs en entrée est identifié.
- ADD—La somme des valeurs est calculée.
- SUBTRACT—La différence entre les valeurs est calculée. Les contrôleurs de sous-réseau et les types de traçage de boucles ne prennent pas en charge la fonction de soustraction.
Les options des valeurs Operator des filtres par fonctions d’interruption sont les suivantes : - IS_EQUAL_TO—L’attribut est égal à la valeur.
- DOES_NOT_EQUAL—L’attribut est différent de la valeur.
- IS_GREATER_THAN—L’attribut est supérieur à la valeur.
- IS_GREATER_THAN_OR_EQUAL_TO—L’attribut est supérieur ou égal à la valeur.
- IS_LESS_THAN—L’attribut est inférieur à la valeur.
- IS_LESS_THAN_OR_EQUAL_TO—L’attribut est inférieur ou égal à la valeur.
- INCLUDES_THE_VALUES—Opération AND (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—Opération AND (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—Opération AND (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—Opération AND (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 Use Local Values des filtres par fonctions d’interruption sont les suivantes : - TRUE—Les valeurs locales sont utilisées.
- FALSE—Les 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, un filtre d’interruption est défini pour arrêter la trace lorsque le paramètre Device Status (Statut du dispositif) a la valeur Open (Ouvert) et que la portée de la traversabilité est définie sur les tronçons uniquement, la trace ne s’interrompt pas même si elle détecte un dispositif ouvert, car 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 indiquer 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-nearest neighbors (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 a la 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 a pour valeur FILTER_BY_NEAREST (par exemple, Shape length [Longueur de forme]). | String |
nearest_categories [nearest_categories,...] (Facultatif) | Catégories à renvoyer lorsque l’option filter_nearest a pour valeur FILTER_BY_NEAREST (par exemple, Protective [Protection]). | String |
nearest_assets [nearest_assets,...] (Facultatif) | Groupes de ressources et types de ressources à renvoyer lorsque filter_nearest a pour valeur FILTER_BY_NEAREST (par exemple, ElectricDistributionDevice/Transformer/Step Down [Dispositif de distribution électrique/Transformateur/Abaisseurs]). | String |
functions [[Function, Attribute, Filter Name, Filter Operator, Filter Type, Filter Value],...] (Facultatif) | Fonction(s) de calcul appliquée(s) aux résultats du traçage.
Les composants des fonction sont les suivants : - Function : choisissez l’une des fonctions de calcul.
- Attribute : procédez à un filtrage en fonction d’un 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 l’un des opérateurs.
- Filter Type : choisissez l’un des types de filtre.
- Filter Value : indiquez une valeur spécifique pour l’attribut de filtre en entrée.
Les options des valeurs Function des fonctions sont les suivantes : - AVERAGE—La moyenne des valeurs en entrée est calculée.
- COUNT—Le nombre d’entités est identifié.
- MAX—Le nombre maximum de valeurs en entrée est identifié.
- MIN—Le nombre minimum de valeurs en entrée est identifié.
- ADD—La somme des valeurs en entrée est calculée.
- SUBTRACT—La différence entre les valeurs en entrée est calculée.Les contrôleurs de sous-réseau et les types de traçage de boucles ne prennent pas en charge la fonction de soustraction.
Considérons, par exemple, une entité de point de départ 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 ADDest de 50, la AVERAGE est de 25, le COUNT est de 2, et la SUBTRACT est de -10. Les options des valeurs Filter Operator sont les suivantes : - IS_EQUAL_TO—L’attribut est égal à la valeur.
- DOES_NOT_EQUAL—L’attribut est différent de la valeur.
- IS_GREATER_THAN—L’attribut est supérieur à la valeur.
- IS_GREATER_THAN_OR_EQUAL_TO—L’attribut est supérieur ou égal à la valeur.
- IS_LESS_THAN—L’attribut est inférieur à la valeur.
- IS_LESS_THAN_OR_EQUAL_TO—L’attribut est inférieur ou égal à la valeur.
- INCLUDES_THE_VALUES—Opération AND (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—Opération AND (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—Opération AND (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—Opération AND (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 Filter Type des fonctions sont les suivantes : - SPECIFIC_VALUE—Filtrez en fonction d’une valeur spécifique.
- NETWORK_ATTRIBUTE—Filtrez 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 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. Les composants des propagateurs sont les suivants : - Attribute : filtrez par n’importe quel 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 une cartographie 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 valeur Function pour les propagateurs sont les suivantes : - PROPAGATED_BITWISE_AND—Les valeurs d’une entité à la suivante sont comparées.
- PROPAGATED_MIN—La valeur minimale est identifiée.
- PROPAGATED_MAX—La valeur maximale est identifiée.
Les options de valeur Operator pour les propagateurs sont les suivantes : - IS_EQUAL_TO—L’attribut est égal à la valeur.
- DOES_NOT_EQUAL—L’attribut est différent de la valeur.
- IS_GREATER_THAN—L’attribut est supérieur à la valeur.
- IS_GREATER_THAN_OR_EQUAL_TO—L’attribut est supérieur ou égal à la valeur.
- IS_LESS_THAN—L’attribut est inférieur à la valeur.
- IS_LESS_THAN_OR_EQUAL_TO—L’attribut est inférieur ou égal à la valeur.
- INCLUDES_THE_VALUES—Opération AND (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—Opération AND (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—Opération AND (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—Opération AND (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 Ce paramètre est uniquement disponible dans 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) | Types des entités qui sont renvoyées en fonction d’un attribut de réseau ou d’une catégorie. Par exemple, une trace configurée pour filtrer toutes les entités sauf les entités Tap (Dérivation), toute entité tracée à laquelle la catégorie Tap (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élection des résultats. Si vous utilisez plusieurs attributs, vous pouvez utiliser l’option Combine Using pour définir une condition And (Et) ou une condition Or (Ou).
Les composants des Conditions de sortie sont les suivants : - Name : filtrez en fonction de n’importe quel attribut de réseau défini dans le système.
- Operator : choisissez l’un des opérateurs.
- Type : choisissez une valeur spécifique ou un attribut de réseau à partir de 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 voulez ajouter plusieurs attributs. Vous pouvez les combiner avec une condition And (Et) ou une condition Or (Ou).
Les options des valeurs Operator des conditions de sortie sont les suivantes : - IS_EQUAL_TO—L’attribut est égal à la valeur.
- DOES_NOT_EQUAL—L’attribut est différent de la valeur.
- IS_GREATER_THAN—L’attribut est supérieur à la valeur.
- IS_GREATER_THAN_OR_EQUAL_TO—L’attribut est supérieur ou égal à la valeur.
- IS_LESS_THAN—L’attribut est inférieur à la valeur.
- IS_LESS_THAN_OR_EQUAL_TO—L’attribut est inférieur ou égal à la valeur.
- INCLUDES_THE_VALUES—Opération AND (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—Opération AND (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—Opération AND (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—Opération AND (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 conditions de sortie sont les suivantes : - SPECIFIC_VALUE—Filtrez en fonction d’une valeur spécifique.
- NETWORK_ATTRIBUTE—Filtrez en fonction d’un attribut de réseau.
Les options des valeurs Combine Using des conditions de sortie sont les suivantes : - AND—Combinez les conditions.
- OR—Utilisez 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_FEATURES—Les entités isolées sont incluses dans les résultats de traçage.
- EXCLUDE_ISOLATED_FEATURES—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 (Facultatif) | Spécifie si les interruptions dynamiques dans la configuration de tracé sont ignorées pour les points de départ. Cela peut s’avérer utile lorsque vous effectuez un tracé de dispositif de protection en amont en utilisant les dispositifs de protection découverts (interruptions) comme points de départ pour rechercher les dispositifs de protection en amont suivants. - IGNORE_BARRIERS_AT_STARTING_POINTS—Les interruptions au points de départ sont ignorées dans le traçage.
- DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTS—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 |
include_up_to_first_spatial_container (Facultatif) | Indique si les conteneurs retournés se limitent ou non à ceux rencontrés jusqu’au premier conteneur spatial (inclus) 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 Include Containers a pour valeur INCLUDE_CONTAINERS. - INCLUDE_UP_TO_FIRST_SPATIAL_CONTAINER—Seuls les conteneurs rencontrés jusqu’au premier conteneur spatial (inclus) figurent dans les résultats lorsque des associations d’inclusions 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_CONTAINER—Tous 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 le traçage. - SELECTION—Les résultats du traçage sont renvoyés en tant qu’ensemble de sélection des entités de réseau appropriées. Il s’agit de l’option par défaut.
- AGGREGATED_GEOMETRY—Les résultats du traçage sont agrégés par type de géométrie et stockés dans les classes d’entités multi-parties 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 s’applique uniquement lors de l’exécution d’un traçage en amont, en aval ou d’isolement. - TRACE_INDETERMINATE_FLOW—Les entités dont le flux est indéterminé sont tracées. Il s’agit de l’option par défaut.
- IGNORE_INDETERMINATE_FLOW—Les 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 lorsque des objets jonction ou tronçon non spatiaux sont rencontrés sans structure ou conteneur associé dans la hiérarchie d’associations des entités traversées. Ce paramètre garantit que les objets non spatiaux renvoyés par un traçage sont associés à des entités spatiales. - VALIDATE_LOCATABILITY—Le traçage renvoie une erreur si des objets jonction ou tronçon non spatiaux sont rencontrés sans structure ou conteneur associé dans la hiérarchie d’associations des entités traversées.
- DO_NOT_VALIDATE_LOCATABILITY—Le traçage ne vérifie pas la présence d’objets non localisables et renvoie des résultats que ces objets soient présents ou non dans la hiérarchie d’associations des entités traversées. Il s’agit de l’option par défaut.
| Boolean |
use_digitized_direction (Facultatif) | Indique si les opérations de traçage en amont et en aval déterminent le sens de flux d’après le sens de numérisation de la ligne, les ID globaux d’origine et de destination de l’objet tronçon dans l’association, et l’attribut Flow direction. Ce paramètre est disponible et actif uniquement avec les réseaux de distribution en version 7 et ultérieures lorsque le paramètre trace_type a pour valeur UPSTREAM ou DOWNSTREAM. - USE_DIGITIZED_DIRECTION—Les opérations de traçage déterminent le sens de flux d’après le sens de numérisation de la ligne, les ID globaux d’origine et de destination de l’objet tronçon dans l’association et l’attribut de sens de flux. Avec 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 le sens de flux en fonction de la localisation des contrôleurs de sous-réseaux. Il s’agit de l’option par défaut.
Pour les géodatabases entreprise, ce paramètre requiert ArcGIS Enterprise 11.3 ou version ultérieure. | Boolean |
synthesize_geometries (Facultatif) | Spécifie si les géométries sont inférées ou créées (synthétisées) pour les associations et les objets tronçon traversés dans le cadre d’une opération de traçage. Ce paramètre s’applique uniquement au type de résultat Géométrie agrégée. - DO_NOT_SYNTHESIZE_GEOMETRIES—Les géométries ne sont pas synthétisées pour les associations et les objets tronçon traversés. Il s’agit de l’option par défaut.
- SYNTHESIZE_GEOMETRIES—Les géométries sont inférées et créées pour les associations et les objets tronçon traversés dans la classe d’entités Trace_Results_Aggregated_Lines en sortie.
Pour les géodatabases entreprise, ce paramètre requiert ArcGIS Enterprise 11.3 ou version ultérieure. | Boolean |