Configurando Filtros

O que so Filtros ? Filtros so variveis criadas no script SQL que possibilitam restringir o resultado da pesquisa, garantindo a exibio de resultados mais especficos, de acordo com as necessidades do usurio. No script SQL as variveis so facilmente identificadas, pois so precedidas pelo caractere : (dois pontos).

Descrio dos componentes da tela de configurao de filtros.

Ordem: Define a ordem em que os filtros sero exibidos na tela de filtros que precede a emisso do
relatrio.

Parmetro: Contm o nome da varivel criada no script SQL. Componente: Determina o tipo de componente que ser utilizado para o filtro em questo. Os filtros
disponveis so: EDIT, DATA, COMBOBOX, GROUPBOX, CHECKBOX, CONSULTA, CHECKCOMBOBOX e NUMERICO. Legenda: Contm o nome que ser exibido na tela de filtros que precede a emisso do relatrio. Default: Define qual ser o valor padro utilizado para o filtro. As possibilidades de valor padro variam de acordo com o tipo de componente selecionado. A escolha de valor padro no impede que os valores sejam alterados na tela de filtros que precede a emisso do relatrio. como obrigatrios sero exibidos com a marcao (*) antes de seu nome de exibio, de modo a facilitar a identificao dos mesmos.

Obrigatrio: Define se o filtro dever ou no ser de preenchimento obrigatrio. Os filtros marcados

Itens: Recebe script de pesquisa a ser utilizado com componentes dos tipos COMBOBOX,
GROUPBOX, CONSULTA e COMBOCHEKBOX.

Consulta: Recebe script de pesquisa a ser utilizado com componentes do tipo CONSULTA.

Aplicao para os tipos de Componentes EDIT o tipo de componente no qual o usurio digita o valor desejado. muito utilizado para campos numricos e caractere. Quando o componente for do tipo EDIT, os campos Itens e Consulta no tem efeito sobre o componente. O campo Default pode ser utilizado para exibir o valor inicial para o filtro, o qual poder ser alterado na tela de filtros, caso necessrio. Os campos Itens e Consulta no tem efeito sobre o componente de tipo EDIT.

A pesquisa do componente de tipo EDIT feito com Case Sensitive, ou seja, o componente ir efetuar a pesquisa exatamente da maneira que a informao foi digitada, levando em considerao caracteres maisculos, minsculos e acentuao. Caso o campo de pesquisa no seja preenchido, o mesmo ir considerar todos os valores existentes. O campo de pesquisa tambm pode ser preenchido utilizando-se do critrio de pesquisa do comando SQL like, onde o caractere % utilizado para determinar que qualquer informao pode ser considerada na pesquisa.

DATA o tipo de componente no qual o usurio informa o valor em formato de data. utilizado para filtrar informaes em perodos de tempo. Quando o componente for do tipo DATA, o item Default opes de valores padro especficas para este tipo de componente. As opes de valor padro so:

HOJE: Preenche o campo automaticamente com a data atual do sistema. ONTEM: Preenche o campo automaticamente com a data do dia anterior, tendo como base a
data do sistema.

AGORA: Preenche o campo automaticamente com a data e hora atual do sistema. PRIMEIRO_DIA_MES: Preenche o campo automaticamente com o primeiro dia do ms, tendo
como base a data do sistema.

ULTIMO_DIA_MES: preenche o campo automaticamente com o ltimo dia do ms, tendo como
base a data do sistema.

Os campos Itens e Consulta no tem efeito sobre o componente de tipo DATA.

Observe que quando o componente do tipo DATA, o mesmo oferece a busca de datas atravs de um calendrio, onde possvel navegar atravs dos meses e anos, para localizao mais rpida e prtica da data desejada.

Nota: A data do sistema mencionada nos itens anteriores refere-se data do servidor do banco de dados utilizado pelo sistema. Sendo assim, podem ocorrer casos em que a data/hora da estao de trabalho seja diferente da data/hora exibida na tela de filtros.

COMBOBOX o tipo de componente no qual apresentado para o usurio uma lista de opes, das quais pode ser selecionado apenas um item, ou ento pode ser selecionado o item TODOS. Quando o componente for do tipo COMBOBOX, as opes selecionadas no item Default no tem efeito sobre o componente. Para criar a lista de itens que sero exibidos necessrio criar um script de pesquisa que ser adicionado no contedo do campo Itens

