Projeto: FS009282 - Integração AVA SESI - Desenvolvimento
Nome do Cliente: Confederação Nacional da Indústria - SESI
...
Expandir | ||
---|---|---|
| ||
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. 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 pacote Integração AVA do iPaaS. |
Expandir | ||
---|---|---|
| ||
O fluxo abaixo segue a regra geral do da integração. | ||
Expandir | ||
: | title | Configurações
Expandir | ||||
---|---|---|---|---|
| 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. Expandir | | |||
| ||||
Expandir | ||||
| ||||
Expandir | ||||
|
Informações |
---|
|
Informações | ||||
---|---|---|---|---|
| ||||
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. |
title | Campo 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.
Menu: TOTVS Educacional |Currículo e Oferta| Parametrizações por Curso| Anexos | Modelo de etapas da Matriz Aplicada.
Informações |
---|
|
title | Anexo 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
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.
title | Processo 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"
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.
Informações |
---|
|
title | Importaçã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. |
title | Plugin 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
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:Informações |
---|
|
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
Expandir | |||||||||
---|---|---|---|---|---|---|---|---|---|
| |||||||||
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"
|
Expandir | ||
---|---|---|
| ||
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.
|
Expandir | ||
---|---|---|
| ||
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. |
Expandir | ||
---|---|---|
| ||
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.
|
Expandir | ||||||
---|---|---|---|---|---|---|
| ||||||
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:
Para que a integração ocorra corretamente as seguintes validações serão realizadas:
|
Expandir | ||
---|---|---|
| ||
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
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:
|
Expandir | ||
---|---|---|
| ||
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. Na tela de Item Log estarão disponíveis os seguintes campos:
|
Expandir | ||
---|---|---|
| ||
HTML | ||
---|---|---|
<style>
.expand-control {
cursor: pointer;
text-decoration: none;
margin-bottom: 10px;
background-color: #ededed;
height: 30px;
font-size: 14px;
padding: 5px;
}
.expand-control-text {
vertical-align: top;
font-weight: bold;
color: #242424;
}
.post {
background-color: #378000;
color: #ffffff;
display: inline-block;
padding: 5px;
border-radius: 5px;
font-weight: bold;
}
.get {
background-color: #004fd6;
color: #ffffff;
display: inline-block;
padding: 5px;
border-radius: 5px;
font-weight: bold;
}
.put {
background-color: #ffa200;
color: #ffffff;
display: inline-block;
padding: 5px;
border-radius: 5px;
font-weight: bold;
}
.delete {
background-color: #cf0000;
color: #ffffff;
display: inline-block;
padding: 5px;
border-radius: 5px;
font-weight: bold;
}
.endereco{
display: inline-block;
padding: 5px;
font-weight: bold;
}
</style>
<!--
EXEMPLO DE MARCAÇÃO PARA TIPO DE REQUEST:
<div class="post">POST</div>
<div class="get">GET</div>
<div class="put">PUT</div>
<div class="delete">DELETE</div>
O ENDEREÇO DEVE SER INSERIDO COM A SEGUINTE MARCAÇÃO:
<div class="endereco">/rm/api/TOTVSCustomizacao/CstIntegracaoProtheus/ItemContabil</div>
--> | ||
Expandir | ||
| ||
Expandir | ||
title | FAQ