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 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 asignará al tipo de activo.

  • ContenedorSe 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.
  • EstructuraSe 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.
  • NingunaNo 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.

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

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 asignará al tipo de activo.

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

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

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

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

Temas relacionados