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

Résumé

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 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 soient définies comme conteneurs ou structures à 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 technique.

• 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.

Syntaxe

SetAssociationRole(in_utility_network, domain_network, featureclass, assetgroup, assettype, association_role_type, association_deletion_semantics, {view_scale}, {split_content})

Paramètre	Explication	Type 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. CONTAINER —Les entités de ce type de ressource peuvent contenir d’autres entités comme contenu. STRUCTURE —Les entités de ce type de ressource peuvent comporter d’autres entités comme contenu. NONE —Aucun type de rôle. Il s’agit des entités qui ne sont ni un container 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 ; comment les entités enfant sont gérés lorsque l’entité parent est supprimée. Cela s’applique à la fois aux rôles d’association de conteneur et de structure. CASCADE —Lorsque le conteneur ou la structure parent sont supprimés, toutes les entités de dépendance ou de contenu sont supprimées. SET_TO_NONE — En cas de suppression d’un conteneur ou d’une structure, ses entités de dépendance ou de contenu ne sont pas supprimées. Elles sont en revanche retirées de l’association de dépendance structurelle ou de contenu. RESTRICTED — S’il existe des entités de dépendance ou de contenu, la tentative de suppression du conteneur ou de la structure renvoie une erreur. Les entités de dépendance ou de contenu doivent être supprimés avant la suppression du conteneur ou de la structure.	String
view_scale (Facultatif)	Échelle à laquelle saisir le mode d’inclusion 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.	Double
split_content (Facultatif)	Indique ce qu’il arrive au contenu associé d’un container si l’entité de container 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. SPLIT —Fractionne le contenu du container en cas de fractionnement de l’entité de container. 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_SPLIT —Ne fractionne pas le contenu du container en cas de fractionnement de l’entité de container. 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 dérivée

Nom	Explication	Type de données
out_utility_network	Réseau technique actualisé.	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