Parâmetros da Consulta
Os Parâmetros da Consulta são utilizados para filtrar as informações que serão obtidas do banco de dados. Eles são utilizados na composição dos Comandos SQL, mas também podem ser usados para compor o título da Consulta e para serem passados como parâmetro para objetos que venham a ser chamados de dentro da Consulta.
Ao contrários do que acontece com os outros objetos, os Parâmetros da Consulta são únicos que podem ser preenchidos manualmente pelo usuário durante o acesso no LATROMI Web.
Índice
Configuração dos Parâmetros
Na tela de modificação de parâmetro, estão uma série de campos de configuração, os quais serão descritos abaixo:
Nome
Nome do Parâmetro. É um campo chave, usado para identificar o parâmetro dentro do sistema. Ele deve ser único dentro da Consulta É permitido apenas a entrada de letras sem acentuação, números e o caractere "_" (underline).
Descrição
Descrição do Parâmetro. É o texto que será exibido no LATROMI Web para apresentar o campo ao usuário. Se não for preenchido, o sistema usará o nome do parâmetro.
Tooltip
Texto do balão de ajuda, que é mostrado no navegador ao posicionar o cursor do mouse sobre o parâmetro.
Tipo
Tipo do Parâmetro. Cadas tipo possui diferentes apresentações e tipos de dados. Veja mais no tópico #Tipos de Parâmetros.
Valor Padrão
Valor inicial do Parâmetro. Se for especificado, o parâmetro será preenchido automaticamente com este valor ao abrir a Consulta no LATROMI Web.
Largura
Largura do Parâmetro em pixels.
Preenchimento Obrigatório
Se estiver marcado, será obrigatório o preenchimento do Parâmetro antes de efetuar a Consulta.
Quando a Consulta está com a configuração "Executar consulta ao iniciar" habilitada, a validação dos parâmetros é ignorada.
Visível
Se estiver marcado, o Parâmetro não será exibido no LATROMI Web para o usuário.
Tipos de Parâmetros
Existem parâmetros com diferentes tipos de dados e apresentação. Abaixo, estão descritos cada um deles:
Texto
Tipo de Parâmetro que permite a entrada de qualquer caractere.
Numérico
Tipo de Parâmetro que permite apenas a entrada de números. Quando este tipo é selecionado, o campo para configurar as Casas Decimais é exibido na tela de Configuração de Parâmetros.
Data
Tipo de Parâmetro que permite apenas a entrada de datas. Quando este tipo é selecionado, o campo Valor Padrão muda para uma lista com as opções:
- Vazio: Campo em branco.
- Valor Fixo: Permite especificar uma data no formato YYYY-MM-DD, ou selecionar uma marcação de Sessão ou Variável Global.
- Data Atual: O Campo é preenchido com a data atual do servidor.
- Início do Mês: O Campo é preenchido com o primeiro dia do mês, conforme data do servidor.
- Final do Mês: O Campo é preenchido com o último dia do mês, conforme data do servidor.
Além disso, ao lado direito do campo Valor Padrão é exibido um campo para informar o valor de dias a serem somados ao valor especificado. Use um número negativo para fazer subtração.
ComboBox
Lookup
Este tipo de Parâmetro exibe um conjunto de opções provenientes do banco de dados para o usuário selecionar uma delas. Para isso, é necessário vincular um Browser Dinâmico ao Parâmetro. Para fazer este vínculo, clique no botão .
Para obter maiores informações, acessa a página de Configuração de Lookup.
Utilizando os Parâmetros =
Substituição dos parâmetros em Comando SQL da Consulta