Páginas filhas
  • Web Service Consulta SQL

Versões comparadas

Chave

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

SQL.zip

Aviso
titleSuporte CORS

Este serviço não dá suporte a CORS - Cross-Origin Resource Sharing. Caso seja necessário este suporte, será necessário alterar o escopo inicial do projeto, este assunto deverá ser levado ao conhecimento das Gestoras do SESI/SENAI no DN:: Cristiane Fractal (cristiane.silva@senaicni.com.br) e Priscila Karla Amorim ([email protected]).

Pré-Requisitos / Parametrizações

Expandir
titleToken - Consumo do WebService

Parâmetros para Geração do Token 


No TOTVS Educacional, por meio do menu Transparência | Parâmetros disponível no menu "Customização", o usuário administrador efetuará a geração do Token para consumo do WebService de Consultas. 


* Alguns regionais ainda utilizam a versão 1 do Portal da Transparência e por isso o parâmetro Token permanece na lista.


Deverão ser parametrizadas as seguintes informações:

  • Usuário: Usuário do SGE que será utilizado para geração do Token que fará autenticação no RM.  


  • Senha: Senha do usuário do SGE que será utilizado para geração do Token que fará autenticação no RM.  


  • Token Portal Transparência V2:

    Token necessário para validar acesso aos Web Services da TOTVS nas customizações disponibilizadas pelo Departamento Nacional. Este Token é a informação do Usuário do SGE e sua senha criptografados de acordo com o modelo de autenticação disponível.

    O código criptografado deverá ser enviado toda vez que for acionado algum Web Service disponibilizado pela TOTVS para as Customizações do Departamento Nacional. A customização será capaz de descriptografar o código enviado para então realizar uma tentativa de login no SGE com o Usuário e Senha utilizados para a criptografia. 

    Para gerar o Token é necessário executar o processo "Gerar Token" acessível pela opção "Processos" da tela de Parâmetros. O Token gerado poderá ser visualizado no parâmetro "Token Portal Transparência V2".




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.

Swagger

Todos os serviços disponíveis no RM são agrupados e listados nessa ferramenta, que visa auxiliar na manutenção e documentação de APIs REST.

Para acessar o Swagger, é necessário acessar o link no seguinte formato "http://<servidor>:<portaFrameHTML>/swagger/ui/index" ou "http://<servidor>/FRAMEHTML/swagger/ui/index" (12.1.32) (Exemplo: http://localhost:8080/swagger/ui/index ou http://localhost/FRAMEHTML/swagger/ui/index).


Para verificar a porta, acesse, através do IIS, o Website "FrameHTML", que é gerado quando realizada a instalação do Portal RM:


Após isso, basta clicar com o botão direito do mouse no Website "FrameHTML" e clicar na opção "Editar ligações...". Conforme imagem abaixo, a porta seria a 8080, e o link ficaria da seguinte forma "http://localhost:8080/swagger/ui/index".


Ao acessar o Swagger, serão listados todos os serviços disponíveis, com a descrição do serviço, parâmetros e urls:



O webservice de consultas SQL é o "CstExecSQL", método "ExecutaConsultaSQL".

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.

Para maiores detalhes, acesse aqui o manual da Lib DN.

Parâmetros do Web Service

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

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.

CodSistema (Obrigatório)O Código do Sistema ao qual a Consulta SQL pertence. (Para consultar a lista com os códigos dos sistemas, clique aqui.)

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).


Exemplo do envio da requisição via Postman:


Código da requisição em HTTP

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


Âncora
_CodSistema
_CodSistema

Lista Códigos dos Sistemas

NomeCódigo do Sistema
RM Custos0
RM ChronusA
RM TestisB
RM SaldusC
RM LiberD
RM Classis - EE
RM FluxusF
RM BisG
RM AgilisH
RM BonumI
RM FactorK
RM BibliosL
RM SolumM
RM OfficinaN
RM Saude/JanusO
RM LaboreP
RM SSOR
RM Classis NetS
RM NucleusT
RM Classis - UU
RM VitaeV
RM PortalW
RM SGIX
RM AcessoY