Páginas filhas
  • 01 - Instalação GRL

Versões comparadas

Chave

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

Pagetitle
Instalação GRL
Instalação GRL



O Gerenciador de Relatórios é uma ferramenta que apresenta a listagem dos relatórios impressos em disco a partir do LOGIX no formato texto (extensão LST) quando for configurado como SPOOL padrão de visualização de relatórios para a Logix.

Esta ferramenta pode ser executada em qualquer Sistema Operacional e o seu acesso é via navegador WEB.

A seguir serão apresentados alguns itens relaciondos a instalação e configuração da ferramenta para correto funcionamento na integração com o produto Logix

01. PRÉ-REQUISITOS


Para quem possui o Gerenciador de Arquivos, versão anterior a ferramenta Gerenciador de relatórios, deverá substituir pelo Gerenciador de Relatórios LOGIX (GRL) para que o processo de integração como Single Sign On (Autenticação automática) do LOGIX esteja funcional.

A execução do LOGIX integrada com o Gerenciador de Relatórios somente é válida a partir da versão 4.4.14 da ferramenta.

O GRL foi desenvolvido para executar com as versões mais atuais do webserver apacheApache-tomcat Tomcat desenvolvido pelo grupo Apache. O Apache-tomcat é executado sobre a plataforma java.

Para a instalação e configuração da ferramenta integrada ao ERP LOGIX, é necessário conhecimento básico em Apache Tomcat, Java, sistema operacional onde o Apache Tomcat e java fore forem instalados, configurações do ERP LOGIX e configurações JDBC com banco de dados.


02. INSTALAÇÃO


Siga os passos a seguir para instalar o Gerenciador de Relatórios pela primeira vez:


  •  Instale o Java SE Development Kit (JDK). A versão runtime Java não é suficiente para executar o Gerenciador de Relatórios, neste caso é necessário instalar a versão JDK. 


  •  Anote o caminho da pasta onde foi instalado o Java e crie a seguinte variável de ambiente no servidor, com conteúdo igual ao caminho completo da pasta de instalação do Java JDK:
Bloco de código
languageruby
themeConfluence
    Exemplo: JAVA_HOME=c:\java\jdk1.8.0


  •  Instale o Apache TomCat mais atual disponibilizado pelo fabricante compatível com o sistema operacional do servidor clicando AQUI.
Aviso

Se já existir uma versão de Apache TOMCAT e Java JDK instalado, não é necessário realizar nova instalação.

...

  •  Faça o download do Gerenciador de Relatórios disponível a partir da central de downloads da Totvs e descompacte o arquivo na pasta de instalação de um servidor Apache TomCat instalado e funcional (abaixo da pasta webapps):

...

  •  Na pasta de instalação do Apache TomCat existe uma pasta nomeada como bin e nesta existe um arquivo nomeado como startup.bat (windows) ou startup.sh (para ambientes linux). Tente executar este arquivo de lote/shell, onde deverá aparecer uma tela semelhante a figura abaixo:

...

  •  Será exibida a seguinte tela, com dados referentes aos serviços gerenciados pelo Apache TomCat:

Ao final atente para que o serviço tenha sido iniciado com sucesso como na imagem acima onde tem o texto "org.apache.catalina.startup.Catalina.start Server startup in 3227 ms".

...

Nota

Se alguma mensagem de erro for reportada, tente solucionar com auxílio das documentações disponíveis do Apache TomCat.


  •  Todos os parâmetros de configuração utilizados pelo Gerenciador de Relatórios estão devidamente documentados no arquivo web.xml. O arquivo WEB.XML  que está disponível na pasta WEB-INF localizada na pasta onde foi descompactado o arquivo ZIP de instalação do gerenciador Gerenciador de relatóriosRelatórios.
Bloco de código
languageruby
themeConfluence
    Exemplo:   C:\usr\Tomcat 9.0\webapps\gerenciadorelatorios\WEB-INF\web.xml
Dica

Configure o serviço do Apache Tomcat para ser iniciado automaticamente no servidor, conforme orientações do fabricante.

