WEBENSINO003 - Integração TOTVS Educacional RM Classis x Webensino x AMS

Criar um ambiente único, portátil e independente, possibilitando a demonstração das funcionalidades do TOTVS Educacional (em ambiente Windows), bem como do Webensino (ambiente Linux), tanto separados quanto de forma integrada.

Entidades de Integração

As seguintes entidades e processos estão desenhados para integração:

Aluno: será integrada a entidade Aluno do TOTVS Educacional com a entidade Aluno do Webensino, sendo que terá uma entidade chamada Aluno E-Learning no Webensino que será utilizada para os alunos externos matriculados em cursos livres.

Professor: será integrada a entidade Aluno do TOTVS Educacional com a entidade Aluno do Webensino.

Categoria: será integrada a entidade Categoria do Webensino com a entidade Curso do TOTVS Educacional.

Curso: será integrada a entidade Curso do Webensino com a entidade Disciplina do TOTVS Educacional.

Turma: será integrada a entidade Turma do Webensino com a entidade Turmas da Disciplina do TOTVS Educacional.

Matrícula: a matrícula em uma disciplina E-Learning no TOTVS Educacional será replicada no Webensino. A matrícula chamada Matrícula Isolada seguirá o mesmo princípio da matrícula Normal do TOTVS Educacional. Será também permitido que a matrícula, em cursos livres e conteúdos E-Learning, seja realizada no Webensino e esta será replicada no TOTVS Educacional.

Percentual de Completude: o Webensino enviará para o TOTVS Educacional o Percentual de Completude do aluno no curso.

Boletos: as regras para boletos serão todas definidas no TOTVS Educacional. Pelo WebServices, será possível consultar do Webensino informações dentro do Financeiro do RM. Será possível gerar também os boletos dos cursos livres pelo Webensino consultando o Financeiro do RM.

Autenticação: o RM disponibiliza WebService que permitirá a validação de usuários e suas senhas. Será síncrono.

Avaliação: serão integradas as avaliações do AMS para o RM e para o Webensino.

Escore (Nota): o AMS enviará para o TOTVS Educacional as notas de cada avaliação, ao final da avaliação.

Montando um Ambiente Integrado

Webensino e AMS:

Para execução do ambiente Webensino de forma portátil, foi criada uma máquina virtual (VM), com o ambiente LINUX homologado.

Pré-requisitos:

VMWare Player (versão utilizada: 3.1.0).

Copiar o arquivo da máquina virtual (5Gb).

Firefox ou Internet Explorer para os devidos testes.

 Exemplo:

01 - Ao iniciar a VM selecionar a opção "I copied it" e acionar o botão OK. Isso acontecerá toda vez que a VM for movida de pasta, mas apenas uma vez. Depois disso, não acontecerá de novo até que seja movida ou copiada para outro local.

02 - Na tela seguinte ao Bem Vindo ao KUDZU, acionar uma tecla para configurar a rede da VM.

03 - No passo seguinte, selecionar a opção Remover a Configuração da Rede Antiga e, assim, é possível configurar uma nova rede. Para isso, basta pressionar a tecla Enter.

04 - Em seguida, configurar o novo dispositivo que vai habilitar a rede e, portanto o acesso ao Webensino e ao AMS. Para isso, basta pressionar a tecla Enter novamente.

05 - Na tela seguinte, selecionar a opção Utilizar Configuração do IP Dinâmico (BOOTP/DHCP), acionando a barra de espaço. Depois, acionar a tecla direcional para baixo (↓) para selecionar a opção OK, e pressionar a tecla Enter.

06 - A Máquina Virtual continuará carregando e, por fim, apresentará os endereços dos produtos, Webensino, AMS e EPM. (Guardar estes endereços).

O usuário e senha padrão para acesso ao sistema Webensino é "dec" e para o AMS é "admin".

07 - Para ativar ou desativar a integração do Webensino com o RM Classis, os seguintes passos devem ser executados:

Acessar a VM pela linha de comando.

Após a tela de apresentação, onde são apresentados os endereços de IP para acesso aos sistemas, pressionar a tecla Enter para acessar a tela de login.

Quando solicitadas as informações de login, insira as informações abaixo:

webensino login: root

Password: webensino

Depois disso, acessar o MySQL utilizando o comando abaixo:

mysql -uroot ead_demo

Em seguida, deve-se estar acessando o banco de dados. Pode-se confirmar a informação observando que a linha onde se digita comandos está desta maneira:

mysql>

Assim, para ativar a integração com o RM Classis, digitar o seguinte comando:

UPDATE PersonalizacaoArray SET dsValor = 'true' WHERE dsChave = 'integradoRM';

