Dúvida
Como montar o ambiente de integração Educacional x DocXpress?
Ambiente
TOTVS Educacional - Integração - DocXpress - A partir da versão 12.1.24
Solução
Para montagem do ambiente de integração, realize os seguintes passos. Estando o ambiente da Instituição em nosso Cloud TOTVS, toda ação dentro do ambiente de instalação deverá ser solicitada a nosso suporte do Cloud. Antes de seguir os passos abaixo, observe se o ambiente possui liberação de Firewall/Proxy de acesso ao endereço do webservice (ged.docxpress.com.br) nas portas 80 e 443. Siga os 10 passos abaixo.
1. Após realizar a contratação da solução, primeiramente recomendamos uma leitura das documentações da integração disponibilizadas pela Debarry no endereço abaixo. (É necessário usuário e senha disponibilizados pela Debarry para acessar o endereço). https://www.debarry.com.br/Login/
2. Para funcionamento da integração, deverão ser executados alguns scripts e a criação de algumas views no Banco de dados. Os scripts e views são obtidos juntos ao suporte da Debarry para execução no ambiente TOTVS; estando o ambiente TOTVS em nosso CLOUD, direcione os scripts e views obtidos para execução ao nosso suporte Cloud TOTVS. Sobre os scripts, atualmente são 3 a serem executados.
O primeiro script (geralmente chamado TABELAS) criará as tabelas ZDOCXPRESS_USUARIO e ZDOCXPRESS_LINKASS com os dados do Usuário da integração. O segundo script (geralmente chamado KEYS) criará a tabela ZDOCXPRESS_KEYS onde estarão as chaves da integração (em relação à tabela ZDOCXPRESS_KEYS, a mesma deve ter 1 linha (row) com as chaves de acesso ao WebService. Se possuir mais de uma linha na tabela, é necessário verificar qual a correta a partir do banco de dados do DocXpress e excluir a chave desativada.) Por último, execute o terceiro script (geralmente chamado ACTIONS; onde possui o CNPJ da empresa). Abaixo seguem prints das tabelas no banco de dados; os dados estão em branco mas virão todos preenchidos. Já paras as views, maiores informações devem ser obtidas junto ao suporte da Debarry. A execução das views chamadas DX_V_HISTORICO_105 | DX_V_HISTORICO_105_HIST são obrigatórias!
3. Baixe as DLLS no repositório da Debarry (https://www.debarry.com.br/Login/). Realize o download da DLL referente à versão correspondente do TOTVS RM. As novas DLLS sempre são disponibilizadas pela Debarry, em caso de dúvidas, poderá entrar acionar o Suporte deles. Deve se utilizar sempre a mais atualizada, compatível com a versão do RM e Banco de dados utilizados. Obs: Quando vamos atualizar as DLLS do ambiente, devemos excluir as antigas ou substituí-las da pasta Custom e adicionar as novas.
Após realizar o download, acesse a pasta de instalação TOTVS e no caminho C:\totvs\CorporeRM\RM.Net crie uma pasta com nome Custom (caso a mesma ainda não exista). Dentro dessa pasta, vamos inserir as DLLS baixadas do repositório da Debarry (não insira nenhum outro item nessa pasta além das DLLS da integração).
Se o ambiente estiver configurado em n camadas, deverá realizar esse procedimento em todos os Servidores que possuem serviço do RM (em cada servidor que executa qualquer serviço Host). Importante também não colocar nenhuma DLL fora dessa pasta para não ocorrerem incidentes nos processos da integração com o Educacional. Segue exemplo abaixo. DLLS baixadas.
Inserção das DLLS na pasta Custom (basta copiar e colar, ou selecionar todas e arrastar para a pasta).
4. Verificar se alguma das DLLS estão bloqueadas, caso esteja, bastará desbloqueá-la (Este procedimento geralmente é necessário em ambientes com Windows SERVER). Para validar se estão bloqueadas, selecione a DLL na pasta (deverá fazer uma a uma) e clique com o botão direito do mouse ou use o comando SHIFT + F10; em seguida clique em 'Propriedades'. Caso a DLL esteja bloqueada por questões de Segurança do Windows, clique em 'Desbloquear' ou 'Unlock'.
5. Abra o arquivo Alias.dat localizado no diretório de instalação do RM geralmente no caminho padrão: C:\totvs\CorporeRM\RM.Net e para cada tag <RunService>false</RunService> o valor deverá ser alterado de False para True. (exemplo abaixo)
6. Após essas ações, devemos parar o HOST (SERVICE ou EXE), o executando (sempre) como ADM.
7. Apague os arquivos _Broker e _BrokerCustom localizados no diretório de instalação do RM geralmente no caminho padrão: C:\totvs\CorporeRM\RM.Net conforme print abaixo.
8. Reinicie o HOST (SERVICE ou EXE). Após o reinício dos Hosts, caso existam apenas as DLLS do DocXpress na pasta Custom, o Broker_Custom deverá ter aproximadamente o tamanho de 6,32~7kb.
Ao acessar o RM.EXE no módulo Educacional no caminho Integrações | Acesso doc.Xpress, teremos liberado o menu para login do usuário de integração com o DocXpress. Insira o usuário e senha e clique em Salvar. Nesta tela também será exibida a versão da DLL utilizada e a possibilidade de uso do Acrobat Reader para visualização dos documentos (este programa deverá estar instalado, não sendo obrigatório; não é um programa onde a TOTVS ofereça suporte).
9. Para que o Usuário do RM.EXE utilize as funcionalidades da integração, o mesmo deverá ter as permissões liberadas no perfil. Dentro do cadastro do Perfil no sistema Educacional (acesse pelo módulo Serviços Globais o menu Segurança | Perfis | Sistema: Educacional | Selecione o Perfil), dentro do Perfil, acesse a aba 'Acesso a Menus'. Dentro das permissões, acesse o item 'Customização' e libere as permissões necessárias ao Perfil que será associado ao Usuário do Educacional.
10. O GED, que é o Gerenciador Eletrônico de Documentos da DocXpress é acessado através do seguinte link: https://ged.docxpress.com.br/Login/ (usuário e senha devem ser obtidos junto ao suporte da Debarry). Recomendamos para utilização do GED o navegador Google Chrome.
Para utilização do GED no navegador Edge, será necessário a instalação de um complemento chamado WEB PKI, que é uma extensão gratuita que permite usar Certificados digitais em páginas web. Realizando sua instalação (obtido em vários site da WEB), poderá acessar com sucesso o GED. Após essas ações, a integração estará pronta para ser utilizada!
0 Comentários