Objetivo

Este documento foi elaborado para informar aos usuários-chave da área Educacional do SENAI DN aplicados apenas para o Template Digital sobre as customizações contratadas.
Para isso, serão apresentados os requisitos referentes à customização.Será apresentada uma visão prática do processo e cadastros educacionais, explorando os conceitos utilizados e as funcionalidades do Sistema. O material orienta a execução das atividades para garantir que todo o Processo Educacional mapeado durante o Projeto seja contemplado.

Público Alvo

Este manual é destinado aos colaboradores selecionados como usuários-chave da área Educacional do SENAI DN aplicados apenas para o Template Digital.

Metodologia

Este material tem como base a visão prática e completa do Processo Customizado da área Educacional através da customização. A metodologia utilizada tem como ponto de partida o mapeamento completo do respectivo processo, relacionado com as interfaces no Sistema TOTVS Educacional. Sempre que houver alguma atividade a ser realizada no Sistema, as suas funcionalidades e rotinas serão explicadas com detalhe.

Síntese

Serão abordados os requisitos referentes às tratativas customizadas para possibilitar que o SENAI DN realize a 1° fase da pesquisa do SAPES para alunos e egressos através do módulo Avaliação e Pesquisa do TOTVS Educacional e que os dados sejam integrados com a plataforma SAPES para gestão das demais fases da pesquisa.

Parâmetros da Integração

Liberação dos anexos customizados na árvore de perfil

Para que os usuários tenham acesso a customização será necessário a liberação nas permissões de perfil dos usuários para que apareçam em seus respectivos lugares.
Acesso bloqueado Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddavd2f8f6fd2bc7cb53733d1c88956f3a37.png

Exemplo de perfil ainda sem liberação de acesso no Painel de Satisfação

Para permitir o acesso siga este caminho abaixo:
Serviços Globais >Segurança >Perfil >Selecione o Sistema: Educacional-Avaliação e Pesquisa >Acesso a menus > 05: Sistema Industria > Painel de Satisfação e permita o acesso ao menu Painel de Satisfação, conforme exemplo a abaixo:
Perfil liberado para o acesso no Painel de Satisfação conforme o perfil do usuário.. Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddavd8f5c7ac6c9344fa067913ba2ee55c11.png

Visualização da customização no módulo Avaliação e Pesquisa

Após a liberação no perfil do usuário, o mesmo poderá acessar o módulo Educacional >Avaliação e Pesquisa na aba Sistema Industria e os ícones customizados no agrupador Painel de Satisfação estarão liberados para acesso do mesmo, conforme imagem abaixo.
Acesso Liberado Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav454e3e67068fb76e8f126c566c759852.png

Na interface de Parâmetros Sapes o usuário deverá efetuar as seguintes parametrizações:

1.2.1 Aba Parâmetros de Web Service

Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav5c36ca04a5a8ca73caf676b6931c537a.png

Estes parâmetros deverão ser armazenados por Coligada.

Sigla Estado - DR: Lista dos estados do Brasil e a sigla CT (Cetiqt), onde o usuário selecionará Sigla do DR/Estado das matrículas, para enviar ao SAPES informações de alunos referente ao estado onde estão matriculados.

Endereço WebService: Parâmetro do tipo texto, neste parâmetro o usuário deverá informar o endereço de acesso ao WebService disponibilizado pelo SAPES para o regional do estado informado no parâmetro 'Sigla Estado - DR'.

Token acesso (Integração): Parâmetro do tipo texto, neste parâmetro o usuário deverá informar o valor fixo de acordo com cada Regional utilizado na autenticação da Integração com WebService do SAPES.

Número tentativas de reenvio: Parâmetro do tipo texto, neste parâmetro o usuário deverá informar o número máximo de tentativas que a customização deverá tentar realizar a integração com SAPES dos registros com status de erro para o regional do estado informado no parâmetro 'Sigla Estado - DR'

Somente será possível incluir uma parametrização por estado

1.2.2 Aba Modalidade de Cursos

Estes parâmetros deverão ser armazenados por Coligada. Nesta aba será exibida uma visão onde o usuário deverá informar a (s) Modalidades de Cursos, definidos por Coligada, para envio de dados ao SAPES. Ao clicar em incluir, será exibido o campo:

