Histórico da Página
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=/ |
| 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
...
- .
- 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
SGDB Nome do arquivo (driver) Informix ifxjdbc.jar DB2 db2jcc.jar SQL Server sqljdbc4.jar ORACLE ojdbc6.jar POSTGRES postgresql.jar
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas