Mettre à jour un sous-réseau (Utility Network)

Synthèse

Met à jour les informations sur le sous-réseau dans la table Sous-réseaux, la classe d’entités SubnetLine et les diagrammes système de sous-réseau pour les sous-réseaux spécifiés.

Pour la table Sous-réseaux, cet outil change le statut des contrôleurs de sous-réseau associés pour qu’ils soient nettoyés (l’Is dirtyattribut est défini sur Faux). Si des échecs de cohérence ou des erreurs de sous-réseau sont détectés pendant l’exécution de l’outil, le statut des contrôleurs de sous-réseau associés seront marqués comme non valides (l’attribut Is dirty est défini sur non valide). Dans la classe d’entités SubnetLine, un enregistrement sera généré pour tout nouveau sous-réseau, les enregistrements des sous-réseaux supprimés seront effacés et la forme et les informations des sous-réseaux modifiés seront actualisées. Certains attributs seront créés ou mis à jour pour les entités de sous-réseau.

En savoir plus sur la procédure de mise à jour des sous-réseaux

Utilisation

  • Si une géodatabase d’entreprise est utilisée, les conditions suivantes doivent être remplies :

    • Le réseau de distribution doit être inscrit en tant que branche versionnée.
    • Le réseau de distribution en entrée doit provenir d’un service de réseau de distribution.
    • Si cet outil est exécuté sur la version par défaut et que le paramètre Mettre à jour la stratégie de sous-réseau pour le niveau est configuré de sorte à ne pas gérer l’Is dirtyattribut, l’opération de mise à jour du sous-réseau peut être utilisée pour supprimer des lignes de la table Sous-réseaux où l’attribut Is deleted a pour valeur vrai.
    • Si cet outil est exécuté sur la version par défaut, la géométrie, l’attribut d’un nom de sous-réseau et les champs propagés de la classe d’entités SubnetLine sont mis à jour sur place. Si cet outil est exécuté sur une version nommée, le comportement par défaut (sans événements) limite la mise à jour aux entités et aux objets modifiés dans la version. Le mode de mise à jour peut être modifié pour que les événements soient utilisés (avec événements). Cette option exécute le comportement de la géodatabase et peut être définie dans la configuration du sous-réseau pour la version par défaut et les versions nommées.

      En savoir plus sur le mode de mise à jour utilisé par l’outil Mettre à jour un sous-réseau

  • Cet outil crée ou met à jour les diagrammes de réseau pour les sous-réseaux actualisés si un modèle de diagramme a été spécifié lors de la configuration de la définition du sous-réseau.

  • Toute mise à jour doit être enregistrée avant d’exécuter l’outil.

  • La topologie du réseau doit être activée.

  • Il n’existe aucune zone à valider sectionnant les entités de sous-réseau.

Paramètres

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

Réseau de distribution qui contient le sous-réseau.

Utility Network; Utility Network Layer
Réseau de domaine

Réseau de domaine contenant le sous-réseau.

String
Niveau

Niveau contenant le sous-réseau.

String
Tous les sous-réseaux du niveau
(Facultatif)

Détermine si tous les sous-réseaux figurant dans le niveau seront mis à jour. Pour mettre à jour un sous-ensemble de sous-réseaux dans le niveau, utilisez le paramètre Nom de sous-réseau.

  • Sélectionné : tous les sous-réseaux du niveau seront mis à jour. Cet option utilise un traitement asynchrone pour mettre à jour les sous-réseaux utilisant le système UtilityNetworkTools de service de géotraitement. Ce service est réservé aux tâches de géotraitement du réseau de distribution et bénéficie d’un paramètre de délai d’expiration plus long par défaut. Il s’agit de l’option par défaut.
  • Non sélectionné : seuls les sous-réseaux spécifiés dans le paramètre Nom de sous-réseau seront mis à jour.

Boolean
Nom de sous-réseau
(Facultatif)

Le nom du sous-réseau qui sera mis à jour à partir du niveau. Si tous les sous-réseaux sont mis à jour à l’aide du paramètre All subnetworks in tier (Tous les sous-réseaux du niveau), ce paramètre est ignoré. Lorsque la table de sous-réseaux contient au moins 10 000 enregistrements pour un tier, la liste de choix du paramètre n’est pas renseignée et un champ vierge est proposé pour le nom du sous-réseau.

String
Poursuite après échec
(Facultatif)

