Exibir origem

Projeto: FS007963 (941582) – Portal da Transparência 2.0
Cliente: SESI / SENAI DN
Autor: Thiago Neiva Chagas
Data: 5 de outubro de 2018

Sumário
Objetivo deste documento
Síntese
Instalando a customização
Requisitos

Req. 01 – Validação de preenchimento de campos (SESI e SENAI)
Req. 02 – Consultas para criação de filtros (SESI e SENAI)
Req. 03 – Consulta dados a serem disponibilizados no Portal

WebService de retorno de consultas SQL

5. Histórico de atualização do documento
5.1. Histórico de versões

1. Objetivo deste documento

Prezados Senhores,
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 o que está descrito no documento FS007963 (941582) – Portal da Transparência 2.0.

2. Síntese

Informar a Síntese do Manual de Customização.

A síntese é a idéia original do projeto, ou seja, a solicitação do cliente.
Contém o que o projeto deve fazer, como deve se comportar, bem como as suas restrições de operação.
Indica as atividades que os usuários deverão ser capazes de executar com a utilização do projeto.
Explicita o objetivo do negócio.

A "Síntese" que consta no documento de Especificação do projeto poderá auxiliar na elaboração desse item, considerando as atualizações necessárias.

3. Instalando a customização

Para instalação desta customização o seguinte cenário é requerido:

Sistema base: TOTVS Educacional
Base de dados: SQL / Oracle
Liguagem: .NET
Versão ERP: Versão

4. Requisitos

4.1. Req. 01 – Validação de preenchimento de campos (SESI e SENAI)

Pré-requisitos / Parametrizações

Necessário habilitar os seguintes campos complementares da turma: "Publica no Portal do Regional", "Vagas gratuid. Regimental/regulamentar", "Data inicial de matrícula", "Data final de matrícula" e "Forma de Inscrição".
Para acessar o roteiro de ativação dos campos complementares, clique aqui.

Detalhamento do processo

Foi desenvolvida uma validação customizada no cadastro de Turmas, a fim de verificar se os campos complementares foram preenchidos.
A customização irá exibir uma mensagem de erro impedindo que a alteração/cadastro da turma seja realizado se o campo "Publica Portal do Regional" estiver com o valor de S (Sim) e algum dos seguintes campos estejam em branco:

- Vagas de Gratuidade
- Data inicial de matrícula
- Data final de matrícula
- Forma de inscrição
- Pré-Requisitos
  - Obs.: o campo Pré-Requisitos, para o SENAI, deverá ser preenchido na Matriz Curricular, e para o SESI, será preenchido na Série (Habilitacao), ambos campos complementares.

Se o campo "Publica Portal do Regional" estiver vazio ou com N (Não), a customização irá permitir que os registros sejam salvos, porém irá alertar com uma mensagem quais os campos complementares que foram preenchidos e que a Turma não será exibida no Portal.

4.2. Req. 02 – Consultas para criação de filtros (SESI e SENAI)

Pré-requisitos / Parametrizações

Detalhamento do processo

Foram desenvolvidas Consultas SQL para que seja possível elaborar os filtros utilizados no Portal Regional.
Para o SESI, foram criadas as seguintes consultas, com seus respectivos parâmetros e retorno:

Consulta	Parâmetros	Retorno
Município	Coligada (Obrigatório)	CIDADE
Programa	Coligada (Obrigatório) e município (opcional)	CODMODALIDADECURSO e MODALIDADECURSO
Produto	Coligada (Obrigatório) e município (opcional) e programa (opcional)	Produto (CODSERVICOSCAE)

Para o SENAI, foram criadas as seguintes consultas:

Consulta	Parâmetros	Retorno
Município	Coligada (Obrigatório)	CIDADE
Área de Atuação	Coligada (Obrigatório) e município (opcional)	Código da Área (CODAREA) e Nome da Área (NOMEAREA)
Curso	Coligada (Obrigatório)e município (opcional) e área de atuação (opcional)	Código do Curso (CODCURSO) e Nome (NOMECURSO)

4.3. Req. 03 – Consulta dados a serem disponibilizados no Portal

Pré-requisitos / Parametrizações

Detalhamento do processo

