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, 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

EtiquetaExplicaciónTipo 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.

  • ContenedorLas entidades u objetos de este tipo de activo pueden contener otras entidades y objetos como contenido.
  • EstructuraLas entidades u objetos de este tipo de activo pueden tener otras entidades u objetos adjuntos a ellos.
  • NingunoNo 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.

  • CascadaCuando se elimina un contenedor o estructura principal, se eliminan todas las entidades de red de adjuntos o contenido.
  • Establecer como ningunaCuando 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.
  • RestringidoSi 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

EtiquetaExplicaciónTipo de datos
Red de servicios actualizada

La red de servicios actualizada.

Utility Network

arcpy.un.SetAssociationRole(in_utility_network, domain_network, featureclass, assetgroup, assettype, association_role_type, association_deletion_semantics, {view_scale}, {split_content})
NombreExplicaciónTipo 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.

  • CONTAINERLas entidades u objetos de este tipo de activo pueden contener otras entidades y objetos como contenido.
  • STRUCTURELas entidades u objetos de este tipo de activo pueden tener otras entidades u objetos adjuntos a ellos.
  • NONENo 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.

  • CASCADECuando se elimina un contenedor o estructura principal, se eliminan todas las entidades de red de adjuntos o contenido.
  • SET_TO_NONECuando 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.
  • RESTRICTEDSi 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.

  • SPLITEl 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_SPLITEl 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

NombreExplicaciónTipo 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í

Temas relacionados