Las búsquedas son los objetos que se utilizan para realizar consultas en las tablas de datos.

Transcripción

1 Tutor de búsquedas Las búsquedas son los objetos que se utilizan para realizar consultas en las tablas de datos. Las búsquedas hacen uso de los sub-objetos de tabla llamados índices. Una búsqueda podrá estar compuesta por un único componente (por un único índice) o por varios componentes (por varios índices). A través de este tutor vamos a conocer cómo podemos construir una búsqueda que nos permita buscar por diferentes criterios, es decir, por varios componentes. Para ello vamos a basarnos en una aplicación de incidencias, que contendrá un proyecto de datos y un proyecto de aplicación que herede del anterior. El proyecto de datos contendrá las tablas siguientes: Las tablas tienen la siguiente estructura: 1

2 En la tabla de INCIDENCIAS los índices WORDS (de tipo Palabras) y PARTS (de tipo Trozos de palabras) indexan tanto el campo NAME como el campo OBSERVACIONES. Un índice de tipo Palabras indexa un registro por cada palabra encontrada en las partes que forman la clave. Un índice de tipo Trozos de palabras indexa un registro por cada grupo de 3 ó más caracteres de cada una de las partes que forman la clave. En este tutor aprenderemos a crear una búsqueda en la tabla de INCIDENCIAS, por los criterios siguientes: Por PALABRAS o Por TROZOS de palabras y Entre límites de FECHA. y de una ENTIDAD concreta. y Con un ID concreto. Tendremos que crear, además de la búsqueda, un formulario para pedir los datos de la búsqueda: 2

3 Si en dicho formulario el usuario deja algún dato en blanco, no se realizará la búsqueda por el componente correspondiente al mismo. Creación del formulario de búsqueda En este tutor no vamos a explicar detalladamente la creación y edición de un formulario, ya que existe un tutor específico sobre formularios, sino que explicaremos solamente aquellos aspectos necesarios y de interés para este tutor sobre búsquedas. Para crear el formulario, editaremos el proyecto de aplicación con Velneo vdevelop V7, pulsaremos la tecla Insert para abrir la galería de objetos y haremos doble clic sobre el siguiente icono: De las propiedades del objeto formulario modificaremos las siguientes:» Identificador: INCIDENCIAS_BUS.» Nombre: Incidencias.» Tabla asociada: INCIDENCIAS.» Especial para búsquedas: Verdadero. Los subobjetos del proyecto de datos heredado que editaremos en el formulario son: Junto a la etiqueta Código, se ha añadido un control de tipo Edición cuyo contenido es el campo ID de la tabla de INCIDENCIAS: #ID Junto a la etiqueta Texto, se ha añadido un control de tipo Edición cuyo contenido es el campo NAME de la tabla de INCIDENCIAS: #NAME. Dado que podemos buscar o por PALABRAS o por TROZOS de palabras, crearemos una variable local de tipo booleano. Si su contenido es 1 la búsqueda alfabética se hará por PALABRAS, si es 0, por TROZOS de palabras: 3

4 Hemos incluido dos Botones de radio para editar la variable local PALABRAS. El que tiene el Nombre Por palabras tiene como Contenido la variable local PALABRAS y como Valor 1. El que tiene el Nombre Por trozos de palabras tiene como Contenido la variable local PALABRAS y como Valor 0. Dado que la búsqueda por el componente fecha va a ser entre límites de fecha (entre una fecha inicial y una fecha final), tendremos que crear en el formulario dos variables locales de tipo fecha. Las llamaremos FCH-LIM-INI y FCH-LIM-FIN, respectivamente: 4

5 Junto a la etiqueta Fecha inicio, se ha añadido un control de tipo Edición Fecha cuyo contenido es la variable local FCH_LIM_INI. Junto a la etiqueta Fecha fin, se ha añadido un control de tipo Edición Fecha cuyo contenido es la variable local FCH_LIM_FIN. Junto a la etiqueta Entidad, se ha añadido un control de tipo Edición cuyo contenido es el campo NAME del enlace a la tabla de ENTIDADES: #ENTIDADES.NAME. El botón cuyo Nombre es Buscar, dispara el Comando Aceptar. El botón cuyo Nombre es Cancelar, dispara el Comando Cancelar. Creación de la búsqueda Para crear la búsqueda haremos doble clic sobre el icono (Tecla Insert) y estabeceremos las siguientes propiedades: de la galería de objetos» Identificador: INCIDENCIAS.» Nombre: Incidencias.» Tabla asociada: INCIDENCIAS.» Formulario: INCIDENCIAS.» Invertir lista: Falso. Dejaremos que la lista se presente en orden ascendente según el índice usado. 5

