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 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.

• 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.

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
Añadir entidades	Clase de entidad de origen a la que se agregarán las entidades.	Feature Class
Relación (Opcional)	Especifica la relación espacial entre las entidades. Intersecar—Las entidades de la clase de entidad de origen Agregar entidades se incorporarán al diagrama si se intersecan con una de las Entidades existentes. Esta es la opción predeterminada. Dentro de una distancia—Las entidades de la clase de entidad de origen Agregar entidades se incorporarán al diagrama si se encuentran dentro de la distancia especificada (usando la distancia euclidiana) de una de las Entidades existentes. Use el parámetro Distancia de búsqueda para especificar la distancia. Contiene | Está contenida en—Las entidades de la clase de entidad de origen Agregar entidades se incorporarán al diagrama si contienen entidades de origen o están contenidas en Entidades existentes. Dentro de—Las entidades de la clase de entidad de origen Agregar entidades se incorporarán al diagrama si están dentro de las Entidades existentes. Toca el límite—Las entidades de la clase de entidad de origen Agregar entidades se incorporarán al diagrama si tienen un límite que toca una de las Entidades existentes. Si las Entidades existentes son líneas o polígonos, el límite de la entidad de entrada Agregar entidades solo puede tocar el límite de una de las Entidades existentes, y ninguna parte de la entidad de entrada puede cruzar el límite de ninguna de las Entidades existentes. Comparten un segmento de línea con—Las entidades de la clase de entidad de origen Agregar entidades se incorporarán al diagrama si comparten un segmento de línea con una de las Entidades existentes. Las entidades agregadas y existentes deben ser de línea o polígono. Cruzado por el contorno de—Las entidades de la clase de entidad de origen Agregar entidades se incorporarán al diagrama si las cruza el contorno de una de las Entidades existentes. Las entidades agregadas y existentes deben ser líneas o polígonos. Si se utilizan polígonos para las Entidades existentes, 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
Entidades existentes	La clase de entidad de origen en la que se ejecutará la consulta espacial.	Feature Class
Distancia de búsqueda (Opcional)	La distancia entre entidades se indica en el parámetro Entidades existentes y las entidades en el parámetro Agregar entidades. Este parámetro solo es válido si el parámetro Relación está establecido en Intersecar, Dentro de una distancia, Contiene o Dentro de.	Linear Unit
Definición de consulta de entidades agregadas (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
Definición de consulta de entidades existentes (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
Descripción (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.	Utility Network; Trace Network
Plantilla de diagrama de salida	El nombre de la plantilla de diagrama.	String

Python

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})

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
added_features	Clase de entidad de origen a la que se agregarán las entidades.	Feature Class
overlap_type (Opcional)	Especifica la 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. Utilice 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 existing_features o están contenidas en ellas. WITHIN—Las entidades de la clase de entidad de origen added_features se incorporarán al diagrama si se encuentran dentro 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 las 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	La clase de entidad de origen en la que se ejecutará la consulta espacial.	Feature Class
search_distance (Opcional)	La distancia entre entidades del parámetro existing_features y las entidades del 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.	Utility Network; Trace Network
out_template_name	El nombre de la plantilla de diagrama.	String

Muestra de código

Ejemplo de AddSpatialQueryRule (script independiente)

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