Exporter un sous-réseau (Utility Network)

Synthèse

Exporte des sous-réseaux à partir d’un réseau de distribution dans un fichier .json. Cet outil permet également de supprimer une ligne de la table Subnetworks (Sous-réseaux) tant que l’attribut Is deleted est défini sur True (Vrai). Cela indique que le contrôleur de sous-réseau a été supprimé du sous-réseau.

Remarque :

À partir d’ArcGIS Enterprise 10.9.1, l’opération d’exportation d’un sous-réseau est traitée de manière asynchrone à l’aide du service de géotraitement UtilityNetworkTools lorsqu’un réseau de distribution est utilisé dans une géodatabase d’entreprise. Le service UtilityNetworkTools est préconfiguré dans le dossier System des services d’entités qui incluent un réseau de distribution. Il possède un paramètre de délai d’expiration plus long et est réservé aux tâches de géotraitement sur les réseaux de distribution.

En savoir plus sur l’exportation des sous-réseaux

Utilisation

  • Les sous-réseaux doivent être validés pour pouvoir être exportés ; exécutez l’outil Mettre à jour un sous-réseau au préalable.

  • Les paramètres de la catégorie Trace Parameters ne peuvent être utilisés que dans Python.

  • Si une géodatabase d’entreprise est utilisée, les conditions suivantes doivent être remplies :
    • La valeur du paramètre Input Utility Network (Réseau de distribution en entrée) doit provenir d’un service de réseau de distribution.
    • Licence :
      Une licence doit être affectée au compte de portail actif avec l’extension de type d’utilisateur ArcGIS Advanced Editing pour que cet outil puisse être utilisé dans un déploiement d’entreprise.
  • Lorsque le paramètre Confirmation de la définition de l’exportation est activé, les conditions suivantes doivent être satisfaites :

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

    • Les géodatabases d’entreprise présentent les exigences supplémentaires suivantes :
      • Cet outil doit être connecté à la version par défaut pour pouvoir être exécuté.
        • Aucune autre session connectée à la version par défaut ne pourra exécuter d’opérations de validation ou d’activation au cours de l’opération d’activation.
      • Le compte de portail ArcGIS Enterprise connecté doit correspondre à celui du propriétaire du réseau de distribution du portail.

  • Dans ArcGIS Pro 2.3, les paramètres suivants ont été ajoutés : Inclure la géométrie, Type de résultat, Attributs de réseau générés et Champ de résultats. Lorsque ces paramètres sont utilisés, le format de fichier JSON en sortie varie. Ces paramètres requièrent ArcGIS Enterprise 10.7 ou version ultérieure lorsqu’ils sont utilisés avec une géodatabase d’entreprise. Vérifiez la syntaxe de la réponse JSON en sortie.

Paramètres

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

Réseau de distribution contenant le sous-réseau à exporter.

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
Nom de sous-réseau

Nom du sous-réseau à exporter du tier. Sélectionnez une source spécifique pour exporter les informations relatives au sous-réseau. 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
Confirmation de la définition de l'exportation

Indique si l’attribut LASTACKEXPORTSUBNETWORK du contrôleur correspondant dans la table Sous-réseaux et l’entité dans la classe d’entités SubnetLine sera actualisé.

  • Activé : l’attribut LASTACKEXPORTSUBNETWORK du contrôleur correspondant dans la table Sous-réseaux sera actualisé. Si le contrôleur est marqué pour suppression (Is deleted = True), il sera supprimé de la table Subnetworks (Sous-réseaux). Cette option nécessite que le réseau de distribution en entrée référence la version par défaut.
  • Désactivé : l’attribut LASTACKEXPORTSUBNETWORK du contrôleur correspondant dans la table Sous-réseaux ne sera pas actualisé. Il s’agit de l’option par défaut.

Boolean
JSON en sortie

Nom et emplacement du fichier .json qui sera généré.

File
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 la capacité à être traversé détermine si la capacité à être traversé est appliquée aux jonctions, tronçons, ou aux deux. Si, par exemple, une interruption conditionnelle est définie pour arrêter la trace lorsque DEVICESTATUS est défini sur Open avec la portée de traversabilité réglée sur les tronçons uniquement, alors la trace ne s’interrompt pas même si elle détecte un dispositif ouvert. En effet, DEVICESTATUS ne s’applique qu’aux jonctions. En d'autres termes, ce paramètre indique au traçage d'ignorer ou pas : les jonctions, tronçons, ou les deux à la fois.

  • Jonctions et tronçonsLa capacité à être traversé s’applique aux jonctions et aux tronçons.
  • 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
Inclure la géométrie
(Facultatif)

Indique si la géométrie figure dans les résultats.

  • Activé : la géométrie est incluse dans les résultats.
  • Désactivé : la géométrie n’est pas incluse dans les résultats. Il s’agit de l’option par défaut.

Remarque :

