Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
Filtrar
Permite criar filtros para uma fonte de dados, visando o tratar os dados que serão retornados.
Parâmetros de entrada
Nome | Tipo | Descrição |
---|---|---|
Parâmetro 1 | Fonte de dados | Fonte de dados que será filtrada pelo bloco |
Parâmetro 2 | Texto | Filtro que será utilizado para tratar as informações da fonte de dados no bloco |
Compatibilidade
Servidor
Cliente
Operadores de comparação OData
Os comandos enviados para o bloco utilizam operadores lógicos do OData, são eles:
- eq: verifica se o campo é igual ao valor informado;
- ne: verifica se o campo é diferente do valor informado;
- gt: valida se o campo é maior que o valor informado;
- lt: verifica se o campo é menor que o valor informado;
- ge: valida se o campo é maior ou igual ao valor informado;
- le: valida se o campo é menor ou igual ao valor informado.
Operadores lógicos OData
É possível também construir expressões utilizando os operadores lógicos do OData. São eles:
- and: operador binário classificado como true se as subexpressãos a esquerda e direta são classificadas como true;
- or: operador binário classificado como true se uma de suas subexpressãos a direita ou esquerda foram classificadas como true;
- not: operador unário avaliado como true se sua subexpressão é avaliada como false e vice-versa.
Informações | ||
---|---|---|
| ||
Para mais informações sobre os operadores do OData, clique aqui. |
Exemplo
Nesse exemplo, será realizado um filtro na fonte de dados abaixo para que só apareçam na grade as pessoas maiores de 18 anos.
Figura 1 - Pessoas cadastradas na lista
Para isso é preciso selecionar a fonte de dados no bloco e em seguida enviar um comando de filtro que segue os padrões OData. Como em nosso exemplo queremos retornar apenas as pessoas maiores de 18 anos, o comando utilizado será " idade gt 18 ".
Figura 2 - Função que filtra a fonte de dados
O botão "Filtrar" abaixo da grade está chamando o bloco de programação "FiltrarFonte", ao clicar no botão, a grade é atualizada com o novo filtro.
Figura 3 - Resultado do filtro aplicado na fonte de dados
Utilização da função
Para utilizar a função é necessário adicionar uma fonte de dados a uma view. Além disso, é preciso vincular o bloco de programação a view onde está a fonte de dados desejada, caso não saiba como fazer o vínculo clique aqui.