Páginas filhas
  • Manual Operacional da Customização - Integração Itinerário - FS007523

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

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 FS007523 - Integração Itinerário.

Síntese

O SENAI possui a necessidade de realizar a integração de cursos entre a base do Itinerário Nacional e a base SGE DN, e desta base para as bases do SGE dos diversos DR's existentes nos estados.

Esta integração se dá em duas partes.

A primeira delas, correspondente à este manual, são os cadastros que serão alimentados e comporão os dados integrados entre os sistemas.

Requisitos


Expandir
titleReq. 01 – Cadastro Customizado de Unidades de Competência

Pré-Requisitos / Parametrizações

Não se aplica.

Detalhamento do Processo

Foi desenvolvido no menu Customizado do TOTVS Educacional o cadastro de Unidades de Competência.

O usuário poderá inserir, editar e excluir os registros dessa entidade. Os seguintes campos estarão disponíveis para edição:

  • Competência (obrigatório): será gravado o código da Competência.
  • Descrição (obrigatório): será gravado a descrição da Competência.

Image Modified

O usuário poderá também inserir as capacidades da Unidade, que podem ser Capacidades Técnicas (Detalhadas no Requisito 3) e Capacidades de Gestão (Detalhadas no Requisito 4).

Image Modified

Image Modified

Expandir
titleReq. 02 – Cadastro Customizado de Fundamentos Técnicos Científicos

Pré-Requisitos / Parametrizações

Nenhum.


Detalhamento do Processo

Foi desenvolvido no menu Customizado do TOTVS Educacional o cadastro de Fundamentos Técnicos Científicos.

O usuário poderá inserir, editar e excluir os registros dessa entidade. Os seguintes campos estarão disponíveis para edição:

  • Código (obrigatório): será gravado o código do Fundamento Téc. Científico.
  • Descrição (obrigatório): será gravado a descrição do Fundamento Téc. Científico.

Na tela de visualização dos dados, o usuário poderá consultar ainda se o registro foi inserido manualmente ou via Integração, através da coluna Origem Registro.

Image Modified

Image Modified


Expandir
titleReq. 03 – Cadastro Customizado de Capacidades Técnicas

Pré-Requisitos / Parametrizações

Nenhum.


Detalhamento do Processo

Foi desenvolvido no menu Customizado do TOTVS Educacional o cadastro de Capacidades Técnicas.

O usuário poderá inserir, editar e excluir os registros dessa entidade. Os seguintes campos estarão disponíveis para edição:

  • Código (obrigatório): será gravado o código da Capacidade Técnica.
  • Descrição (obrigatório): será gravado a descrição da Capacidade Técnica.

Na tela de visualização dos dados, o usuário poderá consultar ainda se o registro foi inserido manualmente ou via Integração, através da coluna Origem Registro.

Image Modified

Image Modified


Expandir
titleWeb Service Consulta SQLReq. 04 – Cadastro Customizado de Capacidades de Gestão

Pré-Requisitos / Parametrizações

Nenhum.


Detalhamento do Processo

Foi desenvolvido

um Web Service destinado a executar consultas SQL's cadastradas no RM.

Ao realizar a instalação da customização, ele estará disponível para acesso através do serviço do RM.

Segurança

Para a autenticação no Web Service, é utilizado um Token, gerado pela tela de parametrização da customização.

Para isso, o usuário deverá acessar a tela de Parâmetros, no menu "TOTVS Educacional→Customização→Parâmetros".

Após acessar a tela, preencher os campos Usuário e Senha com dados válidos para realizar um login no RM. Em seguida, executar o processo "Gerar Token".

O Token gerado no campo "Token Portal Transparência V2" deverá ser enviado em todas as requisições, no header "Authorization", da seguinte forma: Basic token_gerado.

Parâmetros do Web Service

O web service possui 3 parâmetros, sendo dois deles obrigatórios e todos enviados via GET:

no menu Customizado do TOTVS Educacional o cadastro de Capacidades de Gestão.

O usuário poderá inserir, editar e excluir os registros dessa entidade. Os seguintes campos estarão disponíveis para edição:

  • Código (obrigatório): será gravado o código da Capacidade de Gestão.
  • Descrição (obrigatório): será gravado a descrição da Capacidade de Gestão.
  • Tipo (obrigatório): O tipo da capacidade de Gestão poderá ser Metodológica, Organizativa ou Social.

Na tela de visualização dos dados, o usuário poderá consultar ainda se o registro foi inserido manualmente ou via Integração, através da coluna Origem Registro.


Image Added

Image Added

Expandir
titleReq. 05 – Cadastro Customizado de Conhecimentos

Pré-Requisitos / Parametrizações

Nenhum.


Detalhamento do Processo

Foi desenvolvido no menu Customizado do TOTVS Educacional o cadastro de Conhecimentos.

O usuário poderá inserir, editar e excluir os registros dessa entidade. Os seguintes campos estarão disponíveis para edição:

  • Código (obrigatório): será gerado automaticamente um código do Conhecimento.
  • Descrição Conhecimento Nível 1 (obrigatório): será gravado a descrição do primeiro nível do Conhecimento.
  • Descrição Conhecimento Nível 2: será gravado a descrição do segundo nível do Conhecimento.
  • Descrição Conhecimento Nível 3: será gravado a descrição do terceiro nível do Conhecimento.


Image Added


Na tela de visualização dos dados, o usuário poderá consultar ainda se o registro foi inserido manualmente ou via Integração, através da coluna Origem Registro.

Image Added

Expandir
titleReq. 06 – Cadastro Customizado de Ambientes Pedagógicos

Pré-Requisitos / Parametrizações

Nenhum.


Detalhamento do Processo

Foi desenvolvido no menu Customizado do TOTVS Educacional o cadastro de Ambientes Pedagógicos.

O usuário poderá inserir, editar e excluir os registros dessa entidade. Os seguintes campos estarão disponíveis para edição:

  • Código (obrigatório): será gravado o código do Conhecimento.
  • Descrição (obrigatório): será gravado a descrição do Conhecimento.
  • Tipo (obrigatório): O tipo do Ambiente Pedagógico poderá ser:

Máquinas

Equipamentos

Ambientes Pedagógicos

Material Didático

Máquinas, Equipamentos, Instrumentos e Ferramentas

Ferramentas e Suprimentos

Instrumentos

Materiais

Equipamentos, Ferramentas e Instrumentos

Recursos Didáticos

Mobiliário

Observações/Recomendações


Na tela de visualização dos dados, o usuário poderá consultar ainda se o registro foi inserido manualmente ou via Integração, através da coluna Origem Registro.

Image Added

Image Added

Expandir
titleReq. 07 – Anexo Customizado de Unidade de Competência - Curso

Pré-Requisitos / Parametrizações

Nenhum.


Detalhamento do Processo

Foi desenvolvido um anexo customizado no TOTVS Educacional, menu Currículo e Oferta – Matrizes Curriculares.

O usuário poderá inserir, editar e excluir os registros dessa entidade. Os seguintes campos estarão disponíveis para edição:

  • Competência (obrigatório): um lookup onde o usuário irá selecionar a Unidade de Competência (Detalhada no Requisito 1) desejada para ser inserida na Matriz Curricular.

Na tela de visualização dos dados, o usuário poderá consultar ainda se o registro foi inserido manualmente ou via Integração, através da coluna Origem Registro.

Image Added

Image Added

Expandir
titleReq. 08 – Anexo Customizado de Unidade de Competência - Disciplina

Pré-Requisitos / Parametrizações

Nenhum.


Detalhamento do Processo

Foi desenvolvido um anexo customizado no TOTVS Educacional, menu Currículo e Oferta – Disciplinas.

O usuário poderá inserir, editar e excluir os registros dessa entidade. Os seguintes campos estarão disponíveis para edição:

  • Competência (obrigatório): um lookup onde o usuário irá selecionar a Unidade de Competência (Detalhada no Requisito 1) desejada para ser inserida na Disciplina.

Na tela de visualização dos dados, o usuário poderá consultar ainda se o registro foi inserido manualmente ou via Integração, através da coluna Origem Registro.

Image Added

Image Added

Expandir
titleReq. 09 – Anexo Customizado de Fundamentos Técnicos Científicos – Disciplina

Pré-Requisitos / Parametrizações

Nenhum.


Detalhamento do Processo

Foi desenvolvido um anexo customizado no TOTVS Educacional, menu Currículo e Oferta – Disciplinas.

O usuário poderá inserir, editar e excluir os registros dessa entidade. Os seguintes campos estarão disponíveis para edição:

  • Fundamentos Técnicos Científicos (obrigatório): um lookup onde o usuário irá selecionar o Fundamento Técnico Científico (Detalhada no Requisito 2) desejada para ser inserida na Disciplina.

Na tela de visualização dos dados, o usuário poderá consultar ainda se o registro foi inserido manualmente ou via Integração, através da coluna Origem Registro.

Image Added

Image Added

Expandir
titleReq. 10 – Anexo Customizado de Capacidades Técnicas – Disciplina

Pré-Requisitos / Parametrizações

Nenhum.


Detalhamento do Processo

Foi desenvolvido um anexo customizado no TOTVS Educacional, menu Currículo e Oferta – Disciplinas.

