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

EtiquetaExplicaciónTipo 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

EtiquetaExplicaciónTipo 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

arcpy.locref.ConfigureLookupTable(in_feature_class, lookup_table, field_applied_to, lookup_key, {lookup_display}, {allow_any_lookup_value})
NombreExplicaciónTipo 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_VALUEPermitir que se configure un valor cuando no hay ninguno presente en la tabla.
  • ALLOW_ANY_VALUENo permitir que se configure un valor de visualización de búsqueda. Esta es la opción predeterminada.
Boolean

Salida derivada

NombreExplicaciónTipo 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')

Información de licenciamiento

  • Basic: Requiere ArcGIS Location Referencing
  • Standard: Requiere ArcGIS Location Referencing
  • Advanced: Requiere ArcGIS Location Referencing

Temas relacionados