Indique si le processus de mise à jour s’arrête en cas d’échec de la mise à jour d’un sous-réseau lors de la mise à jour de plusieurs sous-réseaux.

  • Sélectionné : le processus de mise à jour ne s’arrête pas en cas de défaillance d’un sous-réseau. Il continue.
  • Non sélectionné : le processus de mise à jour s’arrête en cas de défaillance d’un sous-réseau. Il s’agit de l’option par défaut.

Boolean
Interruptions conditionnelles
(Facultatif)
Remarque :

Ce paramètre est uniquement disponible pour Python.

Value Table
Interruptions de fonctions
(Facultatif)
Remarque :

Ce paramètre est uniquement disponible pour Python.

Value Table
Inclure les entités d’interruption
(Facultatif)
Remarque :

Ce paramètre est uniquement disponible pour Python.

Boolean
Appliquer la traversabilité à
(Facultatif)

Spécifie le type de traversabilité qui sera appliqué. La portée de traversabilité détermine si la traversabilité est appliquée aux jonctions, aux tronçons, ou aux deux. Par exemple, si une interruption conditionnelle est définie pour arrêter le traçage lorsque DEVICESTATUS est défini sur Open et que la portée de traversabilité est définie sur les tronçons uniquement, le traçage ne s’arrêtera pas même si un dispositif ouvert est détecté, car DEVICESTATUS s’applique uniquement aux jonctions. En d’autres termes, ce paramètre indique au traçage d’ignorer ou pas : les jonctions, tronçons, ou les deux à la fois.

  • Jonctions et tronçonsLa capacité à être traversé s’applique aux jonctions et aux tronçons. Il s’agit de l’option par défaut.
  • Jonctions uniquementLa capacité à être traversé s’applique uniquement aux jonctions.
  • Tronçons uniquementLa capacité à être traversé s’applique uniquement aux tronçons.
Remarque :

Ce paramètre est uniquement disponible pour Python.

String
Propagateurs
(Facultatif)
Remarque :

Ce paramètre est uniquement disponible pour Python.

Value Table

Sortie obtenue

ÉtiquetteExplicationType de données
Réseau de distribution mis à jour

Réseau de distribution mis à jour.

Utility Network

arcpy.un.UpdateSubnetwork(in_utility_network, domain_network, tier, {all_subnetworks_in_tier}, {subnetwork_name}, {continue_on_failure}, {condition_barriers}, {function_barriers}, {include_barriers}, {traversability_scope}, {propagators})
NomExplicationType de données
in_utility_network

Réseau de distribution qui contient le sous-réseau.

Utility Network; Utility Network Layer
domain_network

Réseau de domaine contenant le sous-réseau.

String
tier

Niveau contenant le sous-réseau.

String
all_subnetworks_in_tier
(Facultatif)

Détermine si tous les sous-réseaux figurant dans le niveau seront mise à jour. Pour mettre à jour un sous-ensemble de sous-réseaux dans le niveau, utilisez le paramètre subnetwork_name.

  • ALL_SUBNETWORKS_IN_TIERTous les sous-réseaux du niveau seront mis à jour. Cet option utilise un traitement asynchrone pour mettre à jour les sous-réseaux utilisant le système UtilityNetworkTools de service de géotraitement. Ce service est réservé aux tâches de géotraitement du réseau de distribution et bénéficie d’un paramètre de délai d’expiration plus long par défaut. Il s’agit de l’option par défaut.
  • SPECIFIC_SUBNETWORKSeuls les sous-réseaux spécifiés dans le paramètre subnetwork_name seront mis à jour.
Boolean
subnetwork_name
(Facultatif)

Le nom du sous-réseau qui sera mis à jour à partir du niveau. Si tous les sous-réseaux sont à mettre à jour à l’aide du paramètre all_subnetworks_in_tier, ce dernier est ignoré.

String
continue_on_failure
(Facultatif)

Indique si le processus de mise à jour s’arrête en cas d’échec de la mise à jour d’un sous-réseau lors de la mise à jour de plusieurs sous-réseaux.

  • CONTINUE_ON_FAILURELe processus de mise à jour ne s’arrête pas en cas de défaillance du sous-réseau. Il continue.
  • STOP_ON_FAILURELe processus de mise à jour s’arrête en cas de défaillance du sous-réseau. 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 de réseau, un opérateur et un type, ainsi qu’une valeur attributaire. Par exemple, arrêtez un traçage lorsque l’attribut Device Status d’une entité est égal à la valeur spécifique de Open. Lorsqu’une entité remplit ces conditions, le traçage s’arrête. En cas d’utilisation de plusieurs attributs, vous pouvez définir une condition Et ou une condition Ou à l’aide du paramètre Combine using (Combiner en utilisant).

