Integração Datasul x PPI-Multitask (Acervo - Uso Interno)

Contexto de negócio 

1. MES

Manufacturing Execution Systems, ou simplesmente MES, é o termo usado para designar os sistemas focados no gerenciamento das atividades de produção e que estabelecem uma ligação direta entre o planejamento e o chão de fábrica. Os sistemas MES geram informações precisas e em tempo real que promovem a otimização de todas as etapas da produção, desde a emissão de uma ordem até o embarque dos produtos acabados.

A importância destes sistemas vem da lacuna que normalmente existe entre o ERP (Entreprise Resource Planning) e os softwares específicos da linha de produção. O MES pode importar dados do ERP e integrá-los com o dia-a-dia da produção, gerenciando e sincronizando as tarefas produtivas com o fluxo de materiais.

Considerando que na cadeia de suprimento o maior valor agregado costuma estar na produção, faz todo sentido investir em sistemas que otimizem o fluxo, controle e qualidade do material (Fonte: PPI-Multitask).

2. Planejamento e Controle de Produção

A reunião dos meios de produção (matéria-prima, mão-de-obra e equipamentos) possibilita a fabricação de produtos que surgem pela ação dos Sistemas produtivos.

Os planos que servem de guia na execução e no controle da produção são comandados pelo órgão auxiliar denominado Planejamento e Controle da Produção (PCP), que dita normas a linha de produção, visando a um fluxo ordenado e contínuo do processo produtivo.

Sistemas Envolvidos

• TOTVS DATASUL 12
• PC-FACTORY (PPI MULTITASK)

Integração

O objetivo da Integração PC Factory (software MES da empresa PPI Multitask) X ERP TOTVS é disponibilizar aos clientes TOTVS uma nova opção para controle da produção por meio da automação dos processos, permitindo a atualização e extração de informações de forma on-line de modo a simplificar o fluxo dos clientes.

Escopo

Pré-requisitos instalação/implantação/utilização

1. Datasul

Pré-requisitos de instalação da integração:

• Datasul versão 12.1.6.
• Módulo de produção implantado.
• Servidor de Web Service, disponibilizado dentro do EAR Datasul 12.1.6.
• Configuração de usuário de integração EAI.

Pré-requisitos de negócio:

A integração padrão atende movimentos de quantidades produzidas e horas reportadas, ou seja, não estão inclusos ajustes de requisições, as requisições necessitam ocorrer de forma automática no momento de reporte de acordo com pelo menos uma dos recursos abaixo:

• Alocação de material;
• Ordens de produção com linha do tipo serviço (requisição continuarão sendo feita dentro do produto TOTVS em momento diferente do reporte);
• Ajustes nas reservas das ordens de produção para que cada componente possua depósito e localização de requisição informado.

Além dos requisitos listados acima, somente são atendidas na Fase I da integração TOTVS MES as ordens com política de reporte do tipo "Ordem", ou seja, reportes por item e chão de fábrica não são suportados nesta fase do projeto.

Demais recursos serão complementadas neste documento conforme liberação das próximas fases.

Instalação/Atualização

1. Servidor de Aplicação TOTVS (JBOSS)

A integração TOTVS x PPI-

Instalação/Atualização

