Projeto FS007783 (874083) – Customização EJA (SESI)
FIERGS
20/11/2017MANUAL OPERACIONAL DA CUSTOMIZAÇÃO
Projeto: FS007780 (873247-874083) – Customização EJA (SESI)
Cliente: FIERGS
Data: 20/11/2017
Sumário
1. Objetivo do documento
2. Síntese
3. Instalando a customização
3.1. Ambiente necessário
3.2. Executando o instalador de arquivos
3.3. Executando os scripts
3.4 Permissão de Acesso a Telas
4. Observações Importantes
5. Requisitos
5.1 Req. 01 – Parâmetros EJA
5.1.1 Pré-Requisitos / Parametrizações
5.1.2 Descrição do Processo
5.2 Req. 02 – Interface de Encontro com Professor – visão do Aluno (Web)
5.2.1 Pré-Requisitos / Parametrizações
5.2.2 Descrição do Processo
5.3 Req. 03 – Interface de Encontro com Professor (Win)
5.3.1 Pré-Requisitos / Parametrizações
5.3.2 Descrição do Processo
5.4 Req. 04 – Impressão da Lista de Presença e Req. 05 – Relatório de Lista de Presença
5.4.1 Pré-Requisitos / Parametrizações
5.4.2 Descrição do Processo
5.5 Req. 06 – Interface Encontro com Professor – visão do Professor (Web)
5.5.1 Pré-Requisitos / Parametrizações
5.5.2 Descrição do Processo
{*}5.6 Req. 07 – Processo de Envio de Frequência AVEA  EJA*
5.6.1 Pré-Requisitos / Parametrizações
5.6.2 Descrição do Processo
5.7 Req. 08 – Processo para Apuração de Presencialidade nos Encontros com Professor
5.7.1 Pré-Requisitos / Parametrizações
5.7.2 Descrição do Processo
6. Histórico de Atualização do Documento

1. Objetivo do documento

O documento a seguir tem por objetivo orientar o usuário sobre as implementações realizadas para sua empresa. Todas as funcionalidades descritas neste manual têm como base do que está descrito no documento "Especificação Anexo I – Detalhamento Funcional – FS007783.

2. Síntese

O objetivo deste projeto é detalhar a solução proposta para buscar as informações de frequência lançadas no curso da Educação Continuada (AVEA) e copiar para o Curso EJA do Aluno no contexto do Ensino Básico. Este projeto também disponibilizará a rotina customizada para inscrição e consolidação das presenças nos Encontros com Professor.
Este documento tem como objetivo orientar o usuário na utilização da customização desenvolvida pela TOTVS.

3. Instalando a customização

3.1. Ambiente necessário

• Sistema base: TOTVS Educacional
• Banco de dados: Oracle
• Versão do ERP: 12.1.17

3.2. Executando o instalador de arquivos

O instalador é gerado com o nome "TOTVS Customização – Customização EJA - 12.01.17.exe" e esse copiará todos os arquivos referentes a customização para a máquina do usuário. O instalador de arquivos deverá ser executado em todas as máquinas que utilizarão a Customização.

Figura – Instalador Passo 1

Figura – Instalador Passo 2

Figura – Instalador Passo 3

Figura – Instalador Passo 4

Após a instalação o usuário poderá consistir os arquivos correspondentes a customização.

Importante!
Conforme descrito na especificação, ressaltamos que plugins e dlls desenvolvidos para a versão acima podem apresentar algum tipo de incompatibilidade nas próximas versões oficiais, precisando assim serem recompilados(as). Portanto, qualquer mudança de versão deve ser previamente comunicada à TOTVS. A forma dessa comunicação é a seguinte:

• Abertura de uma ocorrência junto ao suporte (suporte.totvs.com) com no mínimo 15 dias de antecedência da data marcada para conversão, solicitando ao departamento de customização a conversão do plugin.
  
• Após recebimento do mesmo executar a validação de suas funcionalidades em um ambiente de testes da nova versão.
  No Painel de Controle, a instalação é gerada conforme abaixo:
  
  Figura – Conclusão
  

  3.3. Executando os scripts

• Executar o script 'TOTVS_Custom_Register_Action.sql';
• Executar o script 'TOTVS_Custom_Consolidate_All.sql;

