Projeto:  FS009282  - Integração AVA SESI - Desenvolvimento

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 garantir uma integração eficiente, será estabelecida uma conexão entre o sistema TOTVS Educacional - SGE e o sistema AVA SESI.

A integração ocorrerá no momento de:

Importação de Dados do AVA SESI para o SGE:

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 desenvolvimento de diagramas via TOTVS iPaaS.

O fluxo abaixo segue a regra geral do integração.



Foram criadas Consultas SQL para que a integração busque os dados customizados e permitir a integração ser realizada através do iPaaS.

As consultas são disponibilizadas dentro do Instalador Win do projeto, e cabe ao usuário importa-las no RM com as devidas configurações conforme gif abaixo.

Para que a Customização do Portal do Professor esteja ativa, é necessário configurar para que o Portal do Professor saiba aonde deve procurar pela customização.
Abra o diretório do Portal do Professor e abra o arquivo config.json que se encontra na pasta config.


Neste arquivo é necessário adicionar a propriedade patchCustomization, esta propriedade recebe um ou mais objetos que informam onde está a customização e qual o nome da mesma.
Modelo de customização:
"patchCustomization": [
    {
      "pathName": "/customizacao/PortalDoProfessorIntegracaoAVA",
      "remoteName": "PortalDoProfessorIntegracaoAVA"
    }
  ]


Onde a propriedade pathName é o nome da pasta onde a customização está instalada "/customizacao/PortalDoProfessorIntegracaoAVA" e remoteName é o nome do projeto da customização "PortalDoProfessorIntegracaoAVA".


Estes ajustes são necessários para que o Portal do Professor passe a utilizar a Customização.

A Integração AVA foi desenvolvida com parâmetros customizados para o registro de informações de dados provenientes do AVA para o SGE.

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


  • Cadastro Avaliações

Nesta tela estão os dados das Avaliações cadastradas.

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

Campos a serem preenchidos:

  • Id da avaliação AVA;
  • Descrição da Avaliação AVA;



  • Qualquer edição nos parâmetros de avaliação só será permitido se aquele determinado registro não estiver vinculado a nenhuma etapa que esteja com notas lançadas. Caso alguma nota esteja lançada, retornará uma mensagem de erro.



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


  • Este cadastro deve considerar todas as Avaliações (Etapas) da plataforma AVA.
  • Para o correto funcionamento da customização, todos os dados deverão estar parametrizados corretamente.

O script InsertAvaliacoes faz o cadastro inicial das atividades a seguir 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 para incluir e/ou excluir um registro.

Ao cadastrar uma Etapa, será necessário informar a qual Avaliação AVA ela estará vinculada. Para isso, na tela inicial do cadastro, terá um novo campo para incluir essa informação.



O campo será do tipo drop down, onde estará listado as Avaliações cadastradas no parâmetro (HU.01 deste documento) 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.


  • Para o correto funcionamento da customização, as etapas devem estar relacionadas às Avaliações AVA, corretamente.
  • Todas as avaliações cadastradas na plataforma AVA (Avaliações presenciais, avaliações processuais, participação e scorms, em processo e nota final).
  • Demais funcionalidades do Cadastro de Etapas permanecem inalteradas.

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

1 - Acessar o menu TOTVS Educacional |Currículo e Oferta| Turmas/Disciplinas | anexo Etapas;




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.

Após o preenchimento 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" da parametrização por curso. Para isso o usuário deverá realizar o seguinte procedimento:

1 - Acessar o menu TOTVS Educacional |Currículo e Oferta| Parametrizações por Curso;

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



Para que as avaliações sejam replicadas corretamente, é pré requisito 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.


  • Para o correto funcionamento da customização, os modelos das etapas devem estar relacionadas às Avaliações AVA, corretamente.
  • Demais funcionalidades do Cadastro de Etapas permanecem inalteradas.

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


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.

Ao acessar as telas: 

  • Matrícula e Avaliação > Notas e Faltas de Etapa
  • Matrícula e Avaliação > Mais > Digitação por aluno > Notas e Faltas de Etapas

É chamado o plugin para bloquear a alteração ou inclusão de notas para alunos em etapas vinculadas à Plataforma AVA SESI, garantindo que não haja divergência entre os sistemas

Quando o usuário tentar alterar ou inserir uma nota para um aluno, o sistema validará se a etapa está vinculada à plataforma AVA. Se a etapa for vinculada à plataforma AVA, o campo correspondente à nota será desabilitado, impedindo qualquer alteração ou inclusão.





Ao acessar o Portal do Professor:

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

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.

Com essa restrição, o campo de notas dos alunos será automaticamente bloqueado de alterações na etapa selecionada:



  • Para o correto funcionamento da customização, as etapas devem estar relacionadas às Avaliações AVA, corretamente.
  • Turmas/disciplinas não vinculadas à Avaliação AVA: Para turmas/disciplinas que não estão vinculadas a uma avaliação AVA, as regras de bloqueio não se aplicam. Nessas turmas, as funcionalidades de alteração de notas continuam funcionando normalmente, sem nenhuma modificação.

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 pode está 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 (Sucesso ou Erro).
  • Funcionalidade: Tipo de Processo que está sendo feito (Por exemplo: Exportação de Dados).
  • 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.



Cada Funcionalidade, traz as informações de Log:


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 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 (Sucesso ou Erro).
  • Funcionalidade: Tipo de Processo que está sendo feito (Por exemplo: Exportação de Dados).
  • 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.