Projeto: FS008986 - INTEGRAÇÃO UNISENAI

Nome do cliente: FIEP


Objetivo

O objetivo deste manual é descrever as funcionalidades desenvolvidas para possibilitar a Integração do TOTVS Educacional (SGE) x UniSENAI.


Público Alvo
Este manual é destinado aos colaboradores selecionados como multiplicadores e usuários chave para o Programa SGE.


Pré-requisitos

Devem ser liberadas nas permissões de perfil dos usuários, os menus da customização Integração UNISENAI.

Disponível em: Serviços Globais | Perfil | Educacional | Customização | UNISENAI


Para mais detalhes de como liberar no perfil dos usuários, acesse o Manual de Instalação de Customizações na seção Liberando Acesso aos Menus.

Detalhamento do processo

O objetivo deste processo é detalhar como o TOTVS Educacional (SGE) realizará a integração com a UNISENAI de acordo com os Dados de Integração.

Para isso foi criada uma parametrização onde o usuário definirá os valores utilizados pela integração; A interface customizada estará disponível em: TOTVS Educacional | Customizações | UNISENAI| Parâmetros.



Ao clicar no menu de acesso será aberta a tela de parâmetros que possui as abas Dados de Integração, Status de Classificação SGE e Status de Classificação CRM. 



Na Aba Dados de Integração, deve ser informado os dados:

  • Endereço Webservice: Neste parâmetro o usuário deverá informar o endereço de acesso ao Webservice ACE.
  • Usuário: Neste parâmetro o usuário deverá informar usuário de acesso ao Webservice ACE.
  • Senha: Neste parâmetro o usuário deverá informar a senha de acesso ao Webservice ACE.



Na Aba Status de Classificação SGE, deve ser informado os dados:

  • Status Aprovado (Engajar): Neste parâmetro o usuário deverá informar os status da opção no processo seletivo (TOTVS Educacional > Processo Seletivo > Tabelas Auxiliares > Status da Opção), que indique que o candidato foi aprovado na seleção da classificação, como por exemplo: Classificado para chamada, Em chamada, dentre outros.
  • Status Ausente (Retornar): Neste parâmetro o usuário deverá informar os status da opção no processo seletivo (TOTVS Educacional > Processo Seletivo > Tabelas Auxiliares > Status da Opção), que indique que o candidato foi reprovado na seleção da classificação, como por exemplo: Desclassificado por insuficiência de nota, Desclassificado por entrevista, dentre outros.
  • Status Reprovado (Sem êxito): Neste parâmetro o usuário deverá informar os status da opção no processo seletivo (TOTVS Educacional > Processo Seletivo > Tabelas Auxiliares > Status da Opção), que indique que o candidato esteve ausente na seleção da classificação, como por exemplo: Ausente, Não compareceu à chamada, dentre outros.


Os campos para informar os status de classificação do SGE deverão ser parametrizados para cada Filial que deseja utilizar o processo de envio dos alunos classificados para o ACE.



Na Aba Status de Classificação CRM, deve ser informado os dados:

  • Código CRM (Apto para matricular): Neste parâmetro o usuário deverá informar o código do CRM, que indique que o candidato foi aprovado na seleção da classificação, como por exemplo: 887.330.001.
  • Código CRM (Sem êxito): Neste parâmetro o usuário deverá informar o código do CRM,  que indique que o candidato foi reprovado na seleção da classificação, como por exemplo: 186.580.001.
  • Código CRM (Retornar): Neste parâmetro o usuário deverá informar o código do CRM, que indique que o candidato esteve ausente na seleção da classificação, como por exemplo: 887.330.002.


Os campos para informar os status de classificação do CRM deverão ser parametrizados para cada Coligada que deseja utilizar o processo de envio dos alunos classificados para o ACE.

Pré-requisitos

Processo Seletivo criado e configurado para aceitar inscrições de candidatos vindos do UNISENAI.


Detalhamento do processo

