Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Expandir
titleParametrização

Pré-Requisitos / Parametrizações

Não se aplica.

  • Descrição do Processo


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 Modified


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 Modified


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

Image Modified


Situação de matrícula de pré-matriculado: informe as situações de matrícula que indicam pré-matrícula pelo processo seletivo. É importante que seja utilizado uma situação de matrícula que não interfira nas matrículas normais do Totvs Educacional.

Image Modified



Cadastro do Domínio LMS

Esse processo não possui pré-requisitos

  • Descrição do Processo

No cadastro da Turma do Totvs Educacional, será verificado se o campo “Disponível para divulgação está marcado”. Caso ele esteja marcado, ao salvar o registro e essa turma estiver associada a alguma área de interesse em uso no Processo Seletivo, seu código será incluído na tabela ZPSELETTURMA, que indica que a mesma está em uso e disponível para seleção no portal de inscrição.

  • Detalhamento do Processo

Ao acessar o cadastro da turma no SGE você terá a opção de informar se a turma será ou não disponibilizada para seleção no momento da inscrição no processo seletivo


Image Added


Expandir
titleCadastro do Grupo Pai LMSTurma de interesse
  • 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

Expandir
title
Processo Customizado de Exportação de Curso (Matriz Aplicada)

uma área de interesse ofertada, será possível visualizar as turmas de interesse associadas à essa área.

Image Added


Na tela de visão o usuário poderá ativar ou desativar as turmas listadas.

Image Added


A customização só permitirá desativar turmas se elas não possuírem candidatos inscritos.

Image Added

Expandir
titleTurmas da área de interesse
  • 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.

No cadastro da Turma do Totvs Educacional, será verificado se o campo “Disponível para divulgação está marcado”. Caso ele esteja marcado, essa turma será disponibilizada na área de interesse de acordo com a habilitação filial na qual a turma foi criada.

  • 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

Nota
titleImportante!

O código do domínio para cada regional é disponibilizado pela equipe do LMS.

Expandir
title

Modalidade do Curso

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:

‘T’ + STURMA.IDFT

  • Turma/Disciplina:

‘D’ + STURMADISC.IDTURMADISC

  • Vínculo da Turma ao Curso:

‘T’ + STURMA.IDFT

  • Vínculo da Disciplina à Turma:

‘D’ +STURMADISC.IDTURMADISC

‘T’ +STURMA.IDFT

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

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

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

  • Pré-Requisitos / Parametrizações

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

Expandir
titleInscrição via Portal do Processo Seletivo
  • Pré-Requisitos / Parametrizações

Esse processo não possui pré-requisitos

Só será possível escolher uma turma de interesse no portal caso a área de interesse selecionada tenha alguma turma disponível.

  • Descrição do Processo

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

Após selecionar a área de interesse no Portal do Processo Seletivo o aluno deverá selecionar qual é a sua turma de interesse.

  • Detalhamento do Processo

O envio será feito no momento do cadastro da Turma/Disciplina, caso esta seja a Distancia ou Semi-Presencial, será enviada o Curso.

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

Varchar(60)

Type

Fixo ‘Course’

Fixo ‘Course’

Fixo ‘Course’

Expandir
titleProcesso Customizado de Exportação de Turma e Turma/Disciplina

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

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’

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

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’

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

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

ID da Turma/Disciplina

String

string ext_parent_id

ID da Turma

String

Expandir
titleProcesso Customizado Exportação de Professores

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)

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’

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
titleProcesso Customizado de Exportação de Aluno
Nota
titleImportante!

Para que o aluno seja exportado para o LMS o mesmo deve ter um e-mail informado no seu cadastro.

  • 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

Expandir
titleProcesso Customizado de Exportação de Matrícula do Aluno Disciplina
  • 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

Nota
titleImportante!

A execução dos processos acima não é de obrigatoriedade do regional. Favor desconsiderar os processo que não são utilizados pelo regional.

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)

Expandir
titleProcesso Customizado de Exportação de Situação de Matrícula do Aluno
  • Pré-Requisitos / Parametrizações

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

Quando o candidato acessar a tela de inscrição de um processo seletivo, preencher os dados e clicar em finalizar a inscrição o usuário terá sua matrícula realizada no educacional. Estando o processo seletivo configurado é a area de interesse conter Turma de Área de interesse disponiveis, será habilitada uma opção de seção de Turma na área “Opção de Interesse”, onde o usuário deverá selecionar uma turma disponível.

Image Added

Nota
titleImportante!

