Parâmetros do relatório

Você pode especificar os parâmetros do relatório. Por exemplo, o relatório Customer purchases do projeto Demo possui três parâmetros.

Parâmetros do relatório

Para adicionar ou alterar um parâmetro do relatório, clique no botão Report params no painel esquerdo do Application Builder. Um formulário aparecerá exibindo a lista de parâmetros existentes. Em seguida, clique no botão Novo ou Editar do formulário para adicionar ou alterar o parâmetro.

Parâmetro do relatório

Os seguintes campos podem ser especificados:

  • Caption - o nome do parâmetro que será exibido aos usuários

  • Name - o nome do parâmetro que será utilizado no código de programação para acessar o objeto do parâmetro

  • Type - o tipo de dado do parâmetro

  • Lookup item - o item de onde o valor do parâmetro será selecionado

  • Lookup field - o campo no item de pesquisa (lookup)

  • Typeahead - autocompletar/typeahead ativado para o campo de pesquisa

  • Multiple selection - permite seleção múltipla

  • Select all enabled - permite a seleção de todos os itens

  • Lookup value list - seleção de lista de valores de pesquisa

  • Required - se esta caixa de seleção estiver marcada e o atributo Visible estiver ativado, a aplicação cliente exigirá que os usuários informem o valor do parâmetro antes de imprimir o relatório.

  • Alignment - especifica como o valor do parâmetro será alinhado no elemento de entrada.

  • Placeholder - use este atributo para especificar o texto de placeholder que será exibido pelo campo de entrada.

  • Help - se algum texto ou mensagem em HTML for especificado, um ponto de interrogação será exibido à direita da entrada. Quando o usuário mover o ponteiro do mouse sobre esse ícone, uma janela pop-up aparecerá com essa mensagem.

  • Visible - a aplicação cliente cria um formulário para especificar os parâmetros antes de imprimir o relatório. Se esta caixa de seleção estiver marcada, o elemento de entrada para esse parâmetro aparecerá no formulário.

É possível criar um parâmetro de pesquisa. Por exemplo, o relatório Customer purchases tem um parâmetro Customer que pode ser selecionado a partir do Cadastro Customers:

Parâmetro de pesquisa

Neste caso, devemos especificar:

  • Lookup item - o item de onde o valor do parâmetro será selecionado

  • Lookup field - o campo no item de pesquisa

O formulário para configurar os parâmetros do relatório Customer purchases é o seguinte:

Exemplo de parâmetros do relatório Customer purchases