Saltar a contenido

Control de búsqueda

Suggest es un campo de texto con una búsqueda detrás. El usuario escribe, el formulario consulta el origen y ofrece los valores que coinciden; el valor elegido es lo que guarda el control.

Es el control para catálogos largos —clientes, productos, ciudades— donde un dropdown sería inmanejable y el texto libre sería incorrecto.

Qué necesita el control

Ajuste Para qué sirve
Conexión de base de datos Dónde están los valores
SQL La consulta que devuelve los valores y sus etiquetas
Campo de búsqueda Contra qué columna se compara el texto escrito
Filtro Una condición fija que se aplica a la consulta antes de buscar
Límite Cuántos resultados se ofrecen a la vez

La búsqueda funciona de dos maneras, y ambas importan:

  • Por término — el texto escrito se busca dentro del valor o de la etiqueta.
  • Por coincidencia — un valor exacto gana sobre el resto, así que un código escrito completo aparece primero aunque otras filas contengan los mismos caracteres.

Escribir un valor que no existe

El control también puede agregar un valor. Cuando el texto escrito no está en el origen, pulsar Enter inserta un registro nuevo, y el formulario lo informa: Nuevo valor insertado en la tabla. La ayuda del panel de propiedades enuncia la misma regla antes de que nadie lo pruebe.

Ese comportamiento es cómodo para un catálogo que crece mientras la gente trabaja, y peligroso cuando el catálogo debería ser cerrado. Si la lista no debe crecer, usa un dropdown y controla quién edita el origen.

En un caso

  • El valor se guarda como cualquier otro campo; la búsqueda es solo la forma de elegirlo.
  • Solo se conserva el valor elegido, no la lista de sugerencias.
  • Si el origen cambia después, el caso mantiene el valor que guardó.

En una condición

Léelo con @@ y compara contra el valor guardado, no contra la etiqueta:

@@CustomerCode == "C-1042"

Relacionado