Caso exista alguma turma disponível o aluno, obrigatoriamente, deverá informa a sua escolha para continuar com a sua inscrição.

Pode ocorrer de que a configuração da área de interesse esteja correta, porém por algum motivo a matrícula não veja a ser realizada no Totvs Educacional, ocorrendo erro no processamento. Caso isso ocorra nem o cadastro do candidato do processo seletivo e no Totvs Educacional não serão efetuados. E a mensagem de erro com a causa do erro será exibida ao usuário.

Image Added


Matrícula via RM.exe

Ao efetuar uma inscrição do candidato em um processo seletivo de oferta online de cursos, será habilitado o botão de matrícula, ao clicar neste botão o sistema irá validar se o candidato possui algum documento obrigatório pendente (se for definido no processo seletivo e na área ofertada). Essa opção normalmente será utilizada quando houver validação manual de documentos exigidos.

Image Added


Se o candidato não possuir nenhuma pendência de documento ou o processo seletivo não tiver validação de obrigatoriedade de documentos, o sistema irá montar todo o ambiente da matrícula e irá efetuar o processo em segundo plano.

Image Added


Assim que o processo é concluído o candidato já possui uma matrícula no TOTVS Gestão Educacional e sua situação na opção da área de interesse escolhida será de compareceu à chamada, exatamente o status definido quando o processo de matrícula é feito através do TOTVS Gestão Educacional. 

Expandir
titleCancelamento de pré-matrícula
  • Pré-Requisitos / Parametrizações

Para que o processo execute de forma correta você deve informa os valores para os parâmetros: Situação de matrícula de “pré-matriculado”, Dias para cancelamento de pré-matrícula, Motivo de alteração de matrícula para cancelado e Situação de matrícula cancelado.

  • Descrição do Processo

Ao ser executado o processo listara todos os alunos, de acordo com os parâmetros informados, que devem ter suas pré-matrículas canceladas executando o processo nativo do produto de alteração de situação de matricula.

  • Detalhamento do Processo

 

Através do menu “Totvs Processo Seletivo | Customização | Processo Seletivo | Cancelamento de pré-matrícula” será possível realizar o cancelamento de matrículas não efetivadas a X dias, conforme parâmetro de dias para cancelamento.


Image Added


Se um candidato de inscreveu no dia 01/02/2019 e sua matrícula se encontra com o status de pré-matrícula até a data atual (16/02/2019) e o número de dias parametrizado for 15 dias, ao executar o processo sua situação de matrícula será alterada para o status parametrizado como situação de matrícula que indica cancelamento.

Ao cancelar uma pré-matrícula através desse processo não serão realizadas alterações na lista de espera do processo seletivo.


Nota
titleAgendamento de job

Esse processo deve ser agendado, utilizando o agendamento de job, para que seja executado na periodicidade que a federação desejar, dessa forma não será necessário a interação manual para execução do processo de cancelamento de pré-matrícula.

Nota
titleDesmatricular alunos matriculados via Processo Seletivo RM (nativo)

Será possível realizar o processo de desmatricular alunos que foram matriculados via processo seletivo. Será possível filtrar apenas alunos com pendência financeira, como o não pagamento do boleto da matrícula. Nesse processo não é possível filtrar por quantidade de dias.

O acesso ao processo é realizado através do sistema TOTVS Educacional | Matrícula e Avaliação | Processo Seletivo RM | Desmatricular.

Image Added

  • Pré-Requisitos / Parametrizações

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

  • Descrição do Processo

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

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

  • Detalhamento do Processo

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

               

               

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

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

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

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

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

<INCLUIRNOTAAVALIACAO>

<SNOTAS>

<CODCOLIGADA>3</CODCOLIGADA>

<IDTURMADISC>D29205</IDTURMADISC>

<NOTA>78</NOTA>

<CODPROVA>E1</CODPROVA>

<RA>99144488</RA>

</SNOTAS>

</INCLUIRNOTAAVALIACAO>

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

<INCLUIRNOTAAVALIACAO>

<SNOTAS>

<CODCOLIGADA>3</CODCOLIGADA>

<IDTURMADISC>D29205</IDTURMADISC>

<NOTA>78</NOTA>

<CODPROVA>A1E1</CODPROVA>

<RA>99144488</RA>

</SNOTAS>

</INCLUIRNOTAAVALIACAO>

Tipos de dados:

  • Pré-Requisitos / Parametrizações

Configurar web-service, conforme requisito item 1.8.

  • Descrição do Processo

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

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

  • Detalhamento do Processo

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

Assinatura e estrutura do serviço:

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

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

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

