Pré-requisitos

Não se aplica.

Descrição do processo

Tela para que o usuário defina todos parâmetros necessários para efetuar a integração com o CTM-LMS. 

Detalhamento do processo

No menu TOTVS Educacional | Educacional | Customização | Integração LMS | Parâmetros, o usuário administrador consegue efetuar as parametrizações referentes ao processo de integração. As abas do CTM-LMS foram disponibilizadas no menu já existente da customização da Integração LMS Padrão. 

Os parâmetros são:

• Dados de Conexão - Web Service CTM

DR Ofertante

Escala de Notas: escala de notas utilizada pela DR Ofertante.

DR Central

Deverá ser inserido nessa parametrização um ou mais DR Centrais que serão utilizados pela DR Ofertante.

Escala de Notas: Escala de notas que o DR Central utiliza.

Nome: Nome do DR Central que está sendo cadastrado.

Domínio: Código do domínio do DR Central.

Endereço do WebService: Endereço de acesso ao WebService disponibilizado pelo DR Central.

Token: Token de acesso ao WebService disponibilizado pelo DR Central.

Senha: Senha de acesso ao WebService disponibilizado pelo DR Central.

Os dados parametrizados acima são referentes ao meu regional. Sou um DR Central: A opção deverá ser marcada se o preenchimento for realizado com os próprios dados. (Será possível cadastrar somente um DR Central utilizando essa opção). 

• Status de Matrícula - Matrícula

Será utilizada a mesma interface do LMS Padrão, os status de matricula cadastrados serão entendidos como Matriculado no CTM-LMS.

• Status de Matrícula - Inativar Matrícula LMS

Será utilizada a mesma interface do LMS Padrão, os status de matricula cadastrados serão entendidos como Inativo no CTM-LMS.

Pré-requisitos

Não se aplica.

Descrição do processo

Tela para que o usuário defina se a Matriz Curricular utilizará a CTM.

Detalhamento do processo

No menu TOTVS Educacional | Educacional | Currículo e Oferta | Matriz Curricular | Aba Campos Complementares, o usuário deverá informar através da caixa de seleção, se a Matriz Curricular utiliza a Central de Tutoria e Monitoria.

Obs.: Os campos complementares deverão ser habilitados em: TOTVS Educacional | Educacional | Configurações | Níveis de Ensino.

Os dados de matriz curricular são enviados ao CTM-LMS no momento do cadastro da Turma/Disciplina para o domínio CTM do DR Central preenchidos nos campos complementares CTM da Turma.

Os dados que serão enviados ao CTM-LMS:

Pré-requisitos

Inclusão de DR Central nos Parâmetros da Integração.

Descrição do processo

Preenchimento de campos complementares para que o usuário informe a inclusão ou não da Turma no CTM.

Detalhamento do processo

No menu TOTVS Educacional | Educacional | Currículo e Oferta | Turmas | Aba Campos Complementares, o usuário deverá informar dois campos complementares indicando se a turma será exportada para a Central de Tutoria e Monitoria.

Obs.: Os campos complementares deverão ser habilitados em: TOTVS Educacional | Educacional | Configurações | Níveis de Ensino.

CTM: Campo para informar se a Turma será do Tipo DR Central ou DR Ofertante. 

- DR Central: A turma será exportada para o domínio CTM, para que assim seja possível vincular os alunos/matrículas de diversos DRs Ofertantes a ela no CTM. Só será possível cadastrar turmas/disciplinas dos tipos Semipresencial ou a Distância.

- DR Ofertante: A turma não será exportada para o domínio CTM, sendo assim as turmas deverão ser associadas aos grupos da CTM do LMS.

Nome do DR Central: Nome do DR Central correspondente a turma que esta sendo cadastrada. O campo busca os DR Centrais cadastrados na parametrização da Integração.

Observação: Para os regionais que utilizam a parametrização "Tipo de Mediação" somente serão permitidos os tipos semipresencial e a distância.

Pré-requisitos

Inclusão de parâmetros CTM e Nome do DR Central no cadastro de Turmas.