3.4 Permissão de Acesso a Telas

3.4.1 Verificando o Perfil do Usuário

1. O usuário deve acessar o RM.exe em C:\totvs\CorporeRM\RM.Net
2. Acessar TOTVS Serviços Globais | Segurança | Usuário;
3. No campo (Sistema: ) selecione o produto correto;
4. Busque pelo usuário desejado e clique em editar;
5. Navegue até a aba Segurança;
6. Verifique qual é o perfil do usuário (Como mostra na imagem exemplo abaixo o perfil é DBA);

Figura – Permissão - Passo 1

Figura – Permissão - Passo 2

3.4.2 Liberando Acesso aos Menus

1. TOTVS Serviços Globais | Segurança | Perfis;
2. No campo (Sistema: ) selecione o produto correto;
3. Busque pelo perfil desejado e clique em editar (como no exemplo acima o perfil será DBA);
4. Navegue até a aba Acesso a Menus;
5. Procure pelas customizações e selecione as desejadas;
6. Clique em Permitir Acesso e depois em Ok.

Figura – Liberando Acesso

4. Observações Importantes

Para o correto funcionamento do Novo Gerenciador de Jobs algumas configurações devem ser observadas. Dentro da pasta "X:\totvs\CorporeRM\RM.Net" cinco arquivos precisam ser verificados. São eles:

• RM.Host.exe.config.

Certifique-se a tag <add key="JobServer3Camadas" value="true"/> está com o value igual a true.
Adicionar: <add key="IsolateProcess" value="true" />
Adicionar: <add key="EnableProcessIsolation" value="true" />

• RM.Host.Service.exe.config.

Certifique-se a tag <add key="JobServer3Camadas" value="true"/> está com o value igual a true.
Adicionar: <add key="IsolateProcess" value="true" />
Adicionar: <add key="EnableProcessIsolation" value="true" />

• RM.exe.config.

Certifique-se a tag <add key="JobServer3Camadas" value="true"/> está com o value igual a true.

• Alias.dat.

Certifique-se a tag <add key="JobServer3Camadas" value="true"/> está com o value igual a true.
Servidores de (Servidores de JOB e APP) para que as customizações sejam carregadas: <RunService>true</RunService>.

• RM.Host.JobRunner.exe.config (SOMENTE SERVIDORES JOB).

Certifique-se a tag <add key="JobServer3Camadas" value="true"/> está com o value igual a true.
Para carregar os plug-ins de processos customizados: <add key="LoadCustomSlave" value="true" />.

5. Requisitos

5.1 Req. 01 – Parâmetros EJA

Este requisito detalha a disponibilização da tela customizada de Parâmetros EJA, descrevendo os parâmetros necessários para os processos customizados.

5.1.1 Pré-Requisitos / Parametrizações

Não se aplica.

5.1.2 Descrição do Processo

A tela de Parâmetros EJA está disponível no TOTVS Educacional, menu Customização | Parâmetros EJA.

A partir dela, o usuário poderá configurar os seguintes parâmetros:

• Limite para inscrição: Usuário poderá definir o prazo em horas antes do término do encontro para realizar a inscrição. Exemplo:
  • • Encontro com Professor programado para o dia 17/07/2017 de 08 às 12 horas (registro do Plano de Aula).
    • Usuário parametriza 1 hora.
    • Será possível realizar inscrição até as 11:00 horas do dia 17/07/2017

• Limite para cancelamento: Usuário define o prazo em horas, antes do início do encontro, que será considerado no cancelamento de inscrição para Encontro com Professor através do Portal. Exemplo:
  • • Encontro com Professor programado para o dia 17/07/2017 de 10 às 12 horas (registro do Plano de Aula).
    • Usuário parametriza 3 horas.
    • Será possível cancelar inscrição até as 07:00 horas do dia 17/07/2017.

• Relatório de Lista de Presença: Usuário define qual relatório será utilizado para gerar a Lista de Presença dos Encontros.

• Frequência Encontro com Professor: Usuário define o código da Etapa de Frequência de Encontro com Professor.

• Frequência AVEA: Usuário define o código da Etapa de Frequência AVEA.

• Situação de Matrícula Isolada: Usuário define o código da Situação de Matrícula que será utilizada ao gerar a matrícula isolada (Requisito 06).