<INCLUIRFREQUENCIAETAPA>

     <SNOTAETAPA>

   <CODCOLIGADA></CODCOLIGADA>

   <IDTURMADISC></IDTURMADISC>

   <NOTAFALTA></NOTAFALTA>

   <RA></RA>

</SNOTAETAPA>

</INCLUIRFREQUENCIAETAPA>

Exemplo XML preenchido:

       

<INCLUIRFREQUENCIAETAPA>

   <SNOTAETAPA>

          <CODCOLIGADA>1</CODCOLIGADA>

          <IDTURMADISC>D1724</IDTURMADISC>

          <NOTAFALTA>10</NOTAFALTA>

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

   </SNOTAETAPA>

</INCLUIRFREQUENCIAETAPA>

  • Pré-Requisitos / Parametrizações

Configurar web-service, conforme item 1.8.

  • Descrição do Processo

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

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

  • Detalhamento do Processo

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

                O método terá a seguinte estrutura:

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

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

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

Código da Avaliação

Descrição da Avaliação

Valor da Avaliação

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

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

       <INCLUIRAVALIACAO>

     <SPROVAS>

   <CODCOLIGADA></CODCOLIGADA>

   <IDTURMADISC></IDTURMADISC>

   <DESCRICAO></DESCRICAO>

   <CODPROVA></CODPROVA>

   <VALOR></VALOR>

   <DTPREVISTA></DTPREVISTA>

   <MEDIA></MEDIA>

</SPROVAS>

   </INCLUIRAVALIACAO>

Exemplo XML preenchido:

       <INCLUIRAVALIACAO>

       <SPROVAS>

          CODCOLIGADA>1</CODCOLIGADA>

          <IDTURMADISC>D1724</IDTURMADISC>

          <DESCRICAO>TESTE 123</DESCRICAO>

          <CODPROVA>3</CODPROVA>

          <VALOR>3</VALOR>

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

          <MEDIA>12</MEDIA>

        </SPROVAS>

</INCLUIRAVALIACAO>             

  • Pré-Requisitos / Parametrizações

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

  • Descrição do Processo

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

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

  • Detalhamento do Processo

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

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

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

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

Informações que serão enviadas:

 

  • Pré-Requisitos / Parametrizações

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

  • Descrição do Processo

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

  • Detalhamento do Processo

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

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

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
Expandir
titleExportação de dados Portal (Consultas SQL Via WebService)

Foram desenvolvidas consultas SQLs que deverão ser importadas no sistema TOTVS Educacional. Essas consultas permitirão a consulta de dados através de WebService disponibilizado na API do FrameHTML.

Configurações da FrameHTML e forma de acesso

No diretório de instalação da FrameHTML deverá ser editado o arquivo Web.Config e alterado o parâmetro owin:AutomaticAppStartup para True.

Exemplo:

<add key="owin:AutomaticAppStartup" value="true" />


Para consumir o WebService deverá ser enviada a autenticação de usuário e senha no cabeçalho da requisição.


Exemplo de consumo via Postman:

Image Added


Exemplo de URL de requisição:


Para realizar a consulta serão necessários identificar os dados que permitirão a localização da consulta SQL importada no sistema TOTVS Educacional e também os parâmetros necessário para execução do filtro.


Parametros:

  • CodColigada: indica a coligada da consulta SQL
  • codSentenca: código da sentença SQL importada no sistema;
  • codSistema: código do sistema da consulta. Por padrão deve ser informado “S”;
  • parameters: parâmetros para filtro da consulta. No exemplo abaixo estão sendo passados os filtros para CODCOLIGADA e CODFILIAL. O parâmetros deverão ser separados por ponto e vírgula “;” e seus valores  separados pelo sinal de igualdade “=”.


Exemplo: parameters=NomeDoParametro1=valor1;NomeDoParametro2=valor2


http://localhost:12117/RM/API/TOTVSCustomizacao/ConsultasSQL/ExecutaConsultaSQL?codColigada=0&codSentenca=FSW.CNI.001&codSistema=S&parameters=CODCOLIGADA=1;CODFILIAL=1


Nota
titleParâmetros não obrigatórios

Caso o parâmetro do filtro não seja obrigatório o mesmo não precisa ser passado na URL. Exemplo em que o CODFILIAL não é obrigatório e serão consultados dados de todas as filiais:


http://localhost:12117/RM/API/TOTVSCustomizacao/ConsultasSQL/ExecutaConsultaSQL?codColigada=0&codSentenca=FSW.CNI.001&codSistema=S&parameters=CODCOLIGADA=1