GROUPBOX o tipo de componente no qual apresentado para o usurio uma lista de opes, das quais pode ser selecionado apenas um item. Diferentemente do componente de tipo COMBOBOX, todos os itens da lista so imediatamente exibidos, ou seja, sem uma caixa com barra de rolagem. Quando o componente for do tipo GROUPBOX, as opes selecionadas no item Default no tem efeito sobre o componente. Para criar a lista de itens que sero exibidos necessrio criar um script de pesquisa que ser adicionado no contedo do campo Itens No componente de tipo GROUPBOX, a lista de opes pode ser criada de duas maneiras diferentes: 1) Atravs de script de pesquisa, tal qual feito nos componentes de tipo COMBOBOX. 2) Atravs da lista de valores que podero ser selecionados.

Quando for utilizar uma lista pr-definida de valores, importe observar que a informao digitada antes do hfen corresponde ao valor que ser pesquisado no banco de dados, e a informao digitada aps o hfen corresponde ao valor que ser exibido na tela de filtros.

10

CHECKBOX o tipo de componente no qual apresentado para o usurio um campo de checagem, onde o mesmo pode ser selecionado ou no. Quando o campo de checagem for selecionado, a pesquisa ir atribuir o valor S varivel. Quando o campo de checagem no for selecionado, a pesquisa ir atribuir o valor N varivel. Sendo assim, o componente de tipo CHECKBOX recomendado para campos de preenchimento obrigatrio, e que contenham apenas os valores S ou N. Quando o componente for do tipo CHECKBOX, as opes selecionadas no item Default, Itens e Consulta no tem efeito sobre o componente.

11

CONSULTA o tipo de componente que efetua uma consulta pr-determinada a partir de um valor informado, ou, caso necessrio, abre uma nova tela de pesquisa, para que o item desejado possa ser localizado com maior facilidade. O componente de tipo CONSULTA o nico componente que utiliza todos os campos da tela de configurao de filtros. No campo Default pode ser informado o valor que ser utilizado como valor padro para a pesquisa, podendo ser alterado na tela de filtros, no momento da pesquisa. O campo Itens deve receber script de pesquisa que efetuar a pesquisa rpida, ou seja, a pesquisa que no requer a abertura da tela de pesquisa. Particularidades do script do campo Itens: - Selecionar apenas 1 campo, que ser exibido como resultado da pesquisa - Adicionar clusula de comparao entre o campo informado na tela e o campo da tabela utilizada na pesquisa.

12

O campo Consulta deve receber script de pesquisa que efetuar a pesquisa detalhada, ou seja, a pesquisa que ser efetuada com a abertura de nova tela de pesquisa. Particularidades do script do campo Consulta: - Selecionar todos os campos que desejar exibir como resultado da pesquisa. - Adicionar as clusulas de comparao entre o campo informado na tela e o campo da tabela utilizada na pesquisa. Observe que neste script podem ser informados vrios campos para serem comparados na pesquisa.

Esta a tela de pesquisa rpida, onde basta informar o cdigo desejado e teclar Tab para que a pesquisa seja feita e o resultado seja exibido no campo logo frente.

13

Esta a tela de pesquisa detalhada, onde temos os seguintes componentes: - Classificao: neste componente selecionamos o campo que ser utilizado para efetuar a pesquisa, caso exista mais de um campo na lista de pesquisa. - Chave: neste componente informamos o valor que ser pesquisado para o campo selecionado no componente Classificao - Pesquisar: o boto que aciona o processo de pesquisa. - Grid: Local onde o resultado da pesquisa exibido - Imprimir: A tela de pesquisa detalhada permite que o resultado da pesquisa seja impresso em forma de lista, com os mesmos campos utilizados na exibio da Grid. - Confirmar: Aps selecionar o item desejado, o boto Confirmar retorna para a tela de filtros, atribuindo ao campo de filtro o valor selecionado na tela de pesquisa detalhada. Esta funo tambm pode ser executada atravs de duplo clique do mouse. - Cancelar: O boto Cancelar retorna para a tela de filtros, no atribuindo valor ao campo de filtro. Esta funo tambm pode ser executada atravs da tecla Esc.

14

CHECKCOMBOBOX o tipo de componente no qual, assim como no COMBOBOX, apresentado para o usurio uma lista de opes, porm, neste componente vrios itens podem ser selecionados. Quando o componente for do tipo CHECKCOMBOBOX, as opes selecionadas no item Default no tem efeito sobre o componente. Para criar a lista de itens que sero exibidos necessrio criar um script de pesquisa que ser adicionado no contedo do campo Itens.

15

NUMERICO o tipo de componente no qual o usurio digita o valor desejado. O componente NUMERICO funciona de maneira idntica ao componente EDIT, exceto pela caracterstica de que este componente aceita que sejam informados apenas nmeros. Sendo assim, este componente indicado para casos em que o filtro feito em campos numricos. A utilizao deste componente impede que caracteres no numricos sejam informados, e que o resultado da pesquisa seja afetado por esse tipo de erro.

16