Exibir código-fonte para Browser Dinâmico:Parâmetros

[[Arquivo:Client Consulta ParametroList.png|miniaturadaimagem|Lista de Parâmetro da Consulta]]
[[Arquivo:Client Consulta Parametro.png|miniaturadaimagem|Tela de Configuração dos Parâmetros da Consulta]]
[[Arquivo:Web Consulta Parametro.png|miniaturadaimagem|Parâmetros de Consulta exibidos no LATROMI Web]]
{{DISPLAYTITLE:Parâmetros do Browser Dinâmico}}
Os Parâmetros do Browser Dinâmio 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.

== 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.
É permitida 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 Client''' para apresentar o campo ao desenvolvedor. Se não for preenchido, o sistema usará o nome do parâmetro.

=== Tipo ===
Tipo do Parâmetro. Cadas tipo possui diferentes tipos de dados. Veja mais no tópico [[#Tipos de Parâmetros]].

== 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.
== Utilizando os Parâmetros ==
Neste tópico, será explicado como os Parâmetros podem ser utilizados dentro da Consulta:

=== Comandos SQL ===
A função principal dos Parâmetros é servir de '''filtro''' para os dados que serão retornados para geração da Consulta. Para usar um parâmetro em um Comando SQL, basta posicionar o cursor na parte do comando onde deseja utilizar o parâmetro, localizá-lo na árvore a direita e dar um duplo-clique com o botão esquerdo do mouse. Se quiser substituir uma parte do comando por um parâmetro, também é possível selecionar o texto que deseja substituir antes de dar o duplo-clique.
[[Arquivo:Client Consulta Substituindo Parametros.png|thumb|none|Substituição dos parâmetros em Comando SQL da Consulta]]

=== Passagem de Parâmetros ===
Os parâmetros, assim como os outros tipos de [[Marcações]], podem ser passados para outros objetos a partir da Consulta. Essas chamadas podem ocorrer em [[Consulta:Links|Links]] de Colunas ou [[Consulta:Botões|Botões]].
[[Arquivo:Client Consulta PassagemDeParametro.png|miniaturadaimagem|nenhum|Passagem de parâmetros para outros objetos]]


== Ver Também ==
* [[Browser_Dinâmico:Visão_Geral|Visão Geral do Browser Dinâmico]]