Framework - Linha Datasul - FRW - Erro: Falha ao carregar documento PDF ao tentar executar relatório BIRT

 Tempo aproximado para leitura: 00:01:30 min

Ocorrência
Ao executar relatórios BIRT -  Business Intelligence e Reporting Tools, é apresentada a mensagem Falha ao carregar documento PDF ao abrir o arquivo, e totvs.report.engineDir not defined or doesn´t exists no log do Tomcat ou no próprio relatório PDF - Portable Document Format ao abri-lo com um aplicativo de texto.

Ambiente
Framework - Framework (Linha Datasul) – Básico (BTB) - Todas as versões

Causa
Este erro ocorre pois os diretórios configurados nas Propriedades Relatórios do produto estão incorretos ou não foram preenchidos.

Solução
Para correção do erro, realize os seguintes passos:
1. Acesse o produto Datasul 12;
2. Na guia superior direita do browser acesse Configurações - Propriedades Do Sistema - Propriedades Relatórios;
3. No campo Diretório do engine do relatório informe o caminho do servidor Tomcat onde está instalado o BIRT, informando até a pasta ReportEngine. Por exemplo: c:\totvs\dts-1\instance-8080\birt-runtime-4-8-0\ReportEngine;
4. No campo Diretório dos templates de relatório informe o caminho do servidor Tomcat onde está localizada a pasta datasul-report. Por exemplo: c:\totvs\dts-1\instance-8080\apache-tomcat-9.0.31\datasul-report;
5. Reinicie o serviço do Tomcat.

Importante
1. A versão recomendada do BIRT para o ambiente Tomcat deve ser 4.6 ou superior.
2. Os diretórios devem seguir o padrão de cada Sistema Operacional com relação as barras e diretórios com maiúsculas e minúsculas ("\" ambiente Windows ou "/" ambiente Linux/Unix).
3. O usuário que inicia o serviço do Tomcat deve ter acesso aos diretórios configurados nas Propriedades Relatórios.

Saiba mais
Para mais informações, acesse a documentação disponível em Download de PDF - Datasul Tomcat.