FAQs - Suporte técnico

RM - Integrações - Fórmula Visual - Utilizando a atividade "Executar Requisição REST"

Dúvida
Como utilizar a atividade "Executar Requisição Rest"

Ambiente

RM – Fórmula Visual – Vesão 12

Solução

Este documento tem por objetivo especificar a atividade “Executar Requisição REST” disponível na Fórmula Visual.

mceclip0.png

 

Especificação:

A atividade “Executar Requisição REST” permite que a fórmula visual execute uma requisição utilizando o protocolo HTTP(S) e o padrão REST com formato JSON. Esta requisição de ser feita utilizando qualquer método HTTP (GET, POST, ETC) e permite que os dados retornados pela requisição sejam consumidos pela fórmula.
É possível ainda definir o tipo de autenticação da requisição que pode ser básica (informando um usuário e senha) ou baseada em Tokens (informando o schema e token).

 

Parâmetros de requisição:

 

  • Endereço da Requisição

Informe o endereço do servidor para executar a requisição. O endereço deve ser informado completo inclusive com o protocolo que pode ser HTTP ou HTTPS. É possível criar parâmetros para montagem do endereço, informando os valores entre <>.

Exemplo:

https://www.google.com/search?q=<texto>

Neste caso será criada uma propriedade dinâmica para que seja informado o conteúdo do parâmetro <texto>.

  • Método de Requisição:

Selecione o método HTTP que será utilizado para fazer a requisição, os métodos disponíveis são Get, Head, Post, Put, Delete e Patch.

  • Tempo Limite:

Informe um tempo limite para execução da requisição em segundos. Caso este tempo seja ultrapassado será gerado um erro de timeout.

  • Utilizar Proxy do Sistema:

Selecione se a requisição deverá utilizar a configuração padrão de proxy do Windows.

 

mceclip1.png

 

Definição da requisição:

  • JSON (Requisição:

Informe um texto no formato JSON que será utilizado para fazer a requisição ao servidor. Este texto poderá conter parâmetros para montagem do JSON que deverão ser informados entre <>.

mceclip2.png

 

Propriedades dinâmicas geradas:

mceclip3.png

  • JSON (Resposta)

Informe um texto no formato JSON, contendo um exemplo de JSON que é retornado pelo servidor, que será utilizado para gerar a estrutura de tabelas e campos do retorno da requisição.

 

Segurança/Autenticação:

  • Tipo de Autenticação:

Selecione o tipo de autenticação da requisição, que pode ser:

None: Não utiliza nenhum tipo de autenticação.

Basic: Faz a requisição utilizando autenticação básica através de um usuário e senha, que devem ser informados nas propriedades Usuário e Senha. Para mais informações consulte: 
https://pt.stackoverflow.com/questions/254503/o-que-%C3%A9-basic-auth

Token: Faz a requisição utilizando autenticação via Token (através do Header Authorization), que devem ser informados nas propriedades Token e Token Schema. 
Para mais informações consulte:
https://pt.wikipedia.org/wiki/OAuth

 

  • Usuário:

Informe o nome do usuário que será utilizado pela autenticação básica.

  • Senha:

Informe a senha do usuário que será utilizado pela autenticação básica.

  • Token:

Informe os dados do Token que será utilizado pela autenticação via Token.

  • Token Schema:

Informe o Schema do Token que será utilizado pela autenticação via Token. São exemplos de schema BEARER, OASIS e outros

 

Tipo de Conteúdo:

  • Codificação do Texto da Requisição:

Informe o tipo de codificação utilizado para codificar/decodificar os textos da requisição. Por padrão será utilizado a formato UTF-8.

Para mais informações consulte:

https://msdn.microsoft.com/pt-br/library/system.text.encoding(v=vs.110).aspx

  • Tipo de Conteúdo Aceito:

Informe o tipo de conteúdo MIME aceito como retorno da requisição. Por padrão será aceito qualquer tipo de conteúdo, porém alguns servidores Web exigem que o tipo de conteúdo aceito seja informado (Header HTTP Accept).

Para mais informações consulte:

https://developer.mozilla.org/pt-BR/docs/Web/HTTP/Headers/Accept

  • Tipo de Conteúdo da Requisição:

Informe o tipo de conteúdo MIME que será enviado nos dados da requisição (Header HTTP Content-Type). Por padrão o sistema irá utilizar o tipo “application/json”.

Para mais informações consulte:

https://developer.mozilla.org/pt-BR/docs/Web/HTTP/Headers/Content-Type

 

Resposta:

  • Resposta (Código)

Contém o código HTTP da resposta do servidor.

  • Resposta (Texto)

Contém o conteúdo da resposta da requisição no formato de texto, caso o tipo da resposta (Content-Type: “text”), em formato texto.

  • Dados da Leitura:

Contém uma fonte de dados com os dados do retorno da requisição, caso a tipo da resposta (Content-Type: “application/json”), em formato de tabelas/colunas. A propriedade JSON (Retorno) será utilizada para geração da estrutura da fonte de dados.

Dica: Utilize a atividade de Transformar Registro em XML e gere um erro com a estrutura de tabelas da requisição).

mceclip4.png

  • Tabelas:

Provê acesso aos dados retornados pela requisição no formato de tabela/coluna.

  • Campos:

Provê acesso aos dados da tabela principal retornada pela requisição.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Esse artigo foi útil?
Usuários que acharam isso útil: 0 de 0

0 Comentários

Por favor, entre para comentar.
X Fechar

Olá ,

Há pendência referente a um de seus produtos contratados para a empresa ().

Entre em contato com o Centro de Serviços TOTVS para tratativa.

Ligue! 4003-0015 opção 4 e 9 ou registre uma solicitação para CST – Cobrança – Verificação de pendências financeiras . clique aqui.

TOTVS

X Fechar

Olá ,

Seu contato não está cadastrado no Portal do Cliente como um perfil autorizado a solicitar consultoria telefônica.

Por gentileza, acione o administrador do Portal de sua empresa para: (1)configurar o seu acesso ou (2)buscar um perfil autorizado para registro desse atendimento.

Em caso de dúvidas sobre a identificação do contato administrador do Portal, ligue (11) 4003-0015, opção 7 e, em seguida, opção 4 para buscar o suporte com o time de Assessoria ao Portal do Cliente. . clique aqui.

TOTVS

X Fechar

Olá ,

Para o atendimento de "Consultoria Telefônica" você deverá estar de acordo com o Faturamento.

TOTVS

X Fechar

Olá,

Algo inesperado ocorreu, e o usuario nao foi reconhecido ou você nao se encontra logado

Por favor realize um novo login

Em caso de dúvidas, entre em contato com o administrador do Portal de Clientes de sua empresa para verificação do seu usuário, ou Centro de Serviços TOTVS.

Ligue! 4003-0015 opção 4 e 9 ou registre uma solicitação para CST – Cadastros . clique aqui.

TOTVS

Chat _

Preencha os campos abaixo para iniciar o atendimento:

Chat _