Manual - Integração AVA

O SESI DN utilizará a plataforma AVA SESI para facilitar a execução de atividades de cursos a distância e semipresenciais. Para isso, será feita uma conexão entre o Sistema TOTVS Educacional - SGE e o AVA SESI, garantindo uma integração eficiente.

Aqui, será realizada a importação dos dados provenientes do AVA para o SGE. Especificamente, serão transferidos dados relativos a notas dos alunos. Esta transferência será executada utilizando o pacote Integração AVA do iPaaS.

O fluxo abaixo segue a regra geral da integração:

Para que a Integração AVA SESI funcione corretamente, é essencial que as configurações sejam realizadas de forma adequada.

Configurações necessárias: Pré-Requisitos - Integração AVA SESI

A Integração AVA foi desenvolvida para o registro de informações de dados provenientes do AVA para o SGE.

A interface para configuração desses registros está disponível em: TOTVS Educacional | Sistema Indústria | Integração AVA| Cadastro Avaliações

• Cadastro Avaliações

Ao clicar em Integração Ava, irá retornar as opções: Cadastro de Avaliações e Monitor de Log. Ao clicar em Cadastro de avaliações, irá abrir uma tela onde o usuário autorizado, poderá incluir, editar ou excluir avaliações. A liberação do acesso deverá ser feita na árvore de Perfil no módulo Serviços Globais.

Observação I: Somente pessoas com os devidos acessos poderão incluir, editar ou excluir as Avaliações. A liberação do acesso deverá ser feita na árvore de Perfil no Módulo Serviços Globais.

Ao clicar na opção Cadastro de avaliações os campos abaixo deverão serem preenchidos:

• Descrição da Avaliação AVA - Campo Descrição onde será possível informar a descrição da avaliação
• Id da avaliação AVA - Campo Identificador onde será possível informar o Código identificador da Avaliação

Observação II: Podem ocorrer casos em que as avaliações sejam previamente preenchidas através de scripts. Para estes casos, as avalições serão apresentadas na tela com as informações pré defindas no script.

Atenção: A Edição do Cadastro de Avaliação só será permitida se o registro que estiver sendo editado não estiver vinculado a nenhuma Etapa que esteja com notas lançadas. Caso o registro selecionado esteja com notas lançadas , retornará a seguinte mensagem informativa: " Não é possível editar/excluir avaliações que possuam, notas lançadas" 

• Ao editar/excluir uma avaliação que esteja vinculada a uma etapa que não possua notas lançadas, os registros de origem da informação (custom button e anexo) serão limpados.

Na tela de Modelo de Etapas, na aba Identificação, no campo Avaliação Ava, deverá ser selecionada a Avaliação que será considerada como Avaliação AVA SESI, para identificar em quais etapas serão gravados os dados recebidos de notas da plataforma AVA.

Ao cadastrar uma Etapa, será apresentado o novo campo para informar a qual Avaliação AVA ela estará vinculada. 

O campo será do tipo DropDown, onde serão listadas as Avaliações cadastradas  e o usuário fará a seleção.

Essa ação indica que a Etapa cadastrada será considerada para recebimento da Avaliação AVA selecionada.

Menu: TOTVS Educacional | Currículo e Oferta | Parametrizações por Curso | Anexos | Modelo de etapas da Matriz Aplicada. 

Nas etapas de Notas da Turma/Disciplina, o campo Anexo Avaliação AVA será utilizado para armazenar as informações das Avaliações AVA associadas à etapa no SGE. 

Este campo será considerado no envio para as turmas/disciplinas, para que ao acessar uma turma disciplina consiga verificar se a mesma está relacionada a uma Avaliação AVA.

Acessar o menu TOTVS Educacional | Currículo e Oferta | Turmas/Disciplinas | Anexos

Os dados desse anexo podem ser cadastrados manualmente ou preenchidos através do processo Atualizar etapas de Turma/disciplinas da Parametrização por Curso, que copia os dados do modelo de etapa para a etapa correspondente da Turma/disciplina.

O registro de Etapas realizado na parametrização por curso, quando realizado antes da criação das turmas/disciplinas, replica automaticamente as informações para o Anexo Etapas das Turmas/disciplinas.

Após o registro das Etapas nas turmas/disciplinas, caso ocorra alguma alteração nas Etapas será necessário que as turmas/disciplinas sejam atualizadas. Para isso, existe um processo nativo de Atualizar Etapas de Turmas/disciplinas.

Após o Registro das etapas do campo "Avaliação AVA" no modelo de etapa, este poderá ser replicado para as etapas das turmas disciplinas ao ser executado o processo de "Atualizar etapas de Turma/disciplinas" utilizando a funcionalidade Parametrização por curso que poderá ser acessado através do Menu:

TOTVS Educacional | Currículo e Oferta | Parametrizações por Curso seguindo os seguintes passos: 

 Selecionar o(s) registro(s) desejado(s) e executar o processo "Atualizar etapas de Turma/Disciplinas"

Para que as avaliações sejam replicadas corretamente, é necessário que o campo 'Atualizar modelo de avaliações' esteja marcado:

Ao ser executado o processo atualizará os dados do anexo Avaliação AVA da etapa de Turma/Disciplina.

As notas serão inseridas nas etapas das disciplinas do TOTVS Educacional por meio do iPaaS. A plataforma AVA enviará os dados por meio de uma requisição para o iPaaS, que, por sua vez, acionará as APIs do TOTVS RM para realizar a inclusão das notas.