Modalidade: Neste parâmetro, o usuário deverá informar as modalidades que terão dados integrados ao SAPES, as mesmas poderão ser alteradas de acordo com a necessidade do SENAI

Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav33ab5d2363f60bb02aff4473e3314a5b.png

1.2.3 Aba Questões

Questão Empregado: Neste parâmetro o usuário deverá informar qual questão foi criada para que o aluno responda se está trabalhando atualmente.

Questão Situação Profissional: Neste parâmetro o usuário deverá informar qual questão foi criada para que o aluno responda qual a sua situação profissional.

Questão Outra Situação Profissional: Neste parâmetro o usuário deverá informar qual questão foi criada para que o aluno responda qual a sua situação profissional.

Questão Remuneração: Neste parâmetro o usuário deverá informar qual questão foi criada para que o aluno responda sua remuneração atual.

Satisfação: Neste parâmetro o usuário deverá informar qual questão foi criada para que o aluno responda o nível de satisfação com o SENAI.

Questão E-mail: Neste parâmetro o usuário deverá informar qual questão foi criada para que o aluno responda o seu e-mail.

Questão Telefone Residencial: Neste parâmetro o usuário deverá informar qual questão foi criada para que o aluno responda o seu telefone residencial.

Questão Telefone Celular: Neste parâmetro o usuário deverá informar qual questão foi criada para que o aluno responda o seu telefone celular.

Questão Telefone Recado: Neste parâmetro o usuário deverá informar qual questão foi criada para que o aluno responda o seu telefone para recado.

Questão Logradouro: Neste parâmetro o usuário deverá informar qual questão foi criada para que o aluno responda o logradouro (rua, avenida etc..) do seu endereço.

Questão Número: Neste parâmetro o usuário deverá informar qual questão foi criada para que o aluno responda o número do seu endereço.

Questão Complemento: Neste parâmetro o usuário deverá informar qual questão foi criada para que o aluno responda o complemento do seu endereço.

Questão Bairro: Neste parâmetro o usuário deverá informar qual questão foi criada para que o aluno responda o bairro do seu endereço.

Questão Cidade: Neste parâmetro o usuário deverá informar qual questão foi criada para que o aluno responda a cidade do seu endereço.

Questão UF: Neste parâmetro o usuário deverá informar qual questão foi criada para que o aluno responda o estado de seu endereço.

Questão Outro Estado: Neste parâmetro o usuário deverá informar qual questão foi criada para que o aluno responda o estado de seu endereço.
Questão CEP: Neste parâmetro, o usuário deverá informar qual questão foi criada para que o aluno responda o CEP do seu endereço.

Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav11f85e2e61f3306456946fc50719ab6b.png

Aviso
Todas as informações listadas acima serão utilizadas no envio de dados para o Sapes.
.

Cadastro Avaliação SAPES

No módulo educacional –Avaliação e Pesquisa será cadastrada a Avaliação referente a Pesquisa SAPES.
Para seguir o cadastro da avaliação cadastre:
A área de conhecimento da prova para definir áreas avaliadas, onde serão vinculadas as matérias e questões, para aplicação da pesquisa.
Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav93e86175d8828626255daa5e0e5fcba8.png
Informe o nome da área;
Clique em SALVAR

Informe Matéria
O cadastro de Matérias tem como objetivo definir as matérias da área, onde serão vinculadas as questões para aplicação de provas e/ou pesquisas.
Ao se incluir uma matéria deverá informar a qual área ela está vinculada, além de seu nome e sua descrição.

Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav1bd7bf93c5ffe21de9348acdf8939717.png
Informe o nome da Matéria;
Clique em SALVAR

Cadastre as Questões;
Por este menu é possível cadastrar as questões que serão utilizadas na confecção das "Avaliações de conhecimento" ou "Pesquisa de Opinião". Toda as questões estão vinculadas a matérias e áreas.
Assim o banco de questões poderá ser atualizado de acordo com as necessidades organizacionais e as questões cadastradas poderão ser utilizadas em inúmeras provas.
Na prova existe algumas configurações básicas e de execução da prova que são definidas para os dois tipos de prova como:
Informe na aba identificação da questão;
Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav98f6d66710b39bf1d0c9c3d13ff80aa5.png

Após preencher os dados necessários na aba "Identificação", deve-se selecionar a aba "Enunciado/Opções". Nesta aba, caso o usuário possua um texto pronto para utilizar como questão, é possível copiar e colar diretamente no campo "Enunciado".
Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav6f5f6a3e8f95e16aa133d89a81642934.png
Visão das questões já cadastradas;

Crie a prova;

Informe na aba identificação:
Tipo de Prova: Pesquisa de Opinião;
Nome da Prova/Pesquisa;
Marcar a flag Prova Ativa;
Marcar a flag Integração SAPES;
Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav2ca9f0ea24e894206ce1133d51dd7b75.png

Ao finalizar o preenchimento das informações acerca da Prova, o usuário deve adicionar as questões.
Caminho: Prova > Processos > Adicionar questões
Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav043c10d8f12f34529eaa25f1a693d770.png
Informe na aba identificação:

Área
Matéria

As questões relacionadas ao filtro informado apareceram na tela, neste momento selecionaremos as questões que serão vinculadas a prova.
Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddavdb063eb448618f9a3f387b12892565eb.png

Questões da Prova
No momento em que todas as questões estiverem vinculadas à prova, é necessário criar um período.
Caminho: Prova> Anexos > Período
Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddavbe2e9fb900dd90f2dea329f9be4c4ebe.png
O conceito de "Período" é importante, pois de acordo com a necessidade do usuário, a prova pode ser utilizada inúmeras vezes, sendo primordial estabelecer o tempo de usabilidade desta prova.
Informe na aba identificação:

O Nome
O Período

Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav2b4f18e48c46539066e8072a7a936301.png

3 Campo Integração SAPES no cadastro de Prova

Para facilitar o acompanhamento das provas que serão ou não consideradas no envio para o SAPES, foi criado a coluna Integração SAPES na visão: TOTVS Avaliação e Pesquisa | Cadastros | Provas. A coluna irá exibir o campo Integração SAPES e só estará disponível para visualização. A edição da informação será feita diretamente no campo disponível na tela de cadastro de provas.

Campo Integração SAPES no cadastro de Prova

Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav2ca9f0ea24e894206ce1133d51dd7b75.png
Para facilitar o acompanhamento das provas que serão ou não consideradas no envio para o SAPES, será criado a coluna Integração SAPES na visão: TOTVS Avaliação e Pesquisa | Cadastros | Provas.
A coluna irá exibir o campo Integração SAPES e só estará disponível para visualização. A edição da informação será feita diretamente no campo disponível na tela de cadastro de provas.
Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddavc1cc985191382fa3e7c5ad21bf401bdd.png

Importante: O campo não virá com preenchimento default. A parametrização será de responsabilidade do cliente.

3.1 Campo Integração SAPES no cadastro de Prova com a flag habilitada

A Flag habilitada conseguimos enviar a prova para o candidato conforme exemplo abaixo;
Caminho: Educacional> Aba Atividades Acadêmicas >Agrupador Acadêmico >Avaliação Institucional
Clicar em avançar Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav8cf9dca692be473af77bde84fd5fa837.png

Selecione o filtro;
Clicar em avançar
Escolha o filtro desejado;
Clicar para executar o filtro
Os alunos selecionados serão exibidos na tela
Clicar em avançar Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav698f6f694e6d080051efbca030b42bbc.png
Informe na tela abaixo:

Avaliação
Período
Objeto Avaliado

Clicar em imagem para adicionar a prova/pesquisa Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav71f70a92d2dfca88659b47bd00c0c7bb.png
Clicar em ExecutarA avaliação será exibida
O processo será executado;

Após a execução do processo o usuário visualizará a relação dos alunos/candidatos que estarão relacionados a pesquisa SAPES.
Caminho: TOTVS Avaliação e Pesquisa | Cadastros | Provas | Candidatos.
Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav30389ef1132f111163f1ecc7703e4c48.png

3.2 Campo Integração SAPES no cadastro de Prova com a flag desabilitada