Consultas disponibilizadas:

Expandir
titleConsulta de Unidade (Filial)

Consulta de Unidade (Filial)

Parâmetro: Coligada (obrigatório) e código da Filial (opcional).


Saída: serão retornadas todas as Filiais que tenham Processos Seletivos com Publicação em Portais permitida.


Para identificar quais registros devem ser retornados a consulta deve extrair quais Processos Seletivos possuem os campos “Publica Portal Externo” ou “Publica Portal SESI/SENAI” igual a Sim (SPSPROCSELCOMPL.PUBPORTALEXT = S ou SPSPROCSELCOMPL. PUBPORTALSESISENAI = S).


Aquelas registros que corresponderem à estes filtros terão seus dados retornados pela consulta.

Expandir
titleConsulta de Curso (Modalidade e Segmento)

Consulta de Curso (Modalidade e Segmento)

Parâmetro: Coligada (obrigatório) e código do Curso (opcional).


Nome dos parâmetros para filtro: CODCOLIGADA e CODCURSO


Saída: serão retornados todos os Cursos vinculados à uma Área de Interesse Ofertada de algum Processo Seletivo com Publicação em Portais permitida.


Para identificar quais registros devem ser retornados a consulta deve extrair quais Processos Seletivos possuem os campos “Publica Portal Externo” ou “Publica Portal SESI/SENAI” igual a Sim (SPSPROCSELCOMPL.PUBPORTALEXT = S ou SPSPROCSELCOMPL. PUBPORTALSESISENAI = S).


Aquelas registros que corresponderem à estes filtros terão seus dados retornados pela consulta.

Expandir
titleConsulta de Turma

Consulta de Turma

Parâmetro: Coligada (obrigatório), código da Filial (opcional), código da Turma (opcional).


Nome dos parâmetros para filtro: CODCOLIGADA, CODFILIAL e CODTURMA


Saída: serão retornadas todas as Turmas vinculadas à uma Área de Interesse Ofertada de algum Processo Seletivo com Publicação em Portais permitida.


Para identificar quais registros devem ser retornados a consulta deve extrair quais Processos Seletivos possuem os campos “Publica Portal Externo” ou “Publica Portal SESI/SENAI” igual a Sim (SPSPROCSELCOMPL.PUBPORTALEXT = S ou SPSPROCSELCOMPL. PUBPORTALSESISENAI = S).


Aquelas registros que corresponderem à estes filtros terão seus dados retornados pela consulta.

Expandir
titleConsulta de Matriz Curricular / Matriz Aplicada

Consulta de Matriz Curricular / Matriz Aplicada

Parâmetro: Coligada (obrigatório), código do Curso (opcional), código da Habilitação/Série (opcional), código da Matriz Curricular (opcional), código da Matriz Aplicada (opcional).


Nome dos parâmetros para filtro: CODCOLIGADA, CODCURSO, CODHABILITACAO, CODGRADE e IDHABILITACAOFILIAL.


Saída: serão retornadas todas as Matrizes Curriculares / Matrizes Aplicadas vinculadas à uma Área de Interesse Ofertada de algum Processo Seletivo com Publicação em Portais permitida.


Para identificar quais registros devem ser retornados a consulta deve extrair quais Processos Seletivos possuem os campos “Publica Portal Externo” ou “Publica Portal SESI/SENAI” igual a Sim (SPSPROCSELCOMPL.PUBPORTALEXT = S ou SPSPROCSELCOMPL. PUBPORTALSESISENAI = S).


Aquelas registros que corresponderem à estes filtros terão seus dados retornados pela consulta.

Expandir
titleConsulta de Disciplina

Consulta de Disciplina

Parâmetro: Coligada (obrigatório), código da Disciplina (opcional).


Nome dos parâmetros para filtro: CODCOLIGADA e CODDISC.


Saída: serão retornadas todas as Disciplinas de Turmas/disciplinas vinculadas à uma Área de Interesse Ofertada de algum Processo Seletivo com Publicação em Portais permitida.


Para identificar quais registros devem ser retornados a consulta deve extrair quais Processos Seletivos possuem os campos “Publica Portal Externo” ou “Publica Portal SESI/SENAI” igual a Sim (SPSPROCSELCOMPL.PUBPORTALEXT = S ou SPSPROCSELCOMPL. PUBPORTALSESISENAI = S).


Aquelas registros que corresponderem à estes filtros terão seus dados retornados pela consulta.

Expandir
titleConsulta de vagas disponíveis e inscrições

