O manual a seguir visa tem como objetivo detalhar as customizações realizadas feitas neste projeto para realizar a exportação de Alunos dados de usuários do SGE para o SapesIdentity Provider Nacional.
Expandir | ||
---|---|---|
| ||
Pré-Requisitos / ParametrizaçõesNo TOTVS Serviços Globais, por meio do menu Customização | Controle de customizações ativas, verificar se a customização Lib CNI e Integração Identity Provider está ativada. Image Added Descrição do Processo Esta tela permitirá o cadastro dos parâmetros necessários para efetuar a integração com Identity Provider. No TOTVS Educacional, por meio do menu Req. 01 – Parâmetros da Integração Objetivo do Requisito Foi criado uma nova interface de parâmetros para identificar os perfis de usuários considerados alunos, a situação de matrícula que indica matrícula ativa e os dados necessários para conexão, referentes ao novo processo de exportação de usuários para o Identity Provider Nacional. Criada uma nova interface chamada Parâmetros - IDP Nacional para conter o novo parâmetro e outros que forem necessários para a Integração do TOTVS Educacional com Identity Provider. Detalhamento do Processo Estará disponível em: TOTVS Educacional | Sistema Indústria | IDP Nacional | Parâmetros. Image Removed Image Removed, o usuário administrador efetuará as parametrizações referentes ao processo. Image Added Image Added Image Added A interface exibirá os seguintes campos:
|
Expandir | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
Pré-RequisitosO usuário deverá estar vinculado a um cadastro de Pessoa, para que seja possível executar o processo de exportação de usuários do SGE para o Identity Provider Nacional, apenas usuários vinculados a um cadastro de Pessoa do SGE serão exportados. Descrição do processoObjetivo do Requisito Exportar do SGE para o Identity Provider Nacional (IDP WSO2) os dados de usuário criados no SGE de alunos, professores e demais acessos (se associados à uma Pessoa no SGE), independente de terem sido integrados com o Google para criação de e-mail. No contexto do SGE, um usuário (GUSUARIO) pode ser cadastrado sem necessidade de estar associado a um cadastro de pessoa (PPESSOA). Para alunos e professores, esse vínculo é obrigatório e para qualquer outro acesso (usuários internos, secretaria), o cadastro da pessoa e seu vínculo são opcionais. No contexto desta integração, para que o usuário seja exportado para o IDP Nacional, será necessário cadastrar uma Pessoa no SGE, com seu respectivo CPF e dados necessários para integração, e associar o usuário a esse cadastro, através da interface. Apenas usuários vinculados a um cadastro de Pessoa do SGE serão exportados.
Descrição do processo Criado um novo processo chamado O processo customizado de Exportação de Usuários - IDP Nacional , estará disponível através do no menu:TOTVS Educacional | Sistema Indústria | IDP Nacional | Exportação de Usuários, que visa contemplar a nova funcionalidade: Exportação de dados de Usuários SGE para o Identity Provider Nacional. . Image Added Este processo poderá ser agendado ou executado manualmente pelo usuário. Image Removed Detalhamento do processo Ao executar o processo, a customização irá identificar todos os usuários criados que ainda não foram integrados com o Identity Provider e os usuários que sofreram alguma alteração nos dados que são enviados, como e-mail Google, por exemplo.
Para usuários que estiverem relacionados ao perfil de Alunos (parâmetro), serão exportados apenas os que apresentarem matrícula ativa no momento da exportação. a customização irá validar as seguintes regras no processo de exportação:
Para usuários que não forem alunos: Professores e demais acessos, serão exportados todos os usuários criados com o status do cadastro de usuário a customização irá validar as seguintes regras no processo de exportação:
Novo! 4. Só serão exportados usuários que estejam associados a algum perfil no RM em Usuário > Segurança > Perfis. Image Added Apenas para usuários estrangeiros, além das validações de professor e aluno, após a exportação com sucesso para os usuários estrangeiros, a API nos retornará um identificador sequencial como CPF, que será armazenado no SGE ao termino do processo (tabela de controle interna). Todos os usuários existentes no momento da execução , e que atendam as condições e que ainda não foram enviados, citadas acima serão exportados. Ao executar o processo e enviar o usuário, o registro é salvo na tabela de integração (interna) para controle de envio dos dados. O envio também ficará disponível na interface de log, para visualização do usuário. Para contemplar esse processo, será disponibilizada pelo SENAI uma nova API para que o SGE envie os seguintes dados dos usuários: | ||||||||||||
Informação | Origem | |||||||||||
Nome | Nome do cadastro de usuário GUSUARIO.NOME | |||||||||||
Nome Social | Nome social do cadastro de usuário GUSUARIO.NOMESOCIAL | |||||||||||
CPF | CPF da Pessoa associada ao usuário. PPESSOA.CPF Para usuários estrangeiros, este campo não será preenchido | |||||||||||
E-mail principal | E-mail principal associado ao cadastro da pessoa. PPESSOA.EMAIL | |||||||||||
E-mail legado ou pessoal | E-mail original do aluno/professor cadastrado antes da geração do novo e-mail google. SALUNOCOMPL.EMAILLEGADO SPROFESSORCOMPL.EMAILLEGADO Apenas para Aluno e Professor. | |||||||||||
E-mail SENAI Google | E-mail gerado pelo Google para Aluno e Professor. SALUNOCOMPL.EMAILGOOGLE SPROFESSORCOMPL.EMAILGOOGLE Apenas para Aluno e Professor. | |||||||||||
Tipo | “aluno”, “docente” e “outros”. Se o usuário acumular mais de um papel, será enviada a lista. | |||||||||||
Data de nascimento | Data de nascimento do cadastro da pessoa, quando preenchida. PPESSOA.DTNASCIMENTO | |||||||||||
Gênero | Sexo do cadastro da pessoa, quando preenchido. PPESSOA.SEXO F - Feminino ou M- Masculino | |||||||||||
Celular | Telefone do cadastro da pessoa. PPESSOA.TELEFONE2 | |||||||||||
Unidades Operacionais | Filiais cadastradas no Anexo Usuário/Filial do cadastro do Usuário SUSUARIOFILIAL.CODFILIAL GFILIAL.NOME | |||||||||||
Cidade | Nome da Cidade do endereço do cadastro da pessoa PPESSOA.CIDADE | |||||||||||
UF | Código UF do endereço do cadastro da pessoa. PPESSOA.ESTADO. | |||||||||||
Registro Acadêmico | RA do Aluno. SALUNO.RA Apenas para Alunos. | |||||||||||
Estrangeiro | True ou False, de acordo com a nacionalidade informada. PPESSOA.NACIONALIDADE 10 = False Diferente de 10 = True |
Aviso | ||
---|---|---|
| ||
Para os usuários sem CPF e que ainda não possuírem o identificador único no SGE (primeira exportação), não será possível verificar a existência do usuário no Identity Provider (será enviado como inclusão). |
Aviso | ||
---|---|---|
| ||
Alguns dados exportados se referem ao cadastro da Pessoa associada ao aluno ou professor no SGE. Normalmente usuários de secretaria/internos não ficam vinculados a um cadastro de pessoa, mas para serem exportados neste processo, será necessário cadastrar a Pessoa informando os dados necessários para a exportação e vincular o usuário criado. Portanto, se o usuário for cadastrado diretamente na tela de usuários do SGE, ele não estará associado a uma Pessoa e portanto, não estará apto para ser enviado na exportação. Ele só será exportado após ser vinculado à Pessoa (para alunos, precisa atender também a regra da matrícula ativa). |
A API também será responsável em enviar atualização desses campos, ou seja, toda vez dos dados sempre que algum campo utilizado for alterado no SGE para o usuário/pessoa, a API do Identity será chamada para atualização, quando o processo customizado for executado.
title | Importante: |
---|
.
title | Processo de Exportação de dados para Sapes - Por Turma |
---|
Pré-requisitos
Para envio da pesquisa de Egresso do Senai, serão considerados os dados dos alunos que estão concluindo determinado curso das modalidades parametrizadas.
Descrição do processo
O menu utilizado ficará disponível em: TOTVS Educacional| Currículo e Oferta | Turma | Processos| Exportar Dados para o Sapes, para ser executado de forma manual pelo usuário.
Image Removed
Detalhamento do processo
Ao clicar no processo, será exibida tela com a lista de aluno da turma selecionada, para que o usuário selecione todos ou apenas os desejados. O processo enviará ao Sapes uma lista de dados das matrículas dos alunos selecionados que atenderem aos requisitos pré-definidos. Se ocorrer alguma atualização dos dados após o envio, o processo irá identificar a modificação e enviar a atualização para o SAPES.
Serão exportados dados dos alunos após atualizar a Analise Curricular, de acordo com as seguintes regras:
Image Removed
Observação: O Processo de Exportação de Dados para o Sapes por Turma, permite selecionar apenas um registro de turma, por processamento. Caso o usuário selecione mais de uma turma, será exibida a seguinte mensagem.
Image Removed
title | Importante |
---|
Ao executar o processo e enviar o usuário, o registro é salvo na tabela de integração (interna) para controle de envio dos dados. O envio também ficará disponível na interface de log, para visualização do usuário.
Expandir | |||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||
Pré-requisitos Não se aplica. Descrição do processo O objetivo da Interface de Log é armazenar informações e status dos dados que foram exportados do SGE para o Sapes. Detalhamento do processo Será possível acompanhar os status dos dados de matrículas dos alunos enviados para o Sapes. Nesta interface será possível identificar os status dos alunos integrados. Não será permitida a inclusão, alteração ou exclusão de registros nesta interface. Os dados exibidos nesta interface ficam armazenados na tabela customizada ZDOCSIGNMONITOREsse processo não possui pré-requisitos, porem para que o mesmo contenha dados é necessário a execução do processo de exportação de dados para a API do Identity Provider. Descrição do processo A interface de Log será responsável por controlar todos processos realizados pela integração Identity Provider. Neste cadastro você poderá encontrar qualquer valor referente a um registro exportado. Dessa forma essa funcionalidade representa todo o seu histórico de exportação. Os históricos das exportações de dadosusuários para o MoodleIdentity Provider serão registrados e poderão ser visualizadas no menu TOTVS Educacional | Sistema Indústria | Integração SapesIDP Nacional | Monitor de Log. Image Removed Na tela de log estarão disponíveis os seguintes campos: A funcionalidade de Log é baseada em duas visões sendo a primeira o valor de registro principal de usuário que foi exportado para o Identity Provider: Image Added Image Added Detalhamento dos campos Id Log:
O item de log representará a quantidade de vezes que esse usuário teve interações com o Identity Provider, como por exemplo, a quantidade de vezes que o cadastro desse usuário foi atualizado, como na imagem abaixo: Image Added Image Added Na tela de item de log, ao acessar um registroAo 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:
Os dados informados nesta interface serão armazenados em tabela customizada por Filial.
|
Expandir | ||
---|---|---|
| ||
Pré-requisitos Possuir registros enviados com erro.Para e realização do processo é necessário dados registrados no Monitor de log com o status de pendente ou erro para serem reprocessados para a API do Identity Provider. Descrição do processo O objetivo do processo de reenvio de dados é permitir o envio para o Sapes dos registros que não foram exportados corretamente.Esse processo poderá ser executado manualmente ou poderá ser agendado pelo menu de Processos de Monitor de Log, por registro (com status de cancelado,erro ou pendente) e a integração efetuará a exportação dos registros novamente.Detalhamento do processo O Reenvio de Dados, que ao ser acionado a customização tentará realizarnovamente o envio das informações ao Sapes. A funcionalidade estará disponível na tela de Monitor de Logs, menuem: TOTVS Educacional | Sistema Indústria | Integração SapesIDP Nacional | Monitor de Log| Processos | Reenvio de Log.Neste exemplo abaixo o envio apresentou o status de erro; Selecione o erro que desejo reenviar,clicar em processos, reenvio de log; Image Removed Dados. Image Added Image Added Image Added Será permitido o usuário selecionar um ou vários registros com o status de Erro ou Cancelado e poderá ser executado manualmente. Caso o usuário não selecione nenhum registro na visão, o processo de reenvio é executado para todos os registros com status de Erro, e neste caso, pode ser agendado. Ao ser acionado o processo customizado de reenvio de dados, a customização tentará realizar novamente o envio das dos usuários ao Identity Provider. Caso seja processado corretamente, o status do registro passará para Sucesso. Os registros com erro também são reprocessados pelo próprio processo e Exportação de Usuários - Identity Provider, que possui opção de “Reenviar registros com erro”. O reenvio automático será executado até atingir o número máximo de tentativas parametrizado (Parâmetros da integração - Número de Tentativas de Reenvio). Caso o parâmetro esteja vazio a customização não realizará nenhuma tentativa de reenvio automaticamente. Quando o número máximo de tentativas de reenvio for atingido e em nenhuma das tentativas tenha retornado sucesso, a customização passará o status do registro para Cancelado. Dependendo do erro ocorrido, o usuário precisará acessar o Monitor de log e analisar os logs, corrigir os registros (caso necessário) e então acionar o processo de reenvio. Image Removed |