Búsqueda
Búsqueda
Es el objeto que sirve para realizar consultas en las tablas de datos.
Para crear una búsqueda hacer doble clic sobre el icono correspondiente
de la galería de objetos (Tecla Insert).
Las propiedades de una búsqueda son:
Identificador: Etiqueta alfanumérica que identifica de forma unívoca una búsqueda dentro del proyecto de aplicación. Este identificador será el que usemos para referenciarla en otras propiedades de otros objetos.
El identificador constará de mayúsculas y números exclusivamente. Al identificar de forma unívoca una búsqueda no puede haber duplicidad.
Nombre: Etiqueta alfanumérica que servirá como descriptor de la búsqueda. Se usará para presentar información de la búsqueda en objetos y en los inspectores.
Podemos definir una etiqueta por cada idioma presente en el proyecto.
Estilos: Podemos definir el estilo Privado que limita el acceso del usuario final al objeto desde puntos donde no se haya programado el acceso al mismo.
Comentarios: Esta propiedad nos permite documentar el uso de la búsqueda.
Tabla asociada: Tabla de un proyecto de datos heredado sobre la que se va a realizar la búsqueda.
Formulairo: Si hemos diseñado un formulario para petición de datos a buscar, lo seleccionaremos en esta propiedad. El formulario deberá tener su origen en la misma tabla que la búsqueda.
Invertir lista: Permite hacer que se muestre el resultado de la búsqueda en orden inverso.
Fórmula filtro: Permite especificar una condición de filtrado secuencial, una fórmula condicional que deberá cumplir cada registro para ser incluido en la lista final de registros. El filtro se establecerá mediante una fórmula que podremos escribir usando el asistente para edición de fórmulas. Para ello pulsar el botón
que aparece al editar esta propiedad.
Las búsquedas están compuestas por Componentes de búsqueda que permiten definir tanto el índice o índices por los que se realizará la búsqueda como el modo en el que ésta será realizada.
Un componente de búsqueda se crea pulsando el botón Nuevo componente de búsqueda
del editor de búsquedas. Sus propiedades son:
Identificador: Etiqueta alfanumérica que identifica de forma unívoca un componente de búsqueda dentro del proyecto de aplicación. Este identificador será el que usemos para referenciarla en otras propiedades de otros objetos.
El identificador constará de mayúsculas y números exclusivamente. Al identificar de forma unívoca un componente búsqueda no puede haber duplicidad dentro de la misma búsqueda.
Nombre: Etiqueta alfanumérica que servirá como descriptor del componente de búsqueda. Se usará para presentar información del mismo en objetos y en los inspectores.
Podemos definir una etiqueta por cada idioma presente en el proyecto.
Estilos: Podemos definir el estilo Privado que limita el acceso del usuario final al sub-objeto desde puntos donde no se haya programado el acceso al mismo.
Comentarios: Esta propiedad nos permite documentar el uso del componente.
Mezcla: En búsquedas en las que se declare más de un componente, en este parámetro especificaremos la forma de combinar la lista resultante de la ejecución del componente en curso con la del anterior. Hay tres formas de combinar:
Cruzar: La lista final estará compuesta por los registros que se repiten en las dos listas.
Añadir: El resultado es una lista con los registros que pertenecen al primer componente o al segundo. Si un registro pertenece a los dos componentes, sólo aparecerá una vez en la lista final.
Quitar: El resultado es una lista con los registros que pertenecen al primer componente quitando los que también pertenecen al segundo.
Condición activo: Permite especificar una condición para que el componente sea ejecutado. La condición se establecerá mediante una fórmula que podremos escribir usando el asistente para edición de fórmulas. Para ello pulsar el botón
que aparece al editar esta propiedad.
Índice: Esta propiedad nos permite seleccionar el índice de la tabla asociada a la búsqueda por el que se buscará en ese componente.
Modo: Permite definir el modo en el que se realizará la búsqueda por el índice seleccionado en el componente. Hay tres modos posibles:
Todo el fichero: El resultado de la búsqueda serán todos los registros de la tabla (exceptuando los excluidos debido al filtro secuencial establecido en la propiedad Fórmula filtro de la búsqueda, si está definido). En este caso, como es lógico, no es necesario especificar un formulario para pedir datos ni declarar los datos iniciales de búsqueda.
Parte izquierda de la clave: Realiza la búsqueda de los registros cuya parte izquierda de la clave coincida con la introducida por el usuario en el Formulario para pedir datos. Se pueden especificar tantos campos (partes) de la clave como sean necesarios. Es posible establecer un valor inicial para ese modo de búsqueda en la propiedad Límite inicial que se muestra al seleccionar este modo de búsqueda.
Entre límites: Realiza la búsqueda de los registros cuya clave esté comprendida entre dos límites, inicial y final. Estos límites podrán ser establecidos o bien en el formulario para pedir datos de la búsqueda o bien de forma directa en las propiedades Límite inicial y Límite final que se muestran al seleccionar este modo de búsqueda.
Es posible declarar variables locales en la búsqueda. Para ello, estando activo el panel de propiedades de la búsqueda, seleccionar la opción Variable
del panel de subobjetos de Velneo vDevelop V7.