Com a flag Integração SAPES desabilitada não será possível associar e enviar a avaliação aos candidatos/alunos conforme exemplo.
Flag desabilitada Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav630d9f73d9210c95b8dd6f8320bd4898.png
Não será possível prosseguir com a associação de alunos/candidatos para responder a pesquisa

4 Anexo Integração SAPES na tela de Candidato

Criação de anexo customizado no cadastro nativo de candidatos para que o usuário visualize a relação dos dados da pesquisa SAPES à matrícula do aluno.
Permitindo que o usuário visualize a relação dos dados da pesquisa SAPES à matrícula do aluno. O anexo estará disponível na interface nativa de candidatos, disponível no TOTVS Avaliação e Pesquisa | Cadastros | Provas | Candidatos.
Selecione o candidato e clique e anexo Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav86e8d2f88eed8274aacf8dd41fa5f5f1.png

O anexo será somente de visualização

E estará disponível para visualização do usuário as seguintes informações abaixo;
Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav47dc81f0b2cc9b4c353b35cc351f7e8a.png

4.1 Respondendo a Pesquisa On-line

Esse código de inscrição pode ser enviado através do e-mail de inscrição do candidato.
Para responder, o candidato deve informar o código de inscrição no campo "Digite o código de Execução" e clicar em "Entrar", em seguida, o questionário será exibido.
Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav48e75de606beef81d22bca3d0a12aefd.png

O candidato/aluno responderá a pesquisa

E finalizará a pesquisa

4.2 Atualização da tela de candidatos após responder a pesquisa on-line

Na tela de candidatos podemos verificar todos que responderão a pesquisa
No exemplo abaixo temos a candidata com a inscrição OF452FB664-Adriane Campos que consta na listagem de candidatos que ainda não responderam a pesquisa.
Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddavcfc2345ad746690d74daed89611407dc.png
Após execução da pesquisa on-line o nome não aparecerá mais como candidata.
O usuário poderá ver as informações no Ranking da Prova de todos os candidatos que já responderam a pesquisa on-line.
Na listagem não constará o nome do candidato que respondeu a pesquisa On-line Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav2b7254d0bba1c7fecf3847aaa37df766.png

5 Anexo Integração SAPES na tela de Ranking

O anexo customizado no cadastro nativo de Ranking para que o usuário visualize a relação dos dados da pesquisa SAPES à matrícula do aluno, dados que serão identificados no Dados da matrícula do candidato.

Foi criado o anexo Integração SAPES na tela nativa de candidatos, disponível no TOTVS Avaliação e Pesquisa | Cadastros | Provas | Ranking.

Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav0fd85cb7521a5d1120ebf475185250b0.png

O usuário visualizará a relação dos dados da pesquisa SAPES à matrícula do aluno disponível no TOTVS Avaliação e Pesquisa | Cadastros | Provas | Ranking | Anexos |Integração SAPES
Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav1d5f96e7adf2698cb266dbebf1c491a9.png

5.1 Anexo Integração SAPES na tela de Ranking antes da Exportação de Dados

NA tela não teremos as informações que foram exportadas.
Dados ainda não foram exportados, ficando vazio. Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav78baee64e307a7f2acd3e5cda7d1a12f.png

5.2 Anexo Integração SAPES na tela de Ranking após a Exportação de Dados

O usuário visualizará a relação dos dados da pesquisa SAPES à matrícula do aluno após a exportação de dados
Dados exportados Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddaved029f2fe590ea7f57be353bbfa60f5a.png

6 Dados da Matricula do candidato

Identificando os dados filtrados pelo usuário na tela de execução do processo nativo de associação de Avaliação Institucional e gravar as informações em tabela customizada para relacionar os dados de matrícula do aluno que a pesquisa da 1° fase do SAPES foi enviada.
No exemplo abaixo temos o cadastro da aluna com a aba e-mail e endereço em branco antes de responder a pesquisa.

Aluna com E-mail e Endereço não informados. Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav6f2ec88da7b9bb4b0b4f6be058482758.png

Atualização no cadastro do aluno no TOTVS Educacional considerando as perguntas respondidas.
E-mail e Endereço atualizado Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav39a0e44f1240d8ba26c7da1087b887ec.png

7 Exportação de Pesquisas para o SAPES

