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. Puede aplicar filtros a varias capas con los filtros de grupo. 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 cambiar la visibilidad de las entidades en todos los widgets que utilicen la misma capa en su aplicación.
• Desea filtrar entidades de varias fuentes de datos en función de un valor comú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 único seleccionando una fuente de datos y agregando expresiones. El panel Crear nuevo filtro que aparece incluye estos ajustes:
  • Datos: seleccione los datos que quiere filtrar. Solo puede seleccionar una fuente de datos por filtro. Los filtros admiten capas de entidades, capas de entidades en mapas web seleccionados, vistas de datos y URL de servicios de entidades. Si una fuente de datos tiene alguna vista de datos asociada, estará disponible para elegirla en la lista desplegable.
  • Etiqueta: proporcione un nombre significativo para el filtro de grupo. De forma predeterminada, la etiqueta es el nombre de la fuente de datos.
  • 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): active esta opción para que los paneles de filtro se contraigan de forma predeterminada. Si el filtro se configura para pedir valores, los usuarios deben hacer clic para expandir el filtro para ver los detalles adicionales. Este ajuste es útil para ahorrar espacio si tiene muchos filtros.
• Nuevo grupo: haga clic en el botón Nuevo grupo y, a continuación, en Nuevo grupo para crear un filtro de grupo. El panel Crear nuevo grupo que aparece incluye estos ajustes:
  • Datos: seleccione los datos que quiere filtrar. Puede seleccionar varias fuentes de datos. Los filtros de grupo admiten capas de entidades, capas de entidades en mapas web seleccionados, vistas de datos y URL de servicios de entidades. Si una fuente de datos tiene alguna vista de datos asociada, estará disponible para elegirla en la lista desplegable. No se admiten fuentes de datos de salida.
  • Etiqueta: proporcione un nombre significativo para el filtro de grupo. Cuando agrega un filtro de grupo, de forma predeterminada su etiqueta sigue una regla de numeración continua.
  • Icono: elija un icono para el filtro de grupo. 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 Generador de expresiones SQL de grupo ofrece varias opciones para crear consultas complejas e interactivas.
  • Opciones: puede activar las siguientes opciones para cada filtro de grupo:
    • Aplicar este filtro automáticamente: active este ajuste para aplicar el filtro a los datos automáticamente cuando el usuario abra la aplicación.
    • Contraer detalles del filtro automáticamente (si los hay): active esta opción para que los paneles de filtro se contraigan de forma predeterminada. Si el filtro se configura para pedir valores, los usuarios deben hacer clic para expandir el filtro a fin de ver los detalles adicionales. Este ajuste es útil para ahorrar espacio si tiene muchos filtros.
• Si agrega varios filtros individuales o grupos, 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 y grupos para cambiar su orden.
• Puede utilizar los botones Duplicar y Eliminar que aparecen junto a cada filtro y grupo para duplicarlos y eliminarlos.
• 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.
• Herramientas avanzadas: configure herramientas avanzadas.
  • Restablecer todos los filtros: incluya un botón para que los usuarios restablezcan todos los filtros a sus estados configurados originales.

    Sugerencia:

    La herramienta de filtro del widget Lista ofrece un botón de restablecimiento de forma predeterminada.

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 de cada cláusula incluye las siguientes partes:

• 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. Vea una lista completa de operadores admitidos para cada 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 podrá elegir sus valores en los ajustes (excepto para 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: permita que los usuarios proporcionen una entrada personalizada y cambien los filtros durante el 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 la etiqueta.
  • Personalice la posición de la etiqueta. Puede elegir ajustar en línea diferente 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 (solo es aplicable a tipos 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: duplique una sola cláusula o todo un conjunto de cláusulas y agréguelo al final de la cola dentro del Generador de expresiones SQL. Si está dentro de un conjunto de cláusulas, este botón duplica una única cláusula y la agrega al final del 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.

Generador de expresiones SQL de grupo

El Generador de expresiones SQL de grupo le permite realizar expresiones lógicas para filtros de grupo, que filtran varios campos de fuentes de datos basándose en valores comunes. La expresión incluye las siguientes partes:

• Campo principal: el campo que se utiliza para establecer el operador y los valores del resto de campos del filtro de grupo.
• Todos los campos: todos los campos filtrados por el filtro de grupo, incluido el campo principal. Puede utilizar las listas desplegables para seleccionar campos de las fuentes de datos conectadas. Solo puede seleccionar campos que sean del mismo tipo de campo (cadena de caracteres, fecha o número) que el campo principal. Si selecciona varios campos de una misma fuente de datos, haga clic en AND para especificar que el valor debe existir en ambos campos o en OR para especificar que el valor puede existir en cualquier campo.
• Operador: seleccione un operador funcional para evaluar los valores de los datos para los campos seleccionados. Los operadores varían en función del tipo de campo del campo principal. Vea una lista completa de operadores admitidos para cada tipo de campo.
• Valor: escriba o seleccione un valor para completar la expresión. 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).

Puede configurar las siguientes opciones adicionales para la expresión:

• 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 el valor del campo principal. 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 expresión 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: permita que los usuarios proporcionen una entrada personalizada y cambien los filtros durante el 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 la etiqueta de expresión.
  • Personalice la posición de la etiqueta. Puede elegir ajustar en línea diferente 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 (solo es aplicable a tipos de fuente único y múltiple).

Operadores

La siguiente tabla enumera los tipos de campo y los operadores que admiten:

Operador	Número	Cadena de caracteres	Fecha
es
no es
es como mínimo
es como máximo
es menor que
es mayor que
está entre
no está entre
comienza por
no comienza por
termina con
no termina en
contiene
no contiene
es cualquiera de
no es ninguno de
es el
no es el
está en
no está en
es anterior a
es posterior a
es el o antes del
es el o después del
está en el último*
no está en el último*
está en el siguiente*
no está en el siguiente*
está vacío
no está vacío

*Solo se aplica a los servicios de entidades alojados de ArcGIS Online.