Dados que serão recebidos pela integração:

{
        "idUser": "ID do usuário do Portal Sesi" (string),
        "idTurma": "ID da Turma do Portal Sesi"(string),
        "tipoNota": "Tipo da Nota ('N' para Nota ou 'C' para conceitual)"(string),
        "turmaDisciplina": [
                {
                        "idTurmaDisc": Id. da Turma Disciplina no SGE (int),
                        "notasPorEtapa": [
                                {
                                        "idAvaliacaoAva": Id da Avaliação do AVA (int),
                                        "nota": Valor da nota (int),
										"conceito": Codigo do conceito (string)
                                },
                                {
                                        "idAvaliacaoAva": Id da Avaliação do AVA (int),
                                        "nota": Valor da nota (int),
										"conceito": Codigo do conceito (string)
                                },
                                {
                                        "idAvaliacaoAva": Id da Avaliação do AVA (int),
                                        "nota": Valor da nota (int),
										"conceito": Codigo do conceito (string)
                                },
                                {
                                        "idAvaliacaoAva": Id da Avaliação do AVA (int),
                                        "nota": Valor da nota (int),
										"conceito": Codigo do conceito (string)
                                },
                                {
                                        "idAvaliacaoAva": Id da Avaliação do AVA (int),
                                        "nota": Valor da nota (int),
										"conceito": Codigo do conceito (string)
                                }
                        ]
                }
        ]
}

Para que a integração ocorra corretamente as seguintes validações serão realizadas:

• Consultas SQL do projeto importadas no sistema.
• Coligada SESI preenchida nos parâmetros gerais da Gestão CNI.
• Aluno exportado com sucesso para o Portal Sesi Educação com as suas turmas e matrículas.
• Etapa da turma disciplina Permite digitação diretamente na etapa.
• Data para preenchimento da etapa na turma disciplina deve estar vigente.
• Caso o grupo de conceitos seja definido é necessário informar o conceito.

Para que não haja divergência entre os sistemas, não será permitido  alteração ou inclusão de notas para alunos em etapas vinculadas à Plataforma AVA SESI.

Ao acessar as telas de Notas e Faltas de Etapa e Digitação por Aluno, Se o usuário tentar modificar ou inserir uma nota para um aluno, será verificado se a etapa está vinculada à plataforma AVA SESI, o campo correspondente será desabilitado,  não sendo possível realizar nenhuma alteração ou inclusão e retornará uma mensagem informativa ao usuário.

As notas dos alunos que não tenham notas vinculadas a Plataforma AVA SESI podem ser alteradas/inseridas através das interfaces nativas do TOTVS Educacional nos menus Citados abaixo: 

TOTVS Educacional | Matrícula e Avaliação | Notas e Faltas de etapa

TOTVS Educacional | Matrícula e Avaliação | Mais | Digitação por aluno | Notas e Faltas de etapas

Portal do Professor:

• Portal do Professor | Diário de Classe | Selecionar a turma/disciplina | Notas e faltas de etapa

No Ao acessar o Portal do Professor não será permitido inserir notas para Etapa de Notas vinculada à Plataforma AVA, devendo ser inseridas exclusivamente por meio da Plataforma AVA.

Ao aplicar o filtro para a Etapa de Notas vinculada à Plataforma AVA, será exibida uma mensagem de aviso informando que as notas devem ser inseridas exclusivamente por meio da Plataforma AVA, o campo de notas dos alunos será automaticamente bloqueado de alterações na etapa selecionada conforme exemplo abaixo: 

O Monitor de Log registra informações sobre os dados exportados para a Integração AVA, incluindo detalhes sobre os dados enviados, recebidos, status e datas de processamento.

Os dados apresentados nesta interface serão armazenados em uma tabela personalizada por coligada.

Além disso, o Monitor de Log servirá como referência para os usuários identificarem casos que necessitem de reenvio de dados. 

A interface estará disponível em: TOTVS Educacional | Sistema Indústria | Integração AVA | Monitor de Log.

Na tela de log estarão disponíveis os seguintes campos:

• Id Log: Identificador sequencial de Log.
• Campos Chave: Descrição dos campos utilizados para gerar o registro integrado.
• Valores Chave: Chave primária do registro integrado.
• Status: Situação da Integração.
• Funcionalidade: Tipo de Processo que está sendo feito (Por exemplo: Importação de Notas).
• Data de Criação: Data de Criação do registro.
• Data da última alteração: Data da última alteração do registro.
• Número de tentativas de Reenvio: Quantidade de vezes que um registro já foi reenviado.
• Criador por: Usuário responsável pela inclusão do registro.
• Alterado Por: Usuário responsável pela alteração do registro.
• Módulo: Funcionalidades existentes no escopo.

Será apresentada ao usuário uma visão com relação a registros exportados. Não será possível incluir, editar ou excluir informações através dessa interface.



Ao acessar o anexo de um registro será possível o usuário visualizar todos os registros relacionados ao cadastro integrado selecionando a opção Item Log. 

Na tela de Item Log estarão disponíveis os seguintes campos:

• Id Log: Identificador sequencial de Log.
• Id Item Log: Identificador sequencial de Log Filho.
• Status: Situação da Integração (Sucesso ou Erro).
• Data de Criação: Data de Criação do registro.
• Data da última alteração: Data da última alteração do registro.
• Mensagem: Mensagem da integração.
• Dados Enviados: Dados que foram enviados para a integração.
• Dados Recebidos: Dados que foram recebidos da integração.