Consulta de vagas disponíveis e inscrições

Parâmetro: Coligada (obrigatório), código do Processo Seletivo (opcional), código da Área de Interesse Ofertada (opcional).


Nome dos parâmetros para filtro: CODCOLIGADA, IDPS e IDAREAINTERESSE.


Saída: serão retornadas todas as vagas disponibilizadas e o número de inscritos por Área de Interesse Ofertada de algum Processo Seletivo com Publicação em Portais permitida.


Para identificar quais registros devem ser retornados a consulta deve extrair quais Processos Seletivos possuem os campos “Publica Portal Externo” ou “Publica Portal SESI/SENAI” igual a Sim (SPSPROCSELCOMPL.PUBPORTALEXT = S ou SPSPROCSELCOMPL. PUBPORTALSESISENAI = S).


Aquelas registros que corresponderem à estes filtros terão seus dados retornados pela consulta.

Expandir
titleConsulta de Processo Seletivo

Consulta de Processo Seletivo

Parâmetro: Coligada (obrigatório), código do Processo Seletivo (opcional).


Nome dos parâmetros para filtro: CODCOLIGADA e IDPS.


Saída: serão retornadas todos os Processos Seletivos com Publicação em Portais permitida.


Para identificar quais registros devem ser retornados a consulta deve extrair quais Processos Seletivos possuem os campos “Publica Portal Externo” ou “Publica Portal SESI/SENAI” igual a Sim (SPSPROCSELCOMPL.PUBPORTALEXT = S ou SPSPROCSELCOMPL. PUBPORTALSESISENAI = S).


Aquelas registros que corresponderem à estes filtros terão seus dados retornados pela consulta.


Expandir
titleConsulta de Área de Interesse

Consulta de Área de Interesse

Parâmetro: Coligada (obrigatório), código do Processo Seletivo (opcional), código da Área de Interesse Ofertada (opcional).


Nome dos parâmetros para filtro: CODCOLIGADA, IDPS e IDAREAINTERESSE.


Saída: serão retornadas todas as Áreas de Interesse Ofertadas de algum Processo Seletivo com Publicação em Portais permitida.


Para identificar quais registros devem ser retornados a consulta deve extrair quais Processos Seletivos possuem os campos “Publica Portal Externo” ou “Publica Portal SESI/SENAI” igual a Sim (SPSPROCSELCOMPL.PUBPORTALEXT = S ou SPSPROCSELCOMPL. PUBPORTALSESISENAI = S).


Aquelas registros que corresponderem à estes filtros terão seus dados retornados pela consulta.

Expandir
titleConsulta de Turmas da Área de Interesse

Consulta de Turmas da Área de Interesse

Parâmetro: Coligada (obrigatório), código da Filial (opcional), código da Turma (opcional) código do Processo Seletivo (opcional), código da Área de Interesse Ofertada (opcional).


Nome dos parâmetros para filtro: CODCOLIGADA, CODFILIAL, CODTURMA, IDPS e IDAREAINTERESSE.


Saída: serão retornadas todas as Turmas vinculadas à Áreas de Interesse Ofertadas de algum Processo Seletivo com Publicação em Portais permitida.


Para identificar quais registros devem ser retornados a consulta deve extrair quais Processos Seletivos possuem os campos “Publica Portal Externo” ou “Publica Portal SESI/SENAI” igual a Sim (SPSPROCSELCOMPL.PUBPORTALEXT = S ou SPSPROCSELCOMPL. PUBPORTALSESISENAI = S).

Expandir
titleProcesso Customizado Importação de Notas

Nome

IncluirNotaEtapa

Parâmetros

Arquivo XML com os campos

Retorno

XML

Tabela

SNOTAETAPA

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

Expandir
titleProcesso Customizado de Importação de Frequência

Nome

IncluirFrequenciaEtapa

Parâmetros

Arquivo XML com os campos

Retorno

XML

Tabela

SNOTAETAPA

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

Expandir
titleProcesso Customizado Importação de Avaliações em Turmas/Disciplinas

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
titleProcesso Customizado de Exportação da Mudança de Turma

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
titleProcesso de Vincular e Desvincular Alunos com LMS
Expandir
titleMonitor de Log
  • 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


Histórico de Atualização do Documento:

Atualização - Melhorias na Integração

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

Descrição das Alterações

Adilson José de Aquino

1.0

 

Criação do documento

Pedro Antonio Silva Barroso

2.0

 

Reformulação para os padrões da Fábrica

Ana Carolina Eleutério Abras4.004/01/2019