01 - BIRT | Instalação e Configuração

Para realizar a configuração de um ambiente capaz de executar e exibir um Report BIRT é necessário seguir alguns passos:

Verificar a versão do Protheus e versão de LIB: No ambiente Protheus a ser utilizado deve-se verificar se trata-se do Protheus 12.1 ou Protheus 11 com a LIB a partir do número 20140916;
Realizar a instalação e configuração inicial do TOTVS | WebViewer : Veja detalhes no link Instalando TOTVS WebViewer

Abaixo segue lista completa das chaves permitidas na sessão [REPORTSERVICE] (citadas no link acima)

Chave de Configuração	Descrição	Possíveis Valores	Exemplo
ENABLED	Define quando o serviço de Report do Birt está ativo ou não	0 ou 1	ENABLED=1
REPORTENGINE	Define qual engine do TOTVS \| WebViewer foi instalada para execução do BIRT	TOMCAT, JBOSS,	REPORTENGINE=TOMCAT
WEBVIEWER	Define qual a URL de conexão com o TOTVS \| WebViewer para exibição do Report.	URL de conexão com o TOTVS \| WebViewer (incluindo porta)	WEBVIEWER=http://localhost:8080/WebViewer/
REPORTDATABASE	Define qual o tipo de Banco de Dados será utilizado para conexão dos DataSources.	MSSQL, ORACLE, DB2, INFORMIX	REPORTDATABASE=MSSQL
REPORTDATABASENAME	Nome do banco de dados para conexão	Nome definido da Base de dados que receberá as conexões	REPORTDATABASENAME=P12
REPORTDATABASESID	SID do banco de dados para conexão (utilizado apenas para Bancos ORACLE)	SID definido para a Base	REPORTDATABASESID=orcl
REPORTDATABASEPORT	Porta de conexão do Banco de Dados	Valores de 1 a 65535 correspondente a porta do SGBD	REPORTDATABASEPORT=1433
REPORTDATABASESERVER	Endereço (DNS ou IP) do servidor de banco de dados para conexão	Endereço para resolução DNS ou endereço IP do servidor SGBD	REPORTDATABASESERVER=127.0.0.1
REPORTDATABASESCHEMA	Esquema da conexão no Banco de Dados (utilizado apenas para Bancos DB2)	Nome do esquema utilizado pela conexão.	REPORTDATABASESCHEMA=DB2USER
REPORTDATABASEINSTANCE	Nome da instancia do Banco de Dados (utilizado apenas para Bancos Informix)	Nome da instancia definida na instalação do Banco de Dados	REPORTDATABASEINSTANCE=ol_windows
REPORTDATABASELOCALE	Define o código de caracteres utilizado pelo Banco de Dados		REPORTDATABASELOCALE=EN_US.CP1252
REPORTWEBSERVERPATH	URL complementar para chamada do visualizador de Reports	Path complementar para chamada do visualizador. Complementando o parâmetro WEBVIEWER	REPORTWEBSERVERPATH=/

Exemplo:

[REPORTSERVICE]

ENABLED=1

REPORTENGINE=TOMCAT

WSURL=http://localhost:88/webservices/

WEBVIEWER=http://localhost:8080/WebViewer/

REPORTDATABASE=MSSQL

REPORTDATABASENAME=P12

REPORTDATABASEPORT=1433

REPORTDATABASESERVER=localhost

REPORTDATABASESCHEMA=DB2

REPORTDATABASEINSTANCE=teste

REPORTDATABASELOCALE=EN_US.CP1252

REPORTWEBSERVERPATH=/

Configurando o Tomcat

Criar a variável de ambiente do sistema operacional CATALINA_HOME contendo até a pasta server do path de instalação do WebViewer: <Path de instalação do TOTVS | WebViewer>\server.
Deve ser criado um arquivo na pasta <Path de instalação do TOTVS | WebViewer>\server\webapps\WebViewer\WEB-INF com a seguinte nomenclatura "config.properties". Neste arquivo devem estar presentes dois parâmetros de configuração que serão responsáveis pela autenticação de conexão do driver JDBC com o banco de dados, seguindo o exemplo a seguir:

username=nome do usuario
password=senha do usuario

Deve ser criada uma pasta chamada "drivers" na pasta de instalação do TOTVS | WebViewer <Path de instalação do TOTVS | WebViewer>\server\webapps\WebViewer\drivers e colocado o driver jdbc do banco de dados utilizado. Este driver é utilizado pelo BIRT para conexão com o banco de dados, por isso deve estar na versão adequada de acordo com a versão do banco de dados utilizado. (Pesquise junto ao fornecedor ou na internet, o driver JDBC para o banco de dados que irá utilizar).
- Este driver deve ser renomeado de acordo com a tabela abaixo
SGDB Nome do arquivo (driver)
Informix ifxjdbc.jar
DB2 db2jcc.jar
SQL Server sqljdbc4.jar
ORACLE ojdbc6.jar
POSTGRES postgresql.jar

Space shortcuts

Child pages

Configurando o Tomcat

SGDB	Nome do arquivo (driver)
Informix	ifxjdbc.jar
DB2	db2jcc.jar
SQL Server	sqljdbc4.jar
ORACLE	ojdbc6.jar
POSTGRES	postgresql.jar