O usuário poderá inserir, editar e excluir os registros dessa entidade. Os seguintes campos estarão disponíveis para edição:

Capacidades Técnicas (obrigatório): um lookup onde o usuário irá selecionar a Capacidade Técnica (Detalhada no Requisito 3) desejada para ser inserida na Disciplina.


Image Added

Image Added

Expandir
titleReq. 11 – Anexo Customizado de Capacidades de Gestão – Disciplina

Pré-Requisitos / Parametrizações

Nenhum.


Detalhamento do Processo

Foi desenvolvido um anexo customizado no TOTVS Educacional, menu Currículo e Oferta – Disciplinas.

O usuário poderá inserir, editar e excluir os registros dessa entidade. Os seguintes campos estarão disponíveis para edição:

Capacidades Técnicas (obrigatório): um lookup onde o usuário irá selecionar a Capacidade Técnica (Detalhada no Requisito 3) desejada para ser inserida na Disciplina.


Image Added

Image Added

Expandir
titleReq. 12 – Anexo Customizado de Conhecimentos – Disciplina da Grade

Pré-Requisitos / Parametrizações

Nenhum.


Detalhamento do Processo

Foi desenvolvido um anexo customizado no TOTVS Educacional, menu Currículo e Oferta – Matrizes Curriculares – Anexo Período – Anexo Disciplinas da Matriz Curricular – Anexo Conhecimentos.

O usuário poderá inserir, editar e excluir os registros dessa entidade. Os seguintes campos estarão disponíveis para edição:

  • Código Conhecimento(obrigatório): um lookup onde o usuário irá selecionar o Conhecimento (Detalhada no Requisito 5) desejada para ser inserida na Disciplina da Matriz Curricular.
  • Aba Capacidades: o usuário poderá inserir N Capacidades, Técnicas ou de Gestão.

Image Added

Image Added

Image Added


Expandir
titleReq. 13 – Cadastro Customizado de Fundamentos Técnicos Cientifícos

Pré-Requisitos / Parametrizações

Nenhum.


Detalhamento do Processo

Foi desenvolvido um anexo customizado no TOTVS Educacional, menu Currículo e Oferta – Matrizes Curriculares – Anexo Período – Anexo Disciplinas da Matriz Curricular – Anexo Capacidades Ambientes Pedagógicos.

O usuário poderá inserir, editar e excluir os registros dessa entidade. Os seguintes campos estarão disponíveis para edição:

  • Cód. Ambiente Pedagógico (obrigatório): um lookup onde o usuário irá selecionar o Ambiente Pedagógico (Detalhado no Requisito 6) desejada para ser inserida na Disciplina da Matriz Curricular.

Image Added

Image Added



Expandir
titleReq. 14 – Tela de Parâmetros da Customização - SGE x Itinerário

Pré-Requisitos / Parametrizações

Nenhum.


Detalhamento do Processo

Foi desenvolvido uma parametrização customizada no TOTVS Educacional, menu Customização – Parametrização SGE x Itinerário. O menu de acesso à tela está localizado no TOTVS Educacional -> Customização -> Integração SGE x Itinerário -> Parametrização SGE x Itinerário.

O usuário poderá configurar os seguintes campos:

  • Endereço do Web Service: Deverá ser inserido o endereço do WebService fornecido pelo Itinerário.
  • Usuário: Deverá ser inserido o usuário do Itinerário.
  • Token: Deverá ser inserido o Token de segurança para o acesso ao Itinerário.


Image Added


Aba Segurança:

O usuário irá gerar um Token de Segurança para que os DR’s utilizem o WebService Totvs. Para isso, é preciso digitar um Usuário e Senha validos para login no RM e clicar em Gerar Token. Após isso, basta Salvar e encaminhar o Token para que possa ser inserido na Parametrização DR x Diretório Nacional.


Image Added


Aba De-Para Área:

O usuário deverá cadastrar os De-Paras das Áreas. Serão exibidos dois campos na tela, o primeiro virá preenchido com as áreas do itinerário, e o segundo, com os dados do Totvs Educacional.


Image Added


Aba De-Para Modalidade:

O usuário deverá cadastrar os De-Paras das Modalidades. Serão exibidos dois campos na tela, o primeiro virá preenchido com as modalidades do itinerário, e o segundo, com os dados do Totvs Educacional.


Image Added


Aba Abreviação Modalidade:

O usuário deverá cadastrar as abreviações das Modalidades, com no máximo 3 caracteres, para serem utilizadas na geração dos Códigos do Curso, Grades e Disciplinas.


Image Added


Aba Versões Itinerário:

O usuário deverá cadastrar as Versões do Itinerário que estarão disponíveis para consulta no processo de Integração de Cursos.


Image Added


Exemplo de uma requisição enviada para o WebService

