| Nom | Explication | Type de données |
in_trace_network | Réseau de traces qui contient la nouvelle configuration de tracé nommée. | Trace Network; Trace Network Layer |
trace_config_name | Nom de la configuration de tracé nommée. | String |
trace_type | Spécifie le type de traçage à configurer. - 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é.
- 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 utilise le sens de flux.
- 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 utilise le sens de flux.
- SHORTEST_PATH—Un traçage du chemin le plus court qui recherche le chemin le plus court entre deux points de départ sur le réseau, quel que soit le sens de flux, est utilisé. Le coût de la traversée du chemin est déterminé en fonction de l’attribut de réseau défini pour le paramètre shortest_path_network_attribute_name.
| 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 les recherches et l’indexation. | String |
path_direction (Facultatif) | Indique la direction du chemin de traçage. Le coût de la traversée du chemin est déterminé en fonction de la valeur du paramètre shortest_path_network_attribute_name. Ce paramètre est respecté uniquement lors de l’exécution d’un traçage de type SHORTEST_PATH. - NO_DIRECTION—Le chemin entre les deux points de départ, quel que soit le sens de flux, est utilisé. Il s’agit de l’option par défaut.
- PATH_UPSTREAM—Le chemin en amont entre les deux points de départ est utilisé.
- PATH_DOWNSTREAM—Le chemin en aval entre les deux points de départ est utilisé.
| String |
shortest_path_network_attribute_name (Facultatif) | Nom de l’attribut de réseau utilisé pour calculer le chemin. 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_barriers (Facultatif) | Spécifie si les entités d’interruption de traversabilité (capacité à être traversé) sont incluses dans les résultats du traçage. - 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 |
ignore_barriers_at_starting_points (Facultatif) | Indique si les interruptions dans la configuration de tracé sont ignorées pour les points de départ. - 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 |
allow_indeterminate_flow (Facultatif) | Indique si les entités dont le flux est indéterminé ou non initialisé sont tracées. Ce paramètre est respecté uniquement lors de l’exécution d’un traçage en amont ou en aval. - TRACE_INDETERMINATE_FLOW—Les entités dont le sens de flux est non initialisé ou indéterminé sont tracées.
- IGNORE_INDETERMINATE_FLOW—Les entités dont le sens de flux est non initialisé ou indéterminé ne sont pas tracé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é (capacité à être traversé) sur les entités en fonction d’une comparaison avec un attribut de réseau. Une interruption conditionnelle utilise un attribut de réseau, un opérateur et un type, ainsi qu’une valeur attributaire. Par exemple, arrêtez un traçage lorsque l’attribut Code d’une entité est égal à la valeur spécifique de ArtificialPath. Lorsqu’une entité remplit ces conditions, le traçage s’arrête. Si vous utilisez plusieurs attributs, vous pouvez utiliser le composant Combine Using pour définir une condition And (Et) ou une condition Or (Ou). Les composants d’interruptions conditionnelles sont les suivants : - Name : filtrez en fonction de n’importe quel attribut de réseau défini dans le système.
- Operator : faites votre choix parmi les différents opérateurs.
- Type : choisissez une valeur spécifique ou un attribut de réseau à partir de la valeur spécifiée dans le composant Name.
- Value : indiquez la valeur spécifique pour le 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 composants Operator sont les suivants : - 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.
Les composants Type sont les suivants : - SPECIFIC_VALUE—Filtrez en fonction d’une valeur spécifique.
- NETWORK_ATTRIBUTE—Filtrez en fonction d’un attribut de réseau.
Les composants Combine Using sont les suivants : - AND—Combinez les interruptions conditionnelles.
- OR—Utilisez ce paramètre si l’une des interruptions conditionnelles est satisfaite.
| 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 de fonctions peuvent être utilisées, par exemple, pour limiter la distance que la trace peut parcourir depuis le point de départ ou pour définir une valeur maximale à laquelle arrêter une trace. 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 la recherche de parcours 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 composants Function sont les suivants : - AVERAGE—Moyenne des valeurs en entrée.
- COUNT—Nombre d’entités.
- MAX—Maximum des valeurs en entrée.
- MIN—Minimum des valeurs en entrée.
- ADD—La somme des valeurs.
- SUBTRACT—La différence entre les valeurs.
Les composants Operator sont les suivants : - 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.
Les composants Use Local Values sont les suivants : - 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. Par exemple, dans un réseau de pistes de loisirs, si une interruption conditionnelle est définie pour arrêter la trace lorsque le type de piste est défini comme étant du gravier et que la portée de la traversabilité est définie sur les jonctions uniquement, la trace ne s’arrêtera pas, même si elle rencontre un chemin en gravier, car le type de chemin s’applique uniquement aux tronçons. En d’autres termes, ce paramètre indique à la trace d’ignorer ou non les jonctions, les tronçons, ou d’inclure à la fois les jonctions et les tronçons. - 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 |
functions [[Function, Attribute, Filter Name, Filter Operator, Filter Type, Filter Value],...] (Facultatif) | Fonction de calcul appliquée 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 composants Function sont les suivantes : - AVERAGE—Moyenne des valeurs en entrée.
- COUNT—Nombre d’entités.
- MAX—Maximum des valeurs en entrée.
- MIN—Minimum des valeurs en entrée.
- ADD—La somme des valeurs.
- SUBTRACT—La différence entre les valeurs.
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 MIN, le résultat est de 20, de 30 pour MAX, de 50 pour ADD, de 25 pour AVERAGE, de 2 pour COUNT et de 10 pour SUBTRACT. Les options des composants 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.
Les options des composants Filter Type 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 |
output_conditions [[Name, Operator, Type, Value, Combine Using],...] (Facultatif) | Types des entités renvoyées selon un attribut de réseau. Par exemple, sur un tracé configuré pour filtrer toutes les entités sauf les entités Tap (Dérivation), toute entité tracée à laquelle l’attribut Tap (Dérivation) n’est pas attribué 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 par 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 composant Name.
- Value : indiquez la valeur spécifique pour le 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 composants 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.
Les options des composants Type 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 composants Combine Using sont les suivantes : - AND—Combinez les conditions.
- OR—Utilisez ce paramètre si l’une des conditions est satisfaite.
| Value Table |
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 des classes d’entités affichées dans les couches de la carte active.
| String |