• N° de Horas para Frequência: Usuário define o número máximo de horas dos Encontros com Professor que serão considerados na apuração de frequência, descrita no Req. 08 – Processo de Apuração de Presencialidade nos Encontros com Professor. Se o aluno ultrapassar o número máximo, a carga horária máxima será o valor desse parâmetro.

• Permite Professor Finalizar Encontro: Usuário marca o Flag caso queira que a opção de Finalizar Encontro do "Req. 06 – Interface de Encontro com Professor – visão do Professor (Web)" esteja disponível para os Professores. Caso contrário apenas pela interface detalhada no "Req. 03 – Interface de Encontro com Professor (Win)" será possível finalizar Encontros.

• Modalidades: Usuário define as modalidades dos Cursos que serão permitidos para gerar os encontros.

Tela da Parametrização da customização

5.2 Req. 02 – Interface de Encontro com Professor – visão do Aluno (Web)

Este requisito detalha a disponibilização da Interface de Encontro com Professor – acesso do Aluno através do Portal Web.

5.2.1 Pré-Requisitos / Parametrizações

1. O Aluno precisa ter o acesso ao portal configurado (usuário e senha).
2. Gerar o Plano de Aula das Turmas/Disciplinas de Encontro com Professor.

5.2.2 Descrição do Processo

A interface está disponível no Portal Educacional do Aluno, botão Menu, link customizado Encontro com Professor.
O link customizado existe no antigo e no novo Portal do Aluno.

Link Encontro Professor – Portal Educacional
Através deste Portal o Aluno poderá ser se inscrever nos encontros com o professor disponíveis. Ao acessar o link, a tela de Encontro será exibida conforme abaixo:

Lista de Encontros disponíveis para inscrição


Estarão listados todos os planos de aula das disciplinas de Encontro, respeitando as seguintes regras:

• O aluno deverá estar matriculado na mesma Turma das Turmas\Disciplinas do Encontro.
• A disciplina do Encontro deverá ser Disciplina Filha de alguma Disciplina na qual o Aluno possua matrícula no mesmo Período Letivo.
• O período letivo será o parametrizado no TOTVS Educacional, ou seja, o atual.
• Modalidade do Curso vinculado à Turma/Disciplina (SCURSO.CODMODALIDADECURSO) deverá estar parametrizada no Req. 01 – Parâmetros EJA.
• Encontro não poderá estar encerrado.

Os encontros serão agrupados por horário. Exemplo:

• Plano de Aula – Matemática – 8:00 – 09:00.
• Plano de Aula – Matemática – 9:00 – 10:00.
• Plano de Aula – Matemática – 10:00 – 11:00.
• Plano de Aula – Matemática – 11:00 – 12:00.

Para o exemplo acima, será exibido apenas um registro, Encontro Matemática – 08:00 a 12:00.
Através da página de encontros, o aluno poderá se Inscrever ou Cancelar a inscrição no encontro, respeitando os prazos de cancelamento e inscrição definidos na parametrização (Requisito 01). Se o prazo de inscrição estiver encerrado ou o encontro esteja com a capacidade máxima de alunos atingida, uma mensagem será exibida e os botões serão ocultados.

5.3 Req. 03 – Interface de Encontro com Professor (Win)

Este requisito detalha a disponibilização da Interface de Encontro com Professor (Win).

5.3.1 Pré-Requisitos / Parametrizações

Não se aplica.

5.3.2 Descrição do Processo

A interface está disponível no TOTVS Educacional, menu Customização, uma tela "Encontros Professor", para que os usuários (professores e secretaria) possam consultar os Encontros e cancelar ou realizar novas inscrições.

Serão listados os encontros, agrupando todos os horários do dia em um único registro, de acordo com as seguintes regras:

• Planos de Aula de uma Turma/Disciplina que possua o campo complementar Encontro com Professor preenchido como Sim (STURMADISCCOMPL.ENCONTRO = 1).
• Modalidade do Curso vinculado à Turma/Disciplina (SCURSO.CODMODALIDADECURSO) estar parametrizada no Req. 01 – Parâmetros EJA.
• Os encontros serão agrupados pelo Curso, Disciplina, Turno e Data. Portanto, Alunos matriculados em séries diferentes serão exibidos em um único registro.

