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.
Sintaxis
arcpy.nd.AddSetStartingPointByAttributeRule(in_utility_network, template_name, is_active, network_source, {where_clause}, {junction_terminals}, {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.
| 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
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
Información de licenciamiento
- Basic: No
- Standard: Sí
- Advanced: Sí