Índice:


       

Objetivo:


       O objetivo deste documento é trazer uma visão de como funciona tela de Cadastro de Parâmetros. 

Introdução:


    Caso o usuário deseje utilizar como Fonte de Dados para o relatório uma consulta SQL e utilizar um parâmetro nela, esse parâmetro deve ser cadastrado anteriormente. 


Os parâmetros podem ser aplicados apenas em Fontes de dados do tipo SQL. No caso de Tabelas, devem ser utilizados os Filtros.


Como criar:


    Para criar um novo parâmetro, basta clicar em "Adicionar" e informar os campos abaixo:

Nome: Informe o nome do parâmetro, deve ser um nome único e será por ele que o parâmetro será identificado.

Descrição: Campo opcional caso o usuário deseje escrever uma descrição.

Tipo do parâmetro: Nesse campo o usuário deve informar de qual tipo será o parâmetro (Ex: DateTime, Int, Double, String, entre outros).

Valor do parâmetro: Informe qual valor o parâmetro irá assumir (esse valor pode ser alterado posteriormente).

Parâmetro interno: Quando essa opção estiver desmarcada, significa que o parâmetro pode receber valores vindo de fora. Caso esteja marcada, 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 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.