Histórico da Página

...

Nome do Cliente: Confederação Nacional da Indústria 

...

Objetivo

Prezados Senhores, 

O documento a seguir tem por objetivo orientar o usuário sobre as implementações realizadas para sua empresa. Todas as funcionalidades descritas neste manual têm como base do que está descrito nos documentos:

• Especificação - Detalhamento Funcional - FS008015 (918970 - 982021)
• Análise de impacto I -  FS008015 (918970 - 982021) Processo para Criação de Áreas de Interesse - PS

Esse manual tem a função de detalhar, de forma operacional, como ocorrerá o processo seletivo customizado.

...

Image Removed

• 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.

Image Removed

• 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.

Image Removed

• 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.

Image Removed

O usuário deverá acessar o menu “Totvs Processo Seletivo | Customização | Processo Seletivo | Parâmetros” para configurar as informações sobre o funcionamento da customização.

• Detalhamento do Processo

Dias para cancelamento de pré-matrícula: Neste parâmetro deverá ser informado a quantidade de dias a serem consideradas para cancelamento de matrículas não efetivadas. Serão considerados os candidatos que estiverem com situação de pré-matrícula e que a data de inscrição/matrícula seja anterior a X dias a contar da data atual.

Image Added

Motivo de alteração de matrícula para cancelado: Informe o motivo que será gravado no registro de alteração de situação de matrícula para os casos de cancelamento de matrícula.

Image Added

Situação de matrícula cancelado: Informe a situação de matrícula que indicará cancelamento.

Image Added

Situação de matrícula de pré-matriculado: Informe as situações de matrícula que indicam pré-matrícula pelo processo seletivo. 

Image Added

• Pré-Requisitos / Parametrizações

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

Image Removed

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.

Image Removed

• Pré-Requisitos / Parametrizações

Esse processo não possui pré-requisitos.

• Descrição do Processo

Esta tela permitirá o cadastro do Domínio LMS da modalidade do curso. Esse valor será usado para identificar a qual domínio a modalidade será cadastrada no sistema LMS.

• Detalhamento do Processo

                Ao acessar a modalidade do curso, em anexo você terá a opção de informar qual o Domínio LMS para essa modalidade.

Image Removed

• Pré-Requisitos / Parametrizações

Esse processo não possui pré-requisitos.

• Descrição do Processo

Este processo envia as informações do Curso para o Sistema LMS via WebService.

• Detalhamento do Processo

No cadastro da Turma

Para envio do curso será necessário informa o domínio LMS a qual esse curso pertence. Para isso, será necessário informa, no anexo “Domínio LMS” do cadastro de modalidade do curso, qual é domínio LMS da modalidade, dessa forma o curso pertence ao domínio informado na sua modalidade.

E no momento da alteração das informações do curso, caso este tenha vínculo com alguma Turma/disciplina do tipo À Distância ou Semi-Presencial, as informações serão enviadas para atualização.

Serão enviada as seguintes informações:

Campo LMS (Details)

Campo de Origem TOTVS

Descrição do campo de origem do TOTVS

Formato TOTVS

codcoligada

SHABILITACAOFILIAL.CODCOLIGADA

Código da Coligada

Smallint

External_id

‘C’ + SHABILITACAOFILIAL.IDHABILITACAOFILIAL

ID da Habilitação – Será concatenado a letra C para identificar que é um curso

Varchar

name

SHABILITACAOFILIAL.CODCURSO + ‘-‘

SCURSO.NOME

Nome do Curso

Varchar(60)

classification

SMODALIDADECURSO.DESCRICAO

Modalidade do Curso

Varchar(60)

Type

Fixo ‘Course’

Fixo ‘Course’

Fixo ‘Course’

Image Removed

Image Removed

Image Removed

• Pré-Requisitos / Parametrizações

Somente serão exportadas turmas/disciplinas à distância ou semi-presencial.

• Descrição do Processo

