Páginas filhas
  • 01 - BIRT | Instalação e Configuração

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

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çãoDescriçãoPossíveis ValoresExemplo
ENABLEDDefine quando o serviço de Report do Birt está ativo ou não0 ou 1ENABLED=1
REPORTENGINEDefine qual engine do TOTVS | WebViewer foi instalada para execução do BIRTTOMCAT, JBOSS,REPORTENGINE=TOMCAT
WEBVIEWERDefine 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/
REPORTDATABASEDefine qual o tipo de Banco de Dados será utilizado para conexão dos DataSources.MSSQL, ORACLE, DB2, INFORMIXREPORTDATABASE=MSSQL
REPORTDATABASENAMENome do banco de dados para conexãoNome definido da Base de dados que receberá as conexõesREPORTDATABASENAME=P12
REPORTDATABASESIDSID do banco de dados para conexão (utilizado apenas para Bancos ORACLE)SID definido para a BaseREPORTDATABASESID=orcl
REPORTDATABASEPORTPorta de conexão do Banco de DadosValores de 1 a 65535 correspondente a porta do SGBDREPORTDATABASEPORT=1433 
REPORTDATABASESERVEREndereço (DNS ou IP) do servidor de banco de dados para conexãoEndereço para resolução DNS ou endereço IP do servidor SGBDREPORTDATABASESERVER=127.0.0.1 
REPORTDATABASESCHEMAEsquema da conexão no Banco de Dados (utilizado apenas para Bancos DB2)Nome do esquema utilizado pela conexão.REPORTDATABASESCHEMA=DB2USER 
REPORTDATABASEINSTANCENome da instancia do Banco de Dados (utilizado apenas para Bancos Informix)Nome da instancia definida na instalação do Banco de DadosREPORTDATABASEINSTANCE=ol_windows
 REPORTDATABASELOCALEDefine o código de caracteres utilizado pelo Banco de Dados
 

 REPORTDATABASELOCALE=EN_US.CP1252
REPORTWEBSERVERPATHURL complementar para chamada do visualizador de ReportsPath complementar para chamada do visualizador. Complementando o parâmetro WEBVIEWER

 REPORTWEBSERVERPATH=/


ORACLESIDSEPARATOR

Indica para versões do Oracle 12c em diante qual será o separador de SID utilizado na conexão com o banco de dados. Por default a conexão com o Oracle é realizada como separador ":" para o SID

jdbc:oracle:thin:@000.0.0.0:1521:SID

Para a versão do Oracle 18 deve-se usar o "/"

jdbc:oracle:thin:@000.0.0.0:1521/SID

Esta chave é utilizada somente para oracle e é opcional, sendo o seu default :.

Esta chave somente é utilizada a partir da lib label 20200504

Normalmente : ou /ORACLESIDSEPARATOR=:

Exemplo:

 [REPORTSERVICE]

ENABLED=1

REPORTENGINE=TOMCAT

...

REPORTDATABASESCHEMA=DB2

REPORTDATABASEINSTANCE=ol_tec_windows2008teste

REPORTDATABASELOCALE=EN_US.CP1252

REPORTWEBSERVERPATH=/ 

Configurando o Tomcat

 

Quando utilizado o Tomcat como engine de processamento e exibição de Reports, devem ser observados os seguintes detalhes:

 

...

  • 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

...

  • .
    Image Added


  • Deve ser criado um arquivo na pasta <Path de instalação do TOTVS | WebViewer>\server\webapps\WebViewer\WEB-INF com a seguinte nomenclatura

...

  • <environment>".properties". Deve ser criado um arquivo para cada ambiente Protheus que deseja utilizar a instalação do BIRT.
    O nome do arquivo deve ser o nome do environment configurado no appserver.ini. Exemplo: "produção.properties" ou "desenvolvimento.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
    SGDBNome do arquivo (driver)
    Informixifxjdbc.jar
    DB2db2jcc.jar
    SQL Serversqljdbc4.jar
    ORACLEojdbc6.jar
    POSTGRESpostgresql.jar