Projeto: FS009282 - Integração AVA SESI
Nome do Cliente: Confederação Nacional da Indústria - SESI
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
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:
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"
Script de Inserção de Atividades
Script - cadastro inicial
Conforme citado na Observação II, será criado um script para cadastrar previamente as avaliações AVA. Essas informações de cadastro serão definidas Pelo SESI DN. O script criado será o InsertAvaliacoes que fará o cadastro inicial das atividades listadas abaixo na visão de parâmetros:
O script com o cadastro inicial, não impede que o usuário que tenha permissão de acesso possa incluir e/ou excluir um registro.
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.
Para que a integração funcione corretamente, é necessário importar no TOTVS RM as consultas SQL disponíveis no pacote de instalação.
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:
Para que as notas sejam inseridas corretamente, os dados do aluno e da turma devem ser exportados corretamente para o Portal SESI Educação, que encaminhará as informações à Plataforma AVA para o envio das notas posteriormente.
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:
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:
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: