Manual Operacional da Customização - Integração UniSENAI

O SENAI Paraná assumirá os cursos de Graduação que antes eram oferecidos pelo IEL. Para facilitar a divulgação e seleção dos cursos, eles desenvolveram uma página WEB com todas as ofertas disponíveis. Agora, o próximo passo é integrar esta página com o ACE , CRM e processo seletivo no SGE.

Cada curso na página WEB será representado por um Card, e cada Card corresponderá a uma Área de Interesse no processo seletivo criado no SGE. A responsabilidade pela criação dos cursos na página WEB e também pela elaboração do processo seletivo no SGE será da FIEP.

Essa integração entre os sistemas permitirá que os candidatos tenham acesso às informações dos cursos e possam se inscrever diretamente na página WEB. 

Fluxograma

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.

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.

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.

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

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

Os arquivos enviados também pode ser vinculados (automaticamente pelo nome ou manualmente) no Anexo Documentação do Candidato.

O nome do arquivo segue o seguinte padrão: Nome Documento + ¶ + CodColigada-IDPS-NumeroInscricao-CodDocumento + extensão do arquivo.

Exemplo: CPF_DO_ALUNO¶3-5181-26-2.JPG

Desta forma, é possível visualizar o vínculo do arquivo enviado no Anexo de Documentos do candidato:

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

Pré-requisitos

Candidatos inscritos pela API e enviados para o ACE através do processo Enviar Candidatos Classificados para o ACE.

Detalhamento do processo

Foi criado um novo campo de status na visão nativa de Candidatos Inscritos disponível em: TOTVS Educacional |Processo Seletivo |Anexos |Candidatos Inscritos|, para o usuário visualizar o status de integração do envio de candidatos para o ACE.

Para preenchimento do novo campo status, a customização deverá consultar o status da integração de envio do candidato para o ACE através da tabela de controle do mesmo, exibindo o status dos candidatos classificados enviados para o ACE.

A exibição do campo será do tipo farol com os seguintes detalhes:

• Status Integração ACE: preenchido pela integração com seguintes valores: 
• Farol Branco/Cinza: Não integrado. (Inscrições ainda não enviadas para o ACE ou que não foram realizadas pela API)
• Farol Verde: Integrado com sucesso. (Inscrições enviadas para o ACE com sucesso)
• Farol Vermelho: Erro na integração. Para mais informações consulte o log. (Inscrições enviadas para o ACE que retornou algum erro)
• Farol Azul: Pendente. (Registro criado pela API que ainda não foi enviado para o ACE)

O campo não será exibido na interface de edição dos candidatos inscritos.

Para que o usuário possa visualizar os registros com status de erro, é necessário que ele acesse a interface do monitor de logs. Não ficará visível nesta interface.

Descrição do Processo

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

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.