EGRAÇÃO TOTVS HCM X Fluig LMS

Contexto de negócio (Introdução)

TOTVS HCM - Linha Datasul

O Módulo de Administração de Treinamento permite a realização de matrículas no LMS (Fluig) através uma seleção de funcionários por empresa, estabelecimento, centro de custo, unidade de lotação e cargos, para que estes possam realizar treinamentos que foram elencadas como necessidade de treinamento. Ainda permite consultar necessidades de treinamento concluídas e fichas de inventário geradas a partir de treinamento realizado pelo LMS.

As principais vantagens obtidas pelas empresas em armazenar as informações dos treinamentos realizados pelas pessoas são:

• • Comprovar a bagagem de Conhecimentos Adquirida individualmente;
  • Possibilitar a execução do Levantamento das Necessidades de Treinamento (LNT);
  • Permitir a localização das pessoas que receberam treinamentos em determinados produtos ou serviços, utilizados na organização;
  • Identificar se as Pessoas estão treinadas para executarem suas funções (Requisito da ISO 9000).

TOTVS LMS

O produto possui Treinamentos que são cursados por usuários matriculados.

Diversos tipos de conteúdo são suportados pelo LMS, dentre eles: Vídeos, áudios, animações, documentos, planilhas eletrônicas, texto e pacotes SCORM 1.2.

O produto ainda possui estrutura de instâncias virtuais, criando a chamada e-Learning Cloud. Há possibilidade de criação de Grupos de Usuários que podem ser organizados da forma que o cliente entender como adequada, afim de que os mesmos possam acessar os dois Catálogos existentes no produto, o Catálogo de Disciplinas e Turmas e o Catálogo de Trilhas e Treinamentos. Este último possui a possibilidade de abrigar Treinamentos e Trilhas Globais, que podem ser compartilhados entre as diversas instâncias, e Treinamentos e Trilhas Locais que podem ser utilizados somente pela instância em questão. Ainda é possível usar um Treinamento, como um Item de um Tópico de uma Turma.

O produto ainda possui uma funcionalidade de Turma Modelo que permite a utilização de uma Turma como modelo de Conteúdos para outras turmas. O produto também possui funcionalidades ligadas à administração de TI como o agendador de tarefas, o cadastro de instâncias, as configurações Globais e Locais. Ainda existe um sistema de notificações e a possibilidade de emissão de certificados de conclusão e aprovação em Turmas, Trilhas e Treinamentos.

Sistemas Envolvidos

Descrição dos sistemas envolvidos no contexto de negócio (e que serão envolvidos na integração).

• TOTVS HCM - O Módulo de Administração de Treinamento do TOTVS HCM linha Datasul permite registrar os cursos, palestras, workshops, dos quais cada funcionário participou, administrar turmas de treinamento, levantar necessidades de trenamento, administrar bolsas de estudo e, emitir e acompanha avaliações.
• Fluig LMS - O produto possui Turmas, Disciplinas, Treinamentos e Trilhas que são cursados por usuários matriculados.
  
  

Integração

Com o uso do EAI da TOTVS, será realizada a integração entre as informações comuns do TOTVS HCM e TOTVS Fluig LMS, possibilitando que as empresas que utilizam o módulo de de administração de treinamento do HCM possam realizar matrículas de funcionários através do HCM, da mesma forma que os funcionários poderão realizar o treinamento através do FLUIG LMS e este atualiza a situação do treinamento no HCM de forma automática e transparente para as empresas.

Durante o processo de consolidação de marcas, iniciado pela TOTVS, várias empresas diferentes foram adquiridas e com elas vários produtos passaram a compor o portfólio de ofertas disponível aos clientes. Esta expansão de ofertas permitiu que clientes de uma marca, antes limitados pelas opções com aquela “etiqueta”, pudesse agora compor o seu ambiente de TI utilizando produtos de origens diferentes.

Com o objetivo de padronizar a integrações com os produtos TOTVS, foi definida uma nova diretriz para os projetos de integração: A de que todos os produtos TOTVS devam trabalhar com uma mensagem XML únicos evitando, desta forma, o processo de transformação de mensagens. 

 Além de questões referentes ao formato das mensagens, a mensagem única também torna uniforme o tratamento destas mensagens XML pelos aplicativos, principalmente no que diz respeito à capacidade de rastreamento.

Todos os processos devem respeitar o fluxo normal de troca de mensagens no padrão de Mensagem Única TOTVS. O fluxo de mensagens poderá ocorrer nos seguintes sentidos:

• • HCM à LMS: Os dados serão trafegados pelo fluxo normal, onde o mesmo irá consumir o WebService do EAI do LMS para envio da(s) mensagem(s). Após a resposta do LMS o HCM atualizará o registro, com o status de processamento e demais dados, no Monitor da Fila de Mensagem Única do LMS.

• • LMS à HCM: O LMS irá consumir o WebService da linha HCM para recebimento de mensagens únicas. O mesmo também será responsável por encaminhar as mensagens para o EAI HCM, que processará a mesma (englobando todas as especificidades requeridas) e encaminhará o retorno de acordo com o tipo de comunicação definida (síncrona ou assíncrona).

Assim como definido no protocolo de comunicação de mensagens únicas, a comunicação pode ser efetuada de duas formas:

• • Síncrona: O sistema de origem gera uma mensagem de integração na sua fila e envia ao WebService de destino. O processo na origem aguarda o processamento da mensagem no destino e ao receber o retorno atualiza o status do processamento na fila de integração.

Mensagens síncronas não podem ser processadas/reprocessadas no monitor da fila de integração.

• • Assíncrona: O sistema de origem gera uma mensagem de integração na sua fila, envia ao WebService de destino e aguarda somente a confirmação de recebimento da mensagem. O processo na origem não fica parado aguardando o processamento da mensagem no destino.

Ao término do processamento da mensagem por parte do sistema de destino o mesmo envia outra mensagem de retorno ao sistema de origem com o status do processamento. As mensagens assíncronas podem ser processadas (status pendente) ou reprocessadas (status erro) manualmente através do monitor da fila de integração.

Escopo

Observação:

A integração de Turmas, trilhas, disciplinas e pessoas externas não é realizada entre os produtos.

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

Versões integração disponível:

• TOTVS HCM - 12.1.14
• Fluig LMS - 1.5.12

Saneamento dos usuários do TOTVS HCM:

Para que o usuário seja integrado do HCM para o Fluig LMS deverão ser observadas as seguintes condições:

• No complemento RH, o funcionário deverá estar informado e o campo Usuário LMS deverá estar marcado.
• Somente um usuário por pessoa física poderá ser integrado com LMS
• O e-mail deverá ser informado no cadastro de usuário
• Não poderá haver outro usuário com o mesmo e-mail.

Para realizar a conferência os passos a seguir deverão ser seguidos:

1. Emitir o relatório Usuário x Funcionário através do programa prghur/spp/lista_usuario_func_email.p. O objetivo do relatório é auxiliar no ajustes de usuários x funcionários que devem ser integrados com Fluig LMS. O programa gera um arquivo csv cujo diretório + nome deverá ser informado na tela. Neste relatório será demonstrado a situação dos usuários do HCM. 
2. Identificar todos os usuários x funcionários que deverão ser integrados com LMS e não possuem e-mail registrado. A atualização do e-mail  poderá ser feita através do programa Usuários Produto (bas_usuar_mestre), pasta geral, no campo E-mail Local. Lembrando que não poderá haver outro usuário com o mesmo e-mail.
3. Identificar todos os usuários x funcionários que deverão ser integrados e possuem e-mail duplicado. Caso a pessoa física destes usuários sejam a mesma, deverá ser selecionado o usuário que deverá realizará a integração com LMS e seguir os seguintes sub-passos:
   1. 1. Acessar o programa bas_usuar_mestre (Usuários do Produto)
      2. Selecionar o usuário que deverá ser integrado com o LMS
      3. Acessar o complemento RH 
      4. Marcar o campo Usuário LMS

Para os funcionários que possuem somente um usuário, não já necessidade de marcar o campo Usuário LMS pois isso deverá feito no processo de Instalação/Atualização.

Instalação/Atualização

Configuração do EAI TOTVS HCM - Linha Datasul:

