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

Versões comparadas

Chave

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

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

Nome do Cliente: Confederação Nacional da Indústria - SESI

...

Expandir
titleSíntese

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 eficienteisso, será estabelecida feita uma conexão entre o sistema 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:

, 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 desenvolvimento de diagramas via TOTVS pacote Integração AVA do iPaaS.

Expandir
titleMacro Fluxo

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

Aviso

O fluxo acima pode divergir devido as customizações financeiras específicas de cada regional.

da integração:

Image Added



Expandir
titlePré-Requisitos

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

Expandir
titleParâmetros
Expandir
titleCadastro Avaliações

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

registros está disponível em: TOTVS Educacional | Sistema Indústria | Integração AVA| Cadastro Avaliações

Image Modified


  • Cadastro Avaliações

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

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

deve

deverá ser feita na árvore de Perfil no

módulo

Módulo Serviços Globais.

Campos a

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
;
  • Descrição da Avaliação AVA;
  • Image Removed
    • - Campo Identificador onde será possível informar o Código identificador da Avaliação

    Image Added

    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 Added

    • 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

    faz

    que fará o cadastro inicial das atividades

    a seguir

    listadas abaixo na visão de parâmetros

    ,

    :

    Image Modified

    O script com o cadastro inicial, não impede que o usuário que tenha permissão de acesso

    para

    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á necessário apresentado o novo campo para 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.
    Image Removed 

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

    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 customizaçãofuncionalidade, 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 anexo 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.

    1 - Acessar o menu TOTVS Educacional | Currículo e Oferta | Turmas/Disciplinas | anexo Etapas; 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
    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 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:
    utilizando a funcionalidade Parametrização por curso que poderá ser acessado através do Menu:

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

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



    Para que as avaliações sejam replicadas corretamente, é pré requisito 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
    • 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
    titlePlugin Importação de Validação / Bloqueio - Notas/Etapas vinculadas a Plataforma AVANotas - 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 do TOTVS RM para realizar a inclusão das notas.

    Aviso

    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:

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

    • Consultas SQL do projeto importadas no sistema.
    • Coligada SESI preenchida nos parâmetros gerais da Gestão CNI.
    • Aluno exportado com sucesso para o Portal Sesi Educação com as suas turmas e matrículas.
    • Etapa da turma disciplina Permite digitação diretamente na etapa.
    • Data para preenchimento da etapa na turma disciplina deve estar vigente.
    • Caso o grupo de conceitos seja definido é necessário informar o conceito.


    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

    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
    .

    Ao acessar as telas de Notas e Faltas de Etapa e Digitação por Aluno, Se Quando o usuário tentar alterar modificar ou inserir uma nota para um aluno, o sistema validará será verificado se a etapa está vinculada à plataforma AVA . Se a etapa for vinculada à plataforma AVASESI, o campo correspondente à nota será desabilitado, impedindo qualquer  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:

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

    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

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

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

    Image Added


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

    • Id Log: Identificador sequencial de Log.
    • Id Item Log: Identificador sequencial de Log Filho.
    • Status: Situação da Integração (Sucesso ou Erro).
    • Data de Criação: Data de Criação do registro.
    • Data da última alteração: Data da última alteração do registro.
    • 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 Added


    Expandir
    titleFAQ


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