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

Resumen

Agrega una regla de diagrama a la secuencia de reglas especificada en una plantilla de diagrama para asignar una capacidad concreta a entidades de diagrama representadas actualmente en el diagrama durante el proceso de creación de diagramas. Esta funcionalidad se usa en otras reglas que se ejecutan más tarde en la secuencia de reglas. Las entidades de diagrama que se procesarán son el resultado de una consulta en una clase de fuente de red o tabla de objetos por atributos.

Más información sobre la regla Agregar capacidad 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 móvil 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.

• Especifique la opción Impedir contracción de contenedor relacionado o Permitir contracción de contenedor relacionado del parámetro Capacidad para marcar entidades de diagrama de contenido, a fin de impedir o permitir que su contenedor relacionado se contraiga con reglas Contraer contenedor ejecutadas más tarde en la secuencia de reglas. Son reglas configuradas con las herramientas Agregar regla de contracción de contenedor, Agregar regla de contracción de contenedor por atributo o Agregar regla de contracción de contenedor por categoría.

• Especifique las opciones Evitar reducir cruce o Permitir reducir cruce del parámetro Capacidad para marcar cruces de diagrama para descartarlos o permitirlos mediante reglas Reducir cruce ejecutadas más tarde en la secuencia de reglas. Son reglas configuradas con las herramientas Agregar regla de reducción de cruce, Agregar regla de reducción de cruce por atributo o Agregar regla de reducción de cruce por categoría.

• Especifique la opción Guardar cruces de contenedores vacíos no conectados como polígonos para el parámetro Capacidad para crear un contenedor de diagrama en lugar de un cruce de diagrama para representar cualquier cruce de red de contenedor vacío o cualquier objeto de cruce que no esté conectado. Esta capacidad solo se aplica a una clase de origen de cruce de contenedor o a una tabla de objetos.

• Especifique la opción Ignorar para iniciar el trazado aguas arriba para el parámetro Capacidad para marcar las entidades del diagrama de modo que sean ignoradas como puntos de inicio por cualquier regla de Trazado configurada más adelante en la secuencia de reglas para el trazado aguas arriba.

• Especifique la opción Ignorar para iniciar el trazado aguas abajo para el parámetro Capacidad para marcar las entidades del diagrama de modo que sean ignoradas como puntos de inicio por cualquier regla de Trazado configurada más adelante en la secuencia de reglas para el trazado aguas abajo.

• A partir de ArcGIS Pro 3.4, puede asignar capacidades a los cruces de diagrama en función de su valencia; es decir, según la cantidad de cruces de diagrama a los que se conectan.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Red de entrada	La red de servicios o red de trazado que contiene la plantilla de diagrama que se modificará.	Utility Network; Trace Network
Plantilla de diagrama de entrada	El nombre de la plantilla de diagrama que se modificará.	String
Activo	Especifica si la regla estará activa al generar y actualizar diagramas basándose en la plantilla especificada. Activado: la regla agregada estará activa durante la generación y la actualización de cualquier diagrama basado en la plantilla de entrada. Esta es la opción predeterminada. Desactivado: la regla agregada no estará activa durante la generación ni la actualización de cualquier diagrama basado en la plantilla de entrada.	Boolean
Fuente de red	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
Expresión	Expresión SQL se utilizará 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
Recurso	Especifica la capacidad que se asignará a las entidades de diagrama consultadas al final de la operación de regla. La funcionalidad especificada la utilizarán otras reglas que se ejecutan más tarde en la secuencia de reglas. Impedir contracción de contenedor relacionado—Todas las entidades consultadas se marcarán para impedir la contracción de su contenedor relacionado mediante reglas Contraer contenedor que se ejecutan más tarde en la secuencia de reglas. Esta es la opción predeterminada. Permitir contracción de contenedor relacionado—Todas las entidades consultadas se marcarán para permitir la contracción de sus contenedores relacionados mediante reglas Contraer contenedor que se ejecutan más tarde en la secuencia de reglas. Evitar reducir cruce—Todos los cruces consultados se marcarán para impedir la reducción mediante reglas Reducir cruce que se ejecutan más tarde en la secuencia de reglas. Permitir reducir cruce—Todos los cruces consultados se marcarán para permitir la reducción mediante reglas Reducir cruce que se ejecutan más tarde en la secuencia de reglas. Guardar cruces de contenedor vacíos no conectados como polígonos—Todos los cruces de contenedor no conectados consultadas se guardarán con geometría poligonal en lugar de geometría de puntos si el contenedor está vacío. Ignorar para iniciar el trazado aguas arriba—Todas las entidades consultadas se ignorarán como puntos de inicio por cualquier regla de Trazado configurada más adelante en la secuencia de reglas para el trazado aguas arriba. Ignorar para iniciar el trazado aguas abajo—Todas las entidades consultadas se ignorarán como puntos de inicio por cualquier regla de Trazado configurada más adelante en la secuencia de reglas para el trazado aguas abajo.	String
Descripción (Opcional)	La descripción de la regla.	String
No conectado (Opcional)	Especifica si la capacidad seleccionada se aplicará a los cruces de diagrama de red no conectados. Activado: la capacidad seleccionada se aplicará a los cruces de diagrama de red no conectados. Esta es la opción predeterminada. Desactivado: la capacidad seleccionada no se aplicará a los cruces de diagrama de red no conectados.	Boolean
Conectado a un único cruce (Opcional)	Especifica si la capacidad seleccionada se aplicará a los cruces de diagrama de red conectados a un único cruce. Activado: la capacidad seleccionada se aplicará a los cruces de diagrama de red conectados a un solo cruce. Esta es la opción predeterminada. Desactivado: la capacidad seleccionada no se aplicará a los cruces de diagrama de red conectados a un único cruce.	Boolean
Conectado a dos cruces diferentes (Opcional)	Especifica si la capacidad seleccionada se aplicará a los cruces de diagrama de red conectados a dos cruces diferentes. Activado: la capacidad seleccionada se aplicará a los cruces de diagrama de red conectados a dos cruces diferentes. Esta es la opción predeterminada. Desactivado: la capacidad seleccionada no se aplicará a los cruces de diagrama de red conectados a dos cruces diferentes.	Boolean
Conectado a tres o más cruces diferentes (Opcional)	Especifica si la capacidad seleccionada se aplicará a los cruces de diagrama de red conectados a tres o más cruces diferentes. Activado: la capacidad seleccionada se aplicará a los cruces de diagrama de red conectados a tres o más cruces diferentes. Esta es la opción predeterminada. Desactivado: la capacidad seleccionada no se aplicará a los cruces de diagrama de red conectados a tres o más cruces diferentes.	Boolean