Descrição do processo

Este processo envia Turmas/Disciplinas para o CTM.

Detalhamento do processo

O envio é feito no momento do cadastro da Turma/Disciplina caso os campos complementares CTM da Turma e Matriz Curricular estejam preenchidos.

Quando forem criadas ou alteradas as turmas/disciplinas de uma turma com o campo complementar CTM indicado como DR Central, a customização realizará a exportação dos dados para o domínio CTM-LMS indicado no campo complementar Nome do DR Central da Turma.

Quando o campo complementar for definido como DR Ofertante no cadastro da Turma ou não estiver preenchido, a estrutura do curso não será importada para o CTM-LMS.

Quando o campo CTM da Turma estiver definido como DR Central, a customização permitirá a criação de Turma/Disciplina apenas dos tipos Semipresencial e a Distância.

Pré-requisitos

Não se Aplica.

Descrição do processo

Este processo realiza o envio de docentes para o CTM-LMS.

Detalhamento do processo

O envio dos docentes para o DR Central informado é realizado no momento da associação do docente com a Turma/Disciplina. A exportação envia somente os docentes informados nas turmas/disciplinas em que a Turma tenha sido cadastrada como DR Central.

São enviados e vinculados nas turmas no LMS apenas os docentes com o campo tipo de professor preenchido com Tutor ou Titular. Os demais tipos são enviados como "Assistente"e não são vinculados as turmas.

Ao realizar alterações no cadastro dos professores as informações são atualizadas no CTM-LMS.

Pré-requisitos

Necessário ter Turma/Disciplina criada.

Descrição do processo

Processo de vínculo de Turma/Disciplina com uma disciplina disponibilizada no CTM-LMS por um DR Central.

Detalhamento do processo

Para realizar o vínculo, deverá ser executado o processo que está em TOTVS Educacional | Educacional | Currículo e Oferta | Turmas/disciplinas | Processos | Vincular Turma/Disciplina a CTM, selecionando a Turma/Disciplina que deseja vincular..

Os campos listados são retornados de acordo com os dados disponibilizados na CTM-LMS do DR Central. 

Deverá ser informado os seguintes parâmetros:

Curso LMS: Curso ofertados no pelo DR Central informado nas parametrizações.

Módulo LMS: Grupos associados ao Curso selecionado no Curso LMS.

Turma LMS: Grupos associados ao Módulo selecionado no Módulo LMS.

Disciplina (Grupo) LMS: Grupos associados a Turma selecionada na Turma LMS.

Os dados do vínculo quando executado com sucesso serão guardados em uma tabela para posterior visualização.

Pré-requisitos

Necessário ter realizado vínculo da Turma/Disciplina com o Grupo (Disciplina) no CTM-LMS.

Descrição do processo

Processo para desvincular uma Turma/Disciplina do TOTVS Educacional de um Grupo (Disciplina) no CTM-LMS.

Detalhamento do processo

Para realizar o desvínculo, deverá ser executado o processo que está em TOTVS Educacional | Educacional | Currículo e Oferta | Turmas/disciplinas | Processos | Vincular Turma/Disciplina a CTM, selecionando a Turma/Disciplina que deseja desvincular.

Esse processo só poderá ser realizado pelo DR Ofertante, com intuito de desvincular uma disciplina do TOTVS Educacional à uma disciplina (Grupo) no CTM-LMS.

Para realizar a execução, a customização verifica se existem alunos matriculados na turma/disciplina do TOTVS Educacional que esteja vinculada à uma disciplina (Grupo) no CTM-LMS.

Caso não tenha, o registro de vínculo da turma é alterado para Inativo.

Caso tenha alunos matriculados, o usuário deverá alterar manualmente no TOTVS Educacional a situação de matrícula dos alunos para um status que esteja parametrizado como Inativo nos parâmetros do LMS padrão. Caso o status da matrícula dos alunos não seja alterado para um dos status equivalentes a inativo, o processo retornará a mensagem: O processo não será executado, existem alunos matriculados.