Foi criado um processo customizado, para ser executado manualmente ou de forma automática pelo usuário, para que seja enviada uma lista de dados com as matrículas dos alunos que responderam a pesquisa enviada da 1° fase do SAPES e atualizado o cadastro de pessoa do aluno (PPESSOA) no TOTVS Educacional, conforme vimos no item anterior 6 deste manual.
Disponibilizado em: TOTVS Avaliação e Pesquisa | Customizações | Integração Sapes | Exportação de Dados
Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav454e3e67068fb76e8f126c566c759852.png
Ao clicamos no ícone Exportação de Pesquisa abrirá a tela de execução de processo

Ao executar o processo, a customização irá:
Identificar Pesquisa SAPES Respondidas: A customização irá validar se possui alguma pesquisa com o campo Integração SAPES preenchido (Req.02 - Campo Integração SAPES no cadastro de Prova), se o curso vinculado à pesquisa possui a modalidade informada na aba 'Modalidade de Cursos' (Req.01 - Parâmetros) e se para essas pesquisas já existem respostas .Caso afirmativo, seguirá os passos abaixo.
Gravar dados de matrícula em anexo customizado: A customização irá exibir os dados da relação de matrícula dos alunos encontrados no Req. 05 – Dados da matrícula do candidato, para que o usuário possa visualizar através do anexo Req. 04 – Anexo Integração SAPES na tela de Ranking.
Exportar dados para o SAPES: A customização irá identificar o estado do endereço dos alunos que responderam à pesquisa SAPES Após o estado localizado, será identificado o endereço de WebService e Token parametrizados para aquele determinado estado (Req.01 - Parâmetros) e através de chamada de WebService Sapes, será enviado as informações abaixo
Será criado pelo SAPES um novo método que será chamado pela customização para exportação dos dados. Não haverá campos obrigatórios para envio, caso o aluno não responda alguma pergunta, a customização irá enviar o campo em branco e será necessário que o SAPES esteja preparado para receber.
Gravar LOG de Processamento: Ao final do processamento, os registros serão gravados no monitor de Log - Integração SAPES (Req. 07 – Monitor de Log). A interface de log poderá ser visualizada no menu TOTVS Avaliação e Pesquisa | Customização | Integração SAPES| Monitor de Log. Se alguma atualização nos dados já enviados ocorrer após o envio, estes dados serão atualizados no Webservice SAPES através desse mesmo processo. O envio dos dados atualizados seguirá a mesma regra dos processos customizados de exportação descritos acima, o processo de atualização irá consumir o mesmo método de Webservice do Sapes, enviando o registro novamente com os dados atualizados.

8 Monitor de Log

A interface de Monitor de Log. o usuário poderá consultar os logs das operações de exportação executadas pela integração do TOTVS Avaliação e Pesquisa com o SAPES. Será utilizada a funcionalidade de log genérico padrão. Os históricos das exportações de dados para o SAPES serão registrados e poderão ser visualizadas no menu TOTVS Avaliação e Pesquisa | Customização | Integração SAPES | Monitor de Log.
Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav67938a25ad9768c9829da461a3a11d2d.png
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).
Módulo: Tipo da integração que está sendo feita.
Data de Criação: Data de Criação do registro.
Data da última alteração: Data da última alteração do registro.

Será apresentado ao usuário uma visão com relação dos registros exportados. Não será possível incluir, editar ou excluir informações através dessa interface.
Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav47dd59435e876e50917f81fce747f081.png

O campo processo será exibido de acordo com o respectivo código: ~

Exportação de Dados – Pesquisa

Exportação de Dados - Respostas

Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav8c319d931fbbd27683b73a7d2bc75027.png

8.1 Item do 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. Estarão disponíveis os seguintes campos:

Id. Item Log: Identificador sequencial de log.
Id. Log: Identificador sequencial de log.
Mensagem: Mensagem com o status da integração do item.
Status: Situação da integração do item selecionado.
Dados Enviados: Relação dos dados enviados para integração.
Dados Recebidos: Relação dos dados recebidos.
Data de Criação: Data de criação do registro.
Data da última Alteração: Data da última alteração do registro.

Fábrica de Software TOTVS BH > Manual Operacional da Customização - Painel de Satisfação > worddav46011fa94aedf829be9371fd8cd22270.png