INTEGRAÇÃO TOTVS HCM X Fluig LMS

DESCONTINUADO

Contexto de negócio (Introdução)

O Módulo de Administração de Treinamento permite a realização de matrículas no LMS (Fluig) através de 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 do 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

 

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 treinamento, 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.

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).

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.

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 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.

Com o objetivo de padronizar as integrações com os produtos TOTVS, foi definida uma nova diretriz para os projetos de integração: A de que todos os produtos TOTVS devem trabalhar com uma mensagem XML única, 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 a 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 a 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

Ajuste dos usuários do TOTVS HCM (Ambientes sem Identity):

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á estar informado no cadastro de usuário
  • Não poderá haver outro usuário com o mesmo e-mail

1. Para realizar a conferência de usuários sem e-mail ou com e-mail que já existe para outro usuário seguir os seguintes passos:
   1. Emitir o relatório Usuário x Funcionário através do programa prghur/spp/lista_usuario_func_email.r. O programa gera um arquivo csv cujo diretório + nome deverão ser informados na tela. Neste relatório será demonstrada 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 informado. 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 o e-mail já existe para outro usuário. 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. Isso poderá ser realizado no processo de carga descrito no item Instalação/Atualização. Caso identifique que existem e-mails iguais para diferentes pessoas físicas, estes e-mails devem ser ajustados no programa bas_usuar_mestre, pasta Geral, campo E-mail Local. 
2. Para realizar a conferência de funcionários sem usuário, cuja pessoa física não possui e-mail ou possui e-mail já existente em outra pessoa física cujo funcionário irá integrar-se com LMS, seguir os seguintes passos:
   1. Emitir o relatório através do programa prghur/spp/lista_func_sem_usuar_email.r. Este programa gera um arquivo CSV (informado na tela) que conterá uma relação de funcionários que não possuem usuário, com suas respectivas pessoas físicas e situação de e-mail. 
   2. Os e-mails deverão ser ajustados através do programa FP1440 - Manutenção de Pessoa Física, pasta Endereço, campo E-mail Contato. 
      
      

Ajuste dos usuários do TOTVS HCM (Ambientes com Identity):

Quando o ambiente possui Identity o usuário não será mais integrado pelo EAI e sim pelo processo do Identity. Porém é necessário que sejam relacionados os funcionários aos usuários, e nestes, deve ser marcado que são Usuários LMS. Isso deverá ser realizado pelo processo de carga que está descrito no Item Instalação/Atualização.

1. Para realizar a conferência de funcionários sem usuário, cuja pessoa física não possui e-mail ou, possui e-mail duplicado seguir os seguintes passos:
   1. Emitir o relatório através do programa prghur/spp/lista_func_sem_usuar_email.p. Este programa gera um arquivo CSV (informado na tela) que conterá uma relação de funcionários que não possuem usuário, com suas respectivas pessoas físicas e situação de e-mail. 
   2. Os e-mails deverão ser ajustados através do programa FP1440 - Manutenção de Pessoa Física, pasta Endereço, campo E-mail Contato. 

Instalação/Atualização

Configuração do EAI TOTVS 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 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 habilitadas nos aplicativos 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 RPW EAI:

Para que as mensagens assíncronas originadas do LMS (Curso, Requisição de Matrícula e Score) sejam integradas com HCM é necessário parametrizar um servidor RPW específico para o EAI. Para realizar essa parametrização acessar o link http://tdn.totvs.com/x/2YdICw.

OBS: O agendamento poderá ser feito para ser executado de 1 em 1 minuto, até 5 em 5 minutos por exemplo. 

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.
    
    
    

Parametrização RPW para matricular funcionário através de Requisição de Matrícula:

Atualmente é possível matricular o usuário em treinamentos pelo HCM ou diretamente pelo Fluig. A matrícula em treinamento pelo HCM é realizada pelo AT0080 ou pelo AT0480 de forma coletiva.

Caso o cliente deseje realizar a matrícula de usuário pelo Fluig poderá realizar através da opção Matrícula Usuários. Este processo irá integrar uma Requisição de Matrícula com o HCM. E o HCM deverá enviar uma Matricula para o LMS de forma para que essa matrícula fique disponível no LMS. Para que esse processo seja de forma automática, necessário  parametrizar o programa AT0480 para executar via RPW com agendamento automático de 1 em 1 minuto, por exemplo. Segue passo a passo para configuração:

• Caso necessário criar um novo  servidor RPW através do programa btb012aa
• Realizar o agendamento do programa no cd8600
• Acessar o programa AT0480
  • Na tela de Parâmetros marcar que deseja matricular usuários
  • Na tela de Parâmetros marcar o campo Matrículas Pendentes
  • Na tela Impressão, selecionar Batch e realizar a parametrização do programa para executar via RPW.

OBS: O agendamento poderá ser feito para ser executado de 1 em 1 minuto, até 5 em 5 minutos por exemplo. 

Carga dos Cursos:

Para verificar como realizar a carga dos cursos para o HCM acessar a documentação em http://tdn.totvs.com/x/2YdICw

Carga dos Usuários (Ambientes que utilizem Identity):

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 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:

Carga dos Cursos:

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

Carga dos Usuários:

• 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
  • realizar o filtro 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:

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

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. 

• 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: 
  • Na pasta Digitação, informar os funcionários que se enquadram nessa situação
  • 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
• Para realizar a carga de funcionários que ainda não são usuários no HCM:
  • Na pasta Seleção realizar o filtro para buscar todas os funcionários que ainda não foram integrados ou informar os funcionários na pasta Digitação
  • Na pasta Parâmetros, no campo Tipo Execução selecionar a opção Criar 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: para 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.

Carga dos Usuários (Ambientes que utilizem Identity):

Quando o ambiente possui Identity, o usuário é atualizado pelo processo do Identity e já é automaticamente disponibilizado no Fluig. Porém é necessário ainda relacionar o funcionário ao usuário e identificar qual será o Usuário no LMS. Abaixo os processos que podem ser realizados para efetuar a atualização destas informações:

• 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 realizar o filtro 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 Marcar Usuário LMS
  • Executar o relatório.
• 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: 
  
  • Na pasta Digitação, informar os funcionários que se enquadram nessa situação.
  • Na pasta Parâmetros, no campo Tipo Execução selecionar a opção Listar Usuários.
  • Ainda na pasta Parâmetros, marcar que deseja Marcar Usuário LMS
  • Executar o relatório.
• Para realizar a carga de funcionários que ainda não são usuários no HCM:
  • Na pasta Seleção realizar o filtro para buscar todas os funcionários que ainda não foram integrados ou Informar os funcionários na pasta digitação
  • Na pasta Parâmetros, no campo Tipo Execução selecionar a opção Criar Usuários.
  • inda na pasta Parâmetros, marcar que deseja Marcar Usuário LMS.
  • Executar o relatório.

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 HCM e LMS 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

Fluxo das Informações

Usuário:

1. Criação de Usuários Colaboradores partindo de funcionários e integração com LMS a partir do FP9160:
   1. FP1440:
      1. Posicionar na pessoa física dos funcionários que serão criados usuários
      2. Atualizar o e-mail da pessoa física
   2. FP9160:
      1. Selecionar os funcinários através da tela de seleção ou pela digitação
      2. Na pasta parâmetros selecionar Criar Usuários
      3. Marcar o campo Integra Usuários com LMS
      4. Confirmar Execução
      5. No relatório serão demonstrados os usuários que foram criados no HCM e um relatórios da integração com LMS
2. Criação de Usuários e integração com LMS a partir do cadastro Usuário Produto: 
   1. bas_usuar_mestre:
      1. Informar código do usuário e demais informações que serão necessárias para o produto
      2. Informar o nome e email do usuário que serão informações que impactarão no LMS.
      3. Informar empresas e grupos usuário necessário para acesso ao produto Datasul
      4. Pressionar o botão complemento RH
      5. Informar o tipo de acesso do Usuário 
      6. Informar o funcionário relativo ao usuário
      7. Marcar o campo Usuário LMS
      8. Confirmar a inclusão
      9. Será demonstrada uma mensagem de Integração realizada com sucesso.
3. Integração de Usuário Existente no HCM com LMS:
   1. FP9160:
      1. Selecionar os funcinários através da tela de seleção ou pela digitação
      2. Na pasta parâmetros selecionar Listar Usuários
      3. Marcar o campo Integra Usuários com LMS
      4. Confirmar execução
      5. No relatório serão listados os usuários que estão sendo considerados e um relatórios da integração com LMS e a situação.
   2. bas_usuar_mestre:
      1. Posicionar usuário que deverá ser integrado
      2. Pressionar o botão Complemento RH
      3. Informar qual o tipo de acesso do Usuário
      4. Informar o funcionário caso não exista
      5. Marcar o Campo Usuário LMS
      6. Pressionar o botão OK para confirmar
4. Alteração do Nome de Usuário para integraçaõ com LMS:
   1. bas_usuar_mestre
      1. Posicionar usuário que deseja ser alterado o nome
      2. Alterar o registro do usuário informando o nome 
      3. Pressionar o botão Complemento RH
      4. Certificar-se de que o campo Usuário LMS está marcado
      5. Pressionar o botão OK 
5. Desabilitação de Usuários no LMS:
   1. FP9160:
      1. Selecionar os funcionários cujo usuário deverá ser desabilitado pela tela de seleção ou pela digitação
      2. Na pasta Parâmetros selecionar que deseja Desabilitar
      3. Marcar o campo Integra Usuário com LMS
      4. Confirmar execução
      5. Será impresso no relatórios os usuários que foram desabilitados no produto Datasul e um relatório de integração com LMS com a situação.
   2. bas_usuar_mestre:
      1. Posicionar no usuário que deseja desabilitar
      2. Alterar o registro do usuário informando a data de hoje no campo data de fim da validade do usuário.
      3. Confirmar o registro
      4. Pressionar o botão Complemento RH 
      5. Certificar-se de que o campo Usuário LMS está marcado
      6. Confirma a atualização
      7. Será demonstrada uma mensagem que foi atualizado com sucesso
         
         