Ao acessar um encontro, serão exibidos todos os alunos inscritos e se ele esteve presente/ausente em cada horário.

Tela de Encontro com Professor, com a listagem dos alunos inscritos e a frequência em cada horário
Se o encontro não estiver Encerrado, o usuário poderá incluir ou excluir as inscrições. Se os prazos estiverem sido encerrados, uma mensagem será exibida solicitando a confirmação da inclusão.
Obs.: não será possível alterar a presença dos alunos no encontro por meio desta interface.
No menu Encontros Professor -> Processos, foi adicionado a rotina de Finalização do Encontro com o Professor. Ao executá-lo, a customização irá realizar os seguintes passos:

• Caso ainda não exista, será gerada uma matrícula isolada para cada aluno inscrito no Encontro. Será utilizado a turma/disciplina e período letivo do encontro selecionado para a geração do registro. A situação utilizada será a parametrizada no Requisito 01.
• Após a efetivação da matrícula, a customização irá lançar as frequências diárias dos alunos, seguindo as regras padrões da rotina disponível no TOTVS Educacional em Matrícula e Avaliação | Frequência diária. A etapa utilizada será a parametrizada no Requisito 01.

5.4 Req. 04 – Impressão da Lista de Presença e Req. 05 – Relatório de Lista de Presença

Este requisito detalha o processo de impressão de Lista de Presença e o conteúdo do relatório (Alunos do Encontro com Professor).

5.4.1 Pré-Requisitos / Parametrizações

1. Importar o relatório de lista de presença disponibilizado pela customização (arquivo Lista Presenca.TotvsReport).
2. Parametrizar o código do relatório (CstRelListPresenca) no menu Customização, Parâmetros EJA, para que seja utilizado neste processo.

5.4.2 Descrição do Processo

Através do menu de "Encontros Professor" (Requisito 03), o usuário possui disponível o processo "Imprimir Lista de Presença", que, ao ser executado, efetuará a geração do relatório.
Serão listados todos os alunos inscritos no encontro, com blocos para cada horário, que corresponde a um plano de aula no TOTVS Educacional e um bloco para assinatura. Serão gerados também 10 linhas em branco, para que o Professor possa marcar a presença de eventuais alunos que ainda não se inscreveram.

Lista de presença do Encontro

5.5 Req. 06 – Interface Encontro com Professor – visão do Professor (Web)

Este requisito detalha a Interface de Encontro com Professor, utilizada pelo usuário Professor para gerenciamento dos Encontros.

5.5.1 Pré-Requisitos / Parametrizações

1. Usuário professor precisa ter acesso ao Portal RM.

5.5.2 Descrição do Processo

O docente poderá acessar a nova página através do Portal RM do TOTVS Educacional, acessando a aba Professores e o menu "Encontros Professor":

Menu para acesso à página de Encontros Professor
Nesta interface serão exibidos os encontros ministrados pelo professor logado, que atendam as seguintes regras:

• Turmas/Disciplinas com o campo complementar Encontro com Professor igual a "Sim".
• Período Letivo da Turma/Disciplina deve ser o parametrizado em TOTVS Educacional | Ambiente | Parâmetros | Secretaria | Período Letivo (Período Vigente).
• Encontro não encerrado.
• Professor logado está cadastrado na Turma/Disciplina.

Todos os planos de aula gerados serão agrupados se ocorrem no mesmo dia, resultando em um único registro. Porém, serão separados no momento de lançar a frequência diária.

Lista de Encontros ministrados pelo professor logado
A partir da listagem dos encontros, o professor poderá lançar as Ausências dos alunos ou Finalizar o encontro se assim estiver habilitado na parametrização (Requisito 01).
Ao acessar a tela de Ausências, serão listados todos os horários do encontro, e o professor deverá marcar os campos para indicar que o aluno estava ausente:

Tela para marcação de Ausências dos Alunos inscritos no Encontro

5.6 Req. 07 – Processo de Envio de Frequência AVEA  EJA

Este requisito detalha o processo customizado de envio da frequência do Aluno no Curso AVEA para o Curso EJA.

5.6.1 Pré-Requisitos / Parametrizações

Não se aplica.

5.6.2 Descrição do Processo

