ÍNDICE

01. VISÃO GERAL

BIRT (Business Intelligence and Reporting Tools) é uma ferramenta para desenvolvimento e execução de relatórios que pode ser realizado com a utilização da IDE Eclipse, com modo design e bibliotecas para runtime em Java. Permite uma comunicação com o Java para gerar os relatórios ou uma comunicação via queries SQL.

Para a utilização com o Datasul está disponível a utilização com o Java, pois teria sua lógica reutilizável e mais flexível a mudanças.

02. INSTALAÇÃO

Para a execução dos relatórios desenvolvidos em BIRT, basta efetuar previamente a instalação do Birt-Runtime, que pode ser realizado o download no link: Project download area | The Eclipse Foundation

03. CONFIGURAÇÃO

Os detalhes de configuração estão nesse link CFG - Relatório. 

04. URL DE VERIFICAÇÃO DE PARÂMETROS

A URL de teste permite verificar as configurações do servidor, caso a pasta configurada como pasta do BIRT ou de seus relatórios não seja apresentada pode significar algo errado na configuração, ou a pasta não existe ou o usuário que inicia o serviço não tem permissão naquela pasta.

@GET /help

• Response → Retorna algumas configurações de ambiente para facilitar a identificação de alguma possível situação inesperada:
  1. os: sistema operacional no qual está sendo executado o Servidor Web Java (Tomcat);
  2. java_home: diretório raiz a instalação da JVM utilizada pelo Servidor Web Java (Tomcat);
  3. java_version: versão da JVM utilizada pelo Servidor Web Java (Tomcat);
  4. encoding: encoding utilizado pela JVM;
  5. separator: separador padrão do sistema operacional '/' ou '\';
  6. birt_home: diretório contento a raiz da engine do BIRT;
  7. birt_temp_dir: diretório temporário utilizado pelo BIRT;
  8. birt_resources: diretório raiz para bibliotecas auxiliares (normalmente /dataul_report/libs/).
  9. report_home: diretório raiz no qual estão os .rptdesign (normalmente /dataul_report/).
     
     

Exemplo TS4THF: http://ServerDTS4THF:1234/totvs-menu/rest/report/help

{
	"report_home": "/usr/local/tomcat/datasul-report/",
	"os": "Linux",
	"java_home": "/usr/local/openjdk-11",
	"birt_temp_dir": "/usr/local/tomcat/datasul-report/temp/",
	"birt_home": "/opt/local/tomcat/birt-runtime-4.6.0/ReportEngine/",
	"java_version": "11.0.11+9",
	"encoding": "UTF-8",
	"separator": "/"
}

05. CUSTOMIZAÇÃO

A customização da parte Progress se dá utilizando os pontos de EPC conforme já realizado hoje com o produto.

Quanto ao relatório, é possível criar uma pasta dentro do diretório do relatório em si, com o nome de custom. Este diretório por sua vez deve conter o arquivo .rptdesign customizado com o mesmo nome do relatório original. Durante a execução do relatório o Datasul Report Service procura primeiramente pelo relatório no diretório customizado, caso não exista realiza a execução do relatório padrão. Conforme exemplo abaixo:

Quando for desenvolvido um relatório especifico é recomendado que o mesmo seja disposto dentro da pasta custom para facilitar a identificação e atendimento em caso de alguma situação inesperada.

Quando o relatório possuir a técnica de i18n implementada, será preciso também copiar os arquivo .properties.

Uma das customizações mais solicitadas é a troca da logo impressa nos relatórios, esta alteração é possível de 2 formas.

1. Alterando o próprio fonte do relatório (.rptdesign) e alterando o caminho da imagem para a imagem desejada. De preferência a imagem deve estar disponibilizada no diretório do próprio relatório ou no diretório: %TOMCAT_INSTANCE%/datasul-report/images;
2. Substituindo o arquivo logo.png, no diretório %TOMCAT_INSTANCE%/datasul-report/images, pela imagem desejada. Para este caso recomenda-se que a imagem tenha as dimensões iguais a padrão: 165 x 160.

<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: flex;
}
#main {
    padding-left: 70px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>