O objetivo deste processo é disponibilizar uma API do TOTVS Educacional (SGE), para realizar a inscrição dos candidatos no processo seletivo nativo. Os campos definidos na parametrização do processo seletivo deverão ser enviados pelo ACE, incluindo os documentos do candidato no SGE. 

O ACE deverá chamar a nova API do SGE, toda vez que ocorrer uma inscrição na página WEB do SENAI (loja), para que as informações dos candidatos e inscrições sejam armazenadas no SGE.

Ao receber os dados, a API irá realizar as seguintes operações no SGE:

  • Cadastrar o candidato/usuário 

Será criado o cadastro de usuário do candidato (SPSUSUARIO) no TOTVS Educacional | Processo Seletivo para obter o Cód. Usuário PS. Caso o usuário não exista, a customização executará a funcionalidade padrão para inclusão de candidatos. O usuário ficará disponível no Menu: TOTVS Educacional |Processo Seletivo | Cadastros | Usuário.



Para validar se o usuário do candidato já existe no SGE será utilizado somente o valor informado no campo CPF, caso a customização encontre um registro com o CPF informado ela retornará o Cód. Usuário PS (CODUSUARIOPS) para prosseguir com a inscrição no processo seletivo.


  • Inscrever candidato na área ofertada do Processo Seletivo

O candidato cadastrado será vinculado no Processo Seletivo informado, preenchendo os dados informados na API para a identificação do processo seletivo (Coligada, Filial, Id do Processo Seletivo, Id da Área de Interesse, Id da Forma de Inscrição). A inscrição poderá ser visualizada no menu Processo Seletivo | Anexo | Candidatos Inscritos).



Os controles de quantidade de candidatos inscritos, quantidade máxima de inscrições e inscrição já realizada serão realizadas pelas regras nativas do SGE da mesma forma que todas as outras validações



  • Fazer Upload de Arquivos do Candidato

Poderão ser enviados arquivos do candidato relacionados às inscrições, que serão salvos no anexo de documentação do candidato no processo seletivo, menu Processo Seletivo | Anexo | Candidatos Inscritos | Anexos | Arquivos do Candidato. A API irá realizar as validações nativas nos arquivos enviados incluindo as configurações de tamanho e quantidade definidas no cadastro do processo seletivo.



Não está previsto neste escopo a integração de documentos com a Secretaria Digital (GED).


A documentação técnica da API está disponível no TDN.

Descrição do Processo

Este requisito detalha a funcionalidade de Monitor de Logs da Integração.

Detalhamento do processo

Nesta interface o usuário poderá consultar os LOGs das operações de exportação executadas pela integração do TOTVS Educacional com o ACE.
Os históricos das exportações de dados para o Moodle serão registrados e poderão ser visualizadas no menu TOTVS Educacional | Customização | UniSENAI | Monitor de Log.

Serão criadas novas funcionalidades no Monitor, são elas:

  1. Inscrição do Candidato no Processo Seletivo
  2. Envio de Candidato Classificado para o ACE

Será apresentada ao usuário uma visão com a relação de registros importados e exportados.

  • Id Log: Identificador sequencial de Log.
  • Data de Criação: Data de Criação do registro.
  • Data da última alteração: Data da última alteração do registro.
  • Status: Situação da Integração (Sucesso ou Erro).
  • Id. Job: Ultimo job executado que resulto criação ou alteração do log.
  • Descrição do módulo: Descrição que permite identificar o módulo.
  • Cód. Filial: Código da Filial associada ao registro.
  • Funcionalidade: Tipo de Processo que está sendo feito (Por exemplo: Exportação Moodle).
  • Campos Chave: Descrição dos campos utilizados para gerar o registro integrado.
  • Valores Chave: Chave primária do registro integrado.
  • Última mensagem do item de log: Ultima mensagem do item do log.
  • Download de arquivos associados: Permitirá o download de arquivo associado ao logo caso exista.

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.

Não será possível incluir, editar ou excluir informações através dessa interface.

Caso o Json enviado tenha mais do que 1000 caracteres totais, os dados recebidos serão gravados como arquivo no banco de dados e poderão ser acessados através do botão "Download de arquivos associados".