Este processo envia as informações da Turma e Turma/Disciplina para o Sistema LMS via WebService.

• Detalhamento do Processo

Será feito o envio das informações da Turma e Turma Disciplina, e será feito o vinculo, da Disciplina -> Turma e da Turma ao Curso, no momento do envio.

Image Removed

Serão enviadas as seguintes informações da Turma:

Campo LMS (Details) – UpdateGroup - Turma

Campo de Origem TOTVS

Descrição do campo de origem do TOTVS

Formato TOTVS

 Name

STURMA.CODTURMA + ‘-’ STURMA.NOME

Nome da Turma

Varchar(60)

external_id

‘T’ + STURMA.IDFT

ID da turma- Será concatenado a letra ‘T’ para indicar que é uma turma

String

 open_date

STURMA.DTINICIAL

Data inicial

Datetime

 close_date

STURMA.DTFINAL

Data final

Datetime

Type

Fixo ‘Course’

Fixo ‘Course’

Fixo ‘Course’

• Turma/Disciplina:

Campo LMS (Details) – UpdateGroup – Turma/Disciplina

Campo de Origem TOTVS

Descrição do campo de origem do TOTVS

Formato TOTVS

 Name

STURMADISC.CODDISC + ‘-‘

SDISCIPLINA.NOME + ‘-‘ SGRADE.CODHABILITACAO

Nome do Curso

String

external_id

‘D’ + STURMADISC.IDTURMADISC

ID da turma/disciplina – Será concatenado a letra ‘D’ para indicar que é uma Disciplina

String

codtemplate

SDISCGRADECOMPL.CODTEMPLATE

Código do Template do LMS

Varchar(20)

open_date

STURMADISC.DTINICIAL

Data inicial

Datetime

close_date

STURMADISC.DTFINAL

Data final

Datetime

Type

Fixo ‘Course’

Fixo ‘Course’

Fixo ‘Course’

• Vínculo da Turma ao Curso:

Campo LMS (Details) –

AttachSubGroup – Turma para Curso

Campo de Origem TOTVS

Descrição do campo de origem do TOTVS

Formato TOTVS

 string ext_group_id

‘T’ + STURMA.IDFT

Id da Turma

String

string ext_parent_id

‘C’ +SHABILITACAOFILIAL.IDHABILITACAOFILIAL

ID do Curso

String

• Vínculo da Disciplina à Turma:

Campo LMS (Details) –

AttachSubGroup –  Disciplina para Turma

Campo de Origem TOTVS

Descrição do campo de origem do TOTVS

Formato TOTVS

 string ext_group_id

‘D’ +STURMADISC.IDTURMADISC

ID da Turma/Disciplina

String

string ext_parent_id

‘T’ +STURMA.IDFT

ID da Turma

String

• 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.

Image Removed

Image Removed

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

Campo LMS (Details) - UpdateUser

Campo de Origem TOTVS

Descrição do campo de origem do TOTVS

Formato TOTVS

 codcoligada

SPROFESSOR.CODCOLIGADA

Coligada

Smallint

 firstname

PPESSOA.NOME

Nome do Professor

Varchar(140)

 lastname

PPESSOA.NOME

Sobrenome do Professor

Varchar(140)

 email

PPESSOA.EMAIL

E-mail do Professor

Varchar(60)

 External_id

SPROFESSOR.CODPROF

ID do Professor

Varchar(10)

 gender

PPESSOA.SEXO

Gênero do Professor

Varchar(1)

 username

PPESSOA.CPF

CPF do Professor

Varchar(11)

 address

PPESSOA.RUA

Endereço do Professor

Varchar(140)

 city

PPESSOA.CIDADE

Cidade do Professor

Varchar(32)

 state

PPPESSOA.ESTADO

Estado do Professor

Varchar(2)

 country

PPESSOA.PAIS

País do Professor

Varchar(60)

 birthday

PPESSOA.DTNASCIMENTO

Data de Nascimento

Datetime(8)

 bphone

