Widget Filtrar

El widget Filtrar permite limitar la visibilidad de entidades en una o más capas a solo aquellas que cumplan los criterios de expresión. Los cambios realizados en un widget Filtrar afectan a datos de toda su aplicación, por lo que otros widgets que utilicen las mismas capas se filtran de forma correspondiente.

Ejemplos

Use este widget para apoyar los requisitos de diseño de la aplicación como por ejemplo los siguientes:

• Dispone de un conjunto grande de datos y quiere proporcionar a diferentes públicos opciones relevantes para filtrar los datos por lo que más les interese.
• Desea permitir a los usuarios que cambien la visibilidad de las entidades en todos los widgets que utilicen la misma capa en su aplicación.

Notas de uso

El widget Filtrar requiere que se defina una fuente de datos para cada filtro que agregue. Puede definir acciones para que un widget Filtrar interactúe con otros widgets, como aplicar el zoom a la entidad seleccionada en un mapa de un widget de mapa. Los usuarios finales pueden activar o desactivar cada filtro para controlar la visibilidad de entidades. Al configurar varios filtros para este widget, puede especificar si todos los filtros habilitados deben ser true para mostrar los datos y si alguno puede ser true para mostrar los datos.

Configuración

El widget Filtrar incluye estos ajustes:

• Nuevo filtro: cree un filtro seleccionando una fuente de datos y agregando expresiones. El panel Crear nuevo filtro que aparece incluye las siguientes propiedades:
  • Datos: seleccione los datos que quiere filtrar. Solo puede seleccionar una fuente de datos por filtro. Se admiten capas de entidades, capas de entidades en mapas web seleccionados, vistas de datos y URL de servicios de entidades. Puede elegir las vistas de datos asociadas enumeradas en la lista desplegable, si las hay.
  • Etiqueta: personalice el nombre de cada filtro.
  • Icono: elija un icono para cada filtro. Puede elegir iconos de las galerías General y Flechas, o agregar su propio icono desde un archivo. Haga clic en el botón Eliminar para quitar iconos cargados no utilizados.

    Nota:

    Puede cargar los siguientes formatos de imagen: PNG, GIF, JPG, JPEG y BMP. Para mantener un rendimiento óptimo, hay un límite de tamaño de 10 MB para cada carga.

  • Expresiones SQL: cree expresiones SQL para especificar los criterios del filtro. El Builder de expresiones SQL ofrece varias opciones para crear consultas complejas e interactivas.
  • Opciones: puede activar las siguientes opciones para cada filtro:
    • Aplicar este filtro automáticamente: cuando los usuarios abren la aplicación, este filtro ya está aplicado a los datos. Los usuarios pueden desactivar el filtro en el widget.

      Nota:

      Si el widget Filtrar está anidado en un controlador de widget, el filtro no se aplicará automáticamente a los datos hasta que el panel del widget se abra (de forma manual o se configure en abierto en la configuración del controlador de widget).

    • Contraer detalles del filtro automáticamente (si los hay): si el filtro se configura para pedir valores, los usuarios deben hacer clic para expandir el filtro para ver los detalles adicionales. (Active esta opción para disponer de un aspecto limpio si tuviera muchos filtros).
• Si agrega varios filtros, haga clic en AND para especificar que todos los criterios de filtro deben ser true o haga clic en OR para especificar que cualquier criterio de filtro puede ser true. También puede arrastrar los filtros para moverlos y cambiar el orden.
• Estilo de disposición: elija entre Vertical, Horizontal o Icono para personalizar el estilo deseado para los filtros de un widget.
• Estilo de activación: elija entre Tecla de alternancia o Botón como estilo para activar o desactivar cada filtro. (El estilo predeterminado es Tecla de alternancia).
  • Excluir los estilos de activación de una sola cláusula: si solo hay una cláusula y pide valores (o muestra etiquetas) en cada filtro, esta opción le permite excluir los estilos de activación (junto con la etiqueta y el icono), mostrar el contenido de la cláusula directamente y aplicarla automáticamente.

