O manual a seguir tem por objetivo orientar o usuário da integração entre os sistemas TOTVS Educacional e LMS Time to Know. Todas as funcionalidades descritas neste manual têm como base do que está descrito nos documentos:
| Aviso | ||
|---|---|---|
| ||
As Melhorias na Integração, estão destacadas neste documento com o ícone: Novo! |
| Expandir | ||
|---|---|---|
| ||
Pré-requisitos No TOTVS Serviços Globais, por meio do menu Customização | Controle de customizações ativas, verificar se a customização Lib CNI e Integração LMS está ativada. ATENÇÃO: Para correto funcionamento da Integração LMS, é necessário configurar também a Integração Google, deixando o campo Ativada marcado ou desmarcado de acordo com a utilização dessa customização.
Descrição do processo Tela para que o usuário defina todos parâmetros necessários para efetuar a integração com o sistema LMS Detalhamento do processo No menu TOTVS Educacional | Sistema Indústria | Parâmetros, o usuário administrador consegue efetuar as parametrizações referentes ao processo de integração.
São eles:
Endereço do WebService: endereço do Web Service - disponibilizado pelo LMS Endereço do WebService de Consulta: endereço do WebService de Consulta - Para atender os Regionais que não atuam com a customização do CTM e na necessidade de consultar os alunos que já foram exportados ao LMS. Usuário: usuário com acesso ao Web Service - disponibilizado pelo LMS Senha: senha do usuário - disponibilizado pelo LMS
Situações de matrícula que identificam quais alunos devem ser enviados para o LMS. Para os processos de alteração de matrícula pelo menos uma situação de matrícula deve estar parametrizada. A figura abaixo | ||
| Expandir | ||
| ||
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 sistema LMS Detalhamento do processo No menu TOTVS Educacional | Customização | Parâmetros, o usuário administrador consegue efetuar as parametrizações referentes ao processo de integração.
São eles:
Endereço do web service: endereço do Web Service - disponibilizado pelo LMS Usuário: usuário com acesso ao Web Service - disponibilizado pelo LMS Senha: senha do usuário - disponibilizado pelo LMS
Situações de matrícula que identificam quais alunos devem ser enviados para o LMS. Para os processos de alteração de matrícula pelo menos uma situação de matrícula deve estar parametrizada. A figura abaixo é ilustrativa e o regional deve parametrizar as situações que serão enviadas para o LMS.
Situações de matrícula que são utilizadas para informar quais Alunos são retirados do LMS. Para os processos de alteração de Matrícula pelo menos uma situação de matrícula deve estar parametrizada. A figura abaixo é ilustrativa e o regional deve parametrizar as situações que serão retiradas do LMS.
Parâmetro utilizado para informar quais modalidades de cursos são enviadas para o LMS. A figura abaixo é ilustrativa e o regional deve parametrizar as modalidades que serão integradas com situações que serão enviadas para o LMS.
Situações de matrícula que são utilizadas para informar quais Alunos são retirados do LMS. Para os processos de alteração de Matrícula pelo menos uma situação de matrícula deve estar parametrizada. A figura abaixo é ilustrativa e o regional deve parametrizar as situações que serão retiradas do LMS.
Parâmetro utilizado para informar quais modalidades de cursos são enviadas para o LMS. A figura abaixo é ilustrativa e o regional deve parametrizar as modalidades que serão integradas com o LMS.
|
Pré-requisitos
Para cadastro do Grupo Pai LMS é necessário criar uma tabela dinâmica, como a da imagem abaixo. Os itens da tabela dinâmica devem estar 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 permite o cadastro do Grupo Pai LMS da matriz aplicada. Esse valor é 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 é possível informar qual o Grupo Pai LMS para essa matriz aplicada.
| Expandir | ||
|---|---|---|
| ||
| Expandir | ||
| ||
Pré-requisitos Não se aplica. Descrição do processo Esta tela permite o Para cadastro do Grupo Pai LMS é necessário criar uma tabela dinâmica, como a da imagem abaixo. Os itens da tabela dinâmica devem estar 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 permite o cadastro do Grupo Pai LMS da matriz aplicada Domínio LMS da modalidade do curso. Esse valor é usado para identificar a qual domínio a modalidade será cadastrada 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 Detalhamento do processo Ao acessar a modalidade do cursomatriz aplicada, em anexo é possível informar qual o Domínio Grupo Pai LMS para essa modalidadematriz aplicada.
|
| Expandir | |||||
|---|---|---|---|---|---|
| Importante! | ||||
O código do domínio para cada regional é disponibilizado pela equipe do LMS. | |||||
| Expandir | |||||
| |||||
| |||||
Pré-requisitos Não se aplica. Descrição do processo Este processo envia as informações do Curso para o Sistema LMS via Web ServiceEsta tela permite o cadastro do Domínio LMS da modalidade do curso. Esse valor é 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 é possível informar qual o Domínio LMS para essa modalidade.
Currículo e Oferta | Cursos | Edite o curso desejado | Edite a Modalidade | Anexos | Domínio LMS
|
| Expandir | ||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||
Pré-requisitos Não se aplica. Descrição do processo Este processo envia as informações do Curso para o Sistema LMS via Web Service. Detalhamento do processo O envio é feito no momento do cadastro da Turma/Disciplina. Caso esta seja a Distância ou Semi-Presencial, é enviado o Curso. Para envio do curso é necessário informar o domínio LMS a qual esse curso pertence. Para isso, é necessário informar 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. 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 são enviadas para atualização. Ao realizar alguma inclusão e/ou alteração nos campos Descrição, Data de Início e/ou Data Término de uma Matriz Curricular que esteja no domínio LMS, essas informações são enviadas para atualização. O envio é feito no momento do cadastro da Turma/Disciplina. Caso esta seja a Distância ou Semi-Presencial, é enviado o Curso. Para envio do curso é necessário informar o domínio LMS a qual esse curso pertence. Para isso, é necessário informar 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. 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 são enviadas para atualização. Ao realizar alguma inclusão e/ou alteração nos campos Descrição, Data de Início e/ou Data Término de uma Matriz Curricular que esteja no domínio LMS, essas informações são enviadas para atualização. São enviadas as seguintes informações:
|
presencial e que estiverem com a opção do campo complementar turma/disciplina Não Enviar ao LMS desmarcado.
O campo complementar na turma/disciplina é criado através do script disponibilizado no pacote de instalação, porém, será necessário liberar a visualização do campo por nível de ensino.
1- Acessar o TOTVS Educacional SGE → clique em configurações → Nível de Ensino → Campos Complementares Disponíveis e conferir se o campo complementar Não Enviar ao LMS está ativo na base de dados. Caso esteja desabilitado, será necessário habilitá-lo.
Descrição do processo
Este processo envia as informações da Turma e Turma/Disciplina para o Sistema LMS via Web Service.
Detalhamento do processo
É feito o envio das informações da Turma e Turma Disciplina, e é feito o vínculo, da Disciplina -> Turma e da Turma ao Curso, no momento do envio.
Quando o parâmetro “Não enviar ao LMS” no campo complementar da Turma/Disciplina está marcado, não é realizado o envio da Turma/disciplinas e consequentemente também não envia os alunos e matrículas associados àquela turma/disciplina.
ATENÇÃO! Caso a turma/disciplina já tenha sido enviado para o LMS e o parâmetro “Não enviar ao LMS” seja desmarcado, a customização não realiza o cancelamento/exclusão das informações já enviadas ao LMS.
São enviadas as seguintes informações da Turma
Turma/Disciplina:
| Expandir | |||
|---|---|---|---|
| |||
Pré-requisitos Somente sã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 Web Service. Detalhamento do processo É feito o envio das informações da Turma e Turma Disciplina, e é feito o vínculo, da Disciplina -> Turma e da Turma ao Curso, no momento do envio.
Sã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 - Concatena 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’ |
Campo LMS (Details) – UpdateGroup |
|---|
- Turma |
|---|
Campo de Origem TOTVS | Descrição do campo de origem do TOTVS | Formato TOTVS | |
|---|---|---|---|
Name |
STURMA. |
CODTURMA + ‘-’ STURMA.NOME+ ‘ |
SDISCIPLINA.NOME + ‘-‘ SGRADE.CODHABILITACAO
(T|‘+STURMA.CODFILIAL+ ‘|‘+STURMA.CODTURMA+ ‘|‘+STURMA.IDPERLET +‘)‘ | Nome da Turma | Varchar(60) |
Nome do Curso
Stringexternal_id |
‘T’ + STURMA.CODCOLIGADA+ STURMA.IDPERLET+ STURMA.CODTURMA | ID da turma |
- Concatena a letra |
'T' para indicar que é uma |
turma | String |
open_date |
open_date
STURMADISC.DTINICIAL
STURMA. |
Código do Template do LMS
Varchar(20)
DTINICIAL |
Data inicial | Datetime |
close_date |
STURMA.DTFINAL | Data final | Datetime | |
Type | Fixo ‘Course’ | Fixo ‘Course’ | Fixo ‘Course’ |
‘T’ + STURMA.IDFT
Campo LMS (Details) – AttachSubGroup UpdateGroup – Turma para Curso/Disciplina | Campo de Origem TOTVS | Descrição do campo de origem do TOTVS | Formato TOTVS | string ext_group_id | Id da Turma | String |
|---|---|---|---|---|---|---|
string ext_parent_id | ‘C’ +SHABILITACAOFILIAL.IDHABILITACAOFILIAL | ID do Curso | String |
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
Expandir| title | Processo Customizado Exportação de Professores |
|---|
Pré-requisitos
Somente são enviados ao LMS professores vinculados a uma Turma/Disciplina a distância ou semi-presencial.
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 é acionado quando um usuário vincula um professor a uma turma/disciplina, no menu Currículo e Oferta | Turmas/Disciplinas | Anexos | Professores. Após ser exportado, o professor consegue acessar o sistema LMS com o seu login sendo o seu CPF e a senha “123456”. Essa senha é temporária e deve ser alterada após primeiro acesso do professor.
| Nota |
|---|
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. |
São enviadas 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)
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)
São enviadas 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’
Name | STURMADISC.CODDISC + ‘-‘ SDISCIPLINA.NOME + ‘ (D|‘ + STURMADISC.IDTURMADISC + ‘)' | Nome do Curso | String |
external_id | ‘D’ + STURMADISC.IDTURMADISC | ID da turma/disciplina – Concatena 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’ |
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.CODCOLIGADA+ STURMA.IDPERLET+ STURMA.CODTURMA | Id da Turma | String |
string ext_parent_id | ‘M’ + STURMA.CODCOLIGADA+ SPERIODO.CODPERIODO+ SCURSO.CODCURSO+ SGRADE.CODGRADE | ID do Curso | String |
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.CODCOLIGADA+ STURMA.IDPERLET+ STURMA.CODTURMA | ID da Turma | String |
A partir da versão 2.0 (Janeiro/2019), a customização envia as seguintes informações:
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:
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
Aluno → Anexos → Matrícula no Período Letivo → Processos → Alterar Situação de Matrícula
Matrícula e Avaliação → Enturmação
Matrícula e Avaliação → Matrícula → Confirmação de Matrícula por Pagamento
Matrícula e Avaliação → Matrícula Isolada
Aluno → Anexos → Matrícula Isolada
Matrícula e Avaliação → Mais → Matrícula de Disciplinas em Lote
Matrícula e Avaliação → Rematrícula
| Expandir | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Pré-requisitos Somente são enviados ao LMS professores vinculados a uma Turma/Disciplina a distância ou semi-presencial e que tenha no campo complementar E-mail Google do seu cadastro preenchido para que seja exportado para o LMS. 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 é acionado quando um usuário vincula um professor a uma turma/disciplina, no menu Currículo e Oferta | Turmas/Disciplinas | Anexos | Professores. Após ser exportado, o professor consegue acessar o sistema LMS com o seu login sendo o seu CPF e a senha “123456”. Essa senha é temporária e deve ser alterada após primeiro acesso do professor. Para a integração, será validado se o E-mail do Google no campo complementar do Professor está preenchido.
São enviadas as seguintes informações referente ao professor:
São enviadas 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 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Expandir | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Pré-requisitos Somente são exportados alunos que estão matriculados em turmas/disciplinas à distância ou semi presencial.
Descrição do processo Este processo envia as informações do Aluno para o Sistema LMS via WebService. Detalhamento do processo No momento em que a matrícula de um aluno é efetuada em uma turma a distância ou semi-presencial, o aluno é enviado para o LMS. Após ser exportado, o aluno consegue acessar o sistema LMS com o seu login sendo o e-mail e a senha sendo seu CPF. Essa senha é 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 distância ou semi-presencial e alguma informação do cadastro é alterada, o aluno é enviado para atualização no LMS.
São enviada as seguintes informações:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Expandir | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| Nota | ||
|---|---|---|
| ||
A execução de todos processos listados não é de obrigatoriedade do regional. Favor desconsiderar os processo que não são utilizados pelo regional. |
São enviadas 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)
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 envia 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 |
| Expandir | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Pré-requisitos Somente são exportados alunos que estão matriculados em turmas/disciplinas à distância ou semi presencial.
Descrição do processo Este processo envia as informações do Aluno para o Sistema LMS via WebService. Detalhamento do processo No momento em que a matrícula de um aluno é efetuada em uma turma a distância ou semi-presencial, o aluno é enviado para o LMS. Após ser exportado, o aluno consegue acessar o sistema LMS com o seu login sendo o e-mail e a senha sendo sua data de nascimento, sem nenhum caractere especial (ex.: 10111995). Essa senha é temporária e deve ser alterada após primeiro acesso do aluno. Para a integração, será validado se o E-mail do Google no campo complementar do aluno está preenchido.
No cadastro do Aluno, caso este esteja matriculado em alguma turma/disciplina a distância ou semi-presencial e alguma informação do cadastro é alterada, o aluno é enviado para atualização no LMS.
São enviada as seguintes informações:
|
| Expandir | |||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||
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:
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
Aluno → Anexos → Matrícula no Período Letivo → Processos → Alterar Situação de Matrícula
Matrícula e Avaliação → Enturmação
Matrícula e Avaliação → Matrícula → Confirmação de Matrícula por Pagamento
Matrícula e Avaliação → Matrícula Isolada Aluno → Anexos → Matrícula Isolada
Matrícula e Avaliação → Mais → Matrícula de Disciplinas em Lote
Matrícula e Avaliação → Rematrícula
São enviadas as seguintes informações para vincular o Aluno a turma/disciplina:
|
| Expandir | ||
|---|---|---|
| ||
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 - Matrícula. |
| Expandir | ||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||
Pré-requisitos É 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#, em que ‘#’ é 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, 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. O campo CODPROVA determina 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 é gravada na Etapa (SNOTAETAPA). Se o código for A + Código da Prova + E + Código da Etapa, a nota é 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
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.
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.
O campo CODPROVA determina 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 é gravada na Etapa (SNOTAETAPA). Se o código for A + Código da Prova + E + Código da Etapa, a nota é 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>| Expandir | |||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||
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:
| |||||||||||||||||||||||
| Expandir | |||||||||||||||||||||||
| |||||||||||||||||||||||
| Expandir | |||||||||||||||||||||||
| |||||||||||||||||||||||
Pré-requisitos É 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#, em que ‘#’ é 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, 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: | |||||||||||||||||||||||
Nome | IncluirNotaEtapa | ||||||||||||||||||||||
Parâmetros | Arquivo XML com os campos | ||||||||||||||||||||||
Retorno | XML | ||||||||||||||||||||||
Tabela | SNOTAETAPA |
No exemplo abaixo segue a estrutura do arquivo XML que deverá ser enviado no caso de uma Nota de Avaliação:
<INCLUIRNOTAAVALIACAO><INCLUIRFREQUENCIAETAPA>
<SNOTAS><SNOTAETAPA>
<CODCOLIGADA>3<<CODCOLIGADA></CODCOLIGADA>
<IDTURMADISC>D29205<<IDTURMADISC></IDTURMADISC>
<NOTA>78<<NOTAFALTA></NOTA>NOTAFALTA>
<CODPROVA>A1E1</CODPROVA> <RA>99144488<<RA></RA>
</SNOTAS>SNOTAETAPA>
</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
INCLUIRFREQUENCIAETAPA>
Exemplo XML preenchido:
<INCLUIRFREQUENCIAETAPA>
<SNOTAETAPA>
<CODCOLIGADA>1</CODCOLIGADA>
<IDTURMADISC>D1724</IDTURMADISC>
<NOTAFALTA>10</NOTAFALTA>
<RA>M-PROF-1</RA>
</SNOTAETAPA>
</INCLUIRFREQUENCIAETAPA>
RA
Varchar(20)
RA do AlunoPré-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:
Código da Avaliação
Descrição da Avaliação
Valor da Avaliação
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
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 é responsável por atualizar no LMS o vínculo dos Alunos das Turmas/Disciplinas selecionadas via Web Service.
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 semi-presencial 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 deve selecionar as Turmas/Disciplinas desejadas e executar o processo. A customização utiliza 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
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”.
Para que o LMS possa acessar o Web Service disponibilizado pelo SGE será necessaário passar as seguintes informações:
1 - CodColigada: Código da coligada a ser utilizada na integração;
| Expandir | ||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||
Pré-requisitos Configurar web-service, conforme conforme Roteiro para Configuração do WebService. Descrição do processo O método customizado, no WebService Web Service TOTVS, receberá recebe um arquivo XML com as informações de faltas na etapa avaliações e executará executa a inclusão de frequência (faltas) para os alunos 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 em ambientes distribuídos e que atende a diversas plataformas com mensagens personalizadas. Detalhamento do processo O método disponibilizado no web service receberá recebe como parâmetro um arquivo XML, onde este conterá as informações de alunos e faltas avaliações a serem processadosincluídas, e neste caso, efetuará efetua os tratamentos necessários para realizar a operação solicitada (inclusão/alteração) no TOTVS Educacional. Assinatura e estrutura do serviçoO método tem a seguinte estrutura:
Detalhamento do processo Ao consumir este método, o arquivo XML será é processado, incluindo ou alterando as faltas dos alunos na etapa 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 faltas na etapaacordo 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: ID do Aluno
O campo TIPOETAPA da tabela SPROVAS é preenchido sempre com ‘N’. No exemplo abaixo segue a estrutura do arquivo XML que deverá ser enviado: <INCLUIRFREQUENCIAETAPA><INCLUIRAVALIACAO> <SNOTAETAPA><SPROVAS> <CODCOLIGADA></CODCOLIGADA> <IDTURMADISC></IDTURMADISC> <DESCRICAO></DESCRICAO> <CODPROVA></CODPROVA> <VALOR></VALOR> <DTPREVISTA></DTPREVISTA> <NOTAFALTA></NOTAFALTA> <RA><<MEDIA></RA>MEDIA> </SNOTAETAPA>SPROVAS> </INCLUIRFREQUENCIAETAPA>INCLUIRAVALIACAO> Exemplo XML preenchido:
<INCLUIRFREQUENCIAETAPA><INCLUIRAVALIACAO> <SNOTAETAPA><SPROVAS> <CODCOLIGADA>1</CODCOLIGADA> <IDTURMADISC>D1724</IDTURMADISC> <DESCRICAO>TESTE 123</DESCRICAO> <CODPROVA>3</CODPROVA> <NOTAFALTA>10<<VALOR>3</NOTAFALTA>VALOR> <RA>M-PROF-1</RA> </SNOTAETAPA> </INCLUIRFREQUENCIAETAPA> | ||||||||||||||||||||||||||||||||||||||
| Expandir | ||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||
Nome | IncluirAvaliacao | |||||||||||||||||||||||||||||||||||||
Parâmetros | Arquivo XML com os campos | |||||||||||||||||||||||||||||||||||||
Retorno | XML | |||||||||||||||||||||||||||||||||||||
Tabela | SPROVAS | |||||||||||||||||||||||||||||||||||||
AVALIAÇÕES | TIPO | DESCRIÇÃO | ||||||||||||||||||||||||||||||||||||
CODCOLIGADA | SMALLINT(2) | Código da coligada | ||||||||||||||||||||||||||||||||||||
IDTURMADISC | Int(4) | ID da turma disciplina | ||||||||||||||||||||||||||||||||||||
CODPROVA | SMALLINT(2) | DESCRICAO | VARCHAR(100) | VALOR | NUMERIC | |||||||||||||||||||||||||||||||||
DTPREVISTA | DATETIME | Data prevista | ||||||||||||||||||||||||||||||||||||
MEDIA | NUMERIC | Valor da Média | ||||||||||||||||||||||||||||||||||||
| Expandir | ||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||
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) | |||||||||||||||||||||||||||||||||||
| Expandir | ||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||
| Expandir | ||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||
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 – Exibe Sim ou Não | |||||||||||||||||||||||||||||||||||||
TIPO | Exportação ou Importação | |||||||||||||||||||||||||||||||||||||
| Expandir | ||||||||||||||||||||||||||||||||||||||
|
<DTPREVISTA>21/09/2015</DTPREVISTA> <MEDIA>12</MEDIA> </SPROVAS> </INCLUIRAVALIACAO>
|
| Expandir | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||
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:
|
| Expandir | ||
|---|---|---|
| ||
Pré-requisitos 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 é responsável por atualizar no LMS o vínculo dos Alunos das Turmas/Disciplinas selecionadas via Web Service. 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 semi-presencial 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 deve selecionar as Turmas/Disciplinas desejadas e executar o processo. A customização utiliza as regras já existentes de situação de matrícula para definir se o aluno será vinculado ou desvinculado da Turma no LMS. |
| Expandir | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
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”.
|
| Expandir | ||
|---|---|---|
| ||
Para que o LMS possa acessar o Web Service disponibilizado pelo SGE será necessaário passar as seguintes informações: 1 - CodColigada: Código da coligada a ser utilizada na integração;
Para mais informações sobre a configuração do WebService e/ou modelo do arquivo Web.Config clique aqui |
Autor | Versão | Data | Descrição das Alterações |
|---|---|---|---|
Pedro Antonio Silva Barroso | 1.0 | 03/05/2018 | Reformulação do documento, colocando no padrão FSW SENAI |
Gustavo Fonseca Nunes | 2.0 | 27/07/2018 | Ajustes solicitados pelo Luiz Antônio (SENAI PE) |
Pedro Marcus Paixão Silva | 3.0 | 17/09/2018 | Atualização das funcionalidades |
| Ana Carolina Eleutério Abras | 4.0 | 04/01/2019 | Atualização - Melhorias na Integração |
| Ana Luiza Martins Moreira | 5.0 | 10/06/2019 | Atualização - Melhorias na documentação |
| Adilson José de Aquino | 6.0 | 05/09/2019 | Atualização - Identificação do WS para configuração do LMS |
| Vinicius Alaor da Silva | 7.0 | 11/08/2020 | Atualização - Melhorias na Integração |
| Jéssica Gonçalves Silva | 8.0 | 11/11/2020 | Atualização - Melhorias na documentação |
| Vanessa de Sousa Carvalho | 9.0 |
| Atualização - Alteração na customização - E-mail do aluno / Envio de CPF |
| Paulo Henrique Rey | 10.0 |
| Atualização - Campos chaves de integração |
| Vanessa de Sousa Carvalho | 11.0 |
| Atualização - Envio de e-mail na exportação de alunos. |
Autor | Versão | Data | Descrição das Alterações |
Pedro Antonio Silva Barroso | 1.0 | 03/05/2018 | Reformulação do documento, colocando no padrão FSW SENAI |
Gustavo Fonseca Nunes | 2.0 | 27/07/2018 | Ajustes solicitados pelo Luiz Antônio (SENAI PE) |
Pedro Marcus Paixão Silva | 3.0 | 17/09/2018 | Atualização das funcionalidades |
| Ana Carolina Eleutério Abras | 4.0 | 04/01/2019 | Atualização - Melhorias na Integração |
| Ana Luiza Martins Moreira | 5.0 | 10/06/2019 | Atualização - Melhorias na documentação |
| Adilson José de Aquino | 6.0 | 05/09/2019 | Atualização - Identificação do WS para configuração do LMS |
