Manual Operacional da Customização - TOTVS Educacional x LMS - SENAI

Pré-Requisitos / Parametrizações

Não se aplica.

• Descrição do Processo

Esta tela permitirá o cadastro dos parâmetros necessários para efetuar a integração com o sistema LMS

• Detalhamento do Processo

  
  

 No TOTVS Educacional, por meio do menu “Parâmetros”, o usuário administrador efetuará as parametrizações referentes ao processo.

Deverão ser parametrizados as seguintes informações:

• Dados Gerais
  
  

• Status de Matrícula - Matrícula: Situações de matrícula que serão utilizadas para informar quais alunos serão enviados para o LMS.
  Para os processos de alteração de matrícula pelo menos uma situação de matrícula deverá estar parametrizada. A figura abaixo é ilustrativa e as situações de matrícula devem ser consultadas no manual de Processos disponibilizado pela equipe do projeto.

• Status de Matrícula - Inativar Matrícula LMS: Situações de matrícula que serão utilizadas para informar quais Alunos serão retirados do LMS. Para os processos de alteração de Matrícula pelo menos uma situação de matrícula deverá estar parametrizada. A figura abaixo é ilustrativa e as situações de matrícula devem ser consultadas no manual de Processos disponibilizado pela equipe do projeto.

• Modalidade: Parâmetro que será utilizado para informar quais modalidades de cursos serão enviados para o LMS. A figura abaixo é ilustrativa e o regional deve parametrizar as modalidades que serão integradas com o LMS.

• Pré-Requisitos / Parametrizações

Para cadastro do Grupo Pai LMS será necessário criar uma tabela dinâmica, como a da imagem abaixo:

Para os itens da tabela dinâmica você deverá informar de acordo com o que foi cadastrado no LMS sendo o código do grupo no LMS o código do item no SGE.

• Descrição do Processo

Esta tela permitirá o cadastro do Grupo Pai LMS da matriz aplicada. Esse valor será usado para identificar a qual grupo Pai LMS essa matriz aplicada pertence no sistema LMS. Essa cadastro não é obrigatório caso o regional não utilize o conceito de Grupo Pai LMS.

• Detalhamento do Processo

Ao acessar a matriz aplicada, em anexo você terá a opção de informar qual o Grupo Pai LMS para essa matriz aplicada.

• Pré-Requisitos / Parametrizações

Somente serão enviados ao LMS professores vinculados a uma Turma/Disciplina a distância ou semi-presencial (STURMADISC.TIPO =’S’ ou ‘D’).

• Descrição do Processo

O processo customizado envia as informações de professores com o sistema LMS da Time do Know.

• Detalhamento do Processo

O processo customizado será acionado quando um usuário vincular um professor a uma turma/disciplina, em Turmas/Disciplinas/Anexos/Professores.

Após ser exportado o professor irá acessar o sistema LMS com o seu login sendo o seu CPF é a senha “123456”. Essa e temporária e deve ser alterada após primeiro acesso do professor.

Serão enviada as seguintes informações referente ao professor:

Serão enviada as seguintes informações referente ao vínculo do Professor à Turma/Disciplina:

A partir da versão 2.0 (Janeiro/2019), a customização foi alterada para enviar as seguintes informações:

• Pré-Requisitos / Parametrizações

Somente serão exportados alunos que esta matriculados em turmas/disciplinas à distância ou semi presencial (STURMADISC.TIPO =’S’ ou ‘D’).

• Descrição do Processo

Este processo vai enviar as informações do Aluno para o Sistema LMS via WebService.              

• Detalhamento do Processo

No momento que for efetuado a matricula de um aluno em uma turma que for a distancia ou semi-presencial, será enviado o aluno para o LMS.

Após ser exportado o aluno irá acessar o sistema LMS com o seu login sendo o e-mail é a senha sendo seu CPF. Essa e temporária e deve ser alterada após primeiro acesso do aluno.

No cadastro do Aluno, caso este esteja matriculado em alguma turma/disciplina a distancia ou semi-presencial e seja alterado alguma informação do cadastro, este será enviado para atualização no LMS.

Serão enviada as seguintes informações:           

• Pré-Requisitos / Parametrizações

Somente serão exportadas matrículas vinculados a turmas/disciplinas a distância ou semi-  presencial.(STURMADISC.TIPO = ‘D’ ou ‘S’).

Somente serão exportados para o LMS matrícula de alunos nos status parametrizados na tabela  ZMATSTATUS, no campo Status de Matrícula-Matrícula, conforme Req.01.(ZMATSTATUS.CODSTATUS = SMATRICULA.CODSTATUS).

• Descrição do Processo

