Définir le rôle d'association (Utility Network)

Synthèse

Modifie le rôle d’association assigné à une classe d’entités de réseau ou table au niveau du type de ressource.

Les rôles d’association définissent la façon dont certaines entités de réseau participent à un réseau de distribution. Un réseau de distribution a des rôles d'association fournis par le système existant pour les structures et les conteneurs. Pour que les entités de réseau soient définies comme un conteneur ou une structure à l’aide des associations, il est nécessaire de définir tout d’abord un rôle d’association. Il est affecté au niveau de la classe d’entités ou de la table pour les groupe de ressources et les types de ressource spécifiques.

En savoir plus sur la définition ou la modification de l’affectation d’un rôle d’association

Utilisation

  • L’échelle d’affichage et la sémantique de suppression pour un rôle de type de ressource peuvent être définies ou mises à jour avec cet outil.

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

  • L’annulation de l’attribution des rôles d’association de conteneur ou de structure ne peut être effectuée qu’avant la première activation de la topologie de réseau. Pour obtenir d’autres exemples et connaître leur état de topologie de réseau requis, reportez-vous à la rubrique Tâches de gestion du réseau de distribution.

  • Si une géodatabase d’entreprise est utilisée, le compte de portail ArcGIS Enterprise connecté doit correspondre au propriétaire du propriétaire du réseau technique du portail.

  • Si une géodatabase d’entreprise est utilisée, le paramètre Input Utility Network (Réseau technique en entrée) doit provenir d’une connexion de base de données établie en tant que propriétaire du réseau technique de la base de données.

Paramètres

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

Réseau de distribution qui contient le type de ressources pour lequel un rôle d'association est à définir.

Utility Network; Utility Network Layer
Réseau de domaine

Réseau de domaine qui contient le type de ressources pour lequel un rôle d'association est à définir.

String
Table en entrée

Classe ou table d’entités de réseau de distribution dans laquelle le rôle d’association sera défini.

String
Groupe de ressources

Groupe de ressources qui contient le type de ressources.

String
Type de ressources

Type de ressource pour lequel le rôle d’association sera défini.

String
Type de rôle

Spécifie le type de rôle d’association à attribuer au type de ressource.

  • ConteneurLes entités ou objets de ce type de ressource peuvent contenir d’autres entités ou objets comme contenu.
  • StructureLes entités ou objets de ce type de ressource peuvent être rattachées à d’autres entités ou objets.
  • AucunAucun type de rôle n’est attribué. Il s’agit des entités ou objets qui ne sont ni un conteneur ni une structure, mais qui sont connectées aux autres structures.
String
Sémantique de suppression

Spécifie la sémantique de suppression pour les entités, c’est-à-dire la manière dont les entités enfant sont gérées lorsque l’entité parent est supprimée. Cela s’applique à la fois aux rôles d’association de conteneur et de structure.

  • CascadeLors de la suppression du conteneur ou de la structure parent, l’ensemble du contenu ou les entités de réseau de dépendance sont supprimés.
  • Défini sur aucunEn cas de suppression d’un conteneur ou d’une structure, son contenu ou ses entités de dépendance et objets ne sont pas supprimés. En revanche, ces éléments sont éliminés de l’association de dépendance structurelle ou d’inclusion.
  • RestreintS’il existe un contenu, des entités de dépendance ou des objets, la tentative de suppression du conteneur ou de la structure renvoie une erreur. Le contenu, les entités de dépendance et les objets doivent être supprimés avant la suppression du conteneur ou de la structure.
String
Afficher l’échelle
(Facultatif)

Échelle à laquelle le mode d’inclusion sera saisi pour mettre à jour les entités contribuant au conteneur. Par exemple, le fait de définir l’échelle d’affichage sur 5 signifie que lorsque vous passez au mode inclusion de l’entité du container, l’échelle est de 1:5. Les unités sont basées sur les unités du réseau de distribution qui se trouvent sur l’onglet Source des propriétés de la couche de réseau de distribution. Cette propriété ne s’applique pas aux objets de jonction et de tronçon.

Double
Fractionner le contenu
(Facultatif)

Spécifie si le contenu associé d’un conteneur est réparti si l’entité de conteneur est fractionnée. Ce paramètre n’est disponible que si le rôle d’association est le rôle de conteneur et ne s’applique qu’aux entités linéaires.

  • Activé : le contenu du container est réparti en cas de fractionnement de l’entité de conteneur. Si une entité linéaire de contenu parallèle est trouvée, le contenu est également fractionné et chaque section est incluse dans l’entité de container la plus proche. Si la ligne de contenu n’est pas parallèle, le contenu est inclus dans l’entité de container la plus proche.
  • Désactivé : le contenu du conteneur n’est pas réparti en cas de fractionnement de l’entité de conteneur. Si une entité linéaire de contenu parallèle est trouvée, le contenu est inclus dans les deux sections de l’entité de container. Si la ligne de contenu n’est pas parallèle, le contenu est inclus dans l’entité de container la plus proche. Il s’agit de l’option par défaut.

