Metadados

Metadados são dados que facilitam o entendimento dos relacionamentos e a utilidade das informações dos dados. Todos os dados descritivos em um documento, físico ou digital, sobre autor, data de criação, local de criação, conteúdo, forma, dimensões são metadados.

A ferramenta de Relatórios apresenta a necessidade de agrupar relatórios emitidos a partir de determinadas configurações, portanto, o intuito deste recurso é possibilitar que outras aplicações consigam identificar se um determinado relatório foi gerado e possam utilizá-los como resultado para outra finalidade.

Sua configuração pode ser por meio de um parâmetro criado no relatório ou ainda, determinar um valor desejado. Esse recurso é utilizado em relatórios com extensão PDF, utilizadas por exemplo nas assinaturas digitais possibilitando e ficando armazenado internamente como metadado.

Para definir um novo metadado, pressione o botão +METADADO.

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 do arquivo PDF, e também propagadas como marcadores para as demais ferramentas.

Todas as variáveis que tiverem o prefixo BTH_METADADO__ serão tratadas como um metadado customizado e um marcador.

A coleta desses valores acontece ao término de impressão de cada página do relatório, portanto 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, favor 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.

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)