PPESSOA.TELEFONE1

Telefone Fixo

Varchar(15)

 mphone

PPESSOA.TELEFONE2

Telefone Celular

Varchar(15)

 id

PPESSOA.CARTIDENTIDADE

RG do Professor

Varchar(15)

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

Campo LMS (Details) - AttachManager

Campo de Origem TOTVS

Descrição do campo de origem do TOTVS

Formato TOTVS

ext_user_id

SPROFESSOR.CODPROF

Código do Professor

Varchar(10)

ext_group_id

‘D’ + STURMADISC.IDTURMADISC

ID da turma

String

manager_type

SPROFESSORTURMA.TIPOPROF

SPROFESSORTURMA.TIPOPROF=NULL

Então Professor

SPROFESSORTURMA.TIPOPROF= ASSISTENTE

Se não

SPROFESSORTURMA.TIPOPROF

Varchar(1)

codcoligada

SPROFESSOR.CODCOLIGADA

Código da Coligada

Smallint

set_primary

Fixo ‘0’

Fixo ‘0’

Fixo ‘0’

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

Campo LMS (Details) - AttachManager

Campo de Origem TOTVS

Descrição do campo de origem do TOTVS

Formato TOTVS

manager_type

SPROFESSORTURMA.TIPOPROF

Se o SPROFESSORTURMA.TIPOPROF = U-Tutor ou T-Titular, envia fixo 'TUTOR'.

Para demais tipos, permanece inalterado.

Varchar(1)

set_primary

SPROFESSORTURMA.TIPOPROF

Se o SPROFESSORTURMA.TIPOPROF = U-Tutor, envia fixo '1'

Se o SPROFESSORTURMA.TIPOPROF = T-Titular, envia fixo '0'

Integer

• 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.

Image Removed

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.

Image Removed

Serão enviada as seguintes informações:           

Campo LMS (Details)

Campo de Origem TOTVS

Descrição do campo de origem do TOTVS

Formato TOTVS

codcoligada

SMATRICULA.CODCOLIGADA

Código da Coligada

Smallint

 firstname

PPESSOA.NOME

Nome do Aluno.

PPESSOA.NOME menos a última sequência de caracteres após o último espaço.

Varchar(120)

 lastname

PPESSOA.NOME

PPESSOA.NOME

Última sequência de catacteres após o último espaço.

Varchar(120)

 email

PPESSOA.EMAIL

E-mail do Aluno

Varchar(60)

 External_id

SMATRICULA.RA

ID do Aluno

Varchar(20)

 gender

PPESSOA.SEXO

Gênero do Aluno  -‘M’ ou ‘F’

Varchar(1)

username

PPESSOA.EMAIL

PPESSOA.EMAIL

Varchar(60)

 address

Serão concatenados os campos:
PPESSOA.RUA,

PPESSOA.NUMERO,

PPESSOA.COMPLEMENTO,

PPESSOA.BAIRRO

Endereço do Aluno

Varchar(288)

 city

PPESSOA.CIDADE

Cidade do Aluno

Varchar(32)

 state

PPPESSOA.ESTADO

Estado do Aluno

Varchar(2)

 country

PPESSOA.PAIS

País do Aluno

Varchar(60)

 birthday

PPESSOA.DTNASCIMENTO

Data de Nascimento

Datetime(8)

 bphone

PPESSOA.TELEFONE1

Telefone Fixo

Varchar(15)

 mphone

PPESSOA.TELEFONE2

Telefone Celular

Varchar(15)

Password

PPESSOA.CPF

Somente os números

Varchar(11)

 id

PPESSOA.CARTIDENTIDADE

RG do Aluno

Varchar(15)

Unidade Operacional

-

Não será enviado ao LMS

CPF

PPESSOA.CPF

Varchar(11)

Situação de trabalho atual

-

Não será enviado ao LMS

Permitir tempo Extra

-

Não será enviado ao LMS

• 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:

Campo LMS (Details)

