Páginas filhas
  • Manual - Integração SGE x Conciliador iPaaS - SESI

Versões comparadas

Chave

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

...

Expandir
titleMacro Fluxo

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



Expandir
titleConfigurações
Expandir
titleConsultas SQL

Para que a integração através do iPaaS ocorra, foram criadas consultas SQL e disponibilizadas dentro do Instalador WIN do projeto.

As consultas disponibilizadas dentro do instalador WIN, deverão ser importadas e configuradas pelo usuário conforme gif abaixo.

Image Removed

Expandir
titleConfigurações - Portal do Professor

Para que a customização do Portal do Professor esteja ativa, é necessário realizar a configuração adequada do arquivo config, permitindo que o Portal saiba onde buscar as personalizações.

Para configurar o arquivo config, acesse o diretório do Portal do Professor e em seguida, abra o arquivo config.json que se encontra na pasta config.

Image Removed

Após abrir o arquivo, adicione a propriedade patchCustomization, nesta propriedade vão constar o local onde está a customização e qual o nome da mesma.
Modelo de customização:
"patchCustomization": [
    {
      "pathName": "/customizacao/PortalDoProfessorIntegracaoAVA",
      "remoteName": "PortalDoProfessorIntegracaoAVA"
    }
  ]

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

Image Removed

Sem estes  ajustes o Portal do Professor não conseguirá a utilizar a Customização.

Expandir
titleParâmetros
Expandir
titleCadastro Avaliações

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

Image Removed

  • 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

Image Removed

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" 

 Image Removed
  • 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.
Informações
  • 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.
Informações
iconfalse
titleScript 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:

Image Removed

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.

Expandir
titleCampo Avaliação AVA - Modelo de Etapas SGE

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 drop down, 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.

Image Removed

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

Informações
  • Para o correto funcionamento da funcionalidade, as etapas devem estar relacionadas às Avaliações AVA corretamente.
  • Todas as avaliações devem estar 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.
Expandir
titleAnexo Avaliação AVA - Turma/disciplina

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

Image Removed

Image Removed

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.

Expandir
titleProcesso Atualizar 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"

Image Removed

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

Image Removed

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

Informações
  • 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.
Expandir
titleImportação de Notas - Via iPaaS

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.

Aviso

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.

Expandir
titlePlugin de Validação / Bloqueio - Notas/Etapas vinculadas a Plataforma AVA

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

Image Removed

Image RemovedPortal 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: 
Image Removed
Informações
  • 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.
Expandir
titleMonitor de Log

Pré-requisitos:

Liberar a permissão do perfil de usuário, no Monitor de Log (Conciliador), conforme caminho Sistema: Educacional | Sistema Indústria | Integradores | Conciliador | Monitor de Log:


Image Added


O Monitor de Log registra informações sobre os dados exportados para a Integração AVA, o barramento SESI por meio do iPaaS incluindo detalhes sobre os dados Dados enviados, Dados recebidos, status Status e datas Datas de processamento, para gestão e ação na correção dos incidentes.

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

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

Image Added

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

  • Id Log:  Identificador sequencial de Log.
  • Campos Chave: Descrição Descrição dos campos utilizados para gerar o registro integrado.
  • Valores Chave: 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 Data de Criação do registro.
  • Data da última alteração: Data Data da última alteração do registro.
  • Número de tentativas de Reenvio: Quantidade Quantidade de vezes que um registro já foi reenviado.
  • Criador por: Usuário Usuário responsável pela inclusão do registro.
  • Alterado Por: Usuário Usuário responsável pela alteração do registro.
  • Módulo: Funcionalidades 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.

Image Added

Na tela de log, ao acessar um registro, será possível Image Removed
Cada Funcionalidade, traz as informações de Log:
Image Removed
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.  
Image Removed
Na tela de log estarão Estarão disponíveis os seguintes campos:

  • Id. Item Log:  Identificador sequencial de Loglog.
  • Campos Chave: Descrição dos campos utilizados para gerar o registro integrado.
  • Id. Log: Identificador sequencial de log.
  • Mensagem: Mensagem com o status da integração do itemValores Chave: Chave primária do registro integrado.
  • Status:  Situação da Integração (Sucesso ou Erro). Situação da integração do item selecionado.
  • Dados Enviados: Relação dos dados enviados para integração.
  • Dados Recebidos: Relação dos dados recebidosFuncionalidade: Tipo de Processo que está sendo feito (Por exemplo: Exportação de Dados).
  • Data de Criação: Data   Data de Criação criação do registro.
  • Data da última alteraçãoAlteração:  Data 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.
Image Removed

Image Added


Informações

Para informações sobre Alteração Status Logs com Erro e o processo de Exclusão de Logs no monitor, acesse o Manual Operacional da Customização - LIB DN








Expandir
titleFAQ