Para ilustrar como ocorre a integração, seguem os diagramas onde demonstram demonstrando situações que podem ocorrer durante a implantação e até mesmo após a implantação.
Lembramos que estes são pontos de alerta, e não garantem que a integração seja realizada com sucesso, afinal cada implantação e integração, por ser única, podem apresentar cenários distintos.
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.
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}