O usuário poderá acessar a tela de Consolidação de Frequência através do menu TOTVS Educacional -> Aba Customização -> menu Consolidar Frequência AVEA.

Inicialmente, o usuário deverá selecionar os Cursos AVEA. Estarão disponíveis para seleção Cursos em que a sua série possua o campo complementar "Compõe Carga Horária EJA" definido como "Sim".
Em seguida, serão exibidas todas as Turmas/Disciplinas vinculadas aos cursos selecionados na primeira grid, sem nenhuma restrição.
Por último, o usuário deverá selecionar os alunos que possuem matrículas nas Turmas/Disciplinas selecionadas e estão com o status de Aprovado para a execução do processo.

Após iniciar a execução a customização irá calcular, a partir das matrículas do Aluno nos Cursos AVEA, o total de aprovações que ele obteve, somando a carga horária da Disciplina da Matriz Curricular em que ele obteve a aprovação.
Em seguida, a customização irá copiar as informações para a tabela de Notas/Faltas (SNOTAETAPA), para a Turma/Disciplina EJA com campo complementar "Seminário" = Sim em que o aluno esteja matriculado. O somatório realizado será copiado para o campo Aulas Dadas das Notas da Etapa (SNOTAETAPA.AULASDADAS). A etapa em que a frequência será armazenada é a definida na Parametrização, campo "Etapa Frequência AVEA".
Observação: O campo Nota/Falta será sempre preenchido com 0.
Exemplo:

Dados que serão recebidos na EJA:

O valor a ser enviado para a matrícula EJA será de 12 (3 * 4).

5.7 Req. 08 – Processo para Apuração de Presencialidade nos Encontros com Professor

Este requisito detalha o processo customizado de apuração da frequência dos alunos nos Encontros com Professor.

5.7.1 Pré-Requisitos / Parametrizações

1. Usuário professor precisa ter acesso ao Portal RM.

5.7.2 Descrição do Processo

O processo de apuração de frequência dos encontros com Professor está disponível através do menu TOTVS Educacional | Customização | Encontros com Professor | Processos | Consolidação dos Encontros com Professor.

Ao executar o processo, a customização irá somar todas as presenças em Encontros que estejam encerrados e irá agrupar por RA, Curso e Série. Em seguida, o parâmetro "N° de Horas para Frequência" será verificado para realizar o cálculo do valor a ser gravado na tabela de Notas/Faltas (SNOTAETAPA), de acordo com a seguinte regra:

• A consolidação se dará pelo número de ausências em relação ao "N° de Horas para Frequência" definido na parametrização da customização. Ou seja, se estiver parametrizado o "N° de Horas para Frequência" = 20, significa que máximo de horas computáveis relacionadas à Encontros com Professor é 20.
• A consolidação de presenças em Encontros com Professor será por Curso/Série. Ou seja, serão compiladas as frequências em todas as Turmas/Disciplinas de Encontro com Professor no mesmo Curso/Série e gravadas na tabela SNOTAETAPA.

Exemplo para o campo "N° de Horas para Frequência" = 20:

• Se um Aluno estiver presente em 8 Encontros será calculado 12 horas de ausência. Esta lógica será utilizada para frequência entre 1 e 19 Aulas de Encontros.
• Se um Aluno estiver presente em 20 Aulas de Encontros será calculada uma ausência de 0 horas.
• Se um Aluno estiver presente em mais de 20 Aulas de Encontros será calculada uma ausência de 0 horas.
• Se um Aluno estiver presente em 0 Encontros ou sequer tenha se inscrevido em Encontros será calculada uma ausência de 20 horas.

Além da validação das ausências em relação às inscrições realizadas pelos Alunos nos Encontros com Professor serão considerados também aqueles Alunos que sequer se inscreveram em Encontros com Professor e portanto não existe registro algum dos mesmos nas tabelas customizadas. Nestes casos a Customização irá avaliar dentre todas as matrículas no Período Letivo (SMATRICPL) atual em Cursos cuja a Modalidade é EJA aqueles Alunos que não possuem registro na ZEJAENCONTRO e então será gerado um registro na SNOTAETAPA com o campo FALTAS e AULASDADAS igual ao parâmetro de "N° de Horas para Frequência".

6. Histórico de Atualização do Documento

6.1. Histórico de Versões

6.2. Aprovação