03. CONFIGURAÇÃO

O gerenciador de relatórios permite realizar a conexão com mais de um banco de dados, sendo necessário apenas configurar a nova conexão no arquivo WEB.XML.

Image Removed

Para que a integração com o LOGIX seja possível, o nome dos ambientes/conexões de banco de dados registrados no arquivo WEB.XML devem respeitar o mesmo nome da chave DBALIAS informada no arquivo de configuração do servidor TOTVS Tec (TOTVSAPPSERVER.INI), pois assim o gerenciador de relatórios irá usar o mesmo banco de dados em uso a partir da execução do sistema LOGIX. Portanto deve-se atentar para que as configurações das chaves de conexão do banco de dados relacionadas a este ambiente no arquivo WEB.XML devem refletir informações para conectar o mesmo banco indicado na conexão do LOGIX na chave DBALIAS do servidor de aplicação TOTVS Tec.

...

titleEXEMPLO

...

Como a chave DBALIAS está definida como logixprd no exemplo acima, este mesmo valor deve ser usado para nomear o ambiente de conexão no arquivo WEB.XML do gerenciador de relatórios conforme exemplo a seguir:

Informações
iconfalse

<!-- Configurações de Conexões de banco de dados ambiente Logix101-->
<!-- dbtype:DBAlias -->
<!-- Os valores compativeis com dbtype são: oracle, sql-server, informix -->
<context-param>
<param-name>dbtype:logixprd</param-name>
<param-value>oracle</param-value>
</context-param>
<!-- driver:DBAlias -->
<context-param>
<param-name>driver:logixprd</param-name>
<param-value>oracle.jdbc.driver.OracleDriver</param-value>
</context-param>
<!-- url:DBAlias -->
<context-param>
<param-name>url:logixprd</param-name>
<param-value>jdbc:oracle:thin:@lndb02:1521:ora10g</param-value>
</context-param>
<!-- login:DBAlias -->
<context-param>
<param-name>login:logixprd</param-name>
<param-value>logix</param-value>
</context-param>
<!-- senha:DBAlias -->
<context-param>
<param-name>password:logixprd</param-name>
<param-value>logixprd</param-value>
</context-param>
<!-- Diretorio a mapear para esta parametrizacao de banco de dados -->
<!-- diretorio_mapear:DBAlias -->
<context-param>
<param-name>diretorio_mapear:logixprd</param-name>
<param-value>DIRETORIO_LOGIX_USUARIO</param-value>
</context-param>

<!-- Filtro inicial dos nomes dos arquivos a serem exibidos para esta -->
<!--parametrizacao de banco de dados-->
<!-- Quando não definido será verificado se existe filtro inicial -->
<!--definido no parâmetro FILTRO_INICIAL padrão para todos as conexões -->
<!-- Para filtrar todos os arquivos contendo o login do usuário como -->
<!--parte do nome do arquivo, pode-se informar o filtro inicial como -->
<!-- *[usuario]* -->
<!-- Exemplo de arquivo: sup6250.admlog.lst -->
<!-- Quando conectar no gerenciador de relatórios com o usuário -->
<!--ADMLOG autometicamente este arquivo será exibido -->
<context-param>
<param-name>filtro_inicial:logixprd</param-name>
<param-value>*</param-value>
</context-param>

Dica
titleCONFIGURANDO MÚLTIPLAS CONEXÕES DE BANCO DE DADOS

É possível configurar no gerenciador de relatórios várias conexões de banco de dados. Isso muitas vezes se faz necessário, pela necessidade de existir banco de dados de uso para ambiente em produção e uso para ambiente em testes e neste caso as configurações podem ser feitas conforme a seguir:

Sempre que houver necessidade de criar mais alguma nova conexão de banco de dados no gerenciador de relatórios, no arquivo WEB.XML as chaves de configuração citadas anteriormente deverão ser incluídas e seus valores devidamente ajustados para cada nova conexão de banco de dados necessário e que seja correspondente a mesma conexão feita a partir do LOGIX, respeitando o nome da conexão DBALIAS utilizada.