Identificador da Mensagem: User

Versão: 4.004

Módulo HCM: Datasul

Módulo LMS: Fluig

Tipo de Envio: Síncrona

Curso:

Identificador da Mensagem: Enrollment

Versão: 3.000

Módulo HCM: Datasul

Módulo LMS: Fluig

Tipo de Envio: Assíncrona

Verificar a documentação em http://tdn.totvs.com/x/2YdICw

Matrícula:

1. Inclusão de Matrícula:
   1. AT0080:
      1. Posicionar no curso que deseja matricular o(s) funcionário(s).
      2. Pressionar o botão Incluir na Grid de Matrículas
      3. Informar o funcionário que deseja matricular
      4. Confirmar a matricula
      5. Será demonstrada uma mensagem que a integração ocorreu com sucesso.O funcionário deverá ser demonstrado como matriculado na Grid.
   2. AT0480:
      1. Selecionar os funcionários que deverão ser matriculados no curso pela tela de seleção ou informar na digitação os funcionários/cursos para criar matrículas
      2. Selecionar o tipo de execução como Matricular na tela de Parâmetros
      3. Informar o diretório que deseja que o arquivo csv seja gerado
      4. Confirmar a execução.
      5. O arquivo csv será gerado no diretório que foi informado na tela com a relação de funcionários que foram matrículados e a situação da integração
2. Desmatricular Funcionários:
   1. AT0080:
      1. Posicionar no curso que deseja desmatricular o(s) funcionário(s).
      2. Posicionar no funcionário que deseja desmatricular 
      3. Pressionar o botão Desmatricular na Grid de Matrículas
      4. Confirmar a desmatrícula do funcionário
      5. Será demonstrada uma mensagem que a integração ocorreu com sucesso. O funcionário deverá aparecer na Grid como desmatriculado.
   2. AT0480:
      1. Selecionar os funcionários que deverão ser matriculados no curso pela tela de seleção ou informar na digitação os funcionários/cursos para criar matrículas
      2. Selecionar o tipo de execução como Matricular na tela de Parâmetros
      3. Informar o diretório que deseja que o arquivo csv seja gerado
      4. Confirmar a execução.
      5. O arquivo csv será gerado no diretório que foi informado na tela com a relação de funcionários que foram matrículados e a situação da integração

Identificador da Mensagem: Enrollment

Versão: 3.000

Módulo HCM: Datasul

Módulo LMS: Fluig

Tipo de Envio: Síncrona

Requisição de Matricula:

Identificador da Mensagem: CatalogEnrollmentRequest

Versão: 1.000

Módulo HCM: Datasul

Módulo LMS: Fluig

Tipo de Envio: Assíncrona

Verificar a documentação em http://tdn.totvs.com/x/2YdICw

Resultado (Score):

Identificador da Mensagem: Score

Versão: 3.000

Módulo HCM: Datasul

Módulo LMS: Fluig

Tipo de Envio: Assíncrona

Verificar a documentação em http://tdn.totvs.com/x/2YdICw

Limitações / Restrições Gerais:

Ambiente sem utilização de Identity:

• • O usuário sempre deverá ser atualizado no Datasul através dos processos FP9160 ou bas_usuar_mestre e integrados com LMS, não é recomendada a inclusão de usuários pelo Fluig.
  • O usuário não poderá ser eliminado depois de ser integrado, apesar dos produtos permitirem. Será necessário realizar o processo de Desabilitação. 
  • Atentar para quando for desabilitar um usuário cuja a pessoa física possuir mais de um usuário e, esse usuário seja o Usuário LMS  pois ele ainda pode ser um usuário ativo em outra empresa por exemplo.

Ambiente com utilização de Identity:

• • Neste caso a integração de usuário não ocorrerá mais diretamente pelos programas FP9160 ou bas_usuar_mestre e sim pelo Identity. 
  • Será necessário executar o processo FP9160 para criar o usuário no Datasul e marcar o campo Usuário LMS que indica que esse usuário que será utilizado para a integração.
  • É necessário atualizar o usuário no bas_usuar_mestre para quando a mesma pessoa física for relacionada a mais de um usuário o campo Usuário LMS deverá ser marcado para identificar qual o usuário que poderá ser matriculado nos cursos RH.
    
    

Situações comuns (opcional)

FP9160: Abaixo os erros e ação a serem realizados para cada situação

bas_usuar_mestre - botão Complemento RH: Abaixo os erros e ação a serem realizados para cada situação

AT0080: Abaixo os erros e ação a serem realizados para cada situação:

Integração de Requisição de Matrícula: os erros descritos abaixo estão descritos nas mensagens recebidas (businesserror) pelo HCM do LMS (monitor EAI Datasul):

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:

Anexos