Histórico da Página

Pré-Requisitos / Parametrizações

Expandir

title	Token - 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.

...

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 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âmetro	Conteú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".

...

Lista Códigos dos Sistemas

Nome	Código do Sistema
RM Custos	0
RM Chronus	A
RM Testis	B
RM Saldus	C
RM Liber	D
RM Classis - E	E
RM Fluxus	F
RM Bis	G
RM Agilis	H
RM Bonum	I
RM Factor	K
RM Biblios	L
RM Solum	M
RM Officina	N
RM Saude/Janus	O
RM Labore	P
RM SSO	R
RM Classis Net	S
RM Nucleus	T
RM Classis - U	U
RM Vitae	V
RM Portal	W
RM SGI	X
RM Acesso	Y

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 1

Nova versão 2

Chave