Salida derivada

Etiqueta	Explicación	Tipo de datos
Red de salida	Red de servicios o red de trazado actualizada.	Utility Network; Trace Network
Plantilla de diagrama de salida	El nombre de la plantilla de diagrama.	String

Python

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

Nombre	Explicación	Tipo de datos
in_utility_network	La red de servicios o red de trazado que contiene la plantilla de diagrama que se modificará.	Utility Network; Trace Network
template_name	El nombre de la plantilla de diagrama que se 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 se utilizará 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	Especifica la capacidad que se asignará a las entidades de diagrama consultadas al final de la operación de regla. La funcionalidad especificada la utilizarán otras reglas que se ejecutan 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 relacionado mediante reglas Contraer contenedor que se ejecutan 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 sus contenedores relacionados mediante reglas Contraer contenedor que se ejecutan más tarde en la secuencia de reglas. PREVENT_TO_REDUCE_JUNCTION—Todos los cruces consultados se marcarán para impedir la reducción mediante reglas Reducir cruce que se ejecutan más tarde en la secuencia de reglas. ALLOW_TO_REDUCE_JUNCTION—Todos los cruces consultados se marcarán para permitir la reducción mediante reglas Reducir cruce que se ejecutan más tarde en la secuencia de reglas. SAVE_EMPTY_CONTAINER_AS_POLYGON_IF_UNCONNECTED—Todos los cruces de contenedor no conectados consultadas se guardarán con geometría poligonal en lugar de geometría de puntos si el contenedor está vacío. IGNORED_STARTING_POINT_FOR_UPSTREAM_TRACE—Todas las entidades consultadas se ignorarán como puntos de inicio por cualquier regla de Trazado configurada más adelante en la secuencia de reglas para el trazado aguas arriba. IGNORED_STARTING_POINT_FOR_DOWNSTREAM_TRACE—Todas las entidades consultadas se ignorarán como puntos de inicio por cualquier regla de Trazado configurada más adelante en la secuencia de reglas para el trazado aguas abajo.	String
description (Opcional)	La descripción de la regla.	String
valence_0 (Opcional)	Especifica si la capacidad seleccionada se aplicará a los cruces de diagrama de red no conectados. APPLY—La capacidad seleccionada se aplicará a los cruces de diagrama de red no conectados. Esta es la opción predeterminada. DO_NOT_APPLY—La capacidad seleccionada no se aplicará a los cruces de diagrama de red no conectados.	Boolean
valence_1 (Opcional)	Especifica si la capacidad seleccionada se aplicará a los cruces de diagrama de red conectados a un único cruce. APPLY—La capacidad seleccionada se aplicará a los cruces de diagrama de red conectados a un solo cruce. Esta es la opción predeterminada. DO_NOT_APPLY—La capacidad seleccionada no se aplicará a los cruces de diagrama de red conectados a un único cruce.	Boolean
valence_2 (Opcional)	Especifica si la capacidad seleccionada se aplicará a los cruces de diagrama de red conectados a dos cruces diferentes. APPLY—La capacidad seleccionada se aplicará a los cruces de diagrama de red conectados a dos cruces diferentes. Esta es la opción predeterminada. DO_NOT_APPLY—La capacidad seleccionada no se aplicará a los cruces de diagrama de red conectados a dos cruces diferentes.	Boolean
valence_3_plus (Opcional)	Especifica si la capacidad seleccionada se aplicará a los cruces de diagrama de red conectados a tres o más cruces diferentes. APPLY—La capacidad seleccionada se aplicará a los cruces de diagrama de red conectados a tres o más cruces diferentes. Esta es la opción predeterminada. DO_NOT_APPLY—La capacidad seleccionada no se aplicará a los cruces de diagrama de red conectados a tres o más cruces diferentes.	Boolean

Salida derivada

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

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.nd.AddDiagramFeatureCapabilityByAttributeRule(
    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í