E, para desativar, digitar o seguinte comando:

UPDATE PersonalizacaoArray SET dsValor = 'false' WHERE dsChave = 'integradoRM';

Instalação do TOTVS ESB

Requisitos:

TOTVS ESB (versão: 5.1.124, obtido em suporte.totvs.com/download));

Mapas de configuração XML “totvsesb-config-EDUCACIONALxWE”;

Firefox ou Internet Explorer para os devidos testes;

Banco de dados Mysql, Sql Server ou Oracle.

Após descompactar o arquivo, ler o arquivo de ajuda ao instalador, antes de iniciar o processo de instalação.

Criar uma base de dados no banco escolhido.

Executar a instalação conforme descrito na documentação.

Depois de instalado, copiar as informações do arquivo de mapas de configuração para a mesma estrutura de diretórios do ByYou ESB (c:\ByYou\ESB\).

Isso deve criar os mapas de integração que devem ser aberto com o ESB Editor.

Exemplo:

01 - Editar as configurações (Config/Edit Properties), informando principalmente as configurações do License Server (ambiente de demonstração).

02 - Edite o WebService WSSenderToWebEnsino (em RMReceiver), informando o caminho do WebService do Webensino. Exemplo  da WSDL URL (referente ao ambiente de testes, podendo não ser idêntico):

http://192.168.95.128/sistema/webensino/webservice.php?wsdl

Executar um teste pelo botão List Operations.

03 - Editar o WebService WSSender RM informando o caminho do WebService do RM um exemplo da WSDL URL (referente ao ambiente de testes, podendo não ser idêntico):

http://localhost/TOTVSBusinessConnect/wsTOTVSMessage.asmx?wsdl

Executar um teste pelo botão List Operations.

04 - Acionar o TOTVS ESB pelo arquivo: c:\ByYou\ESB\bin\Startup_Esb.bat. Isso abrirá um console para acompanhar a integração. Em clientes, este processo será executado como serviço do Windows.

05 - Realizar um teste no ESB, executar no navegador:

http://localhost:8181/ws/integrator/wsdl11/literal/rpc?wsdl

06 - É possível monitorar as transações do ESB pelo monitor.

Obs.: o Windows/Firewall pode bloquear as portas necessárias, cabendo ao administrador permitir a utilização das portas pelo ESB.

Ativação da Integração no TOTVS Educacional

Requisitos:

RM (versão: 11.40, obtido em suporte.totvs.com/download));

Firefox ou Internet Explorer para os devidos testes.

O processo de instalação do RM deve seguir o manual presente em:

http://helpwiki.totvs.com.br/WikiHelp/Ajuda%20Instalador/AIN.Principal.aspx 

É premissa deste processo que o RM esteja instalado e configurado.

Exemplo:

01 - Testando o WebService do lado RM.

Digitar no navegador:

http://localhost/TOTVSBusinessConnect/wsTOTVSMessage.asmx?wsdl

O retorno indica que o WebService está no ativo.

02 - Primeiro, executar a configuração no caminho Integração/Ferramentas/Configurar. 

03 - Na próxima tela, selecionar a opção avançar para iniciar.

04 - Informar os dados de acesso ao Banco de Dados. 

05 - Selecionar o Projeto de Integração TOTVS Educacional x Webensino x AMS.

06 - Executar na tela seguinte, este processo preparará as entidades acima descritas para a integração.

07 - Acessar (Integração/Ferramentas/Parâmetros), selecionar Configurações Gerais BYYOU ESB,  parametrizar os dados solicitados.

08 - Acessar (Integração/Ferramentas/Parâmetros), selecionar TOTVS Educacional Webensino e AMS, preencher os dados conforme endereços dos WebServices.


Recomendações e Dicas

Para os casos de professores e alunos, a integração exige que possuma CPF, usuário e e-mail cadastrado.

No Webensino devem ser inicializados como obrigatórios os campos "Estado", "Naturalidade" e "Cidade Natal" do cadastro de usuário.

O servidor de licenças deve considerar a quantidade de processadores da máquina utilizada.

Depois de gerado um boleto no RM, ele somente irá para a lista de boletos do Webensino após ser gerado o lançamento.

Uma operação de alteração somente terá efeito após uma de inclusão.

Até ter segurança da operação, utilizar o ESB no modo console, para monitoramento das inconsistências e transações.

Liberar as portas necessárias no Windows, caso contrário, o ESB não funcionará.

Em caso de divergências neste processo, por gentileza, abrir um chamado no suporte enviando as seguintes informações:

- documento detalhando o processo efetuado, com prints de tela, caso seja necessário.