Índice:
Objetivo:
O objetivo deste documento é esclarecer as funcionalidades da tela de Parâmetros.
Introdução:
Nesta tela visualizamos e cadastramos os parâmetros utilizados no relatório. Eles poderão ser utilizados como filtros em consultas SQL ou mensagens informativas no relatório.
Os parâmetros são utilizados como filtros apenas em Fontes de dados do tipo SQL. No caso de Tabelas, devem ser utilizado Filtros. |
Como criar:
Para criar um novo parâmetro, basta clicar em "Adicionar" e informar os campos abaixo:
Nome do parâmetro: Informe o nome do parâmetro, deve ser um nome único e é por ele que o parâmetro será identificado (Não é permitido espaços ou caracteres especiais no nome do parâmetro, com exerção do underline "_").
Descrição: Informe uma descrição para o parâmetro.
Tipo: Nesse campo o usuário deve informar de qual tipo será o parâmetro (Ex: Alfanumérico, Data/Hora, Decimal, Inteiro, entre outros).
Valor: Informe qual valor o parâmetro irá assumir.
Obs.: Os parâmetros podem ser salvos sem valores. Quando este parâmetro for utilizado em uma consulta SQL será compreendido o valor “null” na sua execução.
Interno: Quando essa opção estiver marcada como "Não", significa que o parâmetro pode receber valores vindo de fora. Caso esteja marcada como "Sim", isso não acontece, o valor será buscado no propriedade "Valor do parâmetro".
Exemplo prático abaixo:
Em seguida, basta clicar em "Salvar" e vincular o parâmetro à uma consulta SQL na tela Fonte de Dados.
Quando o valor do parâmetro deve ser exclusivamente o valor definido na propriedade "Valor do parâmetro". Exemplo: Imagine que o Protheus esteja chamando o método “ExecuteReports” via API. Se existir algum parâmetro marcado com essa opção, o Protheus não poderá passar nenhum valor para esse parâmetro. O mesmo será buscado da propriedade “Valor do parâmetro” que está nessa mesma tela. |
|
|