Páginas filhas
  • Manual - Integração AVA

Versões comparadas

Chave

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

...

Expandir
titlePré-Requisitos



Aviso
titleAtenção

Para que a customização funcione corretamente, é essencial que todos os pré-requisitos listados abaixo sejam atendidos.


Configurações iPaaS

As configurações do ambiente iPaaS devem ser realizadas seguindo os passos descritos na documentação iPaaS - Configurações de ambiente e conta.

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

Configurações - Instalação 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.


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:

Bloco de código
"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".

Aviso
titleAtenção

Sem esses ajustes, o essas configurações, a customização no Portal do Professor não conseguirá a utilizar a Customizaçãofuncionará corretamente.

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


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


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:

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 downDropDown, 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. 

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

Dados da 




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
titleMonitor de Log

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.
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 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 Importação de DadosNotas).
  • 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.
Image Removed
Cada Funcionalidade, traz as informações de Log:
Image Removed
Image Added


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 AddedImage Removed


Na tela de log Item 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 integradoId Item Log: Identificador sequencial de Log Filho.
  • 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.
  • Mensagem: Mensagem da integração.
  • Dados Enviados: Dados que foram enviados para a integração.
  • Dados Recebidos: Dados que foram recebidos da integração.

Image AddedImage Removed


Expandir
titleFAQ


...