Os dados do desvínculo quando executado com sucesso serão guardados em uma tabela para posterior visualização.

Pré-requisitos

Não se aplica.

Descrição do processo

Tela para visualização de vínculos e desvínculos.

Detalhamento do processo

No Menu TOTVS Educacional | Educacional | Currículo e Oferta | Turmas/disciplinas | Anexos | Grupo CTM, é possível visualizar os vínculos e desvínculos de Turma/Disciplina ao Grupo (Disciplina) no CTM-LMS. 

A visualização só é habilitada para as Turmas/Disciplinas que estiverem com os campos complementares do CTM (Campos CTM e DR Central) preenchidos.

Nesta interface fica registrado todo o histórico de vinculação e desvinculação das turmas/disciplinas do TOTVS Educacional à um Grupo (Disciplina) no CTM-LMS.

Não é possível incluir, excluir ou alterar os dados manualmente nesta interface, todos os registros são apenas para visualização.

Pré-requisitos

Não se aplica.

Descrição do processo

Processo para realizar exportação de alunos e matrículas do TOTVS Educacional para a CTM-LMS.

Detalhamento do processo

Para realizar a exportação dos dados, deverá ser executado o processo que está em TOTVS Educacional | Educacional | Currículo e Oferta | Turmas | Processos | Exportação Matrícula/Aluno - CTM.

A exportação será de uso exclusivo das turmas que são utilizadas no CTM, sendo assim só estará habilitada para os registros que utilizam a CTM.

Tanto o DR Ofertante quanto o DR Central poderão realizar a exportação de Matrícula/Aluno para o CTM-LMS. Porém, diferentemente de um DR Ofertante, uma turma do tipo DR Central não necessitará executar antes o processo de "Vincular Turma/Disciplina a CTM".

Para execução do processo, o aluno deve estar matriculado em pelo menos uma turma/disciplina do SGE que esteja vinculada a um Grupo (Disciplina) no CTM-LMS. Será considerado para matrícula, o aluno que esteja com a situação que indique matrícula conforme parametrização do CTM.

Para identificação de qual DR Ofertante o aluno pertence e evitar RA's repetidos no domínio do DR Central, o processo customizado irá concatenar as informações de UF do regional ofertante no envio do RA do aluno para o CTM-LMS.

Exemplo:

Aluno: João Silva 

RA: 00007898 

UF da Filial: MG               

O RA será enviado para o LMS-CTM da seguinte forma: MG00007898 (UF+RA)

Ao realizar a alteração de situação de matrícula do aluno em alguma disciplina vinculada a CTM-LMS para algum status que seja equivalente a Inativo na CTM, a customização realizará o desvínculo do aluno/matrícula.

No momento da matrícula caso o usuário de um DR Ofertante realize a matrícula de um aluno em turma CTM e nesta turma não tiver nenhuma turma/disciplina do TOTVS Educacional vinculado a uma disciplina (Grupo) do CTM-LMS será exibido a seguinte mensagem: A turma selecionada não possui nenhuma turma/disciplina vinculada ao CTM e não será possível realizar o processo de Exportação Matrícula/aluno-CTM. Para execução do processo customizado será necessário que a turma/disciplina do TOTVS Educacional esteja vinculada a uma disciplina (Grupo) no LMS-CTM.

Caso um aluno tenha seu registro alterado no cadastro de alunos, será verificado no momento de salvar o registro se o mesmo está vinculado a uma matrícula em uma turma/disciplina a distância ou semipresencial que esteja associado a uma disciplina (Grupo) no LMS-CTM. Caso tenha matrículas distintas em mais de um domínio da CTM-LMS, a customização irá atualizar o cadastro em todos os domínios em que haja matrícula.

Pré-requisitos

Campo complementar ETAPALMSCTM informado.

Descrição do processo

Processo para realizar a importação de notas e avaliações do CTM-LMS para o TOTVS Educacional.

Detalhamento do processo

