Páginas filhas
  • Entidades Acadêmicas x Cadastro Pessoas ( Protheus )

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Sistemas Envolvidos

  • TOTVS Educacional – Módulo Educacional que gerencia escolas e faculdades (ensino básico e superior), por meio de ferramentas que permitem maior agilidade nos processos que envolvem os alunos, responsáveis, professores e os funcionários. 
  • BackOffice Protheus (Pessoas)

...

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

    • TOTVS (Educacional, Processo Seletivo, Biblioteca, Financeiro) -> PROTHEUS: Os dados são trafegados pelo fluxo normal até a fila de integração TBC, em que este irá consumir o WebService do EAI do Protheus para envio da(s) mensagem(s). Após a resposta do Protheus, o TOTVS Conector atualiza o registro, com o status de processamento e demais dados, no monitor da fila de Mensagem Única. 
    • PROTHEUS -> TOTVS (Educacional, Processo Seletivo, Biblioteca, Financeiro): O Protheus consume o WebService TOTVS Conector para recebimento de mensagens únicas. Sendo também responsável por encaminhar as mensagens para o TOTVS Conector, que processa  e encaminha o retorno de acordo com o tipo de comunicação definida (síncrona ou assíncrona).

Para mais informações sobre o fluxo dos dados internos ao TBC, vide documentação:

...

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 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. 
    • Assíncrona: O sistema de origem gera uma mensagem de integração na 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 de destino

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

 

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


Atenção: Para instalar qualquer módulo da linha RM, é necessário instalar da Biblioteca RM o pacote que contém a maioria dos arquivos necessários para o funcionamento de todos os módulos, inclusive do TBC.

