En este artículo aprenderemos cómo podemos crear una página de búsqueda en una aplicación en Oracle APEX utilizando las configuraciones de búsquedas.
Para agregar una búsqueda a una aplicación debemos realizar dos pasos básicos:
- Crear una configuración de búsqueda en Componentes Compartidos. Una configuración de búsqueda contiene información sobre la fuente de datos que se puede buscar. Los tipos de búsqueda permitidos incluyen:
- Estándar: La búsqueda se basa en una tabla, consulta SQL o fuente de datos REST. Podemos seleccionar la tabla en el asistente o ingresar una consulta SQL.
- Lista: La búsqueda se realiza dentro de una lista seleccionada de Componentes Compartidos.
- Oracle TEXT: La búsqueda se ejecuta utilizando la funcionalidad Oracle TEXT que proporciona capacidades de búsqueda lingüística y difusa.
- Crear una página de búsqueda. Podemos crear una página de búsqueda ejecutando el Asistente para Crear Página y seleccionando Página de búsqueda, o agregando componentes de búsqueda manualmente. Una página de búsqueda presenta un campo de búsqueda (o elemento de página) que permite a los usuarios enviar términos de búsqueda y una región de resultados de búsqueda. La región de Resultados de búsqueda contiene origenes de búsqueda que se asignan a configuraciones de búsqueda.
Preparando la Búsqueda de Aplicación
Para el siguiente ejemplo de cómo crear una búsqueda estándar vamos a partir de los siguientes supuestos:
- Instalamos el juego de datos de ejemplo Datos de proyectos en nuestro esquema. (Desde el módulo Utilidades -> Juego de datos de ejemplo).
- Creamos una aplicación en base a este juego de datos que contendrá dos informes interactivos uno de la tabla EBA_PROJECTS y otro de la tabla EBA_PROJECT_TASKS.
Tareas
Una configuración de búsqueda contiene información sobre un origen de datos con capacidad de búsqueda. Vamos a trabajar primero en crear dos configuraciones de búsqueda y luego vamos a crear una página de búsqueda utilizando el Asistente para crear página.
Crear Configuración de Búsqueda
La primera configuración de búsqueda se asigna a la tabla EBA_PROJECTS. La segunda configuración de búsqueda se asigna a la tabla EBA_PROJECT_TASKS.
Los pasos a seguir para crear dos configuraciones de búsqueda estándar son:
- Ingresamos a la página de inicio de la aplicación en la cual tenemos los dos reportes interactivos de las tablas EBA_PROJECTS y EBA_PROJECT_TASKS.
Hacemos clic en Componentes Compartidos. - En la sección de Navegación y búsqueda, hacemos clic en Buscar configuraciones.
Aparece la página de Buscar Configuraciones. - Vamos a crear la primera configuración de búsqueda que se asigna a la tabla EBA_PROJECTS:
En la página Buscar Configuraciones, hacemos clic en Crear. Aparece el asistente de Crear configuración de búsqueda.
En el paso 1 del asistente: Detalle:
- Nombre: ingrese un nombre, por ejemplo, Search Projects.
- Tipo de Búsqueda: seleccione Estándar.
- Haga clic en Siguiente.
En el paso 2 del asistente: Origen:
- Origen de Datos: seleccione Base de Datos Local.
- Tipo de Origen: seleccione Tabla.
- Propietario: seleccione el propietario de la tabla.
- Nombre de Tabla/Vista: seleccione EBA_PROJECTS.
- Haga clic en Siguiente.
En el paso 3 del asistente: Asignación de Columna:
- Columna de Clave Primaria: seleccione la columna ID.
- Columna de Título: seleccione la columna NAME.
- Columna de Descripción: seleccione la columna DESCRIPCIÓN.
- Origen de icono: configure el icono que se muestra en el encabezado del resultado de la búsqueda. Las opciones incluyen:
- Iniciales: se utiliza la columna Título para mostrar el icono como iniciales.
- Clase de Icono: se utiliza las clases CSS ingresadas para mostrar el ícono.
- Columna Clase de icono: se utiliza la columna seleccionada que contiene el icono de clase CSS para mostrar el icono. Para este ejemplo, aceptamos el valor predeterminado Iniciales.
- Hacemos clic en Crear configuración de búsqueda.
Se crea la configuración de búsqueda y aparece la página Editar Buscar configuración y muestra el mensaje Configuración de búsqueda creada.
4. Ahora vamos a crear la segunda configuración de búsqueda que se asigna a la tabla EBA_PROJECT_TASKS:
Hacemos clic en la ruta de navegación de Buscar Configuraciones para regresar a la página de Buscar Configuraciones.
Hacemos clic en el botón Crear en la página de Buscar Configuraciones.
Aparece el asistente Crear configuración de búsqueda.
En el paso 1 del asistente: Detalle:
Nombre: ingrese un nombre, por ejemplo, Search Project Tasks.
Tipo de Búsqueda: seleccione Estándar.
Haga clic en Siguiente.
En el paso 2 del asistente: Origen:
Origen de Datos: seleccione Base de Datos Local.
Tipo de Origen: seleccione Tabla.
Propietario: seleccione el propietario de la tabla.
Nombre de Tabla/Vista: seleccione EBA_PROJECT_TASKS.
Haga clic en Siguiente.
En el paso 3 del asistente: Asignación de Columna:
Columna de Clave Primaria: seleccione la columna ID.
Columna de Título: seleccione la columna NAME.
Columna de Descripción: seleccione la columna DESCRIPCIÓN.
Origen de icono: configure el icono que se muestra en el encabezado del resultado de la búsqueda. Para este ejemplo, aceptamos el valor predeterminado Iniciales.
Hacemos clic en Crear configuración de búsqueda.
Se crea la configuración de búsqueda y aparece la página Editar Buscar Configuración.
Hacemos clic en la ruta de navegación de Buscar Configuraciones para regresar a la página de Buscar Configuraciones.
Editar Configuraciones
Desde la página de Editar Buscar configuraciones, hacemos clic en la primera configuración: Search Project Tasks.
En la sección o ficha Enlace, seleccionamos Redirigir a Página en esta Aplicación. Buscamos la página correspondiente al reporte interactivo.
Luego, hacemos clic en Aplicar Cambios.
Seleccionamos la segunda configuración: Search Projects para editar.
Seleccionamos la ficha Enlace y en tipo de enlace seleccionamos Redirigir a página de esta Aplicación.
Crear una página de búsqueda estándar
Una página de búsqueda presenta un campo de búsqueda y una región de resultados de búsqueda. En el Diseñador de Página, la región de Resultados de búsqueda contiene origenes de búsqueda que se asignan a las configuraciones de búsqueda definidas en Componentes Compartidos.
Nota: Utilizando APEX en lenguaje en español se genera un error de que no se puede crear la página. Por ello, hay que crear esta página utilizando APEX en idioma inglés, de ese modo la página será creada normalmente. (Este error ya lo he reportado al equipo de APEX :))
Para crear una página de búsqueda ejecutando el Asistente para crear página:
Navegamos hacia la página de inicio de la aplicación:
- En la página de inicio de nuestro Espacio de Trabajo, hacemos clic en el icono del Creador de Aplicaciones.
- Seleccionamos la aplicación.
- En la página de inicio de la aplicación, hacemos clic en Crear Página.
- Aparece la ventana modal de Crear Página y presenta tres pestañas: Componente, Función y Páginas heredadas.
- En Componente, seleccionamos Página de búsqueda.
- En la sección, Definición de página:
- Nombre: Search Projects.
- Este texto también se utiliza para el título de la página. Después de la creación de la página, podemos modificar el título en el Diseñador de Páginas.
- Modo de Página: Normal.
- Buscar Configuraciones: seleccionamos Search Project Tasks y Search Projects.
- Navegación: aceptamos el valor predeterminado.
- Hacemos clic en Crear Página.
Aparece el diseñador de página.
En la pestaña Representación de página, vemos el elemento de la página, P6_SEARCH y la región de Resultados de la búsqueda. P6_SEARCH es el campo de búsqueda que permite a los usuarios enviar términos de búsqueda. La región de resultados de búsqueda contiene los resultados de la búsqueda y dos origenes de búsqueda que se asignan a las configuraciones de búsqueda creadas en componentes compartidos. Podemos refinar y controlar aún más la visualización y el comportamiento de la búsqueda editando atributos en el Editor de propiedades.
Tengamos en cuenta también que, si seleccionamos un origen de búsqueda, los atributos del origen de búsqueda se muestran en el Editor de propiedades.
Ejecutamos y probamos la página:
En el campo de búsqueda, ingresamos una búsqueda, por ejemplo, web development y presionamos <Enter>.
Aparecen los resultados de la búsqueda.
De esta forma podemos crear una página de búsqueda estándar en APEX.
¡Hasta la próxima!