Campo de Origem TOTVS

Descrição do campo de origem do TOTVS

Formato TOTVS

 ext_user_id

SMATRICULA.RA

RA do Aluno

Varchar(20)

 ext_group_id

‘D’+ SMATRICULA.IDTURMADISC

ID da turma disciplina

Int(4)

...

• 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:

...

Nome

...

IncluirNotaEtapa

...

Parâmetros

...

Arquivo XML com os campos

...

Retorno

...

XML

...

Tabela

...

SNOTAETAPA

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:

...

NOTAS NA ETAPA

...

TIPO

...

DESCRIÇÃO

...

CODCOLIGADA

...

SMALLINT(2)

...

Código da coligada

...

IDTURMADISC

...

Int(4)

...

ID da turma disciplina

...

NOTA

...

Numeric

...

Nota do Aluno

...

CODPROVA

...

SMALLINT(2)

...

Código da Avaliação

...

RA

...

Varchar(20)

...

RA do Aluno

...

• 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:

...

Nome

...

IncluirFrequenciaEtapa

...

Parâmetros

...

Arquivo XML com os campos

...

Retorno

...

XML

...

Tabela

...

SNOTAETAPA

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:

...

NOTAS NA ETAPA

...

TIPO

...

DESCRIÇÃO

...

CODCOLIGADA

...

SMALLINT(2)

...

Código da coligada

...

IDTURMADISC

...

String

...

ID da turma disciplina

...

NOTAFALTA

...

Numeric

...

Número de Faltas(%)

...

RA

...

Varchar(20)

...

ID do Aluno

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:

...

Nome

...

IncluirAvaliacao

...

Parâmetros

...

Arquivo XML com os campos

...

Retorno

...

XML

...

Tabela

...

SPROVAS

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:

...

AVALIAÇÕES

...

TIPO

...

DESCRIÇÃO

...

CODCOLIGADA

...

SMALLINT(2)

...

Código da coligada

...

IDTURMADISC

...

Int(4)

...

ID da turma disciplina

...

CODPROVA

...

SMALLINT(2)

Código da Avaliação

...

DESCRICAO

...

VARCHAR(100)

Descrição da Avaliação

...

VALOR

...

NUMERIC

Valor da Avaliação

...

DTPREVISTA

...

DATETIME

...

Data prevista

...

MEDIA

...

NUMERIC

...

Valor da Média

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:

...

Campo LMS (Details)

DetachUser ToGroup

...

Campo de Origem TOTVS

...

Descrição do campo de origem do TOTVS

...

Formato TOTVS

...

 ext_user_id

...

SMATRICULA.RA

...

RA do Aluno

...

Varchar(20)

...

 ext_group_id

...

‘D’ +SMATRICULA.IDTURMADISC

...

ID da turma disciplina

...

String

...

Campo LMS

(Details)

AttachUserToGroup

...

Campo de Origem TOTVS

...

Descrição do campo de origem do TOTVS

...

Formato TOTVS

...

 ext_user_id

...

SMATRICULA.RA

...

RA do ALuno

...

Varchar(20)

...

 ext_group_id

...

‘D’ + SMATRICULA.IDTURMADISC

...

ID da turma disciplina

...

Int(4)

...

• 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.

Histórico de Atualização do Documento:

...

• 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”:

...

Campos

...

Descrição

...

ID

...

ID do Processo

...

CODCOLIGADA

...

Código da Coligada

...

PROCESSO

...

Nome do Processo

...

STATUS

...

Status do registro – Erro ou Sucesso

...

CHAVE

...

Chave do Registro

...

DATA

...

Data do registro

...

DESCRIÇÃO DO ERRO

...

Descrição do Erro

...

ARQUIVO XML

...

Arquivo XML recebido ou Enviado

...

REPROCESSADO

...

Indica se o registro já foi reenviado – Será exibido Sim ou Não

...

TIPO

...

Exportação ou Importação

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”.

Image Removed

Image Removed

...