Pré-requisitos

Somente são exportadas matrículas vinculadas a turmas/disciplinas a distância ou semi-presencial.

Somente são exportados para o LMS matrícula de alunos nos status parametrizados no campo Código Status da Matrícula (em parâmetros da customização → Status de Matrícula - Matrícula).

Descrição do processo

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

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

Detalhamento do processo

O processo customizado é acionado ao executar o processo de Matrícula do Aluno na Disciplina , através do menu Currículo e Oferta | Alunos | Anexos | Matrícula no Período Letivo | Processos | Matricular Alunos nas Disciplinas. Além do processo descrito acima, também é realizado a integração de matrículas de alunos no LMS por meio dos processos:

• 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

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

Pré-requisitos

Somente são exportados para o LMS alteração de matrícula de alunos nos status parametrizados no campo Status de Matrícula-Alteração de Matrícula.

Pré-requisitos

Configurar web-service, conforme Roteiro para Configuração do WebService.

Descrição do processo

O Web Service utiliza o protocolo/tecnologia SOAP, em que é 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 web service recebe como parâmetro um arquivo XML, onde este conterá as informações de alunos e a notas a serem processados,e efetua 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 é 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 são do processo nativo de inclusão de notas na etapa.

O processo customizado recebe o arquivo XML e envia as informações do arquivo para o serviço nativo de inclusão de notas, que realiza 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.

A nota é sempre importada para a etapa final (SETAPAS.ETAPAFINAL='S') das etapas de notas da turma/disciplina enviada no arquivo e SNOTAETAPA.TIPOETAPA = 'N'.

Estrutura do arquivo XML:

<INCLUIRNOTAETAPA>

    <SNOTAETAPA>

        <CODCOLIGADA></CODCOLIGADA> 

        <IDTURMADISC></IDTURMADISC>

        <NOTAFALTA></NOTAFALTA>

        <RA></RA>

    </SNOTAETAPA>

</INCLUIRNOTAETAPA>

Exemplo de XML preenchido:

<INCLUIRNOTAETAPA>

    <SNOTAETAPA>

        <CODCOLIGADA>1</CODCOLIGADA> 

        <IDTURMADISC>D1724</IDTURMADISC>

        <NOTAFALTA>10</NOTAFALTA>

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

    </SNOTAETAPA>

</INCLUIRNOTAETAPA>

Tipos de dados:

Pré-requisitos

Configurar web-service, conforme Roteiro para Configuração do WebService.

Descrição do processo

O Web Service utiliza o protocolo/tecnologia SOAP, em que é 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 web service recebe como parâmetro um arquivo XML que deve conter as informações de notas de avaliações a serem processados e, neste caso, efetuará os tratamentos necessários para realizar a operação solicitada (inclusão/alteração) no TOTVS Educacional.

Detalhamento do processo

O método tem a seguinte estrutura:

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

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

No exemplo abaixo segue a estrutura dos dados que devem ser enviados no arquivo XML:

O campo TIPOETAPA da tabela SNOTAS é preenchido sempre com 'N'.

O campo CODETAPA da tabela SNOTAS é preenchido de acordo com o código da etapa de notas do LMS, que é identificado através do campo complementar de turmas/disciplinas ETAPALMS. É verificado através do código da turma/disciplina enviada no arquivo, qual o código da etapa informada no campo complementar ETAPALMS.

Estrutura do arquivo XML:

<INCLUIRNOTAAVALIACAO>

    <SNOTAS>

         <CODCOLIGADA></CODCOLIGADA>

        <IDTURMADISC></IDTURMADISC>

        <NOTA></NOTA>

        <CODPROVA></CODPROVA>

        <RA></RA>

    </SNOTAS>

</INCLUIRNOTAAVALIACAO>

Exemplo de XML Preenchido:

<INCLUIRNOTAAVALIACAO>

    <SNOTAS>

         <CODCOLIGADA>1</CODCOLIGADA>

        <IDTURMADISC>D1724</IDTURMADISC>

        <NOTA>5</NOTA>

        <CODPROVA>2</CODPROVA>

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

    </SNOTAS>

</INCLUIRNOTAAVALIACAO>

Pré-requisitos

Configurar web-service, conforme Roteiro para Configuração do WebService.

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 web service 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

Configurar web-service, conforme Roteiro para Configuração do WebService.

Descrição do processo

O método customizado, no Web Service TOTVS, recebe um arquivo XML com as  informações de avaliações e executa 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 web service recebe como parâmetro um arquivo XML, onde este conterá as informações de avaliações a serem incluídas, e neste caso, efetua os tratamentos necessários para realizar a operação solicitada (inclusão) no TOTVS Educacional.

O método tem a seguinte estrutura:

Detalhamento do processo

Ao consumir este método, o arquivo XML é 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 são do processo nativo de inclusão de avaliações.

O processo customizado recebe o arquivo XML e envia as informações do arquivo para o serviço nativo de inclusão de avaliações, que realiza 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 é 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

Somente são exportados para o LMS a alteração de turma com status destino parametrizados no campo Status de Matrícula-Matrícula.

Descrição do processo

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

Detalhamento do processo

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

O aluno é excluído da turma origem através do método DetachUserToGroup e é 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, é 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, é executado somente a inclusão na turma (AttachUserToGroup). 

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

Informações enviadas:

Pré-requisitos

Não se aplica.

Descrição do processo

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

Detalhamento do processo

Na tela "Monitor de Log – TOTVS Educacional com LMS" é 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”.