Através do processo customizado será enviado matrícula do aluno em uma disciplina com o sistema LMS da Time to Know.  O processo customizado será acionado quando um usuário executar o processo “Matricular Aluno nas   Disciplinas”, disponível em Matrícula e Avaliação /Matrícula.

Quando o usuário executar o processo de matrícula do aluno  e o registro for gravado com sucesso  o TOTVS Educacional irá consumir o WS disponibilizado pela Time to Know, que estará  parametrizado na tela de parâmetros da customização (Req. 01).Se a matrícula do aluno na disciplina não for finalizada no TOTVS Educacional, este não será integrado com o LMS.

• Detalhamento do Processo

 O processo customizado será acionado ao executar o processo de Matrícula do Aluno na Disciplina  através do caminho Alunos->Anexos->Matrícula no Período Letivo->Processos-> Matricular Alunos nas    Disciplinas.Além do processo descrito acima os seguintes processos será realizado a integração de matrículas de alunos no LMS:

• Alterar situação de matrícula

Alunos->Anexos->Matrículas no Período Letivo->Processos-> Alterar Situação de Matrícula

Matrículas-> Processos->Matricular Aluno nas Disciplinas->-Processos-> Alterar situação de matrícula no período  letivo

Matrícula e Avaliação->Matrículas->-Processos-> Alterar Situação de Matrícula

Matrícula e Avaliação->Matrículas->Anexos ->Matrícula em Disciplinas->Processos ->Alterar Situação de Matrícula 

• Matrícula no período letivo

Aluno -> Anexos -> Matrícula no Período Letivo -> Processos->Alterar Situação de Matrícula

• Enturmação

Matrícula e Avaliação -> Enturmação

• Confirmação de matrícula por pagamento

Matrícula e Avaliação -> Matrícula -> Confirmação de Matrícula por Pagamento

• Matrícula Isolada

 Matrícula e Avaliação -> Matrícula Isolada

Aluno->Anexos->Matrícula Isolada 

• Matrícula de Disciplinas em Lote

 Matrícula e Avaliação -> Mais - > Matrícula de Disciplinas em Lote 

• Rematrícula

 Matrícula e Avaliação -> Rematrícula

Serão enviada as seguintes informações para vincular o Aluno a turma/disciplina:

• Pré-Requisitos / Parametrizações

Somente serão exportados para o LMS alteração de matrícula de alunos nos status parametrizados na tabela ZSTATUSALTMAT,no campo Status de Matrícula-Alteração de Matrícula, conforme Req.01.ZSTATUSALTMAT.CODSTATUS = SMATRICULA.CODSTATUS).

• Pré-Requisitos / Parametrizações

É importante que no LMS haja uma diferenciação entre as Avaliações que devem ou não ser exportadas para o TOTVS EDUCACIONAL. Ou seja, apenas as Etapas que possuem Avaliações de acordo com o Rendimento Escolar do DR terão Avaliações enviadas do LMS para o TOTVS EDUCACIONAL. Para haver esta diferenciação é necessário que as Avaliações que devem ser enviadas possuam o prefixo A#E#, onde ‘#’ é o código da Avaliação e da Etapa respectivamente. Avaliações que não devem ser enviadas para o TOTVS EDUCACIONAL (Nota direto na Etapa) devem possuir o prefixo E#, no qual # é o código da Etapa.

• Descrição do Processo

O Web Service utiliza o protocolo/tecnologia SOAP, onde é necessário autenticação e possibilita a transferência de mensagens em formato XML para uso em  ambientes distribuídos e que atende a diversas plataformas com mensagens personalizadas.

O método disponibilizado no webservice receberá como parâmetro um arquivo XML, onde este conterá as informações de alunos e a notas a serem processados,e efetuará os tratamentos necessários para realizar a operação solicitada (inclusão/alteração) no TOTVS Educacional.

• Detalhamento do Processo

O processo de inclusão de notas etapas possui a seguinte a assinatura:

Ao consumir este método, o arquivo XML será processado, incluindo ou alterando as notas dos alunos na etapa através do processo nativo do TOTVS Educacional, de acordo com as informações passadas no XML. Todas as validações serão do processo nativo de inclusão de notas na etapa.

O processo customizado irá receber o arquivo XML e enviar as informações do arquivo para o serviço nativo de inclusão de notas, que realizará a inclusão ou alteração da nota do aluno.Caso não exista lançamento de nota para o aluno na etapa, será considerado uma inclusão, ou se já existir nota lançada esta será substituída pelo valor informado no arquivo XML.

O campo CODPROVA determinará se a nota será gravada na Etapa ou na Avaliação dependendo da estrutura do código enviado.

Caso o código possua a estrutura E + Código da Etapa, a nota será gravada na Etapa (SNOTAETAPA). Se o código for A + Código da Prova + E + Código da Etapa, a nota será gravada na Avaliação (SNOTAS).

