Agregar regla de consulta espacial (Diagrama de red)

Resumen

Agrega una regla de diagrama que incorpora automáticamente nuevas entidades de red a los diagramas en función de su ubicación relativa a las entidades de red representadas actualmente en el diagrama.

Más información sobre el uso de reglas de consulta espacial para crear diagramas de red

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.

• La regla Consulta espacial se utiliza para detectar nuevas entidades de red en función de su ubicación relativa a entidades de red que existen actualmente en el diagrama e incorpora las entidades recién detectadas al diagrama de red.

• Las entidades de red con las que funciona la regla se basan en la misma clase de entidad y esas entidades se pueden filtrar mediante el uso de una expresión de consulta SQL.

• Las entidades de red incorporadas se basan en la misma clase de entidad y esas entidades se pueden filtrar mediante el uso de una expresión de consulta SQL.

Sintaxis

arcpy.nd.AddSpatialQueryRule(in_utility_network, template_name, is_active, added_features, {overlap_type}, existing_features, {search_distance}, {added_where_clause}, {existing_where_clause}, {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
added_features	Clase de entidad de origen a la que se agregarán las entidades.	Feature Class
overlap_type (Opcional)	Relación espacial que se evaluará. INTERSECT — Las entidades de la clase de entidad de origen added_features se incorporarán al diagrama si se intersecan con una de las existing_features. Esta es la opción predeterminada. WITHIN_A_DISTANCE — Las entidades de la clase de entidad de origen added_features se incorporarán al diagrama si se encuentran dentro de la distancia especificada (usando la distancia euclidiana) de una de las existing_features. Use el parámetro search_distance para especificar la distancia. CONTAINS — Las entidades de la clase de entidad de origen added_features se incorporarán al diagrama si contienen entidades de origen o están contenidas en la existing_features. WITHIN — Las entidades de la clase de entidad de origen added_features se incorporarán al diagrama si están dentro de una de las existing_features. BOUNDARY_TOUCHES — Las entidades de la clase de entidad de origen added_features se incorporarán al diagrama si tienen un límite que toca una de las existing_features. Si las existing_features son líneas o polígonos, el límite de la entidad de entrada added_features solo puede tocar el límite de una de las existing_features, y ninguna parte de la entidad de entrada puede cruzar el límite de ninguna de las existing_features. SHARE_A_LINE_SEGMENT_WITH — Las entidades de la clase de entidad de origen added_features se incorporarán al diagrama si comparten un segmento de línea con una de las existing_features. Las entidades agregadas y existentes deben ser de línea o polígono. CROSSED_BY_THE_OUTLINE_OF — Las entidades de la clase de entidad de origen added_features se incorporarán al diagrama si las cruza el contorno de una de las existing_features. Las entidades agregadas y existentes deben ser líneas o polígonos. Si se utilizan polígonos para las existing_features, se usará el límite (línea) del polígono. Se incorporarán las líneas que se crucen en un punto, pero no las que compartan un segmento de línea.	String
existing_features	Clase de entidad de origen en la que se ejecutará la consulta espacial.	Feature Class
search_distance (Opcional)	La distancia entre entidades se indica en el parámetro existing_features y las entidades en el parámetro added_features. Este parámetro solo es válido si el parámetro overlap_type está establecido en INTERSECT, WITHIN_A_DISTANCE, CONTAINS o WITHIN	Linear Unit
added_where_clause (Opcional)	La consulta SQL que se utilizará para filtrar las entidades que se agregarán al diagrama. Sin una consulta SQL, las entidades basadas en la clase de fuente especificada que están relacionadas espacialmente con las entidades existentes especificadas se incorporarán al diagrama.	SQL Expression
existing_where_clause (Opcional)	La consulta SQL que se utilizará para filtrar las entidades presentes en el diagrama. Sin una consulta SQL, se tendrán en cuenta las entidades basadas en la clase de fuente especificada que está presente en el diagrama.	SQL Expression
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 AddSpatialQueryRule (script independiente)

Agregue una regla de consulta espacial a la plantilla MyTemplate1 para agregar sistemáticamente todas las líneas de subtransporte que intersecan subestaciones en los diagramas generados.

import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DistributionLine = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.ElectricDistributionLine"
input_StructureBoundary = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.ElectricStructureBoundary"
input_DiagramTemplate = "MyTemplate1"
arcpy.AddSpatialQueryRule_nd(input_Network, input_DiagramTemplate, 
                             'ACTIVE', input_DistributionLine, 'INTERSECT',
                             input_StructureBoundary, None, 'ASSETGROUP=6', 
                             'ASSETGROUP=3')

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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