6 » Fórmula filtro: Lo dejaremos vacío; en este caso, no es necesario aplicar un filtro secuencial al resultado de la búsqueda. Una vez creada la búsqueda, tendremos que definir los componentes de la misma pero antes de hacerlo, recordemos que en el formulario de petición de datos habíamos creado unas variables locales para recoger una serie de datos, que recordemos eran: PALABRAS: De tipo booelano, para que el usuario pueda indicar si quiere realizar la búsqueda por palabras o por trozos de palabras. FCH_LIN_INI y FCH_LIM_FIN para la petición de los límites inicial y final para el componente de la búsqueda por el índice fecha. Pues bien, para recoger en la búsqueda los datos introducidos por el usuario en esas variables del formulario de petición de datos, lo que haremos será crear en la búsqueda también tres variables locales con los mismos identificadores y tipos que las del formulario. Si las variables se llaman igual, Velneo V7 pasa el valor de las variables del formulario a las de la búsqueda de forma automática. Una vez creadas las variables locales ya podremos comenzar a crear los componentes de la búsqueda. Éstos permiten definir tanto el índice o índices por los que se realizará la búsqueda como el modo en el que ésta será realizada. Recordemos que la búsqueda que vamos a crear lo hará por los criterios siguientes: Por PALABRAS. o Por TROZOS de palabras. y Entre límites de FECHA. Y de una ENTIDAD concreta. Y Con un ID concreto. 6

