Agregar filtros y parámetros en la vista de datos

Agregar filtros y parámetros en la vista de datos

Resumen

Las vistas de datos permiten agregar filtros fijos o dinámicos; estos últimos se llaman parámetros. Un filtro fijo se aplica siempre; un parámetro lo decide quien consume el método de la API. En este video se muestra cómo agregar los dos tipos, cómo se combinan con and u or, y dónde quedan los parámetros en la vista guardada.

Antes de comenzar

  • Abra el asistente de vistas desde un origen de datos y seleccione los datos (tabla completa o columnas). Las opciones de filtro están en el Modo avanzado.

Filtros fijos

Agregar un filtro fijo

Para agregar un filtro haga clic en la opción Filtrar datos. Se muestra un formulario donde debe seleccionar la columna sobre la cual se aplica el filtro, el tipo de operación, el operador Valor fijo y el valor por el cual se aplica el filtro. Por ejemplo: columna region, operación Igual a, valor Norte. Confirme con Listo.

Este filtro es fijo, es decir que se aplica siempre sobre la respuesta o contenido del origen de datos y no puede modificarse desde los métodos de las APIs.

Formulario de filtro con columna, operación y valor fijo

Relación entre los filtros

Puede aplicar más de un filtro a la vista, combinando filtros fijos y parámetros. Con dos o más filtros, el panel Resumen de la recolección muestra la relación entre ellos: and, se deben cumplir todos, u or, alcanza con que se cumpla uno. Haga clic en la flecha para pasar de uno a otro.

Parámetros

Agregar un parámetro

Para agregar un filtro de tipo parámetro haga clic en Filtrar datos, seleccione la columna y la operación, y elija el operador Parámetro. Complete un valor por defecto y las configuraciones de validación. Los filtros de tipo parámetro quedan disponibles como parámetros del método de la API y pueden relacionarse con variables de contexto.

Formulario de parámetro con nombre, descripción, valor por defecto y tipo

Los campos disponibles son:

  • Nombre: es el nombre del parámetro, puede ser igual o diferente al título de la columna. Es el nombre que asume el parámetro del método de la API.
  • Descripción: se muestra en la documentación de la API en el portal para desarrolladores.
  • Valor por defecto: el valor que aplica el filtro cuando la solicitud no envía el parámetro.
  • Tipo de dato: texto, número o fecha, con sus reglas de validación.
  • Es obligatorio: si está marcado, el parámetro debe enviarse en la solicitud al método de la API. Si no lo está y no se envía, aplica el valor por defecto.

Validaciones

Puede agregar validaciones a los parámetros, que se aplican en la solicitud al método de la API:

  • Texto: una lista de hasta 100 valores válidos separados por coma, que distingue mayúsculas y minúsculas, y una cantidad máxima de caracteres.
  • Número: un valor mínimo y un valor máximo.
  • Fecha: un formato armado con %Y (año en 4 dígitos), %y (año en 2 dígitos), %m (número de mes), %B (nombre del mes), %b (mes abreviado), %d (día), %H (horas), %M (minutos), %S (segundos) y %f (microsegundos). Se pueden usar dos puntos, guion o espacio entre ellos. Por ejemplo, %Y-%m-%d %H:%M:%S valida 2006-10-25 14:30:59.

Revisión y vista guardada

En el paso 4. Revisión la vista previa aplica los filtros y muestra cada parámetro con su valor por defecto, para que pueda probar otros valores antes de guardar. Después de Guardar, la ficha de la vista lista los parámetros definidos.

Operaciones de filtros

Las operaciones disponibles al aplicar filtros fijos y de tipo parámetro son: Igual a, No igual a, Más grande que, Más grande o igual que, Más pequeño que, Más pequeño o igual que, Contiene alguno, Contiene todo y No contiene todo.

Resultado esperado

El resumen del paso 1 lista cada filtro por columna, con Editar y x para quitarlo, y la relación and u or entre ellos. En la ficha de la vista aparecen los parámetros, que luego se heredan en los métodos de la API.

Errores frecuentes

  • La relación and / or no aparece: solo se muestra cuando hay dos o más filtros.
  • La vista previa no trae filas: el valor fijo o el valor por defecto del parámetro no coincide con ningún dato. Revise mayúsculas y minúsculas.
  • El método de la API rechaza la solicitud: un parámetro obligatorio no fue enviado, o el valor no pasa la validación definida.

Artículos relacionados