(Mais detalhes no anexo: COMO FAZER - TBC - Instalar BibliotecaRM.pdf.

 

Para que a integração possa funcionar, deve-se verificar se a tag DefaultDB, que informa o Alias que será utilizado para acesso a base de dados, existe no arquivo de configuração do Host (RM.Host.Service.exe.config ou RM.Host.exe.config): 

<add key=”DefaultDB” value=”<ALIAS_DO_BANCO_RM>


em que a variável <ALIAS_DO_BANCO_RM> será o nome do alias cadastrado para acesso ao banco de dados.

Exemplo:

 

Image Added

 

 

Importante

Para o funcionamento da integração, somente um servidor (Host), deve estar configurado para ler a fila de mensagens únicas. Esse requisito deve ser atendido para que as mensagens do tipo assíncronas possam ser processadas em sequência

 

 

Para verificar se o webservice está funcionando, abra o endereço abaixo no navegador:

                               Endereço: http://localhost:8051/wspageindex/

 

 

Image Added

 

 

 

A porta 8051 é padrão no sistema e caso seja alterada na tag HttpPort no arquivo de configuração do Host, precisa ser alterada no link acima.

Caso o serviço do Host (RM.Host.Service.exe ou RM.Host.exe) não esteja rodando e/ou a porta não esteja correta, a mensagem abaixo poderá ser exibida:

 

Image Added

 

Liberação de acesso a porta do Host Service

 

Se o Host utilizado for o RM.Host.Service.exe será necessário a execução do comando, abaixo, para liberação da porta configurada na tag “HttpPort”, via prompt de comando: 

  • Adicionar

netsh http add urlacl url=http://+:8051/ user=NetworkService 

  • Apagar

netsh http delete urlacl url=http://+:8051/ 

  • Exibir

netsh http show urlacl

 Caso contrário, a mesma página de erro, acima, será exibida.

                                                                                                        

Uma segunda opção, como alternativa, de configuração, para utilização do EAI é o conjunto de ferramentas denominada TBC – TOTVS Business Connect, que possui esse mesmo webservice em seu instalador e necessita de uma configuração no IIS do Windows.

 

 

Entidades Acadêmicas x Cadastro Pessoas ( Protheus )

Se a integração estiver ativa, todo aluno cadastrado no Educacional deverá ter o seu correspondente no cadastro de pessoas do Protheus.
Ao alterar ou excluir um cadastro do aluno, as alterações devem ser refletidas no seu cadastro no Protheus.
Ao realizar uma exclusão de um aluno será verificado se a pessoa do aluno está vinculada a alguma outra entidade no Educacional, como pesquisador ou participante das bancas de TCC e/ou estágio e para esses casos a mensagem de exclusão de pessoa não será enviada. A mensagem de exclusão de pessoa será enviada para o Protheus, somente quando a pessoa da entidade educacional não estiver vinculada a nenhuma outra.

 

Configurando Integração entidades Acadêmicas x Cadastro Pessoas 

Image Added


Módulo Integração

 

Image Added

 

Ferramentas | Configurar 

 

Image Added

 

Validar conexão com Banco de Dados

 

Image Added

 

Selecionar a Integração ( Entidades Acadêmicas x Cadastro pessoas ( Protheus )

 

Image Added

 

Configurar a Integração 

Inserir a URL do Protheus ( WebService )

Ativar a integração 

Autenticação 

 

Image Added

 

Parâmetros da Integração

Mais detalhes para configuração de CLASSIFICAPAIS

 

Image Added

 

Mapeamento de Entidade ( com o Adpter e a versão do mesmo )

 

...

  • PROCESSO DE CARGA INICIAL 

 

Image Added

 

Totvs Educacional | Integrações | Protheus | Processo para geração de Carga Inicial de entidades acadêmicas

 

Image Added

 

Ferramentas | Configurar 

 

Image Added

 

Testar conexão com banco de dados

 

Image Added

 

Selecionar: Entidades Acadêmicas x Cadastro Pessoa ( Protheus )

 

Image Added

 

Inserir EAI do Protheus em URL WebService

 

Image Added

 

 

Parâmetros da Integração ( Configurar o código = CLASSIFICAPAIS )

Detalhes sobre esta configuração em : http://tdn.totvs.com/display/INT/DI_MANUAL_TOTVS_Educacional_BackOffice_Protheus

 

Image Added

 

 

Adpters ( PEOPLE ) criado para esta funcionalidade de Pessoas.  

Selecionar as mensagens e Processar.

 

 

  • CADASTRO DE PESSOA 



    ( ALUNOS )

Image Added

 

Currículo e Oferta | Aluno e Professor | Alunos

*Se a integração estiver ativa, todo Aluno cadastrado no TOTVS  Educacional irá ter  o seu correspondente no cadastro de pessoas do Protheus.

 

 

 

         ( CADASTRO DE PESQUISADOR )


Image Added

Atividades acadêmicas | Inovação , Pesquisa e Extensão | Cadastros | Pesquisador / Extensionista

Como funcionário do setor de viagens da instituição de ensino, preciso selecionar o participante Pesquisador para registrar a sua viagem.
*Se a integração estiver ativa, todo pesquisador cadastrado no TOTVS Educacional
 Deverá ter o seu correspondente no cadastro de pessoas do Protheus.
- Ao alterar ou excluir um cadastro do pesquisador, as alterações serão refletidas em seu
cadastro do Protheus.
Obs: Extensionistas não poderão ser integrados.

 

 

      ( CADASTRO DE PARTICIPANTES DA BANCA DE ESTÁGIO )


Image Added


Atividades acadêmicas | Estágio | Termo de compromisso

 

Image Added

 

Anexos | Banca de estágio

 

 

Image Added

 

Anexos | Participantes da banca

 

Image Added

 

Participantes podem ser:

  • Professor da instituição
  • Funcionário da empresa
  • Pessoa

 

 

Como funcionário do setor de viagens da instituição de ensino, preciso selecionar o participante da banca de estágio para registrar a sua viagem.
* Se a integração estiver ativa, todo participante cadastrado no Educacional terá
 o seu correspondente no cadastro de pessoas do Protheus.
- Ao alterar ou excluir um cadastro do participante, as alterações serão refletidas
no seu cadastro no Protheus.

 

         ( CADASTRO DE PARTICIPANTE DA BANCA TCC )


Image Added

Atividades acadêmicas | Trabalho de conclusão de curso ( TCC ) | TCC 

 

Image Added

 

Anexos | Banca do TCC

 

Image Added

 

Anexos | Participantes da banca

 

Image Added

 

Participantes podem ser:

  • Professor da instituição
  • Pessoa externa

 

Como funcionário do setor de viagens da instituição de ensino, é preciso selecionar
 o participante da banca de TCC para registrar a sua viagem.

* Se a integração estiver ativa, todo participante cadastrado no TOTVS Educacional
Deverá ter o seu correspondente no cadastro de pessoas do Protheus.
-  Ao alterar ou excluir um cadastro do participante, as alterações serão refletidas no seu cadastro no Protheus.

 

 

 

Após efetuados os cadastros , é preciso processar as mensagens para que os cadastros sejam enviados para o ( Protheus ).

 

Image Added

 

Módulo Integração |  Integração | RM Conector | Mensagem Única | Fila de mensagens únicas 

 

Image Added

 

Selecionar as mensagens ( PEOPLE ) processar fila