Resumen
Las vistas de datos permiten agregar filtros fijos o dinámicos, estos últimos llamadados parámetros.
Filtros fijos
Para agregar un filtro debes hacer clic en la opción
Filtrar datos.
Se mostrará una formulario donde deberás seleccionar la columna sobre la cual aplicará el filtro, el tipo de operación, el operador
Valor fijo y el valor por el cual se aplicará el filtro.
Este filtro es fijo, es decir que aplicará siempre sobre la respuesta o contenido del origen de datos y no podrá ser modificado en los métodos de las APIs.
Parámetros
Para agregar un filtro de tipo parámetro debes hacer clic en la opción
Filtrar datos.
Se mostrará una formulario donde deberás seleccionar la columna sobre la cual aplicará el filtro, el tipo de operación, el operador
Parámetro, un valor por defecto y otras conviguraciones de validación.
Los filtros de tipo parámetro estarán disponibles como parámetros del método de la API y podrán ser relacionados a variables de contexto.
A continuación se detallan los campos disponibles:
- Nombre: es el nombre del parámetro, puede ser igual o diferente al título de la columna. El nombre definido aquí es el nombre que asumirá el parámetro del método de la API.
- Descripción: es la descripción del parámetro. Este texto se mostrará en la documentación de la API en el portal del desarrollador, para brindar más información a los desarrolladores que utilicen el método de la API.
- Valor: debe definirse un valor por defecto sobre el cuál aplicará el filtro.
- Tipo de dato: pueden definirse diferentes tipos de datos y reglas de validación.
- Es obligatorio: puede definirse si el parámetro es obligatorio (deberá ser enviado en la solicitud al método de la API) o no lo es. Si no es obligatorio y no es enviado en la solicitud aplicará el valor por defecto definido.
Puedes agregar validaciones a los parámetros que aplicarán en la solicitud al método de la API.
Las validaciones disponibles son:
- Texto
- Número
- Fecha
Texto
En el caso de seleccionar Texto puedes definir de manera opcional:
- Una lista de valores válidos: puedes ingresar hasta 100 valores válidos separados por coma. Se distinguen entre mayúsculas y minúsculas.
- Cantidad máxima de caracteres
Número
En el caso de seleccionar Número puedes definir de manera opcional un valor máximo y mínimo.
Fecha
Puedes agregar validaciones de formatos de fechas, a partir de las siguientes variables:
%Y = Año en 4 dígitos
%y = Año en 2 dígitos
%m = Número de Mes
%B = Nombre completo del Mes
%b = Nombre del Mes abreviado
%d = Días
%H = Horas
%M = Minutos
%S = Segundos
%f = Microsegundos
Se puede usar dos puntos, guión o espacio entre ellos.
Por ejemplo: '%Y-%m-%d %H:%M:%S:%f' es igual a '2006-10-25 14:30:59.00200'
Relación entre los parámetros
Una vez definidas las configuraciones, podrá conocerlas en el resumen y aplicar los operadores AND y OR entre los parámetros.
Puede aplicar más de un filtro a la vista de datos, combinando filtros fijos y parámetros. Además puede indicar si la condición entre múltiples filtros es OR o AND.
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
- No contiene todo