No exemplo abaixo segue a estrutura do arquivo XML que deverá ser enviado no caso de uma Nota de Etapa:

<INCLUIRNOTAAVALIACAO>

<SNOTAS>

<CODCOLIGADA>3</CODCOLIGADA>

<IDTURMADISC>D29205</IDTURMADISC>

<NOTA>78</NOTA>

<CODPROVA>E1</CODPROVA>

<RA>99144488</RA>

</SNOTAS>

</INCLUIRNOTAAVALIACAO>

No exemplo abaixo segue a estrutura do arquivo XML que deverá ser enviado no caso de uma Nota de Avaliação:

<INCLUIRNOTAAVALIACAO>

<SNOTAS>

<CODCOLIGADA>3</CODCOLIGADA>

<IDTURMADISC>D29205</IDTURMADISC>

<NOTA>78</NOTA>

<CODPROVA>A1E1</CODPROVA>

<RA>99144488</RA>

</SNOTAS>

</INCLUIRNOTAAVALIACAO>

Tipos de dados:

• Pré-Requisitos / Parametrizações

Configurar web-service, conforme requisito item 1.8.

• Descrição do Processo

O método customizado, no WebService TOTVS,  receberá um arquivo XML com informações de faltas na etapa e executará a inclusão de frequência (faltas) para os alunos no TOTVS Educacional.

O Web Service utiliza o protocolo/tecnologia SOAP, onde é necessário autenticação e possibilita a transferência de mensagens em formato XML para uso em  ambientes distribuídos e que atende a diversas plataformas com mensagens personalizadas.

• Detalhamento do Processo

O método disponibilizado no webservice receberá como parâmetro um arquivo XML, onde este conterá as informações de alunos e faltas a serem processados,e neste caso, efetuará os tratamentos necessários para realizar a operação solicitada (inclusão/alteração) no TOTVS Educacional.

Assinatura e estrutura do serviço:

Ao consumir este método, o arquivo XML será processado,incluindo ou alterando as faltas dos alunos na etapa através do processo nativo do TOTVS Educacional, de acordo com as informações passadas no XML. Todas as validações serão do processo nativo de inclusão de faltas na etapa.

Na tabela abaixo estão os dados que devem ser enviados no arquivo XML:

No exemplo abaixo segue a estrutura do arquivo XML que deverá ser enviado:

<INCLUIRFREQUENCIAETAPA>

     <SNOTAETAPA>

   <CODCOLIGADA></CODCOLIGADA>

   <IDTURMADISC></IDTURMADISC>

   <NOTAFALTA></NOTAFALTA>

   <RA></RA>

</SNOTAETAPA>

</INCLUIRFREQUENCIAETAPA>

Exemplo XML preenchido:

<INCLUIRFREQUENCIAETAPA>

   <SNOTAETAPA>

          <CODCOLIGADA>1</CODCOLIGADA>

          <IDTURMADISC>D1724</IDTURMADISC>

          <NOTAFALTA>10</NOTAFALTA>

          <RA>M-PROF-1</RA>

   </SNOTAETAPA>

</INCLUIRFREQUENCIAETAPA>

• Pré-Requisitos / Parametrizações

Configurar web-service, conforme item 1.8.

• Descrição do Processo

O método customizado, no WebService TOTVS, receberá um arquivo XML com  as  informações de avaliações e executará a inclusão das avaliações em turmas/disciplinas no TOTVS Educacional.

O Web Service utiliza o protocolo/tecnologia SOAP, onde é necessário autenticação e  possibilita a transferência de mensagens em formato XML para uso em  ambientes distribuídos e que atende a diversas plataformas com mensagens personalizadas.

• Detalhamento do Processo

O método disponibilizado no webservice receberá como parâmetro um arquivo XML, onde este conterá as   informações de avaliações a serem incluídas,e neste caso, efetuará os tratamentos necessários para realizar a operação solicitada (inclusão) no TOTVS Educacional.

                O método terá a seguinte estrutura:

Ao consumir este método, o arquivo XML será processado, incluindo a avaliação em uma turma/disciplina, através do processo nativo do TOTVS Educacional, de acordo com as informações passadas no XML. Todas as validações serão do processo nativo de inclusão de avaliações.

O processo customizado irá receber o arquivo XML e enviar as informações do arquivo para o serviço nativo de inclusão de avaliações, que realizará a inclusão da avaliação na turma/disciplina.

Na tabela abaixo estão os dados que devem ser enviados no arquivo XML:

