Exporter un sous-réseau (Utility Network)

Synthèse

Exporte des sous-réseaux à partir d’un réseau technique 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.

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

Utilisation

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

  • Les paramètres de la catégorie Trace Parameters sont uniquement exécutables via 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.
  • Lorsque le paramètre Set export acknowledged (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 :
      • Lors de son exécution, cet outil doit être connecté à la version par défaut.
      • Le compte connecté au portail ArcGIS Enterprise doit être celui du propriétaire du réseau technique.

  • Dans ArcGIS Pro 2.3, les paramètres suivants ont été ajoutés : Include Geometry (Inclure la géométrie), Result Types (Type de résultat), Result Network Attributes (Attributs de réseau générés) et Result Fields (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. Sélectionnez une source spécifique pour exporter les informations relatives au sous-réseau.

String
Confirmation de la définition de l'exportation

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

  • Activé : actualise l’attribut LASTACKEXPORTSUBNETWORK du contrôleur correspondant dans la table Subnetworks (Sous-réseaux). 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é : n’actualise pas l’attribut LASTACKEXPORTSUBNETWORK du contrôleur correspondant dans la table Subnetworks (Sous-réseaux). Il s’agit de l’option par défaut.

Boolean
JSON en sortie

Nom et emplacement du fichier JSON à générer.

File
Interruptions conditionnelles
(Facultatif)
Value Table
Interruptions de fonctions
(Facultatif)
Value Table
Inclure les entités d’interruption
(Facultatif)
Boolean
Appliquer la traversabilité à
(Facultatif)
  • Jonctions et tronçonsAppliquez la traversabilité aux jonctions et aux tronçons.
  • Jonctions uniquementAppliquez la traversabilité aux jonctions uniquement.
  • Tronçons uniquementAppliquez la traversabilité aux tronçons uniquement.
String
Propagateurs
(Facultatif)
Value Table
Inclure la géométrie
(Facultatif)

Spécifie si la géométrie doit être incluse 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.

Boolean
Type de résultat
(Facultatif)

Spécifie le type de résultat à exporter.

  • ConnectivitéRenvoyez les entités qui sont connectées via la coïncidence géométrique ou des associations de connexion. Il s’agit de l’option par défaut.
  • CaractéristiquesRenvoyez des informations sur le niveau d’entité dans la réponse.
  • Associations d’inclusion et de dépendanceRenvoyez les entités qui sont associées via des associations d’inclusion et de dépendance structurelle.
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

Sortie obtenue

ÉtiquetteExplicationType de données
Réseau de distribution actualisé

Réseau technique actualisé.

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})
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. 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 Subnetworks (Sous-réseaux) et l’entité dans la classe d’entités SubnetLine est actualisé.

  • ACKNOWLEDGEActualise l’attribut LASTACKEXPORTSUBNETWORK du contrôleur correspondant dans la table Subnetworks (Sous-réseaux). 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_ACKNOWLEDGEN’actualise pas l’attribut LASTACKEXPORTSUBNETWORK du contrôleur correspondant dans la table Subnetworks (Sous-réseaux). Il s’agit de l’option par défaut.
Boolean
out_json_file

Nom et emplacement du fichier JSON à générer.

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 d’interruptions conditionnelles sont les suivants :

  • Name : Choisissez de filtrer par n’importe quel attribut 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 les combiner à l’aide d’une condition Et ou d’une condition Ou.

Les options d’interruption conditionnelles 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 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.
Remarque :

Ce paramètre est uniquement disponible via Python.

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 entre plusieurs fonctions de calcul différentes.
  • Attribute—Choisissez pour filtrer 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 : 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ù le parcours 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. Lorsque des valeurs locales sont utilisées, celles-ci changent le long de chaque chemin et le traçage va plus loin.

  • 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’interruptions de fonctions 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 traçages de boucles ne prennent pas en charge 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).
Remarque :

Ce paramètre est uniquement disponible via Python.

Value Table
include_barriers
(Facultatif)

Spécifie si les entités d’interruption de traversabilité 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.

  • INCLUDE_BARRIERSLes interruptions de traversabilité sont incluses dans les résultats de la recherche de parcours. Il s’agit de l’option par défaut.
  • EXCLUDE_BARRIERSLes interruptions de traversabilité ne sont pas incluses dans les résultats du traçage.
Remarque :

Ce paramètre est uniquement disponible via Python.

Boolean
traversability_scope
(Facultatif)

Spécifie le type de traversabilité à appliquer. La portée de traversabilité détermine si la traversabilité est appliquée aux jonctions, tronçons, ou aux deux. Si, par exemple, une interruption conditionnelle est définie pour arrêter le parcours lorsque DEVICESTATUS est défini sur Open avec la portée de traversabilité réglée sur les tronçons uniquement, alors le parcours ne s’interrompt pas même s’il 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 non les jonctions, les tronçons, voire les deux.

  • BOTH_JUNCTIONS_AND_EDGESAppliquez la traversabilité aux jonctions et aux tronçons.
  • JUNCTIONS_ONLYAppliquez la traversabilité aux jonctions uniquement.
  • EDGES_ONLYAppliquez la traversabilité aux tronçons uniquement.
Remarque :

Ce paramètre est uniquement disponible via Python.

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 : filtrez par 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 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 valeurs possibles pour les 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 operator du propagateur 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_INLCUDE_ANYOpération Et bit à bit où aucun des bits de la valeur n’est présent dans l’attribut (Et bit à bit == Faux).
Remarque :

Ce paramètre est uniquement disponible via Python.

Value Table
include_geometry
(Facultatif)

Spécifie si la géométrie doit être incluse 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)

Spécifie le type de résultat à exporter.

  • CONNECTIVITYRenvoyez les entités qui sont connectées via la coïncidence géométrique ou des associations de connexion. Il s’agit de l’option par défaut.
  • FEATURESRenvoyez des informations sur le niveau d’entité dans la réponse.
  • CONTAINMENT_AND_ATTACHMENT_ASSOCIATIONSRenvoyez les entités qui sont associées via des associations d’inclusion et de dépendance structurelle.
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

Sortie obtenue

NomExplicationType de données
out_utility_network

Réseau technique actualisé.

Utility Network

Exemple de code

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

Exportez les informations du sous-réseau correspondantes à une source nommée RMT002 vers un fichier JSON.

import arcpy
arcpy.ExportSubnetwork_un("Utility Network", "ElectricDistribution", 
                          "Medium Voltage", "RMT002", "ACKNOWLEDGE", 
                          "C:\\Temp\\RMT002clean.json")

Environnements

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

Informations de licence

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

Rubriques connexes