Les composants de l’interruption conditionnelle sont les suivants :

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

Les valeurs Operator d’interruption conditionnelle sont les suivantes :

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

Les options type d’interruption conditionnelle sont les suivantes :

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

Les valeurs Combine Using sont les suivantes :

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

En savoir plus sur l’utilisation de plusieurs expressions conditionnelles

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

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

Les composants de l’interruption fonctionnelle sont les suivants :

  • Function : effectuez votre sélection parmi plusieurs fonctions de calcul différentes.
  • Attribute : choisissez d’appliquer le filtrage par n’importe quel attribut de réseau.
  • Operator : choisissez un nombre de différents opérateurs.
  • Value : définissez une valeur spécifique du type d’attribut en entrée susceptible, si découverte, d’entraîner l’arrêt.
  • Use Local Values : calculez les valeurs dans chaque sens par opposition à une valeur globale générale. Par exemple, une interruption de fonction calcule la somme de Shape length dans laquelle le traçage s’arrête si la valeur est supérieure ou égale à 4. Dans le cas 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. Si les valeurs locales sont utilisées, les valeurs locales le long de chaque chemin changent de sorte que la recherche de parcours continue.

  • TRUELes valeurs locales sont utilisées.
  • FALSELes valeurs globales sont utilisées. Il s’agit de l’option par défaut.

Les valeurs possibles pour les options function d’interruption de fonction sont les suivantes :

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

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

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

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

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

Spécifie le type de traversabilité qui sera appliqué. La portée de traversabilité détermine si la traversabilité est appliquée aux jonctions, aux tronçons, ou aux deux. Par exemple, si une interruption conditionnelle est définie pour arrêter le traçage lorsque DEVICESTATUS est défini sur Open et que la portée de traversabilité est définie sur les tronçons uniquement, le traçage ne s’arrêtera pas même si un dispositif ouvert est détecté, car DEVICESTATUS s’applique uniquement aux jonctions. En d’autres termes, ce paramètre indique au traçage d’ignorer ou pas : les jonctions, tronçons, ou les deux à la fois.

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

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

Les composants de propagateurs sont les suivants :

  • Attribute : procédez à un filtrage en fonction d’un attribut de réseau défini dans le système.
  • Substitution Attribute : utilisez une valeur substituée au lieu de valeurs attributaires de réseau bitset. Les substitutions sont encodées selon le nombre de bits dans l'attribut de réseau en cours de propagation. Une substitution est un appariement de chaque bit en phase avec un autre bit. Par exemple, pour la phase AC, une substitution peut apparier le bit A au bit B et le bit C à la valeur nulle. Dans cet exemple, la substitution pour 1010 (Phase AC) est 0000-0010-0000-0000 (512). La substitution capture l’appariement ; vous savez ainsi que la phase A est appariée à B et que la phase C est appariée à la valeur nulle et non l’inverse (c’est-à-dire que la phase A n’est pas appariée à la valeur nulle et la phase C n’est pas appariée à B).
  • Function : choisissez l’une des fonctions de calcul.
  • Operator : choisissez l’un des opérateurs.
  • 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.

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

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

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

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

Sortie obtenue

NomExplicationType de données
out_utility_network

Réseau de distribution mis à jour.

Utility Network

Exemple de code

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

Mettez à jour un sous-réseau spécifique nommé RMT004.

import arcpy
arcpy.un.UpdateSubnetwork("Utility Network", "ElectricDistribution", 
                          "Medium Voltage", "SPECIFIC_SUBNETWORK", "RMT004", 
                          "CONTINUE_ON_FAILURE")
Exemple 2 d’utilisation de l’outil UpdateSubnetwork (fenêtre Python)

Mettez à jour tous les sous-réseaux figurant dans le niveau Medium Voltage.

import arcpy
arcpy.un.UpdateSubnetwork("Utility Network", "ElectricDistribution", 
                          "Medium Voltage", "ALL")

Environnements

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

Informations de licence

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

Rubriques connexes