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 de red 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 una entidad de red se establezca como contenedor o estructura utilizando asociaciones, es necesario establecer primero un rol de asociación. 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. Consulte Tareas de administración de red de servicios para ver más 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.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Red de servicios de entrada	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
Red de dominio	La red de dominio que contiene el tipo de activo con el rol de asociación que se desea definir.	String
Tabla de entrada	La clase de entidad o tabla de red de servicios donde se definirá el rol de asociación.	String
Grupo de activos	El grupo de activos que contiene el tipo de activo.	String
Tipo de activo	El tipo de activo para el que se definirá el rol de asociación.	String
Tipo de rol	Especifica el tipo de rol de asociación que se desea asignar al tipo de activo. Contenedor—Las entidades u objetos de este tipo de activo pueden contener otras entidades y objetos como contenido. Estructura—Las entidades u objetos de este tipo de activo pueden tener otras entidades u objetos adjuntos a ellos. Nada—No se asignará ningún tipo de rol. Se trata de entidades u objetos que no son un contenedor ni estructura, sino que se conectan a otras estructuras.	String
Semántica de eliminación	Especifica la semántica de eliminación de las entidades, que es como se manejarán las entidades secundarias cuando se elimina la entidad principal. Esto se aplica a los roles de asociación de contenedor y de estructura. Cascada—Cuando se elimina un contenedor o estructura principal, se eliminan todas las entidades de red de adjuntos o contenido. Establecer como ninguna—Cuando se elimina un contenedor o una estructura, sus objetos y entidades de contenido o de adjuntos no se eliminarán. En su lugar, se eliminará de la asociación de contención o adjunto estructural. Restringido—Si existen objetos o entidades de contenido o de adjuntos, se devolverá un error cuando intente eliminar el contenedor o la estructura. Los objetos o las entidades de contenido o de adjuntos se deben quitar antes de eliminar el contenedor o la estructura.	String
Ver escala (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. Esta propiedad no se aplica a los objetos de cruce y eje.	Double
Dividir contenido (Opcional)	Especifica si el contenido asociado de un contenedor se dividirá si la entidad de contenedor se divide. Este parámetro solo está disponible si el rol de asociación es contenedor y solo es aplicable a entidades de línea. Activado: el contenido del contenedor se dividirá 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. Desactivado: el contenido del contenedor no se dividirá 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

Etiqueta	Explicación	Tipo de datos
Red de servicios actualizada	La red de servicios actualizada.	Utility Network

Python

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

Nombre	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 u objetos de este tipo de activo pueden contener otras entidades y objetos como contenido. STRUCTURE—Las entidades u objetos de este tipo de activo pueden tener otras entidades u objetos adjuntos a ellos. NONE—No se asignará ningún tipo de rol. Se trata de entidades u objetos que no son un contenedor ni estructura, sino que se conectan a otras estructuras.	String
association_deletion_semantics	Especifica la semántica de eliminación de las entidades, que es como se manejarán 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 o estructura principal, se eliminan todas las entidades de red de adjuntos o contenido. SET_TO_NONE—Cuando se elimina un contenedor o una estructura, sus objetos y entidades de contenido o de adjuntos no se eliminarán. En su lugar, se eliminará de la asociación de contención o adjunto estructural. RESTRICTED—Si existen objetos o entidades de contenido o de adjuntos, se devolverá un error cuando intente eliminar el contenedor o la estructura. Los objetos o las entidades de contenido o de adjuntos se deben quitar 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. Esta propiedad no se aplica a los objetos de cruce y eje.	Double
split_content (Opcional)	Especifica si el contenido asociado de un contenedor se dividirá si la entidad de contenedor se divide. Este parámetro solo está disponible si el rol de asociación es contenedor y solo es aplicable a entidades de línea. SPLIT—El contenido del contenedor se dividirá 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—El contenido del contenedor no se dividirá 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.	Utility Network

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í