27/11/2012
2 Sumário 1 Visão Geral da Solução... 3 Pré-requisitos... 3 2 Como Utilizar esta Solução... 10 Configurações Necessárias... 10 Passo a Passo... 10 Dicas de Produtividade... 11
3 1 Visão Geral da Solução Necessidade a ser atendida: Necessidade de visualizar rapidamente relatórios em PDF sem que estes fiquem na fila do Gerador de Relatórios esperando outros relatórios serem processados, podendo ser gerados em paralelo sem interdependência. Resumo da solução: Modificar a geração de relatórios para que possam ser processados em paralelo, podendo em seguida ser visualizados no formato PDF. Pré-requisitos Para que o usuário possa utilizar esta solução, o mesmo deverá ter acesso aos seguintes módulos e transações: Módulo Relatórios de Crédito: Siglas e descrições padrões no módulo de Segurança Documento/ Relatório RELT Relatórios Transação CORE Consulta de Relatórios Emitidos Função (padrões) Breve descrição Consulta de relatórios: utilizar para consulta de relatórios solicitados e re-processamento de relatórios pendentes. Funcionalidade NOVA/Alterada Alterada ATENÇÃO: dependendo dos módulos incluídos no contrato de fornecimento de software celebrado com a TOTVS, o cliente poderá não ter acesso à parte dos módulos ou transações citados acima, ou mesmo a nenhum deles. Este documento, portanto, não representa, de modo algum, compromisso da TOTVS em disponibilizar todos módulos e transações citados. Para ter acesso às NOVAS transações, será necessário habilita-las no Sistema de Segurança, conforme segue. Não há novas transações.. Para usufruir desta solução, também serão necessários os seguintes requisitos técnicos adicionais: 1) Java Runtime Environment (JRE) 6 ou superior: Para validar a existência da JRE e sua versão, basta abrir um novo terminal e executar o comando java -version :
2 Caso não esteja instalada a versão correta é necessário remover a versão atual (Manual de como fazer neste link 1) e posteriormente instalar a correta (Manual de como fazer neste link 2). * link 1 - http://www.java.com/pt_br/download/uninstall.jsp * link 2 - http://www.java.com/pt_br/download/help/windows_offline_download.xml Obs: Em alguns casos, apesar de instalar a versão correta no momento que digitamos no terminal java -version, a versão retornada ainda está incorreta. Isso pode estar ocorrendo porque na variável de ambiente path já existe um caminho para uma JRE (isso acontece geralmente para máquinas que possuem o Oracle Client instalado). Para resolver isso, basta remover este caminho da variável path e adicionar o caminho correto da JRE: Exemplo de caminho para a JRE: C:\Arquivos de programas\java\jre7\bin
3 Após realizar as alterações, confirme as mesmas, abra um novo terminal e digite novamente java -version para confirmar a versão atual da JRE. 2) Instalar o Servidor de relatórios (Totvs-RMI): O Servidor de relatórios deve ser instalado como um serviço do windows. Para isso, basta seguir os passos abaixo: - Copiar todos os arquivos da pasta Totvs-RMI para um diretório da máquina (chamarei este diretório de TOTVS_RMI_HOME). Este diretório deve conter os seguintes arquivos: start.bat, totvs-rmi.java, rmi.policy, config.ini. Obs: O arquivo.jar, pode ter seu nome alterado devido a troca de versão. Neste caso, renomeie o mesmo para totvs-rmi.jar. - Copiar o executável nssm.exe (fornecido por terceiros) para um diretório da máquina (chamarei este diretório de NSSM_HOME, logo o caminho do executável será NSSM_HOME\nssm.exe). - Abrir um novo terminal e navegar até o diretório do executável (cd NSSM_HOME). - Executar o seguinte comando: nssm install. - Uma nova janela deve aparecer e deve ser preenchida conforme as imagens abaixo: * Application: Caminho até o arquivo start.bat (TOTVS_RMI_HOME\start.bat). * Options: Deve ficar em branco. * Service name: Totvs-RMI.
2 Obs: Em Arquivos tipo: colocar All files. - Ao clicar no botão Install service, uma mensagem de confirmação deve aparecer em uma nova janela e no terminal.
3 - Após isso, é necessário configurar com qual usuário o serviço deve executar. Neste caso, o usuário deve ser o mesmo foi utilizado para montar os passos anteriores, ou seja, o usuário que foi feito o logon na máquina para instalar/modificar o Java.
2 3) Instalar o PowerBuilder: - Instalar o rutime do PB 8 (PBRun8cli.EXE). - Instalar o rutime do PB 12 (PBRun12cli.EXE). - Criar diretorios: c:\totalbanco\gerarel\ c:\totalbanco\gerarel\credimaster\ c:\totalbanco\gerarel\dprazo\ c:\totalbanco\gerarel\dispon\ c:\totalbanco\gerarel\contabil\ c:\totalbanco\gerarel\cliente\ - Copiar executavel e pbd's de cada modulo para as devidas pastas. - Configurar os arquivos.ini's. No arquivo [client].ini verificar a configuração dos parametros do GeradorDeRelatorio (vide exemplo abaixo) [GeradorDeRelatorio] TipoArquivo=PDF Ativado=N
3 Visivel=S TempoDeEspera=10 LogFile=CF.log DirGravacao=\\10.51.7.72\rels PathAcesso=/rels PathSeparador=/ - Incluir no path do Windows os seguintes valores: C:\TotalBanco\credimaster;C:\TotalBanco\dispon;C:\TotalBanco\dprazo;C:\TotalBanco\contabil;C:\TotalBanco\Pbrun125;C:\TotalBanco\ Pbrun80;C:\TotalBanco\MSSQL;C:\TotalBanco\Oracle; - Para SQLSERVER instalar sqlncli. Verificar compatibilidade do Windows 32/64 bits sqlncli_w7_32.msi - Para Windows 7 32 bits sqlncli_w7_64.msi - Para Windows 7 64 bits sqlncli_xp_32.msi - Para Windows XP 32 bits - Instalar Ghost (gs902w64.exe ou gs906w32.exe) verificar 32/64 bits: 1 Apagar impressora "Sybase DataWindow PS" (caso exista) 2 Adicionar uma nova impressora como imprimir para o arquivo (FILE) 3 Usar a opção "com Disco", selecionar a pasta C:\Program Files\gs\gs9.02\lib\ e o arquivo ghostpdf.inf. 4 A impressora deve ser chamado de "Sybase DataWindow PS" (Exatamente esse nome) 5 Para Windows 64 bits: Na pasta C:\Program Files\gs\gs9.02\bin\ fazer uma cópia de gswin64c.exe e nomeá-lo gswin32c.exe. - Testar a aplicação através do executável (duplo click no.exe): 1 Verificar se a conexão com o banco esta ok (conseguir se logar). 2 Testar alguma consulta, e através do botão direito do mouse, selecionar "salvar como", selecionar o formato PDF, e verificar se o arquivo é gerado com sucesso.
2 2 Como Utilizar esta Solução Esta seção descreve de que maneira o usuário poderá utilizar esta solução de modo eficaz. Siga os passos indicados para usufruir plenamente desta facilidade fornecida pela TOTVS. De fato, normalmente, para que uma solução possa funcionar plenamente, são necessárias algumas configurações. Estas configurações estão descritas no item Configurações Necessárias. Uma vez que as configurações necessárias foram feitas da maneira correta, o item Passo a Passo descreve como, efetivamente, utilizar a solução, através de uma seqüência de passos. Configurações Necessárias As configurações descritas abaixo são NECESSÁRIAS para que a solução possa ser utilizada plenamente e corretamente. 1) Adicionar novo parâmetro no app.xml: Será necessário adicionar o parâmetro <istotvsrmi>true</istotvsrmi> ao arquivo app.xml, encontrado na tabela t900arqu do owner app. 2) Configurar servidor(es) de geração de relatórios: Será necessário configurar o servidor onde o gerador de relatório estará instalado. Estas configurações devem ser realizadas na tabela t400trel (ainda não existe uma transação de configuração visual) para cada módulo, conforme imagem abaixo: - Coluna SG_MDL : Sigla do módulo. - Coluna END_IP4_SRV : Endereço IP (versão 4) do servidor do gerador de relatórios. - Coluna NR_POR_SRV : Número da porta do servidor do gerador de relatórios. - Coluna DS_CMO_EXE : Descrição do caminho do executável - Coluna CD_USU_ATU : Código do usuário atualizador. - Coluna DH_ATU : Data e Hora da atualização. Exemplo de configuração. Passo a Passo A geração dos relatórios permanece da mesma forma, sendo mantido o processo já existente. A nova funcionalidade de re-processamento de relatórios, permite que o usuário reenvie a solicitação de geração do relatório, evitando que o mesmo precise preencher novamente o filtro do relatório. Esta funcionalidade está presente no módulo Relatórios de Crédito,
3 documento Relatórios e transação Consulta de Relatórios Emitidos, para os relatórios solicitados pela nova forma de geração e com status de PENDENTE ou ERRO. Abaixo, seguem imagens de exemplo de utilização: Dicas de Produtividade Não há dicas de Produtividade.