Adicionando metadados e marcadores customizados nos relatórios

Ao desenvolver um relatório é possível criar variáveis que serão adicionadas como metadados customizados ao arquivo PDF, e também propagadas como marcadores para as demais ferramentas.

Todas as variáveis que tiverem o prefixo BTHMETADADO{NOME_DESEJADO} serão tratadas como um metadado customizado e um marcador.

A coleta desses valores acontece ao término da impressão de cada página do relatório, desse modo, para relatórios particionados é possível ter metadados customizados com valores diferentes para cada arquivo PDF gerado. Por esse motivo é importante se atentar para a correta configuração das propriedades da variável, pois impactam diretamente em como e quando o valor vai ser computado, para mais informações técnicas consultar a documentação de variáveis do jasper.

Os valores dos marcadores serão coletados na impressão da última página do relatório, pois são globais para a execução, não importando se o relatório é particionado.

ATENÇÃO!

Caso o desenvolvedor do relatório crie algum marcador que conflite com os que são enviados pelos sistemas quando iniciam a execução, os mesmos serão ignorados, ficando com o valor fornecido pelo sistema.

A seguir temos um exemplo de criação de um metadado customizado.

(Definição da variável com o prefixo necessário)

(Verificando os metadados customizados no arquivo PDF gerado)