Filtro

Configuração

Através do quadro abaixo podemos definir todas as opções que farão parte do Filtro do Formulário.

Interface de configuração do Filtro.

• Atributos

• Filtro Vazio : Se o usuário escolher Sim, serão apresentados todos os registros, caso os campos do filtro estejam em branco. Se a opção for Não nenhum registro é exibido.
• Condição do Filtro : Permite selecionar o comando SQL AND (e) ou OR (ou) para definir os critérios de pesquisa a serem utilizados;
• Exibir Condição : Exibir condição do filtro para que o usuário possa escolher sua opção. Nesse caso “AND” (e) ou “OR” (ou) aparecerão no Formulário de Filtro para que o usuário selecione a opção desejada.
• Usar Autocomplete nos Campos : Campo vira autocomplete automaticamente de acordo com os valores existentes no banco de dados, Se o usuário escolher Sim, o autocomplete será habilitado de forma automatica em todos os campos que possuirem relacionamento. Se a opção for Não nenhum autocomplete será exibido. Caso a opção selecionada seja Defino por campo será respeitada a configuração individual de cada campo.

Filtro dinâmico

Funcionalidade que permite que ao usuário final realizar buscas em sua aplicação sem precisar navegar para outra aplicação, o desenvolvedor precisará indicar quais campos ficarão disponíveis na aplicação.

Configuração

*Interface Configuração do Filtro dinâmico.

• Usar a tecla ENTER para : Utilize a tecla ENTER para tabular de um campo para o próximo, ou para submeter a pesquisa.

Selecionar Campos

Interface de seleção dos campos do filtro dinâmico.

QuickSearch

Quick Search é uma opção que nos permite fazer buscas em vários campos da aplicação através de um campo de entrada de texto na barra de ferramentas.

Ver Vídeo

Aplicação em execução com QuickSearch.

Configurações do Quicksearch

Interface de configuração do QuickSearch.

Layout do Quicksearch

Simplificado: Visualização padrão do quicksearch. Nesta opção é exibido o input onde devemos informar o termos a ser buscado.

Estendido: Neste layout, além do input presente no layout simplificado, descrito acima, é possível selecionar as colunas onde a busca será realizada e o critério que será aplicado. Os critérios devem ser selecionados na opção _Critérios de Pesquisa__, são eles:

Contém, Início igual, Exatamente igual, Não contém, Diferente, Maior que, Maior igual, Menor que e Menor igual

Destacar resultados

Destaca o resultado da pesquisa realizada.

Botão dentro da área de pesquisa

Define o posicionamento do botão de pesquisa, se estará na área de texto ou fora dela.

Opção Ativa -

Opção Desativada -

Mostrar combobox no layout simplificado

Quando ativa, exibe um combobox contendo a junção dos campos definidos nas opções Configurações para pesquisa na opção ‘Todos os Campos’ e Configurações para Pesquisa Individual por campo, além dos critérios de pesquisa selecionados.

No combobox, a opção Todos os campos, selecionada na imagem acima engloba todos os campos selecionados na opção Configurações para pesquisa na opção ‘Todos os Campos’

Os demais campos presentes no combobox, mostrados abaixo de Todos os campos, são os definidos na opção Configurações para Pesquisa Individual por campo

Esta opção está disponível apenas no layout simplificado.

Marca d’agua

Define a marca d’água que será exibida no quicksearch. Pode ser utilizado uma lang ou um texto fixo.

Por padrão, utilizamos a lang: {lang_othr_qk_watermark}

Esta lang pode ser alterada na opção de Traduzir Aplicações.

Largura do Quicksearch

Largura em pixels do input do Quicksearch.

Buscar em qualquer parte

Quando esta opção estiver ativa, o Quicksearch realiza a busca em qualquer parte da string. Ao desativar, a busca será realizada utilizando o critério exatamente igual.

Configurações para Pesquisa Individual por campo

Esta configuração define os campos que estarão disponíveis no combobox do quicksearch, ao ativar a opção de Layout Estendido, nas configurações gerais

Campos para pesquisa individual

Usar campos exibidos na aplicação: Ao selecionar esta opção, apenas os campos exibidos na aplicação estarão disponíveis no combobox.

Definir campos manualmente: Permite que o desenvolvedor selecione os campos que estarão disponíveis no combobox do quicksearch.

Configurações para pesquisa na opção ‘Todos os Campos’

Esta opção define os campos que sempre estarão disponíveis para a busca no quicksearch, independente da sua configuração.

Ao utilizarmos o quicksearch sem especificarmos os campos que desejamos realizar a busca, os campos selecionados aqui serão incluídos na busca, mesmo que não estejam exibidos na interface.

Pesquisa em Todos os Campos

Todos os Campos somados aos campos da Pesquisa Individual: Além dos campos selecionados nesta opção os campos selecionados na opção Campos para pesquisa individual estarão disponíveis na busca do quicksearch.

Apenas os selecionados para Todos os Campos: Apenas os campos selecionado nesta opção estarão disponíveis na busca através do quicksearch

Critérios de Pesquisa

Define os critérios de busca do quicksearch.

Ao marcar as opções, o combobox com os critérios será exibo

Estas são as opções disponíveis como critério de busca do quicksearch.

• Contém
• Início igual
• Exatamente igual
• Não contém
• Diferente
• Maior que
• Maior igual
• Menor que
• Menor igual

Campos do Filtro

Estes são os campos disponíveis para utilização no filtro. Clique no campo desejado para acessar a documentação de configuração do campo no filtro.

Configuração do Filtro

Usar autocomplete:

O campo se transforma em autocomplete automaticamente de acordo com os valores existentes na base de dados.

Usar Select2

Essa opção permite a utilização do novo componente para selecção de dados, permitindo pesquisas na caixa de seleção.

Quantidade de caracteres

Define a quantidade mínima de caracteres para o inicio da busca no Select2.

Quantidade de linhas

Define a quantidade de linhas que será mostrada na busca do Select2.

Quantidade de caracteres:

Define a quantidade de caracteres para iniciar a pesquisa.

Quantidade de linhas:

Define o número máximo de linhas para listar o resultado da pesquisa.

Largura:

Define a largura em pixels para a caixa de resultados.

Opções de pesquisa:

Define a validação que será feita para buscar o resultado da pesquisa.

Início igual: Irá trazer os resultados com o inicio igual ao da busca.
Qualquer parte: Irá trazer os resultados onde existe a busca em qualquer parte do registro.
Final igual: Irá trazer os resultados com o final igual ao da busca.

Converte Letra

Essa opção permite que o desenvolvedor informe como o texto será mostrado no momento da execução.

As opções disponiveis são:

Caixa Baixa: Todas as letras do texto serão convertidas para minúsculas.

Caixa Alta: Todas as letras do texto serão convertidos para maiúsculas.

Capitula primeira palavra: A primeira letra da primeira palavra será convertida para maiúscula.

Capitula todas as palavras: Todas as primeiras letras de todas as palavras serão convertidas para maiúsculas.

Posição entre valores:

Define a posição que os objetos serao exibidos.

Texto entre valores:

Texto que aparecerá entre os valores.

Submeter no Onchange:

Permite quando ativada, submeter o filtro quando houver alterações no campo.

Exibir Condição:

Permite quando ativada exibir ou não a condição do filtro, a mesma só funcionará se o filtro tiver ao menos uma opção.