O processo realizará a importação das avaliações, notas das avaliações e notas das etapas do CTM-LMS, para isso, o campo complementar Etapa LMS-CTM da Turma/Disciplina deverá ser informado para que seja identificada a etapa que receberá as avaliações e notas do CTM-LMS.

O campo complementar será criado através do script disponibilizado no pacote de instalação, porém será necessário algumas conferências para que o campo complementar seja exibido na base de dados e esteja pronto para preenchimento:

 1- Acessar o TOTVS Educacional SGE → clique em configurações → Campos complementares → Turma/Disciplina e conferir se o campo complementar ETAPALMSCTM está ativo na base de dados. Caso esteja vermelho (desativado), será necessário abrir o registro e clicar em Ativar.

2 - Verificar se as etapas estão cadastradas nos anexos da turma/disciplina. TOTVS Educacional → Turmas/Disciplinas → Anexo → Etapas.

3 - Conferir se o campo complementar está habilitado para a filial. Acesse TOTVS Educacional SGE → clique em configurações→  Níveis de ensino → edite o nível de ensino correspondente →  acesse a aba de campos complementares disponíveis →  turma/disciplina → habilite o campo complementar e salve a edição.

No momento da importação, a customização realizará a conversão das notas para a escala de notas utilizada pelo DR Ofertante da seguinte maneira:

- DR Central e DR Ofertante utilizam a mesma escala de notas: A customização não realizará nenhuma conversão nas notas.

- DR Central utiliza escala de notas de 0 a 100 e DR ofertante utiliza escala de notas de 0 a 10: A customização realizará a conversão nas notas dividindo o valor total da nota no CTM-LMS por 10.

- DR Central utiliza escala de notas de 0 a 10 e DR ofertante utiliza escala de notas de 0 a 100: A customização realizará a conversão nas notas multiplicando o valor total da nota no CTM-LMS por 10.

Pré-requisitos

Não se aplica.

Descrição do processo

Criação do menu TOTVS Educacional | Customização | Monitor de Log – CTM. Neste processo o usuário consegue consultar o LOG das operações de importação e exportação executadas pela integração CTM-LMS e também o processo de reenvio dos registros.

Detalhamento do processo

Na tela "Monitor de Log – CTM" é possível efetuar apenas a consulta das informações, não sendo possível editar os dados. Os campos abaixo são exibidos na visão:

O usuário consegue efetuar o reenvio dos registros com status “E”, selecionando os registros com erro e acessando Processos | Reenvio de Registros. Ao executar o processo a rotina customizada consome o WS de acordo com o processo do registro. A identificação do registro a ser enviado é de acordo com o campo Chave e o tipo de processo é identificado através do campo Processo. Quando um registro é reenviado, o campo REPROCESSADO é alterado para “True” e é criado um novo registro detalhando o reenvio. Somente podem ser reenviados registros com o campo REPROCESSADO igual a “False”.

Ao analisar o monitor de log, é importante verificar a mensagem de erro para identificar a causa. Aguns erros, causas e soluções estão listadas abaixo:

ERRO: User with external id: 'XXXXXXXXX' was not found
O erro indica que o aluno não consta no CTM/LMS, verifique se no log existe a exportação do aluno com sucesso, pode ter ocorrido erro na exportação do mesmo e assim, consequentemente seu registro de matrícula não será exportado com sucesso.

ERRO: Group object with external id: 'Dxxxxxxx' was not found
Verifique se a Turma/Disciplina foi vinculada e se ela foi exportada para o CTM com sucesso. Se ela foi exportada com sucesso no anexo "Grupo CTM" da turma será possível ver o external_id.

ERRO: Group object with external id: 'Mxxxxxxx' was not found
Verifique se a Matrix Matriz aplicada foi exportada. É importante verificar se a matriz aplicada possui data final preenchida.

ERRO: (Basic) Authentication failed "O servidor remoto retornou um erro: (401) Não Autorizado."

O erro indica url incorreta e/ou usuário incorreto/sem permissão ou ainda  senha incorreta. É necessário verificar estas informações no parâmetros.