Para a configuração do EAI no produto TOTVS Linha Datasul seguir os passos que encontra-se em: http://tdn.totvs.com/x/8odICw.

As transações de que deverão ser habilitados no aplicativo internos são as seguintes:

As seguintes transações deverão estar aparecendo ser demonstradas na configuração de rota de envio e os seguintes contextos devem estar habilitadas:

Não é necessário habilitar de-para para esta integração.

Necessário configurar o RPW para o EAI conforme descrito em http://tdn.totvs.com/x/2YdICw

Configuração do EAI Fluig LMS:

Para a configuração do EAI no produto TOTVS Linha Datasul acessar o tópico Configurando Integrações via EAI.

As transações de que deverão ser habilitados no aplicativo internos são as seguintes:

As seguintes transações deverão estar aparecendo na configuração de rota de envio e os seguintes contextos devem estar habilitadas: 

Parametrização do Módulo de Administração de Treinamento:

• Acessar o programa AT0000 - Parâmetros Administração de Treinamento e seguir os seguintes passos:
• Marcar o campo Integração com LMS
• Informar o campo Tipo de Curso LMS, deve ser um tipo de curso que está marcado como EPM no AT0021. Este campo será atualizado no curso (poderá ser consultado no AT0010) quando ocorrer a integração de curso do LMS para o HCM.
• Informar o campo Nível Hierárquico: este campo será atualizado no curso (poderá ser consultado no AT0010) quando ocorrer a integração de curso do LMS para o HCM.
• Informar o campo Grau de Instrução: este campo será atualizado no curso (poderá ser consultado no AT0010) quando ocorrer a integração de curso do LMS para o HCM.
  
  

Carga dos Cursos:

Para verificar como realizar a carga dos cursos para o HCM acessar a documentação em:

Carga dos Usuários:

1) Para realizar a carga de usuários que já existem no HCM e são do tipo colaborador é necessário que todas as etapas anteriores estejam concluídas. Acessar o programa FP9160 e executar os seguintes passos:

• Na pasta Seleção deixar os filtros para buscar todas as informações que forem necessárias.
• Na pasta Parâmetros, no campo Tipo Execução selecionar a opção Listar Usuários
• Ainda na pasta Parâmetros, marcar que deseja Integrar informações com o LMS
• Executar o relatório.

Neste momento o sistema irá integrar todos os usuários que possuem complemento RH e estão como colaboradores com o Fluig. Será emitido um relatório com a relação de usuários que foram encontrados e logo após a situação da integração com LMS de cada usuário/funcionário. Caso for identificado que a pessoa física do funcionário possui somente um usuário para o funcionário neste processo de listagem e integração, o campo Usuário LMS é marcado automaticamente e o usuário é integrado. Caso contrário,  e o campo Usuário LMS não estiver marcado não será realizada a integração.

Observação: pára os casos em que existe mais de um usuário com a mesma pessoa física, o usuário deverá escolher qual é o usuário que será integrado com o Fluig através do cadastro de Usuário do Produto (bas_usuar_mestre), botão complemento RH, marcando o campo Usuário LMS.

2) Para realizar a carga de usuários que já existem no HCM e são do tipo de Acesso para Visão Descentralizada ou Estabelecimento 

3) Para realizar a carga de funcionários que ainda não são usuários no HCM:

Este tópico tem por objetivo orientar a instalação da integração, visando o seu funcionamento completo. Instalação de produtos ou ferramentas necessárias podem referenciar outros documentos existentes, desde que estejam disponíveis no repositório de documentação da TOTVS ou sejam enviados junto com o documento da integração em si. As informações mínimas necessárias para teste tópico são:

• Procedimentos que devem ser observados quando um dos produtos for atualizado.
• Configuração necessária que deve ser realizada em arquivos de configuração ou programas de parâmetros etc.
• Arquivos diversos que devem ser mantidos em determinados locais para o funcionamento da integração, exemplo: xml, xsd.
• Atualizações necessárias em banco de dados ou instruções para que elas sejam feitas.
• Processos, módulos ou programas que precisam ser instalados ou atualizados. Deve ser definida a versão mínima necessária dos programas envolvidos.
• Ferramentas, servidores ou serviços que precisam ser disponibilizados e configurados, o que pode gerar necessidade de novo hardware ou aumento de capacidade. Exemplo: serviço de WebService.
• Instruções para habilitar a comunicação da ferramenta EAI entre as partes, quais rotas devem ser definidas ou como as transações devem ser habilitadas.