Boolean

Sortie obtenue

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

Réseau de distribution mis à jour.

Utility Network

arcpy.un.SetAssociationRole(in_utility_network, domain_network, featureclass, assetgroup, assettype, association_role_type, association_deletion_semantics, {view_scale}, {split_content})
NomExplicationType de données
in_utility_network

Réseau de distribution qui contient le type de ressources pour lequel un rôle d'association est à définir.

Utility Network; Utility Network Layer
domain_network

Réseau de domaine qui contient le type de ressources pour lequel un rôle d'association est à définir.

String
featureclass

Classe ou table d’entités de réseau de distribution dans laquelle le rôle d’association sera défini.

String
assetgroup

Groupe de ressources qui contient le type de ressources.

String
assettype

Type de ressource pour lequel le rôle d’association sera défini.

String
association_role_type

Spécifie le type de rôle d’association à attribuer au type de ressource.

  • CONTAINERLes entités ou objets de ce type de ressource peuvent contenir d’autres entités ou objets comme contenu.
  • STRUCTURELes entités ou objets de ce type de ressource peuvent être rattachées à d’autres entités ou objets.
  • NONEAucun type de rôle n’est attribué. Il s’agit des entités ou objets qui ne sont ni un conteneur ni une structure, mais qui sont connectées aux autres structures.
String
association_deletion_semantics

Spécifie la sémantique de suppression pour les entités, c’est-à-dire la manière dont les entités enfant sont gérées lorsque l’entité parent est supprimée. Cela s’applique à la fois aux rôles d’association de conteneur et de structure.

  • CASCADELors de la suppression du conteneur ou de la structure parent, l’ensemble du contenu ou les entités de réseau de dépendance sont supprimés.
  • SET_TO_NONEEn cas de suppression d’un conteneur ou d’une structure, son contenu ou ses entités de dépendance et objets ne sont pas supprimés. En revanche, ces éléments sont éliminés de l’association de dépendance structurelle ou d’inclusion.
  • RESTRICTEDS’il existe un contenu, des entités de dépendance ou des objets, la tentative de suppression du conteneur ou de la structure renvoie une erreur. Le contenu, les entités de dépendance et les objets doivent être supprimés avant la suppression du conteneur ou de la structure.
String
view_scale
(Facultatif)

Échelle à laquelle le mode d’inclusion sera saisi pour mettre à jour les entités contribuant au conteneur. Par exemple, le fait de définir l’échelle d’affichage sur 5 signifie que lorsque vous passez au mode inclusion de l’entité du container, l’échelle est de 1:5. Les unités sont basées sur les unités du réseau de distribution qui se trouvent sur l’onglet Source des propriétés de la couche de réseau de distribution. Cette propriété ne s’applique pas aux objets de jonction et de tronçon.

Double
split_content
(Facultatif)

Spécifie si le contenu associé d’un conteneur est réparti si l’entité de conteneur est fractionnée. Ce paramètre n’est disponible que si le rôle d’association est le rôle de conteneur et ne s’applique qu’aux entités linéaires.

  • SPLITLe contenu du conteneur est réparti en cas de fractionnement de l’entité de conteneur. Si une entité linéaire de contenu parallèle est trouvée, le contenu est également fractionné et chaque section est incluse dans l’entité de container la plus proche. Si la ligne de contenu n’est pas parallèle, le contenu est inclus dans l’entité de container la plus proche.
  • DO_NOT_SPLITLe contenu du conteneur n’est pas réparti en cas de fractionnement de l’entité de conteneur. Si une entité linéaire de contenu parallèle est trouvée, le contenu est inclus dans les deux sections de l’entité de container. Si la ligne de contenu n’est pas parallèle, le contenu est inclus dans l’entité de container la plus proche. Il s’agit de l’option par défaut.
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 l’outil SetAssociationRole (fenêtre Python)

Définissez le rôle d’association du container pour le type de ressources transformer (transformateur). L’échelle d’affichage a été définie sur 10 et la sémantique de suppression est restreinte.

import arcpy
arcpy.SetAssociationRole_un("Utility Network", "ElectricDistribution", 
                            "ElectricDistributionAssembly", "Transformer Bank", 
                            "Transformer", "CONTAINER", "RESTRICTED", 10)

Environnements

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

Informations de licence

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

Rubriques connexes