Configurar tabla de búsqueda (Location Referencing)

Disponible con licencia de Location Referencing.

Resumen

Configura una tabla de búsqueda para uno o varios campos utilizados en un Id. de ruta de varios campos.

Esta herramienta se puede ejecutar después de Crear red LRS a partir de dataset existente o Modificar red LRS para un Id. de ruta de varios campos.

Más información sobre cómo crear LRS, redes y eventos

Una tabla de búsqueda es una alternativa a utilizar dominios de valor codificados cuando un campo que conforma un Id. de ruta de varios campos tiene cientos o miles de posibles valores, por ejemplo, una lista de nombres de calles o un código del Sistema de información de nombres geográficos (GNIS). La tabla de búsqueda se utiliza sobre todo al crear una ruta.

Uso

• La tabla de búsqueda se puede configurar con los campos de parámetros Clave de búsqueda y Visualización de búsqueda, lo que permite al usuario buscar un valor clave mediante su valor de visualización:

  • El campo Lookup Key es el valor que se guardará para el campo en el Id. de ruta de varios campos.
  • El campo Lookup Display es el valor que aparece en el cuadro de texto para el Id. de ruta de varios campos.

• El menú desplegable del parámetro Campo aplicado a solo mostrará los campos que forman parte de un Id. de ruta de varios campos para la Clase de entidad de red LRS elegida.

  Nota:

  El valor del parámetro Campo clave de búsqueda se guardará en la geodatabase como un campo y como parte del Id. de ruta de varios campos.

  Los campos Lookup Key y Lookup Display pueden ser los mismos campos, o campos diferentes, en la tabla de búsqueda.

  El menú desplegable del parámetro Clave de búsqueda mostrará solo los campos de la tabla de búsqueda que tengan el mismo tipo de campo y una longitud menor o igual que el campo de ruta seleccionado en el menú desplegable del parámetro Campo aplicado a.

• El valor del parámetro Visualización de búsqueda es opcional. Si desea permitir un valor que no esté en la tabla de búsqueda, no puede configurar el parámetro Visualización de búsqueda.

• Location Referencing solo lee la tabla de búsqueda; no agregará registros a la tabla. Si el valor deseado no está presente, puede agregarlo a la tabla de búsqueda con esta herramienta.

• Si el relleno está configurado para el campo, se agregará si el valor del campo Lookup Key es menor que la longitud del campo.

• Solo se puede configurar una tabla de búsqueda por red LRS.

• Si la tabla de búsqueda está en una geodatabase multiusuario, la tabla debe ser no versionada.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Clase de entidad de red LRS	La clase de entidad de red LRS de entrada en la que se configurará la tabla de búsqueda. La red debe tener un Id. de ruta de varios campos.	Feature Layer
Tabla de búsqueda	Una tabla que contiene una lista de nombres de calles y sus códigos GNIS correspondientes. Puede ser una tabla independiente o residir en un SDE.	Table View
Campo aplicado a	El campo Id. de ruta de la red LRS en la que se configurará la Tabla de búsqueda.	String
Clave de búsqueda	El campo clave de la Tabla de búsqueda.	String
Visualización de búsqueda (Opcional)	El campo de descripción de la Tabla de búsqueda. Este campo aparece en el cuadro de texto para el Id. de ruta de varios campos.	String
Permitir cualquier valor de búsqueda (Opcional)	Especifica si se puede agregar un valor que no está en la tabla de búsqueda. El parámetro Visualización de búsqueda no se puede configurar cuando esta opción está activada. Activado: permitir que se configure un valor cuando no hay ninguno presente en la tabla. Desactivado: no permitir que se configure un valor de visualización de búsqueda. Esta es la opción predeterminada.	Boolean

Salida derivada

Etiqueta	Explicación	Tipo de datos
Clase de entidad de red de salida	La clase de entidad de red de ruta actualizada con la Tabla de búsqueda configurada.	Feature Layer

Python

arcpy.locref.ConfigureLookupTable(in_feature_class, lookup_table, field_applied_to, lookup_key, {lookup_display}, {allow_any_lookup_value})

Nombre	Explicación	Tipo de datos
in_feature_class	La clase de entidad de red LRS de entrada en la que se configurará la tabla de búsqueda. La red debe tener un Id. de ruta de varios campos.	Feature Layer
lookup_table	Una tabla que contiene una lista de nombres de calles y sus códigos GNIS correspondientes. Puede ser una tabla independiente o residir en un SDE.	Table View
field_applied_to	El campo Id. de ruta de la red LRS en la que se configurará lookup_table.	String
lookup_key	El campo clave en lookup_table.	String
lookup_display (Opcional)	El campo de descripción de lookup_table. Este campo aparece en el cuadro de texto para el Id. de ruta de varios campos.	String
allow_any_lookup_value (Opcional)	Especifica si se puede agregar un valor que no está en la tabla de búsqueda. El parámetro lookup_display no se puede configurar si esta opción está activada. DO_NOT_ALLOW_ANY_VALUE—Permitir que se configure un valor cuando no hay ninguno presente en la tabla. ALLOW_ANY_VALUE—No permitir que se configure un valor de visualización de búsqueda. Esta es la opción predeterminada.	Boolean

Salida derivada

Nombre	Explicación	Tipo de datos
out_feature_class	La clase de entidad de red de ruta actualizada con la Tabla de búsqueda configurada.	Feature Layer

Muestra de código

Ejemplo de ConfigureLookupTable 1 (ventana de Python)

Muestra cómo usar la herramienta ConfigureLookupTable en la ventana de Python.

# Name: Configure_Lookup_Table.py
# Description: Configures a Lookup Table outside of database.
# Requires: ArcGIS Location Referencing

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Tool variables
LRS_Network = r"C:\RH_Data.gdb\LRS\StateLog"
Table = r"C:\Data\cityCodeLookup.dbf"

# Execute the tool
arcpy.locref.ConfigureLookupTable(LRS_Network, Table, "CITY_CODE", "CODE", "DESC_LOOKU", "DO_NOT_ALLOW_ANY_VALUE")

# Check in license
arcpy.CheckInExtension('LocationReferencing')

Ejemplo de ConfigureLookupTable 2 (script independiente)

Demuestra cómo utilizar la herramienta ConfigureLookupTable como un script independiente de Python.

# Name: Configure_Lookup_Table.py
# Description: Configures a Lookup Table present in the same database.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Set LRS network and table
LRS_Network = r"C:\RH_Data.gdb\LRS\StateLog"
Table = r"C:\RH_Data.gdb\cityCodeLookup"

# Execute the tool
arcpy.locref.ConfigureLookupTable(LRS_Network, Table, "CITY_CODE", "CODE", "DESC_LOOKU", "DO_NOT_ALLOW_ANY_VALUE")

print("Table configured successfully")

# Check in license
arcpy.CheckInExtension('LocationReferencing')

Entornos

Espacio de trabajo actual

Información de licenciamiento

• Basic: Requiere ArcGIS Location Referencing (ArcGIS Pipeline Referencing o ArcGIS Roads and Highways)
• Standard: Requiere ArcGIS Location Referencing (ArcGIS Pipeline Referencing o ArcGIS Roads and Highways)
• Advanced: Requiere ArcGIS Location Referencing (ArcGIS Pipeline Referencing o ArcGIS Roads and Highways)