Definir rol de asociación (Red de servicios)

Resumen

Modifica el rol de asociación asignado a una tabla o clase de entidad de red en el nivel de tipo de activo.

Los roles de asociación definen cómo participan algunas entidades en una red de servicios. Una red de servicios cuenta con roles de asociación proporcionados por el sistema para estructuras y contenedores. Para que las entidades se establezcan como contenedores o estructuras utilizando asociaciones, es necesario establecer primero un rol de asociación de . Se asigna en el nivel de tabla o clase de entidad para grupos de activos y tipos de activos específicos.

Más información sobre cómo establecer o modificar una asignación de rol de asociación

Uso

• Esta herramienta permite definir o actualizar la semántica de escala de visualización y eliminación de un rol de tipo de activo.

• La topología de red debe estar desactivada.

• La anulación de la asignación de roles de asociación de contenedor o estructura solo se puede llevar a cabo antes de que la topología de red se habilite por primera vez. Revise Tareas de administración de red de servicios para ver otros ejemplos y su estado de topología de red requerido.

• Al trabajar con una geodatabase corporativa, la cuenta del portal de ArcGIS Enterprise conectada debe ser el propietario de la red de servicios del portal.

• Al trabajar con una geodatabase corporativa, la Red de servicios de entrada debe provenir de una conexión de base de datos establecida como propietaria de la red de servicios de la base de datos.

Sintaxis

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

Parámetro	Explicación	Tipo de datos
in_utility_network	La red de servicios que contiene el tipo de activo con el rol de asociación que se desea definir.	Utility Network; Utility Network Layer
domain_network	La red de dominio que contiene el tipo de activo con el rol de asociación que se desea definir.	String
featureclass	La clase de entidad o tabla de red de servicios donde se definirá el rol de asociación.	String
assetgroup	El grupo de activos que contiene el tipo de activo.	String
assettype	El tipo de activo para el que se definirá el rol de asociación.	String
association_role_type	Especifica el tipo de rol de asociación que se desea asignar al tipo de activo. CONTAINER —Las entidades de este tipo de activo pueden contener otras entidades como contenido. STRUCTURE —Las entidades de este tipo de activo pueden tener otras entidades adjuntadas. NONE —Ningún tipo de rol. Se trata de entidades que no son de contenedor ni estructura, sino que se conectan a otras estructuras.	String
association_deletion_semantics	Especifica la semántica de eliminación de las entidades; cómo se manejan las entidades secundarias cuando se elimina la entidad principal. Esto se aplica a los roles de asociación de contenedor y de estructura. CASCADE —Cuando se elimina un contenedor principal o una estructura, sus entidades de contenido o de adjuntos también se eliminan. SET_TO_NONE — Cuando se elimina un contenedor o una estructura, sus entidades de contenido o de adjuntos no se eliminan, sino que se elimina de la asociación de contención o adjunto estructural. RESTRICTED — Si existen entidades de contenido o de adjuntos, se devuelve un error cuando intenta eliminar el contenedor o la estructura. Las entidades de contenido o de adjuntos se deben eliminar antes de eliminar el contenedor o la estructura.	String
view_scale (Opcional)	La escala en la que se entra en el modo de contención para editar las entidades participantes en el contenedor. Por ejemplo, un cambio de la escala de visualización a 5 significa que, al entrar en el modo de contención de la entidad de contenedor, la escala será de 1:5. Las unidades se basan en las unidades de la red de servicios, que se encuentran en la pestaña Origen del panel de propiedades de la capa de red de servicios.	Double
split_content (Opcional)	Especifica qué pasa al contenido asociado de un contenedor si se divide la entidad de contenedor. Este parámetro solo está disponible si el rol de asociación es contenedor y solo es aplicable a entidades de línea. SPLIT —Divide el contenido del contenedor si la entidad de contenedor está dividida. Si se encuentra una entidad de línea con contenido paralelo, el contenido también se divide y la entidad de contenedor más cercana incluirá cada sección. Si la línea de contenido no es paralela, la entidad de contenedor más cercana incluirá el contenido. DO_NOT_SPLIT —No divide el contenido del contenedor si la entidad de contenedor está dividida. Si se encuentra una entidad de línea con contenido paralelo, ambas secciones de la entidad de contenedor incluirán el contenido. Si la línea de contenido no es paralela, la entidad de contenedor más cercana incluirá el contenido. Esta es la opción predeterminada.	Boolean

Salida derivada

Nombre	Explicación	Tipo de datos
out_utility_network	La red de servicios actualizada.	Red de servicios

Muestra de código

Ejemplo de SetAssociationRole (ventana de Python)

Definir el rol de asociación de contenedor para el tipo de activo "transformer". La escala de visualización se ha cambiado a 10 y la semántica de eliminación es Restringido.

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

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

• Basic: No
• Standard: Sí
• Advanced: Sí