O campo TIPOETAPA da tabela SPROVAS será preenchido sempre com ‘N’.     

                No exemplo abaixo segue a estrutura do arquivo XML que deverá ser enviado:

       <INCLUIRAVALIACAO>

     <SPROVAS>

   <CODCOLIGADA></CODCOLIGADA>

   <IDTURMADISC></IDTURMADISC>

   <DESCRICAO></DESCRICAO>

   <CODPROVA></CODPROVA>

   <VALOR></VALOR>

   <DTPREVISTA></DTPREVISTA>

   <MEDIA></MEDIA>

</SPROVAS>

   </INCLUIRAVALIACAO>

Exemplo XML preenchido:

       <INCLUIRAVALIACAO>

       <SPROVAS>

          CODCOLIGADA>1</CODCOLIGADA>

          <IDTURMADISC>D1724</IDTURMADISC>

          <DESCRICAO>TESTE 123</DESCRICAO>

          <CODPROVA>3</CODPROVA>

          <VALOR>3</VALOR>

          <DTPREVISTA>21/09/2015</DTPREVISTA>

          <MEDIA>12</MEDIA>

        </SPROVAS>

</INCLUIRAVALIACAO>             

• Pré-Requisitos / Parametrizações

Somente serão exportados para o LMS a alteração de turma com status destino parametrizados na tabela ZMATSTATUS, no campo Status de Matrícula-Matrícula, conforme Req.01.

• Descrição do Processo

O processo customizado vai integrar o processo de alteração de turma dos alunos do TOTVS Educacional com o sistema LMS da Time do Know.

O processo customizado será acionado quando um usuário executar o processo nativo “Mudar Turma”, disponível em Matrícula/Processos/Mudar Turma.

• Detalhamento do Processo

O aluno será excluído da turma origem através do método DetachUserToGroup será incluído na nova turma  através do processo AttachUserToGroup.

Caso turma/disciplina origem seja do tipo a distância ou semi-presencial, e a turma destino não, será executado somente  a exclusão do aluno da turma (DetachUserToGroup). 

Caso a turma/disciplina origem não seja do tipo a distância ou semi-presencial, e a turma destino sim, será executado somente a inclusão na turma (AttachUserToGroup).               

Se tanto origem quanto destino forem do tipo a distância ou semi-presencial serão executados a exclusão da turma de origem e a inclusão a turma de destino.

Informações que serão enviadas:

• Pré-Requisitos / Parametrizações

Processo disponível a partir da versão 2.0 (Janeiro/2019). Pode ser utilizado para Turmas/Disciplinas já integradas com o LMS.

• Descrição do Processo

Este processo irá atualizar no LMS o vínculo dos Alunos das Turmas/Disciplinas selecionadas via WebService.              

• Detalhamento do Processo

O objetivo desse processo é apresentar uma contingência para integração de alunos entre o SGE e LMS, permitindo que os alunos sejam vinculados ou desvinculados a qualquer momento, de acordo com as regras já existentes. Ele se faz necessário em situações como a de uma turma/disciplina cadastrada como presencial que já possui alunos matriculados e, em algum momento, a turma/disciplina é modificada para semipresencial ou à distância. O processo está disponível em TOTVS Educacional | Currículo e Oferta | Turmas/Disciplinas | Processos, menu “Vincular/Desvincular Alunos com LMS”.

O usuário deverá selecionar as Turmas/Disciplinas desejadas e executar o processo. A customização irá utilizar as regras já existentes de situação de matrícula para definir se o aluno será vinculado ou desvinculado da Turma no LMS.

• Pré-Requisitos / Parametrizações

Esse processo não possui pré-requisitos.

• Descrição do Processo

No menu customização do TOTVS Educacional esta disponível o processo “Monitor de Log – TOTVS Educacional com LMS”, neste processo o usuário poderá consultar o LOG das operação de importação e exportação executadas pela integração e executar o reenvio dos registros do tipo exportação.

• Detalhamento do Processo

Este cadastro será possível efetuar apenas a consulta das informações, não sendo possível editar os dados.

Os seguintes campos serão exibidos na visão “Monitor de Log – TOTVS Educacional com LMS”:

Esta visão será apenas de “leitura”, não possibilitando ao usuário fazer qualquer tipo de manutenção nos registros, ou seja, inclusão, edição e exclusão.

Nesta visão o usuário poderá efetuar o reenvio dos registros com status “E”. Para isto deverá selecionar os registros com erro  e acessar Processos -> Reenvio de Registros. Ao executar o processo a rotina customizada irá consumir o WS de acordo com o processo do registro. A identificação do registro a ser enviado será de acordo com o campo Chave, e o tipo de processo será  identificado através com o campo Processo.

Quando um registro for reenviado, o campo REPROCESSADO da tabela ZLOGLMS será alterado para “True” e será gerado outro registro detalhando o reenvio. Somente poderão ser reenviados registros com o campo REPROCESSADO igual a “False”.