Agregar regla de capacidad de entidad de diagrama por atributo (Diagrama de red)

Resumen

Agrega una regla de diagrama a una plantilla de diagrama para asignar una funcionalidad concreta a entidades de diagrama representadas actualmente en el diagrama. Esta capacidad la utilizan otras reglas ejecutadas más tarde en la secuencia de reglas. Las entidades de diagrama que se deben procesar son el resultado de una consulta por atributos en una clase de fuente de red o tabla de objetos.

Más información sobre la regla Agregar funcionalidad de entidad de diagrama

Precaución:

Esta herramienta es una herramienta de configuración y administración.

Nota:

Esta herramienta afecta a la coherencia de cualquier diagrama existente basado en la plantilla de diagrama de entrada. Todos los diagramas existentes se vuelven incoherentes y permanecen abiertos con un icono de advertencia de coherencia hasta que se actualicen.

Uso

• Esta herramienta no se admite al trabajar con un servicio de red de servicios o red de trazado. Debe utilizar una red de servicios o red de trazado de una geodatabase de archivos o una conexión de base de datos a una red de servicios o red de trazado de una geodatabase corporativa. Al trabajar con una geodatabase corporativa, existen estos requisitos:

  • El valor del parámetro Red 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 o propietaria de la red de trazado de la base de datos.
  • La cuenta del portal de ArcGIS Enterprise conectada debe ser la propietaria de la red de servicios del portal o la propietaria de la red de trazado del portal.
  • Esta herramienta se debe conectar a la versión predeterminada, que se espera que sea pública y no protegida.

• Utilice las opciones Evitar contracción del principal o Permitir contracción del principal para marcar entidades de diagrama a fin de impedir o permitir la contracción de su contenedor principal mediante reglas Contraer contenedor ejecutadas más tarde en la secuencia de reglas, es decir, reglas configuradas con las herramientas Agregar regla de contracción de contenedor o Agregar regla de contracción de contenedor por atributo.

• Utilice las opciones Evitar reducir cruce o Permitir reducir cruce para marcar cruces de diagrama a fin de descartarlos o no mediante reglas Reducir cruce ejecutadas más tarde en la secuencia de reglas, es decir, reglas configuradas con las herramientas Agregar regla de reducción de cruce o Agregar regla de reducción de cruce por atributo.

Sintaxis

arcpy.nd.AddDiagramFeatureCapabilityByAttributeRule(in_utility_network, template_name, is_active, network_source, where_clause, {capability}, {description})

Parámetro	Explicación	Tipo de datos
in_utility_network	La red de servicios o red de trazado que contiene la plantilla de diagrama que se desea modificar.	Utility Network; Trace Network
template_name	El nombre de la plantilla de diagrama que se desea modificar.	String
is_active	Especifica si la regla estará habilitada al generar y actualizar diagramas basándose en la plantilla especificada. ACTIVE —La regla agregada se habilitará durante la generación y la actualización de cualquier diagrama basado en la plantilla de entrada. Esta es la opción predeterminada. INACTIVE —La regla agregada no estará habilitada durante la generación ni la actualización de cualquier diagrama basado en la plantilla de entrada.	Boolean
network_source	Tabla de objetos o clase de fuente de red que hace referencia a entidades u objetos asociados a las entidades de diagrama a las que se asignará la capacidad concreta.	Table; Feature Class
where_clause	Expresión SQL utilizada para filtrar las entidades u objetos de interés en la tabla de objetos o clase de fuente de red especificada. Para obtener más información sobre la sintaxis SQL, consulte Referencia SQL para las expresiones de consulta utilizadas en ArcGIS.	SQL Expression
capability (Opcional)	Especifica la capacidad que se asignará a las entidades de diagrama consultadas al final de la ejecución de la regla. Esta funcionalidad la utilizarán otras reglas ejecutadas más tarde en la secuencia de reglas. PREVENT_TO_COLLAPSE_CONTAINER — Todas las entidades consultadas se marcarán para impedir la contracción de su contenedor principal mediante reglas Contraer contenedor ejecutadas más tarde en la secuencia de reglas. Esta es la opción predeterminada. ALLOW_TO_COLLAPSE_CONTAINER — Todas las entidades consultadas se marcarán para permitir la contracción de su contenedor principal mediante reglas Contraer contenedor ejecutadas más tarde en la secuencia de reglas. PREVENT_TO_REDUCE_JUNCTION — Todos los cruces consultados se marcarán para evitar que las reglas Reducir cruce se ejecuten más tarde en la secuencia de reglas a fin de reducirlos. ALLOW_TO_REDUCE_JUNCTION — Todos los cruces consultados se marcarán para permitir que las reglas Reducir cruce se ejecuten más tarde en la secuencia de reglas a fin de reducirlos.	String
description (Opcional)	La descripción de la regla.	String

Salida derivada

Nombre	Explicación	Tipo de datos
out_utility_network	Red de servicios o red de trazado actualizada.	Red de servicios; red de trazado
out_template_name	El nombre de la plantilla de diagrama.	Cadena

Muestra de código

Ejemplo de AddDiagramFeatureCapabilityByAttributeRule (script independiente)

Agregar una regla Capacidad de entidad de diagrama a la plantilla MyTemplate1 para marcar todos los conmutadores a fin de impedir que su contenedor se contraiga más tarde.

import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DistributionDevice = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.ElectricDistributionDevice"
input_DiagramTemplate = "MyTemplate1"
arcpy.AddDiagramFeatureCapabilityByAttributeRule_nd(
    input_Network, input_DiagramTemplate, 'ACTIVE', 
    input_DistributionDevice, 'ASSETGROUP=14', "PREVENT_TO_COLLAPSE_CONTAINER")

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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