Pour les géodatabases d’entreprise, ce paramètre nécessite ArcGIS Enterprise 10.7 ou version ultérieure.

Boolean
Type de résultat
(Facultatif)

Indique les types de résultat possibles renvoyés.

  • ConnectivitéLes entités qui sont connectées par coïncidence géométrique ou par des associations de connectivité seront renvoyées. Il s’agit de l’option par défaut.
  • EntitésLes informations au niveau des entités seront renvoyées.
  • Associations d’inclusion et de dépendanceLes entités qui sont associées par des associations d’inclusion et de dépendances structurelles seront renvoyées.
Remarque :

Pour les géodatabases d’entreprise, ce paramètre nécessite ArcGIS Enterprise 10.7 ou version ultérieure.

L’option d’associations d’inclusion et de dépendance nécessite ArcGIS Enterprise 10.8.1 ou version ultérieure.

String
Attributs de réseau générés
(Facultatif)

Attributs de réseau à inclure dans les résultats.

Remarque :

Pour les géodatabases d’entreprise, ce paramètre nécessite ArcGIS Enterprise 10.7 ou version ultérieure.

String
Champ de résultats
(Facultatif)

Champs d’une classe d’entités qui seront renvoyés comme résultats. Les valeurs du champ seront renvoyées dans les résultats pour les entités du sous-réseau.

Remarque :

Pour les géodatabases d’entreprise, ce paramètre nécessite ArcGIS Enterprise 10.7 ou version ultérieure.

Value Table
Inclure des descriptions de domaine
(Facultatif)

Spécifie si les descriptions de domaine sont incluses dans le fichier .json en sortie pour communiquer la cartographie de domaine des contrôleurs, les éléments d’entités, la connectivité et les associations.

  • Activé : les descriptions de domaine sont incluses dans les résultats.
  • Désactivée : les descriptions de domaine ne sont pas incluses dans les résultats. Il s’agit de l’option par défaut.

Remarque :

Pour les géodatabases d’entreprise, ce paramètre nécessite ArcGIS Enterprise 10.9.1 ou version ultérieure.

Boolean

Sortie obtenue

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

Réseau de distribution mis à jour.

Utility Network

arcpy.un.ExportSubnetwork(in_utility_network, domain_network, tier, subnetwork_name, export_acknowledged, out_json_file, {condition_barriers}, {function_barriers}, {include_barriers}, {traversability_scope}, {propagators}, {include_geometry}, {result_types}, {result_network_attributes}, {result_fields}, {include_domain_descriptions})
NomExplicationType de données
in_utility_network

Réseau de distribution contenant le sous-réseau à exporter.

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
subnetwork_name

Nom du sous-réseau à exporter du tier. Sélectionnez une source spécifique pour exporter les informations relatives au sous-réseau.

String
export_acknowledged

Indique si l’attribut LASTACKEXPORTSUBNETWORK du contrôleur correspondant dans la table Sous-réseaux et l’entité dans la classe d’entités SubnetLine sera actualisé.

  • ACKNOWLEDGEL’attribut LASTACKEXPORTSUBNETWORK du contrôleur correspondant dans la table Sous-réseaux sera actualisé. Si la source est marquée pour suppression (Is deleted = True), elle sera supprimée de la table Subnetworks (Sous-réseaux). Cette option nécessite que le réseau de distribution en entrée référence la version par défaut.
  • NO_ACKNOWLEDGEL’attribut LASTACKEXPORTSUBNETWORK du contrôleur correspondant dans la table Sous-réseaux sera actualisé. Il s’agit de l’option par défaut.
Boolean
out_json_file

Nom et emplacement du fichier .json qui sera généré.

File
condition_barriers
[[Name, Operator, Type, Value, Combine Using],...]
(Facultatif)

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

