Histórico da Página
Recuperação de dados no dia "D" do Censo do ensino básico
Características do Requisito
Linha de Produto: |
TOTVS Gestão Educacional | ||||||||
Segmento: | Educacional | |||||||
Módulo: | EDU | |||||||
Rotina: |
|
|
Especificação de produto : $/RM/Documentos/Edu-Educacional/Especificações/Matrícula/ Especificação - Matrícula.docx
Especificação de produto :$/RM/Documentos/Edu-Educacional/Especificações/Matrícula/ Especificação – Situação de Matrícula.docx
Cadastros Iniciais:
| |||||
Cadastros Iniciais: | Cadastro de matricula no período letivo Preparação do arquivo para o Educacenso | ||||
Parâmetro(s): |
Informe os parâmetros utilizados.
Parâmetros do Educacional -> Configurações”-> “Parâmetros” -> “Secretaria” -> “Geral 5/5” Parâmetros de Perfil para o Educacional -> Sistemas Globais” ->” Segurança” ->” Perfis” -> "Parâmetros educacionais" |
Ponto de Entrada:
Informe o ponto de entrada relacionado (link).
Chamados relacionados
Requisito (ISSUE): |
Banco(s) de Dados:
Informe o(s) Banco(s) de Dados utilizado(s).
País(es): |
Informe o(s) Pais(es).
Brasil |
Sistema(s) operacional(is):
Informe o(s) sistema(s) operacional(is) utilizados.
Tabelas utilizadas: |
Informe as tabelas utilizadas.
SMATRICPL |
Versões/Release: |
Informe as versões.
12.1.7 |
Descrição
Permitir
o ao usuário obter uma “fotografia” dos seus dadose arquivar a mesma, em distintas linhas do tempo para futuro envio ao Educacenso.
Importante
(Apenas para Microsiga Protheus, versões anteriores à versão 12)
Antes de executar o compatibilizador informe o nome do compatibilizador é imprescindível:
- Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório PROTHEUS_DATA\DATA, se versão 10, ou \PROTHEUS11_DATA\DATA, se versão 11) e dos dicionários de dados SXs (diretório PROTHEUS_DATA_SYSTEM, se versão 10, ou \PROTHEUS11_DATA\SYSTEM, se versão 11).
- Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
- Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
- Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.
- O compatibilizador deve ser executado com a Integridade Referencial desativada*.
Atenção O procedimento a seguir deve ser realizado por um profissional qualificado como Administrador de Banco de Dados (DBA) ou equivalente! A ativação indevida da Integridade Referencial pode alterar drasticamente o relacionamento entre tabelas no banco de dados. Portanto, antes de utilizá-la, observe atentamente os procedimentos a seguir:
Contate o Help Desk Framework EM CASO DE DÚVIDAS! |
---|
- Em Microsiga Protheus TOTVS Smart Client (se versão 10) ou ByYou Smart Client (se versão 11), digite informe o nome do compatibilizador no campo Programa Inicial. Descreva se o compatibilizador deve ter uma data específica ou superior para que a atualização nos dicionários seja efetuada corretamente. Importante: Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a ___/___/____.
- Clique em OK para continuar.
- Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado ou é apresentada a janela para seleção do compatibilizador. Selecione o programa xxxx().
- Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
É apresentada uma mensagem explicativa na tela. - Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
- Clique em Gravar para salvar o histórico (log) apresentado.
- Clique em OK para encerrar o processamento.
- Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
Descreva se há algum procedimento necessário após a aplicação do compatibilizador.
Procedimento para Implantação
O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.
- Aplique o patch do chamado e execute uma vez a rotina Informe o nome da rotina.
- No módulo informe o nome do módulo acesse informe o caminho e verifique que o parâmetro informe o nome do parâmetro é criado conforme especificações abaixo:
Nome da Variável: | Informe o Nome da Variável |
Tipo: | Informe o Tipo |
Descrição: | Informe a Descrição |
Valor Padrão: | Informe o Valor Padrão |
Atualizações do Compatibilizador
(Apenas para Microsiga Protheus, versões anteriores à versão 12)
- Criação ou Alteração de Perguntas no arquivo SX1 – Cadastro de Perguntes:
Pergunte | (X1_PERGUNT) |
Nome |
|
Grupo | (X1_GRUPO) |
Ordem | (X1_ORDEM) |
Tipo | (X1_TIPO) |
Tamanho | (X1_TAMANHO) |
2. Criação ou Alteração de tabela no arquivo SX2– Tabelas:
Chave | Nome | Modo | PYME |
B04 (X2_CHAVE) | Dente/Região (X2_NOME) | C (X2_MODO) | N (X2_PYME) |
3. Criação ou Alteração de Tabelas Genéricas no arquivo SX5 – Tabelas Genéricas:
Chave | Ex.: AR |
Descrição | Ex.: Tabela de IR de Aplicações Financeiras |
4. Criação ou Alteração (mantenha somente a instrução correspondente) de Campos no arquivo SX3 – Campos:
- Tabela BGD - Prod x Cob x Proc x Co-Part:
Campo | (X3_CAMPO) |
Tipo | (X3_TIPO) |
Tamanho | (X3_TAMANHO) |
Decimal | (X3_DECIMAL) |
Formato | (X3_PICTURE) |
Título | (X3_TITULO) |
Descrição | (X3_DESCRIC) |
Nível | (X3_NÍVEL) |
Usado | (X3_USADO) Informe Sim ou Não |
Obrigatório | (X3_OBRIGAT) Informe Sim ou Não |
Browse | (X3_BROWSE) Informe Sim ou Não |
Opções | (X3_CBOX) |
When | (X3_WHEN) |
Relação | (X3_RELACAO) |
Val. Sistema | (X3_VALID) |
Help | Descreva o conteúdo informado para Help de Campo no ATUSX |
Importante:
O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.
5. Criação ou Alteração de Consulta Padrão no arquivo SXB – Consulta Padrão:
- Pesquisa B05PLS:
Alias | (XB_ALIAS) |
Tipo | (XB_TIPO) |
Sequência | (XB_SEQ) |
Coluna | (XB_COLUNA) |
Descrição | (XB_DESCRI) |
Contém | (XB_CONTEM) |
6. Criação ou Alteração de Índices no arquivo SIX – Índices:
Índice | AA1 |
Ordem | 6 |
Chave | AA1_FILIAL+AA1_CODVEN |
Descrição | Cod. Vendedor |
Proprietário | S |
7. Criação ou Alteração de Parâmetros no arquivo SX6 – Parâmetros:
Nome da Variável | (X6_VAR) |
Tipo | (X6_TIPO) |
Descrição | (X6_DESCRIC + X6_DESC1 + X6_DESC2) |
Valor Padrão | (X6_CONTEUD) |
8. Criação ou Alteração (mantenha somente a instrução correspondente) de Gatilhos no arquivo SX7 – Gatilhos:
- Tabela BD5 – Contas Médicas:
Campo | Informe o conteúdo do (X7_CAMPO) |
Sequência | Informe o conteúdo do (X7_SEQUENC) |
Campo Domínio | Informe o conteúdo do (X7_CDOMIN) |
Tipo | Informe o conteúdo do (X7_TIPO) |
Regra | Informe o conteúdo do (X7_REGRA) |
Posiciona? | Informe o conteúdo do (X7_SEEK) |
Chave | Informe o conteúdo do (X7_CHAVE) |
Condição | Informe o conteúdo do (X7_CONDIC) |
Proprietário | Informe o conteúdo do (X7_PROPRI) |
Procedimento para Configuração
(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou rotinas no menu).
CONFIGURAÇÃO DE PARÂMETROS
- No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure (mantenha somente a instrução correspondente) o(s) parâmetro(s) a seguir:
(É necessário criar uma tabela para cada parâmetro descrito no item Parâmetro(s), da tabela Características do Requisito)
Itens/Pastas | Descrição |
Nome: |
|
Tipo: | Informe o Tipo do parâmetro |
Cont. Por.: | Informe o Conteúdo padrão |
Descrição: |
|
CONFIGURAÇÃO DE MENUS
2. No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do informe o nome do módulo, conforme instruções a seguir:
Menu | Informe o Menu em que estará localizada a rotina |
Submenu | Informe o Submenu em que estará localizada a rotina |
Nome da Rotina | Informe o Título da rotina |
Programa | Informe o Fonte da rotina |
Módulo | Informe o Nome do(s) produto(s) a ser utilizado ou “Todos” |
Tipo | Informe a Função |
Procedimento para Utilização
- Descreva os procedimentos, passo a passo (caso de uso), que serão realizados pelos usuários para que a melhoria seja visualizada identificando as seguintes informações:
- Localização da rotina no menu;
- Localização dos novos campos e/ou perguntas e respectivas pastas de cadastro que são visualizadas pelo usuário;
- Caso seja necessário ter algum cadastro feito previamente, faça uma observação.
Exemplo:
1. No Plano de Saúde (SIGAPLS), acesse Atualizações / Produto Saúde / Produto Saúde (PLSA800).
O sistema apresenta a janela de produtos cadastrados.
2. Posicione o cursor em um produto e clique em Alterar.
3. Na pasta Cobertura/Carências selecione a subpasta Tipo de Prestador.
4. Dê duplo clique no campo TP Prestador (BCW_TIPPRE).
O sistema apresenta a janela Tipo de Prestador – Coparticipação – Alterar.
5. Informe os dados conforme orientação do help de campo e observe o preenchimento do novo campo:
Som. p/Compra (BCW_SOMCOM): selecione Sim para indicar se a coparticipação cadastrada será válida somente para efeito de compra de procedimentos ou Não, caso contrário.
6. Confira os dados e confirme.
Vídeo
- Vídeo hospedado no youtube e inserido no template por meio da macro Widget Connector.
** Canal do youtube e software de vídeoem definição.
Título do Vídeo: | Disponibilizado pelo Marketing. |
Introdução: | Disponibilizado pelo Marketing. |
Passo a Passo: | Capturar diretamente do sistema. |
Finalização: | Disponibilizado pelo Marketing. |
e arquiva-los, em distintas linhas do tempo para futuro envio ao Educacenso.
Procedimento para Utilização
A funcionalidade de geração dos dados Educacenso sofreu uma reformulação, permitindo ao cliente obter uma “fotografia” dos seus dados em momentos distintos na linha do tempo. Evitando assim, que a volatilidade dos dados ao longo do tempo, mascare a real situação da época requerida. Sendo assim, devemos seguir alguns passos:
1º Passo) Foi criado o campo “data de encerramento de matrícula para efeitos do Educacenso” na matrícula do período letivo, que juntamente com o campo “data de matrícula” irão definir uma lógica de filtro por meio da data de corte informada pelo MEC. A data de corte deverá estar compreendida entre a “data de matrícula” e a “data de encerramento de matrícula para efeitos do Educacenso”, sendo que esta última poderá ser nula. Segue a cláusula que será acrescida às consultas do banco de dados, possibilitando buscar os alunos e suas respetivas turmas, esta lógica se aplica da seguinte forma:
(:DATACORTE >= SMATRICPL.DTMATRICULA AND :DATACORTE <= SMATRICPL. DTMATRICULAENCERRA) OR (:DATACORTE >= SMATRICPL.DTMATRICULA AND SMATRICPL. DTMATRICULAENCERRA IS NULL)
2º Passo) Ambos os campos, “data de matrícula” e “data de encerramento para efeitos do Educacenso” poderão ser alterados por meio de permissão, configurada em “Sistemas Globais” | ” Segurança” | ” Perfis” (sistema: Educacional), para tanto deve-se editar o perfil e através do botão direito do mouse escolher o menu: “Outras informações” ->” Parâmetros educacionais”.
- Permitir alterar a data de matricula no período letivo;
- Permitir alterar a data de encerramento da matricula para efeitos do Educacenso no período letivo.
3º Passo) Na tela de parametrização do TOTVS Educacional é de suma importância a definição das consultas que serão usadas na extração dos dados para o Educacenso (Consultas SQL: MEC.2016.00.00, MEC.2016.00.10, MEC.2016.20.00, MEC.2016.30.00, MEC.2016.40.00, MEC.2016.50.00, MEC.2016.51.00, MEC.2016.60.00, MEC.2016.70.00, MEC.2016.80.00). As consultas necessárias devem ser importadas da seguinte forma:
- No ato da importação, sugere-se importar para todas as coligadas.
- Atentar para a aba parâmetros, e clicar em “Fixo”, para que o código da consulta SQL fique exatamente com o mesmo nome da consulta importada.
- Após importação de todas consultas citadas acima, verificar se as mesmas estão devidamente parametrizadas em “Configurações” | “Parâmetros” | “Secretaria” - “Geral 5/5”.
4º Passo) Executar o processo de preparação do arquivo acessando a funcionalidade: “Atividades acadêmicas” | “Assistentes” | “Preparação do arquivo para o Educacenso”.
5º Passo) Acessar a funcionalidade “Atividades acadêmicas” | “Assistentes” | “Arquivamento e recuperação dos dados do Educacenso”.
6º Passo) Esta funcionalidade será responsável por “tirar as fotografias” dos dados do censo, gerando uma versão base. Neste processo deverá ser informada a “data de corte” definida pelo MEC e então clicar no botão “Gerar arquivo base”, responsável por gerar um arquivo XML “base” que será exibido no canto esquerdo da tela no formato de árvore (treeview). O usuário poderá gerar a versão “base” a partir dos dados da base de dados, ou de uma outra versão “base” já gerada.
7º Passo) Para alterar os dados de uma versão “base” basta seleciona-la e clicar no botão “Ler arquivo”, que carregará os dados e os exibirá no lado direito no formato de árvore.
8º Passo) Os campos “data de matrícula” e “data de encerramento da matrícula para efeitos do Educacenso” na matrícula do período letivo podem sofrer alteração mediante permissão. Desta forma podem ocorrer casos em que o usuário altere os cadastros, possibilitando que um determinado aluno passe a ter mais de uma turma nos dados referente ao registro 80. Tendo em vista este tipo de situação existe a funcionalidade “Considerar último registro de matrícula” (um botão na tela), que permitirá somente a permanência da última matricula feita pelo sistema. Esta verificação será feita a partir do campo físico RECCREATEDON da tabela SMATRICPL.
9º Passo) O botão “Remover item” exclui uma ou várias linhas marcadas, nos casos em que a linha possui filhos estes também serão excluídos.
Exemplos:
- Exclusão do registro 30, ocasiona a exclusão dos itens dos registros 40, 50 e 51.
- Exclusão do registro 60, ocasiona a exclusão dos itens dos registros 70 e 80.
10º Passo) Após fazer os devidos ajustes nos dados destas tabelas, o usuário deverá salvar esta manutenção, clicando no botão “Salvar nova versão XML”. Esta ação gera um novo arquivo XML que será listado na visão em árvore, preservando sempre a versão anterior intacta.
11º Passo) O usuário poderá gerar várias versões de manutenção, no entanto, deverá definir qual será a versão oficial, para que o Gerador de Saídas a utilize no momento de gerar o arquivo TXT definitivo. Para definir a versão oficial basta selecionar a versão desejada e clicar no botão “XML oficial”.
12º Passo) Será permitido excluir todos os arquivos de Manutenção gerados, com exceção do arquivo Base, bastando selecionar a versão desejada e clicar no botão “Excluir arquivo”.
13º Passo) Definido o arquivo XML oficial, o usuário poderá gerar o arquivo .txt que será enviado para o MEC. Para a geração do arquivo o usuário deverá acessar o módulo “Integração” e a funcionalidade disponível no menu: “Gerador de Saídas” | “Layouts”. Nos casos em que o Layout “Educacenso” ainda não tenha sido importado, o usuário deverá fazê-lo por meio do menu anexo à própria visão de Layouts: “Processos” | “Importar Layout”.
14º Passo) Após importação do layout, deve-se executar a geração por meio do menu anexo à própria visão de Layouts: “Processos” | “Geração de Saídas”.
15º Passo) Este processo irá requerer três parâmetros, sendo eles: Código coligada, código filial e ano base.
O conteúdo destes campos será por exemplo: 1 para código coligada, 1 para código filial e 2015 para ano base. O arquivo final será gerado em uma pasta de nome “saídas” criada no mesmo diretório da aplicação, no seguinte formato de nome :
EducaCenso-AAAAMMDDhhmmss, onde, AAAA (ano), MM (mês), DD(dia), hh(hora), mm(minutos), ss(segundos).
Exemplo: EducaCenso-20150720115856
Ponto de Entrada
Descrição: | Informe o Menu em que estará localizada a rotina | ||||||||||||||||
Localização: | Informe o Submenu em que estará localizada a rotina | ||||||||||||||||
Eventos: | Informe o Título da rotina | ||||||||||||||||
Programa Fonte: | Informe o Fonte da rotina | ||||||||||||||||
Função: | Informe o Nome do(s) produto(s) a ser utilizado ou “Todos” | ||||||||||||||||
Retorno: |
|
Exemplo:
#Include 'Protheus.ch'
User Function CN120ALT()
Local aCab:= PARAMIXB[1]
Local cTipo:= PARAMIXB[2]
If cTipo == '1'
aCab[4][2]:= 'NF' //Validações do usuário
EndIf
Return aCab