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 clase de entidad u objeto 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 propietaria de la red de servicios del portal.

• Al trabajar con una geodatabase corporativa, el valor del parámetro 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 asignará al tipo de activo. Contenedor—Se asignará el tipo de rol de asociación de contenedor. Las entidades u objetos de este tipo de rol pueden contener otras entidades y objetos como contenido. Estructura—Se asignará el tipo de rol de asociación de estructura. Las entidades u objetos de este tipo de rol pueden tener otras entidades u objetos adjuntos a ellos. Ninguna—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 de red, que define cómo se administrarán las entidades de red de contenido o de adjuntos cuando se elimine el contenedor o la estructura. Esto se aplica a los roles de asociación de contenedor y de estructura. Cascada—Cuando se elimina el contenedor o la estructura, se eliminan todas las entidades de red de adjuntos o contenido. Establecer como ninguna—Cuando se elimina un contenedor o una estructura, sus entidades de red de contenido o de adjuntos no se borran, sino que se eliminan de la asociación de contención o adjunto estructural. Restringido—Si existen entidades de red de contenido o de adjuntos, se devolverá un error al intentar eliminar el contenedor o la estructura. Las entidades de red de contenido o de adjuntos se deben eliminar 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. Este parámetro 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á activo 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. Cuando el contenido es un objeto de cruce no espacial, el contenido se duplica para que cada entidad contenedora tenga un objeto de cruce como contenido. Cuando el contenido es un objeto de eje no espacial, el contenido se divide de forma que cada entidad contenedora tenga un objeto de eje como 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. Cuando se trabaja con contenido de objetos de cruce no espaciales, el contenido será contenido por el contenedor mayor. Cuando se trabaja con contenido de objetos de eje no espaciales, el contenido se mantiene como contenido de ambos contenedores principales. 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 asignará al tipo de activo. CONTAINER—Se asignará el tipo de rol de asociación de contenedor. Las entidades u objetos de este tipo de rol pueden contener otras entidades y objetos como contenido. STRUCTURE—Se asignará el tipo de rol de asociación de estructura. Las entidades u objetos de este tipo de rol 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 de red, que define cómo se administrarán las entidades de red de contenido o de adjuntos cuando se elimine el contenedor o la estructura. Esto se aplica a los roles de asociación de contenedor y de estructura. CASCADE—Cuando se elimina el contenedor o la estructura, se eliminan todas las entidades de red de adjuntos o contenido. SET_TO_NONE—Cuando se elimina un contenedor o una estructura, sus entidades de red de contenido o de adjuntos no se borran, sino que se eliminan de la asociación de contención o adjunto estructural. RESTRICTED—Si existen entidades de red de contenido o de adjuntos, se devolverá un error al intentar eliminar el contenedor o la estructura. Las entidades de red 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. Este parámetro 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á activo 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. Cuando el contenido es un objeto de cruce no espacial, el contenido se duplica para que cada entidad contenedora tenga un objeto de cruce como contenido. Cuando el contenido es un objeto de eje no espacial, el contenido se divide de forma que cada entidad contenedora tenga un objeto de eje como 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. Cuando se trabaja con contenido de objetos de cruce no espaciales, el contenido será contenido por el contenedor mayor. Cuando se trabaja con contenido de objetos de eje no espaciales, el contenido se mantiene como contenido de ambos contenedores principales. 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.un.SetAssociationRole("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í