Builder de expresiones SQL

Un filtro usa expresiones lógicas para buscar y mostrar entidades en una capa a partir de los valores de atributos de sus datos. Las expresiones utilizan la forma general de <nombre de campo> <operador que especifica una condición> <valor o campo>. Por ejemplo, la capacidad de los refugios es mayor que 200.

Para crear expresiones en el Builder de expresiones SQL, haga clic en Agregar cláusula o en Agregar conjunto de cláusulas.

La expresión para cada cláusula incluye los siguientes cuadros de entrada:

• Campo: seleccione un campo de la fuente de datos en la que se va a filtrar. Los tres tipos de campos son número, cadena de caracteres y fecha. Aparecen iconos representativos junto a los nombres de campo.
• Operador: seleccione un operador funcional para evaluar los valores de los datos para el campo seleccionado. Los operadores varían en función del tipo de campo.
• Valor: escriba o seleccione un valor para completar la cláusula. Haga clic en el botón Seleccionar tipo de origen para elegir un valor, como entrada de usuario, campo, único, único (predefinido), múltiple y múltiple (predefinido).

Nota:

Si conecta el Filtro a una fuente de datos de salida, no puede elegir sus valores en la configuración (excepto los valores codificados). La lista de valores se genera dinámicamente en tiempo de ejecución después de que el widget de origen cree los datos de salida. Por este motivo, Pedir valores está activado de forma predeterminada y los valores predefinidos solo se pueden escribir.

Para cada cláusula, puede establecer las siguientes opciones adicionales:

• Distinción entre mayúsculas y minúsculas: para cumplir los criterios del filtro, los datos deben coincidir con el uso de mayúsculas y minúsculas en los valores de la cláusula. Esta opción solo es aplicable a campos de cadenas de caracteres en capas no alojadas (el botón no está disponible para capas alojadas).
• Sin entrada de usuario: de forma predeterminada, la cláusula no pide la entrada de usuarios. Puede activar la opción Mostrar etiqueta para mostrar a los usuarios únicamente las etiquetas predeterminadas o personalizadas.
• Pedir valores: permite a los usuarios personalizar el estilo de entrada, proporcionar una entrada personalizada y cambiar los filtros en tiempo de ejecución. Puede hacer lo siguiente:
  • Elija un estilo de entrada (si hay varios estilos disponibles en función del tipo de fuente de valor seleccionado).
  • Personalice el contenido de la etiqueta.
  • Personalice la posición de la etiqueta: ya sea para ajustarla en otra línea o en la misma línea con entrada.
  • Proporcione sugerencias o instrucciones a los usuarios.
  • Elija los criterios para la lista de valores que los usuarios ven en las opciones de filtro (el último solo es aplicable a un tipo de fuente único y múltiple). Puede mostrar todos los valores, valores de filtro basados en una expresión previa o valores de filtro basados en todas las expresiones.

    Nota:

    Los valores predefinidos le permiten filtrar en función de uno o varios valores que elija en una lista estática o que introduzca directamente. De forma predeterminada, Pedir valores está activado y la lista se configura para mostrar valores en función de las expresiones anteriores. También puede arrastrar los valores para moverlos y cambiar el orden.

• Duplicar: permite a los usuarios duplicar directamente una sola cláusula o un conjunto de cláusulas completo y agregarla la última en la cola dentro del Constructor de expresiones SQL. Si está dentro de un conjunto de cláusulas, esto permite a los usuarios duplicar una sola cláusula y agregarla al final de este conjunto de cláusulas.

Si agrega más de una cláusula o conjunto de cláusulas al filtro, haga clic en AND para especificar que todos los criterios de filtro deben ser true o haga clic en OR para especificar que cualquier criterio de filtro puede ser true. También puede configurar este ajuste para las cláusulas de un conjunto de cláusulas.