Índice

Objetivo

        O objetivo deste documento é demonstrar como é utilizado os filtros em uma visão.

Introdução

        Os filtros são utilizados para melhorar a visualização dos registros em uma visão ou mesmo trazer aqueles que lhe fazem necessidade.

Gerenciamento dos Filtros

        Para criar um filtro na visão dos sistemas clique no botão Filtros | Novo Filtro.

        Acessando Filtros | Novo Filtro você verá todos os filtros disponíveis para uso, bem como sua expressão de filtragem. Esta janela lhe oferece os recursos de Inclusão, Exclusão, Alteração, Renomear filtros e cópia de Filtros. Aqui determinado também qual filtro será usando todas as vezes que você abrir a visão do filtro.

Veja os operadores disponíveis:

• IGUAL A (=): Retornar registros igual a um determinado valor passado pelo usuário 
• DIFERENTE DE (<>): Retornar Registros diferentes de um determinado valor passado pelo usuário
• MAIOR QUE (>): Retornar Registros maiores que um determinado valor passado pelo usuário
• MAIOR OU IGUAL A (>=): Retornar maiores ou igual a de um determinado valor passado pelo usuário
• MENOR QUE (<): Retornar Registros menor que um determinado valor passado pelo usuário
• MENOR OU IGUAL A(<=): Retornar Registros menores ou iguais a um determinado valor passado pelo usuário
• IS NULL: Retornar registros com conteúdos nulos
• IS NOT NULL: Retornar registros com conteúdos não nulos
• LIKE: Determina se uma cadeia de caracteres (string) corresponde a um padrão especificado. Um padrão pode incluir caracteres normais e curingas.
• NOT LIKE: inverte a comparação, verificando se a cadeia de caracteres NÃO corresponde ao padrão especificado.
• BETWEEN: Para utilizar intervalos de valores. Ao utilizar esse operador, tanto o campo Valor quanto o Valor Final ficam habilitados para que sejam informados os valores de início e fim.
• IN (SQL): Para utilizar uma sentença SQL como filtro. No campo Valor selecione a sentença SQL (que está cadastrada no menu Utilitários | Consultas SQL).
• NOT IN (SQL): Para utilizar uma sentença SQL como filtro. No campo Valor selecione a sentença SQL (que está cadastrada no menu Utilitários | Consultas SQL). Nesse caso, o resultado será contrário ao IN.
• IN (Valores): Para utilizar mais de um valor no operador IN no campo selecionado.
• NOT IN (Valores): Para utilizar mais de um valor no operador NOT IN no campo selecionado.

        Para os filtros de data existem datas dinâmicas: Ontem, Hoje, Amanhã, Nesta Semana, Neste Mês e Neste Ano. Essas datas dinâmicas e o calendário podem ser exibidos se o campo for do tipo data e clicando no ícone ...(reticências) do campo Valor. Ainda podem ser feitas manipulações nas datas dinâmicas.

        Exemplo:

• Para retornar lançamentos que vencem na próxima semana deve ser utilizado o campo "Vencimento", o operador deve ser "=" e o valor "Nesta Semana+1"
• Para utilizar um filtro que chama um segundo filtro utilize o botão "Novo grupo".
• Para utilizar uma sentença SQL como filtro utilize o operador IN e no campo Valor selecione a sentença SQL (que está cadastrada no menu Utilitários | Consultas SQL).
• Podem ser utilizados os conectivos "e" e "ou".

Parâmetro Para o Filtro

        Para utilizar um parâmetro no filtro selecione um campo da base de dados, o operador "=" e no campo  'Valor' informe:\[Texto a ser exibido na execução do filtro\], que funciona como um parâmetro. Ao executar o filtro, na tela vai aparecer um local para informar o valor do parâmetro.

     Exemplos: Visão de Clientes/Fornecedores:

• Campo: Nome Fantasia
  Operador: =
  Valor: \[Nome\]%
  Resultado esperado: Na execução do filtro, será solicitado o nome. Suponha que seja digitada somente a letra "A", então o filtro será de todos os nomes fantasia que começam com a letra A.
  
  
• Campo: Código
  Operador: BETWEEN
  Valor: \[Início\]
  Valor Final: \[Fim\]
  Resultado esperado: Na execução do filtro, será solicitado o início e o fim. Suponha que seja digitado para o Início C00000 e para o Fim C99999, então o filtro retorna todos os Clientes que possuem código dentro do intervalo de C00000 a C99999.  Quando o parâmetro for do tipo data, será exibida uma máscara de data no campo. Caso queira, também pode se escolher a data clicando no botão de reticências, será exibido um calendário para se escolher a data do parâmetro.

Expressão

        O Campo expressão exibe todos os critérios do filtro que está sendo editado ou inserido, bem como a sua montagem e seu agrupamento. Para excluir os critérios do filtro selecione o critério e clique no primeiro X. Para excluir todos de uma vez só, clique no segundo X. Alem disso é possível alternar a ordem dos critérios, clicando nos critérios e clicando nas setas na barra de tarefas da expressão.  No critério do Filtro, você pode definir propriedades para cada item:

• Proibir Alteração de Critério: Na primeira coluna representada pelo Cadeado, caso ela esteja marcado o check, indica que é um critério que não poderá ser alterado.
• Proibir Visualização do Critério: Na segunda coluna representada por Pontos Coloridos, caso esteja marcado o check, indica que o usuário não irá visualizar o critério quando editar o filtro.
• Action de Pesquisa: Na coluna Action, caso se escolha uma Action para associá-la ao critério, indica que caso o critério possua parâmetro, este poderá ser associado á um campo de pesquisa e o resultado dessa pesquisa irá preencher o parâmetro. Essa pesquisa será com base em um campo disponível pela Action.  Para definir a Action deve-se acessar á coluna de Actions e clicar no botão reticências. Isso irá abrir a tela de Auto Procura. Nessa tela será necessário preencher os campos: 
  Action: Defina a Action que será usada para efetuar a busca do registro. 
  Campo Chave: Campo que será usado para preencher o parâmetro do critério. 
  Campo de Pesquisa: Campo que será exibido no momento da execução do Filtro, para fazer a pesquisa do registro na Action.

        Após o preenchimento clique em OK na tela de Auto Procura. Clique em OK na tela de criação de filtro. Nomeie o Filtro como "Exemplo de Action". Execute o Filtro criado. Será exibido à tela de Parâmetro do Filtro com o Campo CODCOLIGADA como lookup. Clique nas reticências. Faça a busca por um registro que exista na tabela de Cliente\Fornecedor. Após encontrar o registro dê um duplo clique ou clique em OK. O valor do campo CODCOLIGADA que estiver no registro que foi encontrado da tabela de Cliente\Fornecedor será utilizado para preencher o parâmetro. Clique em OK. Os registros serão filtrados com base na coligada escolhida.