{"id":14165,"date":"2020-01-03T10:00:03","date_gmt":"2020-01-03T18:00:03","guid":{"rendered":"http:\/\/clartechsolutions.com\/?p=14165"},"modified":"2023-03-01T18:02:21","modified_gmt":"2023-03-01T18:02:21","slug":"apex-19-2-busqueda-por-facetas","status":"publish","type":"post","link":"https:\/\/kiusi.com\/en\/apex-19-2-busqueda-por-facetas\/","title":{"rendered":"APEX 19.2 – B\u00fasqueda por Facetas"},"content":{"rendered":"

Una de las nuevas caracter\u00edsticas m\u00e1s interesantes de APEX 19.2 es Faceted Search. La b\u00fasqueda por facetas (o navegaci\u00f3n por facetas) se ve con bastante frecuencia en Internet; t\u00edpicamente en sitios web de tiendas o ventas online. El usuario final puede configurar filtros usando Facetas en el lado izquierdo o superior de la pantalla. Una faceta muestra los posibles valores junto con el recuento de ocurrencias dentro del conjunto de resultados. Despu\u00e9s de que el usuario final cambi\u00f3 una faceta, los resultados, las facetas dependientes y los recuentos de ocurrencias se actualizan inmediatamente.<\/p>\n

Vamos a probar esta nueva caracter\u00edstica. Para ello abrimos el asistente para la creaci\u00f3n de P\u00e1ginas, seleccionamos Informe y luego B\u00fasqueda por Facetas:<\/p>\n

\"\"
Fig. 1: Asistente Crear P\u00e1gina de B\u00fasqueda por Facetas<\/figcaption><\/figure>\n

Despu\u00e9s que elegimos la “B\u00fasqueda por Facetas” y de configurar los atributos habituales, como el nombre de la p\u00e1gina o si deseamos crear una entrada en el men\u00fa de navegaci\u00f3n, aparece el paso “Origen del Informe”. Aqu\u00ed seleccionamos de d\u00f3nde provienen los datos para la p\u00e1gina de B\u00fasqueda de Faceta.<\/p>\n

\"\"
Fig. 2: Origen del Informe<\/figcaption><\/figure>\n

Se pueden crear p\u00e1ginas de b\u00fasqueda por facetas para tablas o consultas SQL; con or\u00edgenes de datos como: Base de Datos Local, Servicio de SQL activado para REST y Origen Web. Para las tablas locales, APEX mantiene una memoria cach\u00e9 de diccionario, que contiene informaci\u00f3n sobre columnas de tablas, claves for\u00e1neas y datos reales. Basado en este cach\u00e9, APEX puede proponer facetas apropiadas y crearlas autom\u00e1ticamente. Como lo podemos ver en la imagen de abajo.<\/p>\n

\"\"
Fig. 3: P\u00e1gina B\u00fasqueda por Facetas<\/figcaption><\/figure>\n

La Fig. 3 muestra la p\u00e1gina de “B\u00fasqueda por Facetas” generada para la tabla EMP. Basada en la memoria cach\u00e9 del diccionario, APEX pudo seguir la relaci\u00f3n de clave for\u00e1nea con la tabla DEPT y crear la faceta con los valores de visualizaci\u00f3n adecuados. Adem\u00e1s, los valores de la columna SAL se distribuyeron en diferentes rangos y se cre\u00f3 una faceta para ingresar el rango de salario. Todas las facetas muestran el recuento de ocurrencias por defecto; los cambios en las facetas conducen a una actualizaci\u00f3n inmediata de la lista de resultados.<\/p>\n

Ahora apliquemos algunos cambios a la p\u00e1gina que acabamos de generar. Despu\u00e9s de hacer clic en Editar p\u00e1gina en la barra de herramientas del desarrollador, el Dise\u00f1ador de P\u00e1ginas se abre y muestra los componentes de la p\u00e1gina.<\/p>\n

\"\"
Fig. 4: P\u00e1gina de B\u00fasqueda por Facetas vista desde el Dise\u00f1ador de P\u00e1ginas<\/figcaption><\/figure>\n

Podemos ver que la p\u00e1gina consta de una regi\u00f3n de informe cl\u00e1sico, que muestra los resultados de b\u00fasqueda, y una regi\u00f3n del nuevo tipo de b\u00fasqueda por facetas, que contiene las facetas. La regi\u00f3n de b\u00fasqueda por facetas est\u00e1 vinculada a la regi\u00f3n del informe cl\u00e1sico (Fig. 5), y cada faceta est\u00e1 vinculada a una de las columnas de resultados del informe cl\u00e1sico (Fig.6).<\/p>\n

\"\"
Fig. 5: La regi\u00f3n de b\u00fasqueda por facetas est\u00e1 vinculada a la regi\u00f3n de informe cl\u00e1sico.<\/figcaption><\/figure>\n
\"\"
Fig. 6: Cada faceta est\u00e1 vinculada a una columna del informe<\/figcaption><\/figure>\n

Las facetas se pueden mostrar como diferentes tipos de elementos IU. APEX 19.2 proporciona los siguientes tipos de facetas.<\/p>\n

    \n
  1. Checkbox (Casilla de Control)<\/li>\n
  2. Radio Group (Grupo de Botones de Radio)<\/li>\n
  3. Select List (Lista de Selecci\u00f3n)<\/li>\n
  4. Range (Rango)<\/li>\n
  5. Search (Buscar)<\/li>\n<\/ol>\n

    La casilla de control, la lista de selecci\u00f3n y los grupos de botones de radio se explican por s\u00ed mismas: las casillas de control permiten elegir m\u00faltiples valores para usarlos en el filtrado de resultados, mientras que los grupos de botones de radio o las listas de selecci\u00f3n solo permiten elegir uno de los valores.<\/p>\n

    La Faceta SEARCH<\/strong><\/p>\n

    La faceta Buscar<\/strong> permite al usuario final realizar una b\u00fasqueda basada en texto en la lista de resultados. Solo se admite una faceta de tipo Buscar para una regi\u00f3n de Faceta por B\u00fasqueda. Las columnas del informe que se usar\u00e1n para la b\u00fasqueda se configuran en la secci\u00f3n Origen dentro de los atributos de la faceta por b\u00fasqueda (Fig. 7).<\/p>\n

    \"\"
    Fig. 7: Configurar columnas de informe para usar en la faceta por b\u00fasqueda<\/figcaption><\/figure>\n

    Si la columna, a la que se hace referencia en la faceta Search, usa un LOV para mostrar, la faceta Search buscar\u00e1 autom\u00e1ticamente en la columna de visualizaci\u00f3n de LOV en lugar de la columna de retorno. La faceta Search aparece de manera predeterminada como la primera faceta en la regi\u00f3n de Facetas por B\u00fasquedas. Como alternativa, podemos crear un elemento de p\u00e1gina del tipo Campo de Texto y usarlo como la faceta Search (Fig. 8).<\/p>\n

    \"\"
    Fig. 8: Configurar un elemento de texto personalizado como la faceta de b\u00fasqueda<\/figcaption><\/figure>\n
    \"\"
    Fig. 9: Uso de un elemento de p\u00e1gina externo para la faceta Buscar.<\/figcaption><\/figure>\n

    La figura 9 muestra una p\u00e1gina de b\u00fasqueda por Facetas que utiliza un elemento de p\u00e1gina personalizado para la faceta de b\u00fasqueda.La Faceta RANGO<\/strong><\/p>\n

    La Faceta de rango permite filtrar la lista de resultados para valores entre un l\u00edmite inferior y superior. Una faceta de rango consiste en un LOV con rangos predefinidos para elegir, dos campos de texto para ingresar manualmente el l\u00edmite inferior y superior, o ambos. Para los rangos predefinidos, se usa la infraestructura APEX LOV normal: por lo tanto, el LOV puede ser un LOV est\u00e1tico, definido en el Dise\u00f1ador de p\u00e1ginas, o uno din\u00e1mico, utilizando una Consulta SQL. En ambos casos, el valor de retorno de LOV debe usar el car\u00e1cter de canalizaci\u00f3n (|) para separar los valores superior e inferior. La figura 11. muestra un ejemplo de configuraci\u00f3n.<\/p>\n

    \"\"
    Fig.10: Configuraci\u00f3n de LOV para la Faceta de Rango<\/figcaption><\/figure>\n

    Las facetas de rango tambi\u00e9n proporcionan soporte limitado para las columnas DATE y TIMESTAMP.<\/p>\n

    Los asistentes Crear P\u00e1gina y Crear Aplicaci\u00f3n nunca generan facetas de rango para columnas DATE.<\/p>\n

    Solo se admiten rangos predefinidos; campos de texto o selectores de fecha para elegir manualmente una fecha como l\u00edmite superior o inferior no es compatible.<\/p>\n

    Dado esto, una faceta de rango para la columna HIREDATE de la tabla EMP se puede crear manualmente en el Dise\u00f1ador de P\u00e1ginas de la siguiente manera:<\/p>\n

      \n
    1. \n
        \n
      1. En el Dise\u00f1ador de p\u00e1ginas, abrimos el men\u00fa contextual del nodo Facetas en nuestra regi\u00f3n de B\u00fasqueda por Facetas.
        \n\"\"<\/li>\n<\/ol>\n<\/li>\n
      2. Ingresamos un nombre para la faceta, por ejemplo: PX_HIREDATE<\/strong> y elegimos una etiqueta.<\/li>\n
      3. Seleccionamos Rango<\/strong> como el tipo de faceta<\/li>\n
      4. Asignamos la faceta a la columna de informe cl\u00e1sico HIREDATE<\/strong> y elejimos FECHA<\/strong> como tipo de datos\"\"<\/li>\n
      5. En la secci\u00f3n Configuraci\u00f3n<\/strong>, desactivamos la Entrada Manual<\/strong>. Esto es obligatorio: la p\u00e1gina arrojar\u00e1 un mensaje de error si la entrada manual est\u00e1 activada para una faceta de rango en una columna FECHA.<\/li>\n
      6. Ingresamos los valores de LOV. Para las columnas DATE, usamos el “formato de fecha can\u00f3nico” de YYYYMMDDHH24MISS<\/strong>. Usamos el s\u00edmbolo de tuber\u00eda (|) para separar el l\u00edmite inferior del superior. Ingresamos el valor de visualizaci\u00f3n seg\u00fan corresponda. Para la columna HIREDATE<\/strong> de la tabla EMP<\/strong>, la definici\u00f3n de LOV podr\u00eda tener el siguiente aspecto:
        \nAntes de 1980         |19800101000000
        \n1980 y 1981              19800101000000|19820101000000
        \n1982 y 1983              19820101000000|19840101000000
        \nDespu\u00e9s de 1983     19840101000000|<\/p>\n

        \"\"<\/li>\n

      7. Guardamos los cambios y ejecutamos la p\u00e1gina. Ahora deber\u00eda tener otra faceta que permita filtrar los resultados en la columna HIREDATE.
        \n\"\"<\/li>\n<\/ol>\n

        Con el mismo enfoque, tambi\u00e9n podemos agregar manualmente m\u00e1s facetas para otras columnas. Lo m\u00e1s importante para cada faceta es t\u00edpicamente el LOV a usar. Para las facetas buenas y utilizables, esa lista no deber\u00eda tener demasiados valores.<\/p>\n

        Atributos de Faceta<\/strong><\/p>\n

        El Dise\u00f1ador de P\u00e1ginas permite configurar una serie de atributos de faceta (fig. 12). \u00c9stos incluyen:<\/p>\n