Datasul

Insira aqui as informações pertinentes a Datasul.

Logix

Insira aqui as informações pertinentes ao Logix.

Protheus

Insira aqui as informações pertinentes ao Protheus.

RM

Insira aqui as informações pertinentes ao RM.

Controle de Versão

O grupo TOTVS, representado por suas marcas, irá 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

Apresente quais as transações/entidades que são trocadas e quem envia a informação para quem. Pode (e recomenda-se) ter um diagrama, uma tabela ou afins que apresente este fluxo.

Relacione quais são as mensagem únicas (TOTVSMessage) utilizadas e qual o seu relacionamento com as entidades já existentes do ERPs envolvidos.

Exemplos:

Fluxo das Informações

Para cada fluxo de informação descreva, se necessário, alterações de comportamento que o respectivo produto irá sofrer. Por exemplo: quando o Logix recebe o PEDIDO de OUTRO ERP, este pedido não poderá ser alterado no Logix.

Liste quais as entidades integradas e como é o mapeamento entre as diferentes estruturas. Por exemplo: Classe no sistema A vira categoria no sistema B, o campo X é refletido no campo Y etc.

Liste quais transações/operações a integração fará com as entidades relacionadas. Exemplo: Insert de PEDIDO, Insert, update de ITEM, buscar saldo em estoque do ITEM no dia X ou buscar dados do FUNCIONÁRIO.

Cadastros

Descreva características gerais do fluxo de informações e que serão comuns para este tipo de entidade. Características particulares para cada entidade deverão ser citadas em tópicos específicos de cada entidade.

Sempre que existir (a sugestão é sempre criar) e for agregador ao documento acrescentar aqui os diagramas/imagens ou até mesmo colocar tais diagramas diretamente na especificação dos processos

Em seguida faça uma descrição para cada um dos fluxos para cada entidade

<Transação/Entidade>

Identificador da Mensagem: <mensagem>

Versão: <versão>

Módulo <marca 1>: <BackOffice – Gestão xxxxxxx>

Módulo <marca 2>: <SIGAXXX>

Tipo de Envio: <Assíncrona/Síncrona>

Notas:

Observações sobre comportamento desta mensagem ou dos processos envolvidos nela/para ela

A seguir descrever as variações, particularidades da mensagem e processos (integração) de acordo com cada marca

Limitações/Restrições

Descreva limitações e restrições para a integração que está sendo descrita.

Processos

Descreva características gerais do fluxo de informações e que serão comuns para este tipo de entidade. Características particulares para cada entidade deverão ser citadas em tópicos específicos de cada entidade.

Sempre que existir (a sugestão é sempre criar) e for agregador ao documento acrescentar aqui os diagramas/imagens ou até mesmo colocar tais diagramas diretamente na especificação dos processos

Em seguida faça uma descrição para cada um dos fluxos para cada entidade

<Transação/Processo>

Tipo de Fluxo: Protheus -> RM

Mensagem: Request_1_000

Versão: 1.000

Descrição de todo o comportamento e funcionamento do processo. Breve contexto, origem, regras, integração (geração da mensagem, envio, recebimento no destino), o quê supostamente irá ocorrer no destino, retorno, impacto, consequências, o que foi afetado, como conferir, validar, etc o retorno.

Acrescentar um diagrama do processo.

A seguir descrever as variações, particularidades da mensagem e processos (desta integração) de acordo com cada marca

Notas:

Observações sobre comportamento desta mensagem ou dos processos envolvidos nela/para ela

Limitações/Restrições

Descreva limitações e restrições para a integração que está sendo descrita. 

Limitações / Restrições Gerais

Descreva limitações e restrições para cada fluxo descrito no tópico anterior. Exemplo:

• ERP1 envia ITEM cadastrado para o ERP2

