Ajouter un niveau (Utility Network)

Résumé

Crée un niveau pour un réseau de domaine dans un réseau de distribution.

Les niveaux sont des ensembles de sous-réseaux qui partagent le même niveau, des restrictions en matière de noms et une topologie identiques. Les niveaux sont obligatoires dans le cadre de la gestion de sous-réseaux.

Utilisation

• Un champ de nom de sous-réseau est ajouté pour les réseaux de domaines avec une définition d’un niveau partitionné pour le premier niveau ajouté au réseau de domaine. Pour les réseaux de domaines ayant une définition de niveau hiérarchique, un nom de champ de sous-réseau est créé avec la valeur de paramètre Subnetwork Field Name (Nom du champ de sous-réseau). Pour en savoir plus, reportez-vous à la rubrique Subnetwork name (Nom de sous-réseau).

• Pour les réseaux de domaines ayant une définition de niveau hiérarchique, le paramètre Tier Group Name (Nom du groupe de niveaux) est obligatoire. Des groupes de niveaux peuvent être créés pour les réseaux de domaines avec une définition de niveau hiérarchique à l’aide de l’outil Ajouter un groupe de niveaux.

• Des niveaux doivent être ajoutés avant de modifier les données dans les classes d’entités du réseau de distribution. Si les données sont ajoutées avant l’ajout d’un nouveau niveau, une erreur se produit.

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

• 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’une connexion à une base de données établie en tant que propriétaire du réseau de distribution de la base de données.
  • Le compte connecté au portail ArcGIS Enterprise doit être celui du propriétaire du réseau technique.
  • Lors de son exécution, cet outil doit être connecté à la version par défaut.

Syntaxe

arcpy.un.AddTier(in_utility_network, domain_network, name, rank, {topology_type}, {tier_group_name}, {subnetwork_field_name})

Paramètre	Explication	Type de données
in_utility_network	Réseau de distribution contenant le réseau de domaine auquel le niveau sera ajouté.	Utility Network; Utility Network Layer
domain_network	Réseau de domaine dans lequel le niveau sera créé.	String
name	Nom du nouveau niveau. Le nom doit être unique dans tout le réseau de distribution.	String
rank	Classement du niveau en cours d’ajout. Le classement le plus élevé est le numéro 1.	Long
topology_type (Facultatif)	Spécifie le type de topologie du nouveau niveau. Les sous-réseaux présentant des types de topologie radiale et de maillage prennent en charge un ou plusieurs contrôleurs de sous-réseau. Ce paramètre est désactivé dans la boîte de dialogue de l’outil si le réseau de domaine en entrée a été créé avec une définition de niveau hiérarchique et que le type de topologie est par défaut le type maillage. Si le réseau de domaine a été créé avec une définition de niveau hiérarchique, le type de topologie par défaut est MESH. Si le réseau de domaine a été créé avec une définition de niveau partitionnée, le type de topologie est obligatoire. Remarque : Pour la gestion des traçages ou des sous-réseau, ce paramètre ne fait actuellement aucune différence en termes de comportement. La fonctionnalité de ce paramètre est en cours de développement et sera applicable dans une prochaine publication. RADIAL —Les sous-réseaux présenteront un type de topologie radiale. MESH —Les sous-réseaux présenteront un type de topologie de maillage. Il s’agit du type de topologie par défaut pour un niveau créé à l’aide d’une définition de niveau hiérarchique.	String
tier_group_name (Facultatif)	Groupe de niveaux existant dans lequel le nouveau niveau sera ajouté. Ce paramètre est obligatoire pour les réseaux de domaines présentant une définition de niveau hiérarchique..	String
subnetwork_field_name (Facultatif)	Nom du champ dans lequel seront stockés les noms de sous-réseau pour ce niveau. Il s’agit d’un champ maintenu par le système qui est créé la première fois qu’un niveau est ajouté à un groupe de niveaux et réutilisé pour chaque niveau ajouté. Par exemple, vous avez deux groupes niveaux : Distribution et Transmission. Lorsque vous ajoutez un niveau dénommé système au groupe Distribution et précisez que le champ du sous-réseau est systemsubnet, le champ est créé. Puis, ajoutez un second niveau dénommé système au groupe Transmission. Ce paramètre détecte si le champ systemsubnet doit être utilisé comme nom du champ de sous-réseau. Ce paramètre est obligatoire pour les types de niveaux hiérarchiques.	String

Sortie dérivée

Nom	Explication	Type de données
out_utility_network	Réseau technique actualisé.	Utility Network

Exemple de code

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

Créez un niveau dans un réseau hiérarchique nommé DistributionSystem dont le type de topologie est MESH.

import arcpy
arcpy.AddTier_un("Utility Network", "GasDistribution", "Distribution System", 
                 1, "MESH", "Distribution", "System")

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

Créez un niveau dans un réseau partitionné nommé MediumVoltage dont le type de topologie est RADIAL.

import arcpy
arcpy.AddTier_un("Utility Network", "ElectricDistribution", "Medium Voltage", 
                 1, "RADIAL")

Environnements

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

Informations de licence

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