Sub-sistema para pesquisas de informação no sistema

Índice

Parâmetros da consulta

PESQUI.CAD_CONSULTAS_GENERICAS_PARAMETROS

Descrição

Manutenção dos parâmetros de uma consulta genérica.

Esta interface é usada em diferentes guias do sistema. Clique nos links de navegação abaixo para obter maiores informações.

Consultas genéricas:

Campos:

Nome dado para identificar o parâmetro.
Título do parâmetro que deve ser apresentado para o usuário (p.ex.: Data de emissão, Vendedor, Produto).
Sequência do parâmetro da operação. Define a ordem com que os parâmetros serão apresentados na interface.
Define o tipo de dado a ser utilizado para o campo. As opções dsponíveis podem ser configuradas através da preferências RTSYSINF.PARAMETROS_OPERACOES.VALORES_DOMINIO
  • Data
  • Data e hora
  • Números longos
  • Inteiro
  • Opção
  • Texto
  • HTML
  • Texto com quebras de linha
  • Real - P.ex: 1, 2.33, etc.
Valor padrão para o campo a ser apresentado automaticamente na tela.
P.ex.
  • S
  • [SYSDATE] (assume a data atual)
  • 1.33
Opções de valores que poderão ser usados para filtrar o relatório.
Utilize este campo para definir as opções de uma caixa de seleção (pop-list) ou ainda para definir as opções de autocomplete de campos alfabéticos de livre digitação.

Pode ser informado de duas formas:

Valores fixos

Devem ser informadas várias linhas no formato 
VALOR=Descrição
VALOR=Descrição2

SQL no banco de dados

Informar uma expressão SQL que deve obrigatoriamente contes as seguintes colunas:
  • VALOR - Para o valor que será assumido no campo
  • DESCRICAO - Para o que deve ser apresentado para o usuário.
    • exemplo: Apresentar nome dos estabelecimentos ordenador por nome:
      • select nome_estabelecimento as valor,nome_estabelecimento as descricao from estabelecimentos order by descricao;

Autocomplete

Para autocomplete, deve-se incluir um SQL com as seguintes colunas:
  • ID (uso do registro)
  • VALOR (valor que será colocado no campo da LOV)
  • DESCRICAO (texto que acrescentará uma informação a mais sobre o registro)
  • PESQUISAR (texto onde o sistema irá pesquisar com o operador LIKE)

Deve-se tomar cuidado com colunas que podem conter valores nulos - Nestes casos, é importante usar uma função tipo COALESCE ou CASE WHEN.

Exemplo: 
select id as id
   , codificador as valor
   , codificador || ' - ' || descricao as descricao
   , codificador || coalesce(descricao, ' ') as pesquisar
from codificadores
where situacao in ( 'D' )
order by codificador
Formatação que o campo deve assumir - Para maiores detalhes, veja os comandos de formatação aceitos pelo respectivo domínio.
Indica se este campo será utilizado como filtro.
Define se o parâmetro é requerido (obrigatório) para realizar a operação/pesquisa.

Operações

Topo

Listar

Apresenta uma lista com os registros que atendem aos filtros informados.
A lista possui diversos recursos práticos e importantes para o usuário:
Data
Data e hora
Números longos
Inteiro
Topo

Alterar

A partir da tela de consulta de um registro, esta operação permite alterar os dados do mesmo.
O sistema abre um formulário com os campos editáveis. Após alterar os campos, o usuário deverá clicar em [b:Salvar].
Comportamento:Topo

Alterar

A partir da tela de consulta de um registro, esta operação permite alterar os dados do mesmo.
O sistema abre um formulário com os campos editáveis. Após alterar os campos, o usuário deverá clicar em [b:Salvar].
Comportamento:Topo

Novo

Permite criar novos registros no sistema. Ao ser executado, o sistema apresenta um formulário com todos os campos do registro que deverão ser preenchidos. Quando todos os campos desejados estiverem preenchidos, clique em [b:Salvar].
Comportamento:Topo

Excluir

Exclui o registro selecionado. A exclusão do registro pode ser disparada a partir da tela de consulta e/ou de manutenção do mesmo.
O registro somente será excluído se todas as condições necessárias forem encontradas, gerando um erro, caso alguma destas condições não estiver sendo atendida.

Regras

Criar operação

Cria uma operação de QUERY caso ainda não exista.

Popular domínios

Popula a lista de domínios permitidos para os atributos/filtros do report.
A lista de domínios pode ser configurada na preferencia RTSYSINF.PARAMETROS_OPERACOES.VALORES_DOMINIO
Eventos que disparam esta regra:
  • Antes de apresentar uma tela formulário "Alterar"
  • Antes de apresentar uma tela formulário "Alterar"
  • Antes de apresentar uma tela formulário "Novo"

Preencher OPERACAO

Preenche o ID da operação quando necessário.