7 Para conseguir esto crearemos un primer componente que cargue todos los registros de la tabla y luego crearemos tantos componentes como distintos criterios de búsqueda indicados que vayan reduciendo la lista obtenida hasta llegar al resultado deseado. Para crear un componente de búsqueda pulsaremos el botón panel de subobjetos y seleccionaremos la opción aparecerá en el panel de subobjetos: de la barra de herramientas del Componente búsqueda. El nuevo componente A este componente le estableceremos las siguientes propiedades:» Identificador: TODA_LA_TABLA.» Índice: ID.» Modo: Todo el fichero. Componente: PALABRAS Añadiremos un nuevo componente de búsqueda, y le estableceremos las propiedades siguientes:» Identificador: PALABRAS.» Mezcla: En este parámetro especificaremos la forma de combinar la lista resultante de la ejecución del componente en curso con la del anterior. En este caso, seleccionaremos el valor Cruzar ya que éste hace que la lista resultante esté compuesta por los registros que se repitan en la lista resultante de ejecutar este componente y la del anterior.» Condición activo: Recordemos que todos los componentes se ejecutarán si el campo o variable correspondiente, editado en el formulario de petición de datos, no está vacío. En este caso, además, tendrá que estar condicionado también a que la variable local PALABRAS sea igual a 1. Para especificar esta condición podremos usar el asistente para edición de fórmulas. Para ello pulsar el botón que aparece al editar esta propiedad y estableceremos la siguiente: ( isempty(#name) = 0 ) & PALABRAS» Índice: Seleccionaremos el índice WORDS. 7

8 » Todas las palabras: En este parámetro indicaremos una fórmula que devuelva True si queremos que se busquen solamente aquellos registros que contengan todas las palabras que el usuario haya escrito en el formulario para la petición de datos de la búsqueda, o que devuelva False si queremos que se busquen los registros que contengan cualquiera de las palabras que el usuario haya escrito en el formulario para la petición de datos de la búsqueda. En este caso estableceremos el valor 1, es decir, todas las palabras.» Límite inicial: En esta propiedad indicaremos, mediante fórmulas, qué campos o variables editados en el formulario de petición de datos de la búsqueda van a usarse para resolver el componente o los componentes del índice en cuestión. En este caso, recordemos que aunque el índice WORDS de la tabla de Incidencias, indexaba tanto el campo NAME como el campo OBSERVACIONES, en este caso tendremos que resolver el componente primero. Para ello pulsaremos el botón que aparece al editar esta propiedad, y se abrirá la ventana siguiente: Para resolver la parte de índice correspondiente al campo NAME pulsaremos el botón que aparece al editarlo y seleccionaremos, de la lista de campos de la tabla, el campo NAME. #NAME: 8

9 De esta forma, el texto escrito en el control de edición del campo NAME del formulario de búsqueda será buscado en ambos campos. Componente: TROZOS Añadiremos un nuevo componente de búsqueda, y le estableceremos las propiedades siguientes:» Identificador: TROZOS.» Mezcla: En este parámetro especificaremos la forma de combinar la lista resultante de la ejecución del componente en curso con la del anterior. En este caso, seleccionaremos el valor Cruzar ya que éste hace que la lista resultante esté compuesta por los registros que se repitan en la lista resultante de ejecutar este componente y la del anterior.» Condición activo: Recordemos que todos los componentes se ejecutarán si el campo o variable correspondiente, editado en el formulario de petición de datos, no está vacío. En este caso, además, tendrá que estar condicionado también a que la variable PALABRAS sea igual a 0. Para especificar esta condición podremos usar el asistente para edición de fórmulas. Para ello pulsar el botón que aparece al editar esta propiedad y estableceremos la siguiente: ( isempty(#name) = 0 ) & (! PALABRAS )» Índice: Seleccionaremos el índice PARTS.» Límite inicial: En esta propiedad indicaremos, mediante fórmulas, qué campos o variables editados en el formulario de petición de datos de la búsqueda van a usarse para resolver el componente o los componentes del índice en cuestión. En este caso, recordemos que aunque el índice PARTS de la tabla de Incidencias, indexaba tanto el campo NAME como el campo OBSERVACIONES, en este caso tendremos que resolver el componente primero. Para ello pulsaremos el botón que aparece al editar esta propiedad, y se abrirá la ventana siguiente: 9

10 Para resolver la parte de índice correspondiente al campo NAME pulsaremos el botón que aparece al editarlo y seleccionaremos, de la lista de campos de la tabla, el campo NAME. #NAME: De esta forma, el texto escrito en el control de edición del campo NAME del formulario de búsqueda será buscado en ambos campos. Componente: FECHA Añadiremos un nuevo componente de búsqueda, y le estableceremos las propiedades siguientes:» Identificador: FECHA.» Mezcla: En este parámetro especificaremos la forma de combinar la lista resultante de la ejecución del componente en curso con la del anterior. En este caso, seleccionaremos el 10

11 valor Cruzar ya que éste hace que la lista resultante esté compuesta por los registros que se repitan en la lista resultante de ejecutar este componente y la del anterior.» Condición activo: Recordemos que todos los componentes se ejecutarán si el campo o variable correspondiente, editado en el formulario de petición de datos, no está vacío. Para especificar esta condición podremos usar el asistente para edición de fórmulas. Para ello pulsar el botón que aparece al editar esta propiedad y estableceremos la siguiente: isempty(fch_lim_ini) = 0 Para añadir las variables locales a la fórmula hacerlo a través de la lista de variables locales del asistente, haciendo doble clic sobre la variable deseada para añadirla a la fórmula.» Índice: Seleccionaremos el índice FECHA.» Modo: En este caso seleccionaremos el valor Entre límites, dado que nos interesa buscar entre dos rangos de fechas.» Límite inicial: En esta propiedad indicaremos, mediante una fórmula, qué campos o variables editados en el formulario de petición de datos de la búsqueda van a usarse para resolver el componente o los componentes del índice en cuestión. Para ello pulsaremos el botón que aparece al editar esta propiedad, y se abrirá la ventana siguiente: Para resolver la parte de índice correspondiente al campo FECHA pulsaremos el botón que aparece al editalo y seleccionaremos, de la lista de variables locales la variable FCH_LIM_INI.» Límite final: En esta propiedad indicaremos, mediante una fórmula, qué campos o variables editados en el formulario de petición de datos de la búsqueda van a usarse para resolver el componente o los componentes del índice en cuestión. Para ello pulsaremos el botón que aparece al editar esta propiedad, y se abrirá la ventana siguiente: 11

12 Para resolver la parte de índice correspondiente al campo FECHA pulsaremos el botón que aparece al editarlo y especificaremos la fórmula siguiente: Choose(IsEmpty(FCH_LIM_FIN), FCH_LIM_INI, FCH_LIM_FIN) Es decir, si el usuario no ha cumplimentado el dato de la fecha final, se asumirá el dato especificado en la fecha inicial, en caso contrario, se tomará el dato indicado en la fecha final. Para añadir las variables locales a la fórmula hacerlo a través de la lista de variables locales del asistente de fórmulas, haciendo doble clic sobre la variable deseada para añadirla a la fórmula. Componente: ENTIDAD Añadiremos un nuevo componente de búsqueda, y le estableceremos las propiedades siguientes:» Identificador: ENTIDAD.» Mezcla: En este parámetro especificaremos la forma de combinar la lista resultante de la ejecución del componente en curso con la del anterior. En este caso, seleccionaremos el valor Cruzar ya que éste hace que la lista resultante esté compuesta por los registros que se repitan en la lista resultante de ejecutar este componente y la del anterior.» Condición activo: Recordemos que todos los componentes se ejecutarán si el campo o variable correspondiente, editado en el formulario de petición de datos, no está vacío. Para especificar esta condición podremos usar el asistente para edición de fórmulas. Para ello pulsar el botón que aparece al editar esta propiedad y estableceremos la siguiente: #ENTIDADES! 0 Es decir, que la entidad editada en el formulario sea distinta de 0.» Índice: Seleccionaremos el índice ENTIDADES. 12

13 » Modo: Seleccionaremos el valor Parte izquierda de la clave. Esto realiza la búsqueda de los registros cuya clave coincida con la introducida por el usuario en el formulario para pedir datos, es decir, la entidad introducida en dicho formulario.» Límite inicial: En esta propiedad indicaremos, mediante fórmulas, qué campos o variables editados en el formulario de petición de datos de la búsqueda van a usarse para resolver el componente o los componentes del índice en cuestión. En este caso, tendremos que resolver con la entidad seleccionada en el formulario de petición de datos. Para ello pulsaremos el botón que aparece al editar esta propiedad, y se abrirá la ventana siguiente: Para resolver la parte de índice correspondiente al campo ENTIDADES pulsaremos el botón que aparece al editarlo y seleccionaremos, de la lista de campos de la tabla, el campo ENTIDADES: #ENTIDADES. Componente: ID Añadiremos un nuevo componente de búsqueda, y le estableceremos las propiedades siguientes:» Identificador: ID.» Mezcla: En este parámetro especificaremos la forma de combinar la lista resultante de la ejecución del componente en curso con la del anterior. En este caso, seleccionaremos el valor Cruzar ya que éste hace que la lista resultante esté compuesta por los registros que se repitan en la lista resultante de ejecutar este componente y la del anterior.» Condición activo: Recordemos que todos los componentes se ejecutarán si el campo o variable correspondiente, editado en el formulario de petición de datos, no está vacío. Para especificar esta condición podremos usar el asistente para edición de fórmulas. Para ello pulsar el botón que aparece al editar esta propiedad y estableceremos la siguiente: #ID! 0, es decir, que el ID sea distinto de 0.» Índice: Seleccionaremos el índice ID. 13

14 » Modo: Seleccionaremos el valor Parte izquierda de la clave. Esto realiza la búsqueda de los registros cuya clave coincida con la introducida por el usuario en el formulario para pedir datos, es decir, con el ID introducido en dicho formulario.» Límite inicial: En esta propiedad indicaremos, mediante fórmulas, qué campos o variables editados en el formulario de petición de datos de la búsqueda van a usarse para resolver el componente o los componentes del índice en cuestión. En este caso, tendremos que resolver con el id establecido en el formulario de petición de datos. Para ello pulsaremos el botón que aparece al editar esta propiedad, y se abrirá la ventana siguiente: Para resolver la parte de índice correspondiente al campo ID pulsaremos el botón que aparece al editarlo y seleccionaremos, de la lista de campos de la tabla, el campo ID: #ID. La búsqueda que acabamos de crear podremos dispararla, por ejemplo, desde una acción, usando como objeto de salida cualquier objeto de listas (rejilla, casillero, etc.). 14