Foi criada uma consulta SQL para retorno dos dados de gratuidade que serão exibidos no Portal da Transparência.Obs.: uma única consulta foi criada para retorno dos dados no contexto do SESI e SENAI.
Segue abaixo um exemplo de retorno do método da consulta com a descrição e valores de todos os campos retornados.

Exemplo de retorno do método de consulta de vagas de gratuidade
Propriedade	Descrição	SESI	SENAI
CODCOLIGADA	Código da Coligada	2	3
NOMECOLIGADA	Nome da Coligada	SESI	SENAI
CODFILIAL	Código da Unidade de Ensino (Filial)	2002	3002
NOMEFILIAL	Nome da Unidade de Ensino (Filial)	SESI - Ampére	SENAI - Ampére
RUA	Rua da Unidade de Ensino (Filial)	Rua Antenas	Rua Antenas
NUMERO	Número da Unidade de Ensino (Filial)	344	344
COMPLEMENTO	Complemento da Unidade de Ensino (Filial)	100	100
BAIRRO	Bairro da Unidade de Ensino (Filial)	Nossa Senhora das Graças	Nossa Senhora das Graças
CIDADE	Cidade do Prédio da Turma ou da Unidade de Ensino (Filial)	AMPERE	AMPERE
ESTADO	Estado da Unidade de Ensino (Filial)	PR	PR
PAIS	País da Unidade de Ensino (Filial)	Brasil	Brasil
CEP	CEP da Unidade de Ensino (Filial)	85640000	85640000
TELEFONE	Telefone da Unidade de Ensino (Filial)	32719719	32719719
NOMECURSO	Nome do curso	Ensino Médio	Eletrônica Industrial
SERIE	Série	1ª Série
PREREQUISITOS	Pré-requisitos	Idade mínima: Idade máxima: Escolaridade:	Idade mínima: Idade máxima: Escolaridade:
CURSOPRESDIST	Presencial/À distância		Presencial
PROGRAMA	Programa	Educação Básica
CODMODALIDADECURSO	Código da Modalidade do Curso	1, 2, 3, 4, 5, 6, 7	05, 11, 15, 150, 21, 31, 41, 57, 58, 67, 81, 87, 91, 92, 93
MODALIDADECURSO	Nome da Modalidade do Curso	Regular	Iniciação Profissional
CODPRODUTO	Código do Produto SCAE	53
PRODUTO	Nome do Produto SCAE	Ensino médio - 1º ano
NOMEAREA	Área de atuação		Eletrônica
CODTURMA	Código da Turma	1B33VEM	APB-V-000149/2018
NOMETURMA	Descrição da Turma	1B33VEM - 1° CT APENA 15	Eletrônica Industrial – 000149/2018
IDPERLET	Identificador do Período Letivo	2894	2987
CODPERLET	Código do Período Letivo	2018	2018/2
NOMEIDPERLET	Nome do Período Letivo	Período Letivo de 2018	Período Letivo 2º Semestre 2018
NOMEGRADE	Nome da Matriz Curricular	1ª Série - Ensino Médio	Eletrônica Industrial
TURNO	Turno	Manhã	Noite
TIPOMEDIACAO	Tipo de Mediação (Turma)	Presencial	Semipresencial
CARGAHORARIA	Carga Horária da Matriz Curricular	900	200
MAXALUNOS	Máximo de Alunos	40	20
VAGASGRAT	Vagas de gratuidade regimental / regulamentar	5	3
VAGASGRATDISP	Vagas de gratuidade regimental / regulamentar disponíveis	2	1
DTINICIOMATRICULA	Data inicial de Matrícula da Turma	10/09/2017	10/05/2018
DTFINMATRICULA	Data final de Matrícula da Turma	31/10/2017	30/06/2018
DTINICIAL	Data inicial da Turma	01/02/2018	01/08/2018
DTFINAL	Data final da Turma	15/12/2018	15/02/2018

4.4. WebService

5. Histórico de atualização do documento

5.1. Histórico de versões

Data	Autor	Versão	Descrição das alterações
05/10/2018	Thiago Neiva Chagas	1.0	Documento inicial.

O objetivo deste projeto é detalhar a nova integração a ser realizada entre o SGE e o Portal da Transparência na qual ao invés de consumir métodos pré-definidos, será consumido um método que executará uma consulta previamente criada no cadastro de consultas SQL padrão do SGE.

Este documento visa descrever de forma detalhada a solução a ser implementada pela TOTVS.