ERP1 somente enviará o ITEM se este estiver em uma das famílias cadastradas no parâmetro FAMILIA_INTEGRACAO.

Se o tipo de valorização do estoque for FIFO.

• ERP2 envia PEDIDO cadastrado para o ERP1

O pedido recebido no ERP1 vindo do ERP2 estará bloqueado para alteração.

Como fazer (opcional)

Descreva os passos que viabilizem a integração.

Exemplo:

Os passos para viabilizar a integração são:

• No Logix ou no Protheus efetue o cadastro das seguintes informações: Clientes, fornecedores, transportadores, cidades, cotação de moeda e unidades de medida.
• No Logix cadastrar um novo depositante e efetuar toda a parametrização necessária para a operação de WMS.
• No Logix cadastrar um novo produto que seja controlado pelo WMS, para o depositante cadastrado anteriormente.
• No Logix efetuar um processo de recebimento para o produto cadastrado anteriormente, utilizando uma nota fiscal provisória (tipo “A”).
• No Protheus consultar a nota fiscal de recebimento que foi registrada no Logix, validando as informações recebidas.
• No Logix efetuar um processamento de regularização fiscal, efetuando a cobertura dos produtos recebidos anteriormente.
• No Protheus verificar se foi efetuado corretamente o relacionamento entre os dois documentos.
• No Logix efetuar um processo de expedição para o novo produto cadastrado, até o momento do envio da mensagem de integração de pedido de venda.
• No Protheus efetuar o faturamento do pedido de venda recebido.
• No Protheus verificar se a nota fiscal gerada contém todas as informações necessárias para o segmento de operador logístico (armazém geral).
• No Protheus efetuar a escrituração fiscal das notas fiscais, verificando se as regras da legislação deste segmento foram respeitadas.
• No Logix é possível consultar o número do pedido de venda gerado para as notas fiscais de retorno simbólico e conta/ordem no programa WMS6333 (Consulta de Documentos). Para os processos de faturamento de serviço o número do pedido está disponível no programa WMS6411 (Movimentos a Faturar).

Situações comuns (opcional)

Descreva situações problemáticas comuns que podem ocorrer durante o funcionamento da integração e como solucioná-los. Neste ponto também é importante dar instruções de como reconhecer e investigar problemas que podem vir a ocorrer durante a integração. Se houver, apresente tabelas de códigos e descrições de erros que a integração poderá apresentar.

Este tópico possivelmente será alimentado com as experiências durante o desenvolvimento da integração e poderá ser realimentado durante o uso da integração no cliente.

Exemplo 1:

Tratamento de erros de integração (Produto A)

Tratamento de erros de integração (Produto B)

Exemplo 2:

Quando uma mensagem é enviada do Logix para o Protheus, podem ocorrer situações em que o WebService não estará totalmente funcional. Nestes casos uma mensagem de erro genérica irá aparecer na tela:

Exemplo:

Erro ao enviar a mensagem de Cidade via Integração

Se o arquivo de log for analisado, poderemos ver a falha na comunicação com o sistema destino:

-------------------------------------------------------------------------------

WSCERR044 / Não foi possível POST : URL http://172.16.31.57:8011/ws/FWWSEAI.apw

ADVPL WSDL Client 1.080707 / tst on 20120315 08:49:51

-------------------------------------------------------------------------------

Para resolver este problema, verifique as configurações do sistema de destino, analisando o funcionamento do servidor utilizado para esta comunicação e a habilitação do endereço do WebService. 

Checklist de suporte da aplicação

Crie um check-list de verificação de alguns pontos importantes para o funcionamento e atendimento da integração.

Instalação/Configuração

Relacione itens de verificação para garantir que a integração está corretamente instalada e configurada. Isto não pode ser uma cópia do procedimento de instalação/configuração, mas verificações pontuais que podem remeter aos itens da instalação.

Checklist de Verificações:

Relacione itens de verificações para que o atendente possa:

• Identificar o funcionamento da integração;
• Identificar a ocorrências de problemas;
• Coletar evidências do mau funcionamento relatado pelo cliente;
• Realizar possíveis ajustes na integração quanto à configuração ou negócio.

Anexos