...
- 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 Preparação de Ambiente (BIRT)Verificar no arquivo de configuração do appserver se a seguinte seção está configurada [REPORTSERVICE]: As possibilidades de configuração deste arquivo são as seguintes: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
...
REPORTDATABASELOCALE=EN_US.CP1252
REPORTWEBSERVERPATH=/
Tomcat
...
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.
Garantir que a versão correta do driver JDBC de conexão com o Banco de Dados esteja presente na pasta de instalação do TOTVS | WebViewer. A pasta a qual deve possuir os arquivos .jar de conexão com o Banco de Dados deve ser a seguinte: <Path de instalação do TOTVS | WebViewer>\server\webapps\WebViewer\drivers; (Quando necessário, pesquise junto ao fornecedor ou na internet, o driver JDBC para o banco de dados que irá utilizar).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 "config<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 |