Consulta SQL cadastrada no RM, com o código "CstTesteFiltros".

Como podemos ver na imagem abaixo, ela retorna os dados do município e tem um parâmetro (MUNICIPIO).

Image Removed

Exemplo do envio da requisição via Postman:

Image Removed

Código da requisição em HTTP

GET /rm/api/TOTVSCustomizacao/ConsultasSQL/ExecutaConsultaSQL?codColigada=0&codSentenca=CstTesteFiltros&parameters=MUNICIPIO=Belo Horizonte HTTP/1.1
Host: localhost:8080
Authorization: Basic bWVzdHJlOnRvdHZz



Expandir
titleReq. 15 – Processo de Integração de Cursos - Itinerário - TOTVS SGE

Pré-Requisitos / Parametrizações

Nenhum.


Detalhamento do Processo

Este processo tem como objetivo consultar a base de dados do Itinerário, utilizando um WebService, e de acordo com a seleção realizada pelo usuário efetuar a integração de cursos no TOTVS SGE. No processo de integração serão importados para a base do SGE Cursos, Habilitação,Matriz Curricular, Período, Disciplinas, Disciplinas no Período e Competências. O menu de acesso ao processo está localizado no TOTVS Educacional -> Customização -> Integração SGE x Itinerário -> Integração Curso.


Na primeira etapa o usuário deverá selecionar a Área, Modalidade e Versão do Itinerário, para que sejam pesquisados os Cursos do Itinerário, obedecendo os dados selecionados. As Áreas e Modalidades deverão ser parametrizadas nos De-Paras (Requisito 14) para que sejam exibidas nos campos. Após a seleção do Curso, o usuário poderá avançar para a segunda etapa.


Image Added


Na segunda etapa, serão exibidos os dados selecionados para conferência. Após a verificação e validação das informações, o usuário poderá avançar para a terceira etapa.

Image Added

Na terceira etapa, serão exibidos os Módulos e as Unidades Curriculares que serão importadas. Será gerada uma nova grade, onde os Módulos serão os Períodos e as Unidades Curriculares serão as Disciplinas, que serão vinculadas aos correspondentes Períodos. O usuário deverá validar e prosseguir para a quarta etapa.


Image Added

Na quarta etapa, serão exibidas as disciplinas em conflito, ou seja, as que já existem cadastradas no TOTVS Educacional. Para cada uma das disciplinas existentes, serão exibidas as Unidades de Competência já cadastradas e as que serão criadas. O usuário poderá apenas atualizar a disciplina, inserindo as novas unidades de competência ou poderá criar uma nova. Para isso, o usuário deverá selecionar o menu presente em cada linha, definindo como “Atualizar Unidade Curricular” ou “Criar Unidade Curricular”.


Exemplo:

  • Disciplina 1
    • Unidades de Competência existentes
      • Unidade Competência 1
    • Unidades de Competência que serão criadas
      • Unidade Competência 2


Se o usuário selecionar a opção “Atualizar Unidade Curricular”, a disciplina será atualizada e ficará com os seguintes dados:

  • Disciplina 1
    • Unidades de Competência:
      • Unidade Competência 1
      • Unidade Competência 2


Se o usuário optar por “Criar Unidade Curricular”, será gerada uma nova disciplina com as duas unidades de competência anteriores.

               

Image Added


Após a verificação das disciplinas em Conflito, o processo será executado. Serão importados os Cursos, Módulos (Período no SGE), Unidades Curriculares (Disciplinas no SGE), Unidades de Competência, Conhecimentos, Fundamentos Técnicos Científicos, Capacidades Técnicas e de Gestão e Capacidades de Ambientes Pedagógicos.


As unidades de Competência carregadas serão integradas no Anexo de Unidades de Competência da Matriz Curricular. 

Os Fundamentos Técnicos Científicos, Capacidades Técnicas e de Gestão serão integrados como anexos da Disciplina.

ParâmetroConteúdo esperado
CodColigada (Obrigatório)A coligada da consulta SQL cadastrada no RM.
CodSentenca (Obrigatório)O Código da sentença SQL.
Parametros (Opcional)

Os parâmetros da consulta SQL. Devem ser passados da seguinte forma:

param1=value;param2=value.

Exemplo:

codColigada=0;codArea=1

Se a consulta que será executada não possuir parâmetros, o campo será enviado sem nenhum valor.


Histórico de atualização do documento

...

Data

Autor

Versão

Descrição das alterações

0509/10/2018

Thiago Neiva Chagas

1.0Documento inicial.

Importação do manual para o TDN.

30/10/2018Ana Carolina Eleutério Abras2.0Req. 15 – Processo de Integração de Cursos - Itinerário - TOTVS SGE