1. Servidor de Aplicação TOTVS (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 credencias 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 através da URL: <hostname>:<porta>/mes-ws/MESService?wsdl

2. Datasul

A integração TOTVS x PPI-Multitask é ativada por intermédio dos seguintes passos:

1. Abrir o programa de Parâmetros do Controle da Produção - CP0106.
2. Selecionar a Página 5.
3. Na área de Integração PPI-Multitask, marcar a opção Ativo.
4. Informar a URL do WebService.
5. Verificar a conectividade do WebService por meio do botão Testar WS.
6. Configurar os parâmetros da integração por meio do botão Parâmetros.
7. Confirmar a ativação por meio do botão OK.

O botão de Testar WS verifica se é possível realizar a conexão com o WebService informado no campo URL do WebService. Este botão tem dois retornos:

• Teste realizado com sucesso.
• Conexão com o WebService MES Channel falhou.

O botão de Parâmetros abre o programa CP0106B que permite o cadastro de filtros para a integração da Ordem de Produção. Os possíveis filtros são:

• Linha de produção.
• Estabelecimento.
• Planejador.

As situações a seguir exemplificam a utilização dos parâmetros.

Situação 1 - Poderá ser criado mais de um filtro para um mesmo campo. Por exemplo: somente as ordens criadas ou alteradas com os planejadores João ou José, estabelecimento ALM e linhas de produção 1 ou 2 serão enviadas para a PPI-Multitask.

Situação 2 - Todas as ordens de produção criadas e alteradas serão enviadas para a PPI-Multitask se todos os filtros estiverem cadastrados com *.

Situação 3 - somente as ordens de produção com estabelecimento 1 serão enviadas para a PPI-Multitask.

Situação 4 - se não existir filtro cadastrado, então nenhuma ordem de produção será enviada para a PPI-Multitask.

Situação 1:

Situação 2:

Situação 3:

Um filtro poderá ser removido por meio do botão Remover no canto inferior direito do programa.

O envio de informações da TOTVS para a PPI-Multitask ocorre nas seguintes transações:

• Cadastro e alteração de item, depósito, grupo de máquina e ordens de produção.
• Cadastro e alteração de reservas, operações e rede pert de ordens de produção.

Controle de Versão

O grupo TOTVS representado por suas marcas administrará as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.

Suporte

O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos RM Conector e Backoffice Protheus estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.

Observação: Este modelo de suporte está sendo revisado pela TOTVS.

Fluxo das Informações

A integração ocorrerá no momento de cadastro ou alteração de cada transação, onde será criado um arquivo XML no diretório “<Pasta temporária de trabalho>\INTEGR_MES” com as informações que foram enviadas. O nome do arquivo XML iniciará com OK, ERROR ou PEND, seguido pela transação, hora/minuto/segundo e um código identificador.

Exemplos de arquivos XML gerados:
Sucesso: OK_Item_14_55_38_<código do item>.xml
Erro: ERROR_Item_14_46_38_<código do item>.xml
Pendente: PEND_ProductionOrder_15_07_38_<número da ordem>.xml

Fluxo das informações das transações:

• Item, depósito e grupo de máquina: no momento da criação ou alteração de um item no programa CD0204, de um depósito no programa CD0601 ou de um grupo de máquina no programa CD0111, o programa irá verificar se a integração está ativa e, se estiver ativa, irá efetuar o envio do cadastro para a PPI-Multitask. Se não ocorrer erro o cadastro não apresentará nenhuma mensagem, se ocorrer erro uma mensagem será exibida questionando se deseja criar uma pendência de envio no programa CD2900. Em ambas as situações, um arquivo XML será gerado na pasta temporária de trabalho. 

• Ordem de produção: no momento da criação ou alteração de uma ordem de produção, ou durante a alteração da situação de uma ordem (eliminação, alocação, requisição), o programa irá verificar se a integração está ativa e, se estiver ativa, irá efetuar o envio do cadastro para a PPI-Multitask, com exceção para as ordens criadas pelo MRP e/ou APS. Se não ocorrer erro o cadastro não apresentará nenhuma mensagem, se ocorrer erro uma mensagem será exibida e uma pendência de envio será criada no programa CD2900. Em ambas as situações um arquivo XML será gerado na pasta temporária de trabalho.

Ordens criadas pelo MRP e/ou APS não são integradas automaticamente, estas geram pendências para execução posterior pelo programa CD2900.

Os programas afetados pela integração são apresentados na tabela abaixo:

Programa de gerenciamento de pendências CD2900 - este programa tem por função administrar as pendências/exceções referentes à integração que são criadas quando ocorre um erro no envio. Permite o reprocessamento de uma mensagem, exclusão de uma pendência e a visualização do XML, além de possuir filtro por data de envio, transação, usuário e tipo de pendência.

Programa de Carga inicial CD7002 - permite o envio das informações do item, depósito, grupo de máquina e ordem de produção e tem o objetivo de efetuar uma carga inicial no momento da implantação do PC Factory, ou então para sincronizar os dois produtos. Cada transação disponibiliza filtros para que o usuário decida o que quer enviar para a PPI-Multitask, esses filtros são apresentados conforme a transação escolhida.

Programa de cadastro de-para CD7003 - permite o cadastro da relação entre o estabelecimento do ERP Datasul e o estabelecimento da PPI-Multitask. Possuem os campos tipo de conteúdo, conteúdo ERP e conteúdo MES. 

Cadastros

Transação Item: Item_3_001.xsd

Identificador da Mensagem: Item

Versão: 3_001

Módulo Datasul: Engenharia

Tipo de Envio: Síncrona

Transação Depósito: Warehouse_1_000.xsd

Identificador da Mensagem: Warehouse

Versão: 1_000

Módulo Datasul: Produção

Tipo de Envio: Síncrona

Transação Grupo de máquina: WorkCenter_1_000.xsd

Identificador da Mensagem: WorkCenter

Versão: 1_000

Módulo Datasul: Produção

Tipo de Envio: Síncrona

Transação Ordem de Produção: ProductionOrder_1_000.xsd

Identificador da Mensagem: ProductionOrder

Versão: 1_000

Módulo Datasul: Produção

Tipo de Envio: Síncrona

Processos

Transação Apontamento de Produção: ProductionAppointment_1_001.xsd

Identificador da Mensagem: ProductionAppointment

Versão: 1_001

Módulo Datasul: Produção

Tipo de Envio: Síncrona 

Transação Apontamento MOB/GGF: WorkforceAndOverheadAppointment_1_000.xsd

Identificador da Mensagem: WorkforceAndOverheadAppointment

Versão: 1_000

Módulo Datasul: Produção

Tipo de Envio: Síncrona

Checklist de suporte da aplicação

Checklist de Verificações:

• No programa CP0106, página 5:
     - Verificar se o checkbox Ativo da Integração PPI-Multitask está marcado.
     - Testar conexão com o WebService informado por meio do botão Testar WS.
     - Verificar se os parâmetros da integração foram preenchidos, acessando o botão de Parâmetros.
• Acessar o diretório “<Pasta temporária de trabalho>\INTEGR_MES” para verificar se o envio de uma transação foi executado sucesso ou se ocorreu um erro. (Válido através da rotina de carga inicial CD7002).
• Verificar se o cadastro De-para Totvs - MES foi preenchido corretamente no programa CD7003.
• Caso ocorra algum erro no envio de uma transação será gerada uma pendência no programa CD2900. Neste programa é possível ver o arquivo com as informações da mensagem XML enviada e também fazer o reprocessamento do envio.

Integração Datasul x PPI-Multitask

Contexto de negócio 

1. MES

Manufacturing Execution Systems, ou simplesmente MES, é o termo usado para designar os sistemas focados no gerenciamento das atividades de produção e que estabelecem uma ligação direta entre o planejamento e o chão de fábrica. Os sistemas MES geram informações precisas e em tempo real que promovem a otimização de todas as etapas da produção, desde a emissão de uma ordem até o embarque dos produtos acabados.

A importância destes sistemas vem da lacuna que normalmente existe entre o ERP (Entreprise Resource Planning) e os softwares específicos da linha de produção. O MES pode importar dados do ERP e integrá-los com o dia-a-dia da produção, gerenciando e sincronizando as tarefas produtivas com o fluxo de materiais.

Considerando que na cadeia de suprimento o maior valor agregado costuma estar na produção, faz todo sentido investir em sistemas que otimizem o fluxo, controle e qualidade do material (Fonte: PPI-Multitask).

2. Planejamento e Controle de Produção

A reunião dos meios de produção (matéria-prima, mão-de-obra e equipamentos) possibilita a fabricação de produtos que surgem pela ação dos Sistemas produtivos.

Os planos que servem de guia na execução e no controle da produção são comandados pelo órgão auxiliar denominado Planejamento e Controle da Produção (PCP), que dita normas a linha de produção, visando a um fluxo ordenado e contínuo do processo produtivo.

Sistemas Envolvidos

• TOTVS DATASUL 12
• PC-FACTORY (PPI MULTITASK)

Integração

O objetivo da Integração PC Factory (software MES da empresa PPI Multitask) X ERP TOTVS é disponibilizar aos clientes TOTVS uma nova opção para controle da produção por meio da automação dos processos, permitindo a atualização e extração de informações de forma on-line de modo a simplificar o fluxo dos clientes.

Escopo

Image Removed

Pré-requisitos instalação/implantação/utilização

1. Datasul

Pré-requisitos de instalação da integração:

• Datasul versão 12.1.6.
• Módulo de produção implantado.
• Servidor de Web Service, disponibilizado dentro do EAR Datasul 12.1.6.
• Configuração de usuário de integração EAI.

Pré-requisitos de negócio:

A integração padrão atende movimentos de quantidades produzidas e horas reportadas, ou seja, não estão inclusos ajustes de requisições, as requisições necessitam ocorrer de forma automática no momento de reporte de acordo com pelo menos uma dos recursos abaixo:

Instalação/Atualização

1. Servidor de Aplicação TOTVS (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:  

:<porta>/mes-ws/MESService?wsdl

2. Datasul

A integração TOTVS x PPI-Multitask é ativada por intermédio dos seguintes passos:

1. Abrir o programa de Parâmetros do Controle da Produção - CP0106.
2. Selecionar a Página 5.
3. Na área de Integração PPI-Multitask, marcar a opção Ativo.
4. Informar a URL do WebService.
5. Verificar a conectividade do WebService por meio do botão Testar WS.
6. Configurar os parâmetros da integração por meio do botão Parâmetros.
7. Confirmar a ativação por meio do botão OK.

O botão de Testar WS verifica se é possível realizar a conexão com o WebService informado no campo URL do WebService. Este botão tem dois retornos:

• Teste realizado com sucesso.
• Conexão com o WebService MES Channel falhou.

O botão de Parâmetros abre o programa CP0106B que permite o cadastro de filtros para a integração da Ordem de Produção. Os possíveis filtros são:

• Linha de produção.
• Estabelecimento.
• Planejador.

As situações a seguir exemplificam a utilização dos parâmetros.

Situação 1 - Poderá ser criado mais de um filtro para um mesmo campo. Por exemplo: somente as ordens criadas ou alteradas com os planejadores João ou José, estabelecimento ALM e linhas de produção 1 ou 2 serão enviadas para a PPI-Multitask.

Situação 2 - Todas as ordens de produção criadas e alteradas serão enviadas para a PPI-Multitask se todos os filtros estiverem cadastrados com *.

Situação 3 - somente as ordens de produção com estabelecimento 1 serão enviadas para a PPI-Multitask.

Situação 4 - se não existir filtro cadastrado, então nenhuma ordem de produção será enviada para a PPI-Multitask.

Situação 1:

Situação 2:

Situação 3:

Um filtro poderá ser removido por meio do botão Remover no canto inferior direito do programa.

O envio de informações da TOTVS para a PPI-Multitask ocorre nas seguintes transações:

• Cadastro e alteração de item, depósito, grupo de máquina e ordens de produção.
• Cadastro e alteração de reservas, operações e rede pert de ordens de produção.

Controle de Versão

O grupo TOTVS representado por suas marcas administrará as demandas de evolução dos layouts e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.

Suporte

O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos RM Conector e Backoffice Protheus estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.

Observação: Este modelo de suporte está sendo revisado pela TOTVS. 

Transações/Entidades/Mensagens únicas

As seguintes transações serão trocadas entre a TOTVS e a PPI-Multitask:

Fluxo das Informações

A integração ocorrerá no momento de cadastro ou alteração de cada transação, onde será criado um arquivo XML no diretório “<Pasta temporária de trabalho>\INTEGR_MES” com as informações que foram enviadas. O nome do arquivo XML iniciará com OK, ERROR ou PEND, seguido pela transação, hora/minuto/segundo e um código identificador.

Exemplos de arquivos XML gerados:
Sucesso: OK_Item_14_55_38_<código do item>.xml
Erro: ERROR_Item_14_46_38_<código do item>.xml
Pendente: PEND_ProductionOrder_15_07_38_<número da ordem>.xml

Fluxo das informações das transações:

• Item, depósito e grupo de máquina: no momento da criação ou alteração de um item no programa CD0204, de um depósito no programa CD0601 ou de um grupo de máquina no programa CD0111, o programa irá verificar se a integração está ativa e, se estiver ativa, irá efetuar o envio do cadastro para a PPI-Multitask. Se não ocorrer erro o cadastro não apresentará nenhuma mensagem, se ocorrer erro uma mensagem será exibida questionando se deseja criar uma pendência de envio no programa CD2900. Em ambas as situações, um arquivo XML será gerado na pasta temporária de trabalho. 

• Ordem de produção: no momento da criação ou alteração de uma ordem de produção, ou durante a alteração da situação de uma ordem (eliminação, alocação, requisição), o programa irá verificar se a integração está ativa e, se estiver ativa, irá efetuar o envio do cadastro para a PPI-Multitask, com exceção para as ordens criadas pelo MRP e/ou APS. Se não ocorrer erro o cadastro não apresentará nenhuma mensagem, se ocorrer erro uma mensagem será exibida e uma pendência de envio será criada no programa CD2900. Em ambas as situações um arquivo XML será gerado na pasta temporária de trabalho.

Ordens criadas pelo MRP e/ou APS não são integradas automaticamente, estas geram pendências para execução posterior pelo programa CD2900.

Os programas afetados pela integração são apresentados na tabela abaixo:

Programa de gerenciamento de pendências CD2900 - este programa tem por função administrar as pendências/exceções referentes à integração que são criadas quando ocorre um erro no envio. Permite o reprocessamento de uma mensagem, exclusão de uma pendência e a visualização do XML, além de possuir filtro por data de envio, transação, usuário e tipo de pendência.

Programa de Carga inicial CD7002 - permite o envio das informações do item, depósito, grupo de máquina e ordem de produção e tem o objetivo de efetuar uma carga inicial no momento da implantação do PC Factory, ou então para sincronizar os dois produtos. Cada transação disponibiliza filtros para que o usuário decida o que quer enviar para a PPI-Multitask, esses filtros são apresentados conforme a transação escolhida.

Programa de cadastro de-para CD7003 - permite o cadastro da relação entre o estabelecimento do ERP Datasul e o estabelecimento da PPI-Multitask. Possuem os campos tipo de conteúdo, conteúdo ERP e conteúdo MES. 

Cadastros

Transação Item: Item_3_001.xsd

Identificador da Mensagem: Item

Versão: 3_001

Módulo Datasul: Engenharia

Tipo de Envio: Síncrona

Transação Depósito: Warehouse_1_000.xsd

Identificador da Mensagem: Warehouse

Versão: 1_000

Módulo Datasul: Produção

Tipo de Envio: Síncrona

Transação Grupo de máquina: WorkCenter_1_000.xsd

Identificador da Mensagem: WorkCenter

Versão: 1_000

Módulo Datasul: Produção

Tipo de Envio: Síncrona

Transação Ordem de Produção: ProductionOrder_1_000.xsd

Identificador da Mensagem: ProductionOrder

Versão: 1_000

Módulo Datasul: Produção

Tipo de Envio: Síncrona

Processos

Transação Apontamento de Produção: ProductionAppointment_1_001.xsd

Identificador da Mensagem: ProductionAppointment

Versão: 1_001

Módulo Datasul: Produção

Tipo de Envio: Síncrona 

Transação Apontamento MOB/GGF: WorkforceAndOverheadAppointment_1_000.xsd

Identificador da Mensagem: WorkforceAndOverheadAppointment

Versão: 1_000

Módulo Datasul: Produção

Tipo de Envio: Síncrona

Checklist de suporte da aplicação

Checklist de Verificações:

• No programa CP0106, página 5:
     - Verificar se o checkbox Ativo da Integração PPI-Multitask está marcado.
     - Testar conexão com o WebService informado por meio do botão Testar WS.
     - Verificar se os parâmetros da integração foram preenchidos, acessando o botão de Parâmetros.
• Acessar o diretório “<Pasta temporária de trabalho>\INTEGR_MES” para verificar se o envio de uma transação foi executado sucesso ou se ocorreu um erro. (Válido através da rotina de carga inicial CD7002).
• Verificar se o cadastro De-para Totvs - MES foi preenchido corretamente no programa CD7003.
• Caso ocorra algum erro no envio de uma transação será gerada uma pendência no programa CD2900. Neste programa é possível ver o arquivo com as informações da mensagem XML enviada e também fazer o reprocessamento do envio.