Projeto: FS00XX - Integração SGE X Solução Integradora
Nome do Cliente: Confederação Nacional da Indústria - SENAI
O Departamento Nacional precisa extrair mensalmente informações de todas as filiais do SGE, para importá-las na Solução Integradora (Portal Integrador). Esse processo é necessário para registrar informações dos regionais, avaliação de indicadores, além de prestação de contas com o MEC. O DN precisa gerar um arquivo texto para cada Regional, gerando até 27 arquivos. O DN não utiliza a solução integradora padrão definida para os DRs, já que existem algumas particularidades na extração do DN. Atualmente os arquivos do DN são gerados pelo Gerador de Saídas do RM, com consultas mantidas pelo DN, específicas por regional (uma para cada), com muitos valores fixos.
O objetivo deste projeto é refazer o processo de geração dos arquivos do DN de forma mais parametrizável e levantando as críticas pré-definidas antes de enviar o arquivo. As regras já estão sendo definidas para que a solução implementada também seja utilizada na geração das críticas e arquivos dos Regionais, que hoje utilizam a solução integradora padrão do SGE (Gerador de Saídas). O projeto é composto pelas seguintes frentes:
● Processo para geração de arquivo mensal contendo registros de Matrículas, Cursos e Carga horária.
● Cadastros e parâmetros no SGE, para permitir maior flexibilidade na manipulação dos dados e validação de críticas.
● Validação das matrículas e cursos identificados para compor o arquivo, possibilitando ao usuário visualizar a crítica e ajustá-la antes de prosseguir com a geração do arquivo, caso necessário.
xxxxxxxxxx
xxxxxxxxx
A criação do campo complementar e das tabelas dinâmicas será realizada pelo script caso estas não exista na base de dados, a ser executado através do executor de scripts:
Assim que executado o Script com sucesso pelo Executor de Script, em Serviços Globais | Customização | Executor de Scripts. Será necessário habilitar o campo complementar.
Para habilitar este campo acesse o menu TOTVS Educacional | Configurações | Níveis de Ensino, selecione o nível de ensino e na aba Campos Complementar disponíveis, habilite o campo complementar criado pelo script.
O Campo complementar que será criado pelo Script é:
TOTVS Educacional | Currículo e Oferta | Matrizes Curriculares
- Curso é integrado ao parceiro?
Atenção
Caso o campo não seja ativado ele não ficará visível na tela de campos complementares de Matriz Curricular.
Para o correto funcionamento da customização, é preciso que as seguintes Tabelas Dinâmicas estejam devidamente registradas na base de dados, essa inclusão das tabelas dinâmicas e de seus itens é realizado pela execução do Script.
Quando a tabela dinâmica é gerada seus itens também são preenchidos, caso a tabela dinâmica já exista os dados devem possuir os seguintes valores abaixo:
Tabela Dinâmica | Item da Tabela Dinâmica | Sistema | Visivel a todas coligadas |
---|---|---|---|
SIMOUNAO | 0 - Não | Educacional | Sim |
1 - Sim | |||
PARCERIA | 0 - Pública | Educacional | Sim |
1 - SESI | |||
2 - Privada | |||
CONCOSUBSE | 0 - Concomitante | Educacional | Sim |
1 - Subsequente |
Exemplo da tabela dinâmica "SIMOUNAO":
Acesse o menu TOTVS Serviços Globais | Administração| Tabela Dinâmica, selecione o sistema Educacional e valide se a tabela esta corretamente inserida e se os items da tabela estão conforme descrito acima.
Atenção
Este cadastro das Tabelas Dinâmicas deve ser corretamente inserido pelo Script, para as tabelas dinâmicas utilizadas pela customização no sistema Educacional e visível a todas coligadas.
Interface de Parâmetros da Solução Integradora disponível no menu:
TOTVS Educacional | Sistema Indústria | Solução Integradora | Parâmetros.
Interface para parametrização das informações de curso que serão utilizadas para geração do arquivo.
Interface para parametrização das informações de matrícula que serão utilizadas para geração do arquivo.
Contexto
Os parâmetros desta aba serão armazenados por coligada.
Contexto
Os parâmetros desta aba serão armazenados por nível de ensino.
Contexto
Os parâmetros desta aba serão armazenados por coligada.
Contexto
Os parâmetros desta aba serão armazenados por coligada.
Observação: Caso não seja localizado código informado neste cadastro, será gerada crítica para o registro.
Contexto
Os parâmetros desta aba serão armazenados por coligada.
Contexto
Os parâmetros desta aba serão armazenados por coligada.
Pré-requisitos
Devem ser liberadas nas permissões de perfil dos usuários, os menus da customização Solução Integradora.
Disponível em: Serviços Globais | Perfil | Educacional | Sistema Indústria | Integradores | Solução Integradora | Situação de Matrícula
Detalhamento do processo
Foi criada uma interface de DE|PARA para o usuário definir para cada situação de matrícula do RM com seus respectivos códigos da solução integradora.
A interface de DE|PARA poderá ser acessada em: TOTVS Educacional | Sistema Indústria | Solução Integradora | De|Para | Situação de Matrícula
Ao acessar a interface pelo menu customização, será exibida uma visão com todos os registros que possuem De/Para cadastrado, e será possível incluir, editar e excluir um registro.
Ao incluir ou editar, será exibida a interface com os campos:
Código RM: campo do tipo Lookup para informar o código da situação de matrícula (SSTATUS) no RM que precisará de DE|PARA com a Solução Integradora.
Código Externo: campo do tipo texto livre, para informar o código da situação de matrícula na Solução Integradora que corresponde à situação de matrícula cadastrada no SGE.
Atenção
Este cadastro de De|Para é separado por nível de ensino, sendo necessário realizar os cadastros em todas os níveis de ensino que serão utilizados na Solução Integradora.
Pré-requisitos
Devem ser liberadas nas permissões de perfil dos usuários, os menus da customização Solução Integradora.
Disponível em: Serviços Globais | Perfil | Educacional | Sistema Indústria | Integradores | Solução Integradora | Raça
Detalhamento do processo
Foi criada uma interface de DE|PARA para o usuário definir para cada situação de matrícula do RM com seus respectivos códigos da solução integradora.
A interface de DE|PARA poderá ser acessada em: TOTVS Educacional | Sistema Indústria | Solução Integradora | De|Para | Situação de Matrícula
Ao acessar a interface pelo menu customização, será exibida uma visão com todos os registros que possuem De/Para cadastrado, e será possível incluir, editar e excluir um registro.
Ao incluir ou editar, será exibida a interface com os campos:
Código RM: campo do tipo Lookup para informar o código da raça (PCORRACA) no RM que precisará de DE|PARA com a Solução Integradora.
Código Externo: campo do tipo texto livre, para informar o código da raça na Solução Integradora que corresponde à raça cadastrada no SGE.
Atenção
Este cadastro de De|Para é separado por coligada, e como este projeto está somente disponível para o SENAI os dados cadastrados ficarão disponíveis para todas as filiais e níveis de ensino.
Pré-requisitos
Devem ser liberadas nas permissões de perfil dos usuários, os menus da customização Solução Integradora.
Disponível em: Serviços Globais | Perfil | Educacional | Sistema Indústria | Integradores | Solução Integradora | Estado Civil
Detalhamento do processo
Foi criada uma interface de DE|PARA para o usuário definir para cada situação de matrícula do RM com seus respectivos códigos da solução integradora.
A interface de DE|PARA poderá ser acessada em: TOTVS Educacional | Sistema Indústria | Solução Integradora | De|Para | Situação de Matrícula
Ao acessar a interface pelo menu customização, será exibida uma visão com todos os registros que possuem De/Para cadastrado, e será possível incluir, editar e excluir um registro.
Ao incluir ou editar, será exibida a interface com os campos:
Código RM: campo do tipo Lookup para informar o código do estado civil (PCODESTCIVIL) no RM que precisará de DE|PARA com a Solução Integradora.
Código Externo: campo do tipo texto livre, para informar o código do estado civil na Solução Integradora que corresponde ao estado civil no SGE.
Atenção
Este cadastro de De|Para é separado por coligada, e como este projeto está somente disponível para o SENAI os dados cadastrados ficarão disponíveis para todas as filiais e níveis de ensino.
Foi disponibilizada uma interface de Cadastro de Unidade, para que os usuários possam informar as unidades, garantindo que as informações estejam devidamente configuradas para a geração do arquivo da Solução Integradora.
A interface está disponível em TOTVS Educacional | Sistema Indústria | Solução Integradora | Cadastro de Unidade.
Ao acessar a interface pelo menu customização, será exibida uma visão com todos os registros de unidade, e será possível incluir, editar e excluir um registro.
Ao incluir ou editar, será exibida a interface com os campos:
Código: campo do tipo texto que será preenchido pelo usuário com o código da unidade que será enviado para solução integradora.
Sigla do DR: neste campo será exibida uma lista dos estados do Brasil e a sigla CT (Cetiqt), onde o usuário deverá selecionar a sigla da Unidade (Lista de DRs).
Nome: neste campo o usuário deverá preencher o nome da unidade.
Flag Unidade Padrão: neste campo o usuário deverá marcar a unidade que ficará como padrão. Será permitida apenas uma unidade padrão por DR.
Município: neste campo será exibida uma lista dos municípios do estado definido como DR, onde o usuário deverá selecionar a cidade da unidade.
Foi disponibilizada uma interface de Cadastro de Nacionalidade, para que os usuários possam cadastrar os códigos dos países referentes às nacionalidades cadastradas no SGE, para que o código do País seja considerado na geração do arquivo.
A interface está disponível em TOTVS Educacional | Sistema Indústria | Solução Integradora |Cadastro de Nacionalidade.
Ao acessar a interface pelo menu customização, será exibida uma visão com todos os registros, e será possível incluir, editar e excluir um registro.
Ao incluir ou editar, será exibida a interface com os campos:
Código da Nacionalidade: campo do tipo loockup para selecionar a nacionalidade previamente cadastrada no SGE.
Código do País: campo do tipo texto para informar o código do País relacionado a nacionalidade informada (livre digitação).
Restrição de Cadastro de Cursos e Turmas por Área Tecnológica
A partir de 2025, para atender às novas diretrizes institucionais da Solução Integradora, as áreas tecnológicas abaixo não poderão mais ser utilizadas. Sendo assim, não será possível criar novos cadastros vinculados a esses valores.
1 | 2 | 3 | 4 | 5 | 6 | 8 | 12 | 13 | 15 | 20 | 24 | 25 | 27 | 28 | 29 | 32 | 35 |
36 | 39 | 40 | 43 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59 |
60 | 61 | 62 | 63 | 64 | 65 | 66 | 67 | 68 | 69 | 70 | 71 | 72 | 99 |
Restrição de Cadastro de Cursos e Turmas por Modalidade do Itinerário V
A partir de 2025, para atender às novas diretrizes institucionais da Solução Integradora, as modalidades abaixo não poderão mais ser utilizadas. Sendo assim, não será possível criar novos cadastros vinculados a esses valores.
22 | Qualificação Profissional - Itinerário V Ensino Médio |
32 | Habilitação técnica de Nível médio - Itinerário V Ensino Médio |
Validação na Matriz Curricular
Foi realizada uma validação na tela de TOTVS Educacional | Currículo e Oferta | Matrizes Curriculares para o campo complementar "Curso é integrado ao parceiro?", para ser de preenchimento obrigatório para as Modalidades 21 e 31.
Foi realizado a criação de uma nova Aba na tela TOTVS Educacional | Currículo e Oferta | Alunos | Anexos | Cursos/habilitações aba "Campos complementares - Produção DN", com os seguintes campos para preenchimento, tendo eles validações especificas conforme a seleção:
Validações no Curso / Habilitações do Aluno - Solução Integradora
Foram realizadas validações na tela TOTVS Educacional | Currículo e Oferta | Alunos | Anexos | Cursos/habilitações aba "Campos complementares - Produção DN" para as seguintes regras abaixo:
- Para os Cursos vinculados a Modalidade 21 e 31, o preenchimento dos campos "Tem parceria?" e "Escolaridade" é de preenchimento obrigatório.
- Os campos "Tem parceria?" e "Escolaridade", vão apresentar uma mensagem de confirmação para a alteração, caso a confirmação seja negativa os campos serão retornados ao seu valor anterior.
- O campo "Parceria" somente é habilitado se o campo "Tem parceria?" possuir o valor "Sim".
- O campo "Estado" somente é habilitado se o campo "Parceria?" possuir o valor "Pública" ou "Privada".
- O campo "Nome da Instituição" somente é habilitado se o campo "Estado" estiver preenchido e será filtrado conforme o Estado selecionado:
- O campo "Escolaridade" ao ser alterado, também irá realizar a alteração do Grau de Instrução do cadastro de Pessoa do aluno selecionado, assim garantindo a informação atualizada sobre a escolaridade do aluno:
- O campo "Concomitante e Subsequente" tem a alteração restrita e este é alterado automaticamente conforme a Escolaridade selecionada, possuindo a seguinte regra:
Interface de Críticas - Solução Integradora
Pré-requisitos
Devem ser liberadas nas permissões de perfil dos usuários, os menus da customização Solução Integradora.
Disponível em: Serviços Globais | Perfil | Educacional | Sistema Indústria | Integradores | Solução Integradora | Cadastro de Críticas
Foi disponibilizada uma interface de Cadastro de Críticas, para que os usuários possam visualizar as críticas e ativar ou desativar a mesma.
A interface está disponível em TOTVS Educacional | Sistema Indústria | Solução Integradora |Cadastro de Críticas.
Ao acessar a interface pelo menu customização, será exibida uma visão com todos os registros de Críticas.
Os campos da Crítica não estarão disponíveis para edição, será possível apenas Ativar/Desativar a crítica.
Monitor de Críticas - Solução Integradora
Pré-requisitos
Devem ser liberadas nas permissões de perfil dos usuários, os menus da customização Solução Integradora.
Disponível em: Serviços Globais | Perfil | Educacional | Sistema Indústria | Integradores | Solução Integradora | Monitor de Críticas
Foi disponibilizada uma interface de Monitor de Críticas, para que os usuários possam visualizar as críticas que foram geradas.
A interface está disponível em TOTVS Educacional | Sistema Indústria | Solução Integradora |Monitor de Críticas.
Ao acessar a interface pelo menu customização, será exibida uma visão com as críticas geradas no processo.
Será possível acessar os detalhes da critica pelo anexo "Item do Registro". Não será possível deletar, editar ou inserir registros.
Ao clicar em um registro será exibido o formulário com os detalhes da crítica, e novamente não será possível editar o registro.
O processo de validação retornará os dados filtrados pelo usuário, analisando os registros conforme as regras definidas.
Antes da geração do arquivo mensal, o usuário deve validar as críticas nos registros identificados.
Cada item do arquivo de registro exibirá suas respectivas críticas, conforme as regras abaixo:
Críticas do Layout: | |
Crítica | Validação |
28 - CPF inválido | CPF do aluno incorreto. Para alunos estrangeiros será gerada essa crítica, já que é enviado fixo o valor NRE. |
29 - CNPJ inválido | CNPJ do aluno ou responsável financeiro (para os casos de matrículas pagas por uma empresa - CNPJ). |
30 - Data inválida | Valida o formato de todas as datas do arquivo. |
33 - Campo sexo | deve ser preenchido com M para masculino ou F para feminino (aluno). |
Tipo registro: Cursos | |
Crítica | Validação |
1000 - O curso está repetido no arquivo enviado – código de curso duplicado | Crítica gerada se existir mais de uma linha no arquivo com o mesmo código de curso. |
1003 - A data de fim da oferta do curso é inválida. Se ela for informada, não poderá ser menor que a data de início da oferta do curso | A data de término de oferta do curso está sendo fixo vazia. Portanto, essa crítica não será validada. |
1006 - Código da área de atuação inválido. Verifique a relação de códigos disponibilizado na tabela referencial. | Crítica será gerada caso a área do curso não esteja informada nos parâmetros ou esteja inativa (SCURSO.CODAREA). |
1008 - Código da modalidade inválido. Verifique a relação de códigos disponibilizado na tabela referencial. | Crítica será gerada caso a modalidade do curso não esteja informada nos parâmetros ou esteja inativa (SCURSO.CODMODALIDADE). |
1009 - Carga horária (escolar + estágio) fora da faixa permitida para a Modalidade. | Crítica gerada se o somatório das cargas horárias da grade: presencial (SGRADECOMPL.CHESCOLAR) e estágio (SGRADECOMPL.CHESTAGIO) estiver fora da faixa informada no parâmetro da modalidade (mínima e máxima). |
Tipo registro: MATRÍCULA | |
Crítica | Validação |
2009 - Código do tipo de situação da matrícula inválido. Verifique a relação de códigos disponibilizados na tabela referencial. | Crítica será gerada caso a situação de matrícula do aluno não esteja informada no de/para ou se estiver inativa nos parâmetros? terá esse controle? |
2010 - Código do tipo de entrada do aluno inválido. Verifique a relação de códigos disponibilizados na tabela referencial. | Crítica será gerada caso o tipo de entrada do aluno não esteja informada nos parâmetros ou esteja inativo. |
2016 - Código do tipo de financiamento inválido. Verifique a relação de códigos disponibilizados na tabela referencial. | Crítica será gerada caso o tipo de financiamento do aluno esteja na lista dos parâmetros de modalidade com status inativo ou se o código obtido no campo ( Tipo de Gratuidade / Fonte de Financiamento) não possuir código de De/Para cadastro de Tipo de Gratuidade. |
2020 - Nível de escolaridade no Ato da Matrícula Incompatível com a Modalidade do Curso. | Crítica será gerada caso o nível de escolaridade mínimo exigido para a modalidade do curso não esteja informado no de/para ou no parâmetro. |
2021 - Código tipo de situação ocupacional do aluno inválido. Verifique a relação de códigos disponibilizados na tabela referencial. | Crítica será gerada caso a situação ocupacional do aluno não esteja informada nos parâmetros. |
2034 - Tipo de Financiamento incompatível com a modalidade do curso | Se o tipo de financiamento não estiver informado na lista parâmetro da modalidade. |
2035 - Idade do Aluno incompatível com a modalidade do curso | Se a idade do aluno estiver fora da faixa informada no parâmetro da modalidade (mínima e máxima). |
2038 - Data de entrada da matrícula menor que a data de início de oferta do curso ou maior que a data de fim da oferta do curso. | Se o valor enviado no campo Data Entrada da matrícula (SMATRICPL.DTMATRICULA) for menor que do campo Data início de Oferta (SGRADE.DTINICIO). Data término do curso não é verificada pois não é enviada. |
2039 - Data de saída prevista da matrícula menor que a data de início da mesma. | Data previsão de saída: (SHABILITACAOALUNOCOMPL.DATAPREVISTASAIDA, caso não esteja preenchida, utiliza a SLOGPLETIVO.DTALTERACAO), menor que a data de início (SMATRICPL.DTMATRICULA). |
2040 - Data de saída da matrícula menor que a data de início ou maior que a data da carga. | Data de saída da matrícula é a data de término real: (maior data registrada no SLOGPLETIVO.DTALTERACAO). Verificar se essa data é posterior ao mês e ano informados para geração do arquivo (data da carga). Caso seja, será gerada crítica. Exemplo: Data de saída: 31/12/2023 Carga: Janeiro/2024 |
2041 - Data de Término Real da Matrícula/Data de Atualização da Situação incompatível com a situação da matrícula | Verificar se o último registro de alteração (SLOGPLETIVO) está com situação de matrícula igual ao valor considerado para envio. |
2900 - Código do tipo de necessidade especial do aluno inválido. Verifique a relação de códigos disponibilizados na tabela referencial. | Crítica será gerada caso a necessidade especial do aluno não esteja informada no de/para. Se não encontrada, será gerada crítica. |
2901 - Código do tipo de raça/cor do aluno inválido. Verifique a relação de códigos disponibilizados na tabela referencial. | Crítica será gerada caso a raça/cor do aluno não esteja informado no de/para. |
2904 - Código do estado civil do aluno inválido. Verifique a relação de códigos disponibilizados na tabela referencial. | Crítica será gerada caso o estado civil do aluno não esteja informado no de/para. |
2905 - Código do nível de escolaridade do aluno inválido. Verifique a relação de códigos disponibilizados na tabela referencial. | Crítica será gerada caso o nível de escolaridade do aluno não esteja informado no de/para. |
2909 - Nome do Aluno Abreviado | O nome do aluno não pode ser abreviado (conter palavra com uma única letra, seguida de ponto) |
2910 - Nome do Aluno com uma Única Palavra | O nome do aluno deve conter mais de uma palavra |
2911 - Nome do Aluno Contém Caracter Inválido | O nome do aluno só pode conter letra, hífen, aspa e ponto |
2913 - Nome da Mãe do Aluno com uma Única Palavra | O nome da mãe do aluno deve conter mais de uma palavra, exceto se for “Desconhecida”. Esta regra se aplica para Cursos à distância (SCURSO.CURPRESDIST = ‘D’) para as modalidades com o parâmetro “Valida Nome da mãe” marcado. |
2914 - Nome da mãe do aluno contém caracter inválido | O nome da mãe do aluno não pode conter letra, hífen, aspa e ponto. Esta regra se aplica para Cursos à distância (SCURSO.CURPRESDIST = ‘D’) para as modalidades com o parâmetro “Valida Nome da mãe” marcado. |
2915 - Nome da Mãe do Aluno Inválido | O nome da mãe do aluno tem que ser diferente de “Não Disponível”. |
2917 - O CPF informado já existe no arquivo para outro aluno com os dados de Nome, Nome da Mãe e Data de Nascimento distintos do primeiro. | Caso exista o mesmo CPF mais de uma vez no arquivo, é necessário validar o Nome, Nome da Mãe e Data de Nascimento, garantindo que estes campos sejam iguais em ambos os registros. |
2920 - Código de aluno duplicado no arquivo (código informado para mais de uma pessoa distinta) | Um mesmo código de aluno não pode, dentro do próprio arquivo, pertencer a pessoas distintas, ou seja, para números de CPF distintos ou, na ausência deste, para um dos campos de NOME, MÃE ou DATA DE NASCIMENTO distintos. |
2921 - Código de aluno duplicado no arquivo em relação à base de dados (código informado para uma pessoa distinta já existente na base) | Um mesmo código de aluno não pode ser informado no arquivo e já existir na base de dados com número de CPF distinto, ou, na ausência deste, para um dos campos de NOME, MÃE ou DATA DE NASCIMENTO distintos. |
2922 - Há registros do mesmo aluno (com o mesmo CPF) no arquivo, porém, com o código de aluno diferente. | Um mesmo aluno (ou o mesmo CPF) não pode ser informado mais de uma vez no arquivo com código de aluno diferentes. |
2923 - Nome da mãe não informado. O preenchimento é obrigatório para cursos diferentes de Iniciação Profissional e para ações presenciais. | O nome da mãe é de preenchimento obrigatório para as modalidades diferentes de "Iniciação Profissional" (código da modalidade diferente de 5) e para as ações presenciais (tipo de ação = 1). Esta regra se aplica para Cursos presenciais (SCURSO.CURPRESDIST = ‘P’) para as modalidades com o parâmetro “Valida Nome da mãe” marcado. |
2933 - Data de Término Prevista é de preenchimento obrigatório. | O campo "Data de Término Prevista" deve ser de preenchimento obrigatório, exceto para matrículas vinculadas a cursos à distância, da modalidade com parâmetro “Data de Término Previsto Obrigatória” desmarcado. |
Tipo registro: CARGA HORÁRIA | |
Crítica | Validação |
2009 - Carga Horária Mensal da Matrícula Superior a 500 | A quantidade de horas total de produção (fases escolar e estágio do tipo de registro 3) não pode ser superior a 500. |