Agregar regla de establecimiento de punto de partida por atributo (Diagrama de red)

Resumen

Agrega una regla de diagrama a una plantilla de diagrama para establecer entidades de diagrama representadas actualmente en el diagrama como puntos de partida para reglas de seguimiento. Las entidades de diagrama son el resultado de una consulta en una clase de fuente de red o tabla de objetos determinada y se puede filtrar por sus atributos.

Más información sobre predefinir puntos de partida en diagramas

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.

• Configurar puntos de partida en una plantilla de diagrama tiene sentido si la plantilla está configurada para que ejecute una regla trazado. Ejecute la herramienta Agregar regla de establecimiento de punto de partida por atributo antes de la herramienta Agregar regla de trazado para establecer entidades de diagrama especificadas como puntos de partida para la regla Trazado. En este caso, la regla Trazado identifica los puntos de partida especificados como los únicos puntos de partida para la ejecución, en lugar de ejecutar todas las entidades representadas en el diagrama en el momento en que se ejecuta.

• Si la regla Establecer punto de partida se utiliza antes de un trazado basado en subredes para configurar puntos de partida en entidades de diagrama que representan elementos de red con terminales, la regla debe especificar el Id. de terminal para identificar el origen del trazado. Si el Id. de terminal no está claramente identificado, el trazado basado en subredes no sabrá desde qué terminal se espera comenzar. En este caso, un error indicará que existen varios puntos de partida fuera del nivel especificado. Cuando se especifica el Id. de terminal, pero no corresponde a un controlador de subred del nivel trazado, un error indicará que no se ha descubierto ningún controlador de subred.

• Si se configura la regla Establecer punto de partida, pero ninguna entidad del diagrama corresponde a los puntos de partida esperados, se omitirá la regla Trazado.

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 desea modificar.	Utility Network; Trace Network
Plantilla de diagrama de entrada	El nombre de la plantilla de diagrama que se desea modificar.	String
Activa	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	La clase de fuente de red o tabla de objetos que hace referencia a las entidades u objetos que se establecerán como puntos de partida.	Table; Feature Class
Expresión (Opcional)	Una expresión SQL para seleccionar el subconjunto de entidades u objetos en la clase de fuente o tabla de objetos especificada que se establecerá como puntos de partida. Para obtener más información sobre la sintaxis SQL, consulte Referencia SQL para las expresiones de consulta utilizadas en ArcGIS.	SQL Expression
Terminales de cruce (Opcional)	Los Id. de terminal que comenzarán el trazado si la clase de fuente de red o tabla de objetos hace referencia a cruces de red con terminales. Se enumeran todos los Id. de terminal recuperados de los cruces del parámetro Fuente de red. Se corresponden con los de la sección Configuraciones de terminales de la pestaña Propiedades de red. Cuando se configuran los parámetros Expresión y Terminales de cruce, los terminales especificados deben corresponderse con entidades u objetos consultados; de lo contrario, no se establecerán puntos de partida.	Long
Description (Opcional)	La descripción de la regla.	String

Salida derivada

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

Python

arcpy.nd.AddSetStartingPointByAttributeRule(in_utility_network, template_name, is_active, network_source, {where_clause}, {junction_terminals}, {description})

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 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	La clase de fuente de red o tabla de objetos que hace referencia a las entidades u objetos que se establecerán como puntos de partida.	Table; Feature Class
where_clause (Opcional)	Una expresión SQL para seleccionar el subconjunto de entidades u objetos en la clase de fuente o tabla de objetos especificada que se establecerá como puntos de partida. Para obtener más información sobre la sintaxis SQL, consulte Referencia SQL para las expresiones de consulta utilizadas en ArcGIS.	SQL Expression
junction_terminals [junction_terminals,...] (Opcional)	Los Id. de terminal que comenzarán el trazado si la clase de fuente de red o tabla de objetos hace referencia a cruces con terminales. Los Id. de terminal se enumeran en la sección Configuraciones de terminales de la pestaña Propiedades de red. Cuando se configuran los parámetros where_clause y junction_terminals, los terminales especificados deben corresponderse con entidades u objetos consultados; de lo contrario, no se establecerán puntos de partida.	Long
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 AddSetStartingPointByAttributeRule (script independiente)

Agregar una regla Establecer punto de partida por atributo a la plantilla MyTemplate1 para establecer puntos de partida en el terminal de carga (n.º 3) de los dispositivos de distribución de un interruptor de circuito (ASSETGROUP <> 4). Significa que cualquier terminal de carga de los interruptores de circuito de los diagramas generados se establecerán como puntos de partida.

import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DiagramTemplate = "MyTemplate1"
input_Device = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.ElectricDistributionDevice"
arcpy.AddSetStartingPointByAttributeRule_nd(input_Network, input_DiagramTemplate, 
                                             "ACTIVE", input_Device, 
                                             "ASSETGROUP <> 4", "3")

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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