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é à la classe d’entités ou au niveau de l’objet pour les groupes 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 à celui du propriétaire du réseau de distribution du portail.

  • Si une géodatabase d’entreprise est utilisée, le paramètre Input Utility Network (Réseau de distribution en entrée) doit provenir d’une connexion à une base de données établie en qualité de propriétaire du réseau de distribution 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 ressource

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 qui sera attribué au type de ressource.

  • ConteneurLe type de rôle d’association de conteneur qui sera attribué. Les entités ou objets de ce type de rôle peuvent contenir d’autres entités et objets comme contenu.
  • StructureLe type de rôle d’association de structure qui sera attribué. Les entités ou objets de ce type de rôle 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 réseau, ce qui détermine comment les entités de réseau de dépendance ou de contenu seront gérées lors de la suppression du conteneur ou de la structure. 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, l’ensemble des entités de réseau de dépendance ou de contenu seront supprimées.
  • Défini sur aucunEn cas de suppression d’un conteneur ou d’une structure, ses entités de réseau de dépendance ou de contenu ne sont pas supprimées, mais elles sont retirées de l’association de dépendance structurelle ou de contenu.
  • RestreintS’il existe des entités de réseau de dépendance ou de contenu, la tentative de suppression du conteneur ou de la structure renvoie une erreur. Les entités de réseau de dépendance ou de contenu doivent être supprimées 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. Ce paramètre 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 actif 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 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. Lorsque le contenu est un objet de jonction non spatial, le contenu est dupliqué de sorte que chaque entité de conteneur possède un objet de jonction comme contenu. Lorsque le contenu est un objet de tronçon non spatial, le contenu est fractionné de sorte que chaque entité de conteneur possède un objet de tronçon comme contenu.
  • 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. Lorsque vous utilisez un contenu d’objet de jonction non spatial, le contenu est englobé par le conteneur le plus grand. Lorsque vous utilisez un contenu d’objet de tronçon non spatial, le contenu est conservé en tant que contenu dans les deux conteneurs parents. 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 qui sera attribué au type de ressource.

  • CONTAINERLe type de rôle d’association de conteneur qui sera attribué. Les entités ou objets de ce type de rôle peuvent contenir d’autres entités et objets comme contenu.
  • STRUCTURELe type de rôle d’association de structure qui sera attribué. Les entités ou objets de ce type de rôle 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 réseau, ce qui détermine comment les entités de réseau de dépendance ou de contenu seront gérées lors de la suppression du conteneur ou de la structure. 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, l’ensemble des entités de réseau de dépendance ou de contenu seront supprimées.
  • SET_TO_NONEEn cas de suppression d’un conteneur ou d’une structure, ses entités de réseau de dépendance ou de contenu ne sont pas supprimées, mais elles sont retirées de l’association de dépendance structurelle ou de contenu.
  • RESTRICTEDS’il existe des entités de réseau de dépendance ou de contenu, la tentative de suppression du conteneur ou de la structure renvoie une erreur. Les entités de réseau de dépendance ou de contenu doivent être supprimées 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. Ce paramètre 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 activé 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. Lorsque le contenu est un objet de jonction non spatial, le contenu est dupliqué de sorte que chaque entité de conteneur possède un objet de jonction comme contenu. Lorsque le contenu est un objet de tronçon non spatial, le contenu est fractionné de sorte que chaque entité de conteneur possède un objet de tronçon comme contenu.
  • 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. Lorsque vous utilisez un contenu d’objet de jonction non spatial, le contenu est englobé par le conteneur le plus grand. Lorsque vous utilisez un contenu d’objet de tronçon non spatial, le contenu est conservé en tant que contenu dans les deux conteneurs parents. 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.un.SetAssociationRole("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