Agregar regla de capacidad de entidad de diagrama por categoría (Diagrama de red)

Resumen

Agrega una regla de diagrama para asignar una funcionalidad concreta a entidades de diagrama con arreglo a las categorías de red. Esta asignación tiene lugar durante la creación de diagramas a partir de una plantilla existente. 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 depende de si se etiquetan con categorías de red específicas.

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.

Nota:

Esta herramienta solo se aplica a plantillas de diagrama a partir de la versión 7 de Utility Network.

Uso

• La regla Agregar funcionalidad de entidad de diagrama agrega una funcionalidad específica a entidades de red u objetos de red representados en el diagrama para que se procesen de una manera determinada por otras reglas de diagrama que se ejecutan más adelante en el proceso de creación del diagrama. Esta herramienta permite configurar la regla Agregar capacidad de entidad de diagrama para ejecutar por categorías de red. Esto significa que puede configurar la adición de una funcionalidad concreta a las entidades de red o los objetos de red representados en el diagrama dependiendo de si están etiquetados con categorías de red específicas.

• Esta herramienta no se admite cuando se trabaja con un servicio de red de servicios. Debe utilizar una red de servicios de una geodatabase de archivos o móvil, o bien una conexión de base de datos a una red de servicios 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.
  • La cuenta del portal de ArcGIS Enterprise conectada debe corresponder al propietario del portal de utility network.
  • 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 que contiene la plantilla de diagrama que se modificará.	Utility 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
Proceso de regla	Especifica cómo se procesarán las entidades de red o los objetos de red que están etiquetados con categorías de red específicas. Excluir categorías—Las entidades de red o los objetos de red que están etiquetados con categorías específicas no se procesarán, a diferencia de los demás objetos de red o entidades de red. Esta es la opción predeterminada. Incluir categorías—Se procesarán las entidades de red o los objetos de red que estén etiquetados con categorías específicas.	String
Categorías	Las categorías de red que se excluirán o incluirán dependen del valor del parámetro Proceso de regla. Si el parámetro Proceso de regla se configura en Incluir categorías, debe especificarse una o varias categorías de red. La funcionalidad concreta se asignará a cualquier entidad de diagrama que esté relacionada con las entidades de red y los objetos de red que estén etiquetados con categorías de red específicas. Si el parámetro Proceso de regla se configura en Excluir categorías, la funcionalidad concreta se asignará a cualquier entidad de diagrama que esté relacionada con las entidades de red y los objetos de red que no estén etiquetados con categorías de red específicas.	String
Recurso	Especifica la capacidad que se asignará a las entidades de diagrama filtradas por categoría 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 filtradas por categoría 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 filtradas por categoría 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 filtrados por categoría 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 filtrados por categoría 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	La red de servicios actualizada.	Utility Network
Plantilla de diagrama de salida	El nombre de la plantilla de diagrama.	String

Python

arcpy.nd.AddDiagramFeatureCapabilityByCategoryRule(in_utility_network, template_name, is_active, inverse_category_selection, category, capability, {description}, {valence_0}, {valence_1}, {valence_2}, {valence_3_plus})

Nombre	Explicación	Tipo de datos
in_utility_network	La red de servicios que contiene la plantilla de diagrama que se modificará.	Utility 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
inverse_category_selection	Especifica cómo se procesarán las entidades de red o los objetos de red que están etiquetados con categorías de red específicas. EXCLUDE_CATEGORIES—Las entidades de red o los objetos de red que están etiquetados con categorías específicas no se procesarán, a diferencia de los demás objetos de red o entidades de red. Esta es la opción predeterminada. INCLUDE_CATEGORIES—Se procesarán las entidades de red o los objetos de red que estén etiquetados con categorías específicas.	String
category [category,...]	Las categorías de red que se excluirán o incluirán dependen del valor del parámetro inverse_category_selection. Si el parámetro inverse_category_selection se configura en INCLUDE_CATEGORIES, debe especificarse una o varias categorías de red. La funcionalidad concreta se asignará a cualquier entidad de diagrama que esté relacionada con las entidades de red y los objetos de red que estén etiquetados con categorías de red específicas. Si el parámetro inverse_category_selection se configura en EXCLUDE_CATEGORIES, la funcionalidad concreta se asignará a cualquier entidad de diagrama que esté relacionada con las entidades de red y los objetos de red que no estén etiquetados con categorías de red específicas.	String
capability	Especifica la capacidad que se asignará a las entidades de diagrama filtradas por categoría 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 filtradas por categoría 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 filtradas por categoría 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 filtrados por categoría 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 filtrados por categoría 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	La red de servicios actualizada.	Utility Network
out_template_name	El nombre de la plantilla de diagrama.	String

Muestra de código

Ejemplo de AddDiagramFeatureCapabilityByCategoryRule(script independiente)

Agregar una regla Capacidad de entidad de diagrama a la plantilla MyTemplate1 para marcar todos los subcontroladores de red a fin de impedir que su contenedor se contraiga más tarde. Como la categoría de red Controlador de subred existe y se asigna a todos los controladores de subred de la red, puede ejecutar la función AddDiagramFeatureCapabilityByCategoryRule para marcar todos los controladores de subred de forma que impidan que sus contenedores relacionados se contraigan.

import arcpy
input_Network = 'D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric'
input_NetworkCategory = 'Subnetwork Controller'
input_DiagramTemplate = 'MyTemplate1'

arcpy.nd.AddDiagramFeatureCapabilityByCategoryRule(
    input_Network, input_DiagramTemplate, 'ACTIVE', 'INCLUDE_CATEGORIES',
    input_NetworkCategory, 'PREVENT_TO_COLLAPSE_CONTAINER')

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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