jueves, 24 de julio de 2014

Crear formulario búsqueda en 10g. Parte 3. Creando la página

Descripción: En este artículo vamos mostrar cómo crear la página con el formulario de búsqueda (search form) en 10g a partir del view object y bind variables creados en los artículos anteriores.

Puedes descargar el ejemplo completo en este enlace: Descarga del ejemplo (10g)

Para incluir el formulario de bússqueda debemos ir a Data Controls y seleccionar la View en la cual queremos tanto buscar como mostrar los resultados.

viewobject desde el datacontrol
vista del viewObject en el DataControl




Extendemos el apartado Operations, y desplegamos el que dice ExecuteWithParams.
ExecuteWithParams se aplica a los filtrados realizados a través de parámetros. En este caso, el parámetro es la bind variable que hemos creado a través de la cual enviamos el valor por el que queremos filtrar.

Si arrastramos a la página (vista de código o de diseño), o si arrastramos a la pestaña de estructura (structure tab), podemos ver que se nos muestra un menú contextual en el que se nos pregunta qué queremos crear.
En este caso vamos a crear un ADF Parameter form.

crear ADF parameter form
crear ADF parameter form

Al hacerlo, se nos muestra una ventana para que seleccionemos los parámetros que queremos utilizar en este buscador. También podemos seleccionar qué etiqueta mostrar junto al cuadro de búsqueda así como qué tipo de componente utilizar.
Nota: En ocasiones podemos tener varios criterios de filtrado, y habrá páginas o escenarios en los cuales, un usuario podrá utilizar sólo algunos criterios, y otro usuarios otros distintos. En nuestro ejemplo sólo tenemos un criterio de filtrado por lo que no tenemos esta situación.

configurar campos del buscador
configurar campos del buscador

Una vez creado el formulario de búsqueda, tendremos que añadir el listado de los resultados.
Para ello utilizaremos el componente aftable, que nos permita mostrar en forma de tablas los datos.

Para hacer esto, volvemos a ir a la View en el DataControl, y arrastramos esta vez a la view a la página o al lugar de la estructura donde queremos que se encuentre.
Seleccionamos para esta ocasión que queremos crear un ADF Read-only Table (tabla de sólo lectura).

añadir tabla de resultados de busqueda
añadir tabla con los resultados




Al hacer esto, se nos presenta un cuadro parecido al que vimos para los parámetros del cuadro de búsqueda. Podemos elegir qué columnas de datos mostrar, con qué título en la cabecera y el componente que se utilizará para mostrar los datos en cada celda.

selección de columnas resultados
selección de columnas de resultados




En este ejemplo vamos a mostrar sólo, los campos FirstName y LastName, por lo que eliminamos los otros.

selección de campos y opciones de la tabla (aftable)
selección de campos y opciones de la tabla (aftable)


También seleccionamos que la tabla permita seleccionar elementos, así como ordenar los resultados dependiendo de los valores de cada columna.

Finalmente ejecutamos la tabla y podemos ver cómo queda.
Evidentemente habría que dar unos cuantos retoques para mejorar el aspecto.

vista resultado buscador
vista resultado buscador

Artículos relacionados:
- Crear formulario búsqueda en 10g. Parte 1. ViewObject y Bind Variable
- Crear formulario búsqueda en 10g. Parte 2. bind variable en la consulta



Puedes seguir el blog por Blogger Twitter

No hay comentarios:

Publicar un comentario