Les composants de l'interruption conditionnelle sont les suivants :

  • Name : filtrez par n’importe quel attribut de réseau défini dans le système.
  • Operator : choisissez un 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 dans laquelle tous les bits de la valeur sont présents dans l'attribut (Et bit à bit == valeur).
  • DOES_NOT_INCLUDE_THE_VALUESOpération Et bit à bit dans laquelle tous les bits de la valeur ne sont pas présents dans l'attribut (Et bit à bit !== valeur).
  • INCLUDES_ANYOpération Et bit à bit dans laquelle au moins un bit de la valeur est présent dans l'attribut (Et bit à bit == Vrai).
  • DOES_NOT_INCLUDE_ANYOpération Et bit à bit dans laquelle aucun des bits de la valeur n'est présent dans l'attribut (Et bit à bit == Faux).

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 : filtrez par n’importe quel attribut de réseau défini dans le système.
  • 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 : calcule les valeurs dans chaque direction, par opposition à une valeur globale générale. Prenons, par exemple, une interruption de fonction qui calcule la somme de Shape length où la trace prend fin 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.

  • TRUEUtilisez les valeurs locales.
  • FALSEUtilisez les valeurs globales. 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 dans laquelle tous les bits de la valeur sont présents dans l'attribut (Et bit à bit == valeur).
  • DOES_NOT_INCLUDE_THE_VALUESOpération Et bit à bit dans laquelle tous les bits de la valeur ne sont pas présents dans l'attribut (Et bit à bit !== valeur).
  • INCLUDES_ANYOpération Et bit à bit dans laquelle au moins un bit de la valeur est présent dans l'attribut (Et bit à bit == Vrai).
  • DOES_NOT_INCLUDE_ANYOpération Et bit à bit dans laquelle aucun des bits de la valeur n'est présent dans l'attribut (Et bit à bit == Faux).
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 la capacité à être traversé détermine si la capacité à être traversé est appliquée aux jonctions, tronçons, ou aux deux. Si, par exemple, une interruption conditionnelle est définie pour arrêter la trace lorsque DEVICESTATUS est défini sur Open avec la portée de traversabilité réglée sur les tronçons uniquement, alors la trace ne s’interrompt pas même si elle détecte un dispositif ouvert. En effet, DEVICESTATUS ne s’applique qu’aux jonctions. En d'autres termes, ce paramètre indique au traçage d'ignorer ou pas : les jonctions, tronçons, ou les deux à la fois.

  • BOTH_JUNCTIONS_AND_EDGESLa capacité à être traversé s’applique aux jonctions et aux tronçons.
  • 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 valeurs possibles des propagateurs function 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 valeurs des propagateurs operator sont les suivantes :

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

Indique si la géométrie figure dans les résultats.

  • INCLUDE_GEOMETRYLa géométrie est incluse dans les résultats.
  • EXCLUDE_GEOMETRYLa géométrie n’est pas incluse dans les résultats. Il s’agit de l’option par défaut.
Remarque :

Pour les géodatabases d’entreprise, ce paramètre nécessite ArcGIS Enterprise 10.7 ou version ultérieure.

Boolean
result_types
[result_types,...]
(Facultatif)

Indique les types de résultat possibles renvoyés.

  • CONNECTIVITYLes entités qui sont connectées par coïncidence géométrique ou par des associations de connectivité seront renvoyées. Il s’agit de l’option par défaut.
  • FEATURESLes informations au niveau des entités seront renvoyées.
  • CONTAINMENT_AND_ATTACHMENT_ASSOCIATIONSLes entités qui sont associées par des associations d’inclusion et de dépendances structurelles seront renvoyées.
Remarque :

Pour les géodatabases d’entreprise, ce paramètre nécessite ArcGIS Enterprise 10.7 ou version ultérieure.

L’option d’associations d’inclusion et de dépendance nécessite ArcGIS Enterprise 10.8.1 ou version ultérieure.

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

Attributs de réseau à inclure dans les résultats.

Remarque :

Pour les géodatabases d’entreprise, ce paramètre nécessite ArcGIS Enterprise 10.7 ou version ultérieure.

String
result_fields
[[Feature Class, Field Name],...]
(Facultatif)

Champs d’une classe d’entités qui seront renvoyés comme résultats. Les valeurs du champ seront renvoyées dans les résultats pour les entités du sous-réseau.

Remarque :

Pour les géodatabases d’entreprise, ce paramètre nécessite ArcGIS Enterprise 10.7 ou version ultérieure.

Value Table
include_domain_descriptions
(Facultatif)

Spécifie si les descriptions de domaine sont incluses dans le fichier .json en sortie pour communiquer la cartographie de domaine des contrôleurs, les éléments d’entités, la connectivité et les associations.

  • INCLUDE_DOMAIN_DESCRIPTIONSLes descriptions de domaine sont incluses dans les résultats.
  • EXCLUDE_DOMAIN_DESCRIPTIONSLes descriptions de domaine ne sont pas incluses dans les résultats. Il s’agit de l’option par défaut.
Remarque :

Pour les géodatabases d’entreprise, ce paramètre nécessite ArcGIS Enterprise 10.9.1 ou version ultérieure.

Boolean

Sortie obtenue

NomExplicationType de données
out_utility_network

Réseau de distribution mis à jour.

Utility Network

Exemple de code

Exemple d’utilisation de la fonction ExportSubnetwork (fenêtre Python)

Exportez les informations du sous-réseau correspondant à une source nommée RMT002 vers un fichier .json avec les descriptions de domaine incluses.

import arcpy
arcpy.un.ExportSubnetwork("Utility Network", "ElectricDistribution", 
                          "Medium Voltage", "RMT002", "ACKNOWLEDGE", 
                          "C:\\Temp\\RMT002clean.json", None, None, 
                          "INCLUDE_BARRIERS", "BOTH_JUNCTIONS_AND_EDGES", 
                          None, "EXCLUDE_GEOMETRY", None, None, None, 
                          "INCLUDE_DOMAIN_DESCRIPTIONS")

Environnements

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

Informations de licence

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

Rubriques connexes