Integração Datasul x TOTVS MES 

Para ilustrar como ocorre a integração, seguem os diagramas onde demonstram situações que podem ocorrer durante a implantação e até mesmo após a implantação.

O primeiro diagrama demonstra um problema bastante comum de ambiente. Chamamos de ambiente, todas as ferramentas e parametrizações estarem corretas, antes de falarmos da integração propriamente dita: Appserver, JBoss, WebService.

O ambiente EAI do ERP Datasul, é a base para que a Integração TOTVS MES seja implantado.

Para clientes novos do ERP Datasul, o ambiente EAI é montado e parametrizado na implantação do ERP, tornando mais fácil a implantação do TOTVS MES.

Para clientes mais antigos do ERP Datasul, o ambiente EAI pode estar desatualizado. Esta desatualização pode ser  por muitos motivos, no entanto o mais comum é que o cliente não usa nenhuma integração do EAI atualmente, logo não percebe esta desatualização. A desatualização, normalmente não é de programas ou funções, mas sim de mudanças que ocorreram em servidores no próprio cliente, e que não foram repassadas ao ambiente EAI.

Umas das primeiras validações a ser realizada, é corrigir o ambiente EAI, para poder atualizar a parametrização (Appserver, JBoss, WebService).

Outro cuidado, que diz respeito a esta parametrização, é quando o cliente possui mais de um ambiente ativo em seus servidores. É necessário então, atenção especial para que as várias bases que o cliente possa possuir: testes, homologação, produção, estejam apontando para as bases e programas corretamente.

O diagrama abaixo mostra esta situação.

O segundo diagrama demonstra outro problema comum, quando ocorre erro no ambiente ERP, e este erro não é apresentado na integração (são erros não gerenciáveis pela aplicação), e fica registrado apenas no log do Appserver.

Estes erros podem ter vários motivos: desde uma variável do tipo numérico recebendo conteúdo caractere, até um erro de compatibilidade de programa e base (CRC).

É importante, nestes casos que não há retorno de parecer no IntegTOTVS, seja investigado o log do Appserver.

Um erro, bem comum, quando está tudo funcionando, e depois de uma atualização de programas para de funcionar, é quando não é atualizado o Appserver com os novos programas. Isto porque, quando se trabalha com ambientes remotos, há necessidade de atualizar os programas no ambiente do ERP e no Appserver.

Instalação

1. Servidor de Aplicação TOTVS

1.1 Servidor de aplicação legado (JBOSS)

A integração TOTVS x PPI-Multitask necessita de uma parametrização de qual usuário será utilizado para a integração durante a comunicação com o WebServices do TOTVS MES, essa configuração é importada das credenciais de login do framework metadados, localizada em datasul_framework.properties.

Esse arquivo pode ser localizado em: %JBOSS_HOME%\server\<instancia>\conf\datasul\datasul_framework.properties.

As seguintes linhas representam as credenciais que necessitam ser informadas corretamente:

#+-------------------------------------------+
#| CONFIGURACOES METADADOS |
#+-------------------------------------------+

<...>

java.naming.security.principal=<user>

java.naming.security.credentials=<password>

Também deverá ser parametrizado um role e user de integração no JBOSS, nos arquivos jbossws-roles.properties e jbossws-users.properties respectivamente, conforme exemplo:

Exemplo de arquivo jbossws-roles.properties:

# A sample roles.properties file for use with the UsersRolesLoginModule
eai=eai2allowed

Exemplo de arquivo jbossws-users.properties:

# A sample users.properties file for use with the UsersRolesLoginModule
eai=eai@123

Esses logins e senhas devem ser parametrizados na aplicação do PC-Factory.

O webservice disponibilizado para o TOTVS MES é encontrado por meio da URL: <hostname>:<porta>/mes-ws/MESService?wsdl

Além disso, é necessário informar a TAG totvs.datasul.mes no arquivo service_locator.properties, conforme exemplo abaixo:

totvs.datasul.mes=${datasul.framework}

1.2 Servidor de aplicação Novo Frame (Tomcat)

• Caso o ambiente esteja configurado para utilizar Datasul for THF (Novo Framework), a URL de acesso ao webservice do MES é diferente, seguindo o padrão http://servidor:porta/totvsmes/public/ws/MESService.wsdl.
• O usuário de integração não mais será conforme a parametrização do Jboss (descrito no item 1.1) mas sim através de um usuário do sistema através de autenticação direta.
• Também deverá ser conferido a instalação do pacote totvsmes.war dentro do webapps do servidor de aplicação, conforme imagem abaixo: