¿Qué es exactamente Search Configuration en Oracle APEX?

Search Configuration en Oracle APEX es un objeto compartido que encapsula la definición de una fuente de datos buscable, la forma en que se deben mostrar los resultados y cómo se debe navegar al hacer clic en un resultado. Estas configuraciones pueden ser referenciadas por las regiones de tipo Search, lo que permite incorporar funcionalidades de búsqueda de manera declarativa, sin necesidad de desarrollar lógica compleja.

Tipos de fuentes de datos compatibles

Oracle APEX permite que Search Configuration se base en diversas fuentes de datos, lo cual la hace extremadamente flexible y poderosa:

Tipo de Fuente	Descripción
Local Data Source	Fuente de datos interna como una tabla o vista de la misma base de datos.
REST Enabled SQL Service	Ejecuta búsquedas sobre una base de datos remota a través de REST SQL.
REST Data Source	Fuente de datos externa definida como un Web Source Module.
Pre-defined Oracle Text	Usa índices Oracle Text predefinidos para búsquedas avanzadas.
Pre-defined Oracle Ubiquitous Search	Integra con mecanismos de búsqueda global en Oracle Cloud.
Pre-defined Oracle Vector Search	Para búsquedas semánticas o basadas en vectores (IA/ML).
Oracle APEX List	Permite buscar dentro de listas de navegación o listas personalizadas.

A continuación, mostraremos como implementar una Busqueda de paginas dentro de una aplicación usando el componente Search Configurations, y en donde el usuario podra buscar dentro de toda la aplicación una pagina determinada y acceder a ella de una manera mas rapida y agil.

1. Crear un Search Configuration

En este caso usaremos la tabla: APEX_APPLICATION_LIST_ENTRIES en donde podremos en funcion a nuestra aplicacion y las lista de entradas en el menu, realizar las busquedas.

App Builder de la aplicacion.
Shared Components.
En la sección de Navigation, haz clic en Search Configurations.
Haz clic en Create.

Configura los siguientes campos:

Name: Búsqueda de Páginas.
Type: Table or View.

Insertar el query: APEX_APPLICATION_LIST_ENTRIES

  Select LIST_ID || '-' || LIST_ENTRY_ID "id",
         ENTRY_TEXT "label",
         APEX_UTIL.PREPARE_URL (
                        replace (
                              replace (
                                 replace (ENTRY_TARGET, '&APP_ID.', :APP_ID),
                                 '&SESSION.', :APP_SESSION),
                              '&DEBUG.', ''))  "target",
         CURRENT_FOR_PAGES_TYPE "is_current_list_entry",
         ENTRY_IMAGE "image",
         ENTRY_IMAGE_ATTRIBUTES "image_attribute", 
         ENTRY_IMAGE_ALT_ATTRIBUTE "image_alt_attribute",
         ENTRY_ATTRIBUTE_01 "attribute1",
         ENTRY_ATTRIBUTE_02 "attribute2",
         ENTRY_ATTRIBUTE_03 "attribute3",
         ENTRY_ATTRIBUTE_04 "attribute4",
         ENTRY_ATTRIBUTE_05 "attribute5",
         ENTRY_ATTRIBUTE_06 "attribute6",
         ENTRY_ATTRIBUTE_07 "attribute7",
         ENTRY_ATTRIBUTE_08 "attribute8",
         ENTRY_ATTRIBUTE_09 "attribute9",
         ENTRY_ATTRIBUTE_10 "attribute10"
  from APEX_APPLICATION_LIST_ENTRIES a
  where APPLICATION_ID = :APP_ID --aca ingresar el numero de la aplicacion

Display Columns: ID, LABEL.
Searchable Columns: ID, LABEL.

En la sección de Link, define que al seleccionar un resultado se redirija a la página correspondiente.

2. Crear una Página de Búsqueda

Crea una nueva página
Crear una region de tipo Search Page.
En Search Sources, seleccionar el Search Configuration creado.
Crear un Page Item en donde ingresará el criterio de busqueda.
En los attributtes de Search Results seleccionar el Page Item creado en: Search Page Item.

3. Como resultado hemos obtenido lo siguiente:

Beneficios de Implementar esta Funcionalidad

✅ Mejora la usabilidad en aplicaciones grandes.
✅ Permite al usuario encontrar rápidamente lo que necesita.
✅ Escalable: puedes usar esta misma técnica para otros tipos de búsqueda (clientes, productos, módulos, etc.).
✅ Centraliza el control de búsqueda desde el componente Search Configuration.

Conclusión

El uso de Search Configuration en Oracle APEX es una práctica recomendada cuando tu aplicación comienza a crecer y el acceso directo a las páginas ya no es tan sencillo. Esta solución no solo mejora la experiencia del usuario, sino que también agrega un nivel de profesionalismo y eficiencia al diseño de tu sistema.

Implementar esta funcionalidad es sencillo, modular y muy potente si se usa correctamente. Aprovecha las herramientas que Oracle APEX ofrece y lleva tu aplicación al siguiente nivel en cuanto a navegabilidad e interacción.

Search Configurations: Mejorando la experiencia de navegación del usuario