Versões comparadas

Chave

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

Índice:


      

Objetivo:


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

Especificação:


A atividade “Executar Requisição HTTP” permite que a fórmula visual execute uma requisição utilizando o protocolo HTTP(S). Esta requisição de ser feita utilizando qualquer método HTTP (GET, POST, ETC) e permite que os dados retornados pela requisição (em formato binário ou texto) 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 da Requisição

Nome

Descrição

Cabeçalhos HTTP

Se a sua requisição exigir o envio de header, preencha esta propriedade da atividade - Disponível a partir da versão 12.1.24.

Os parâmetros devem ser informados um por linha, como no exemplo abaixo. Após clicar em Ok, novas propriedades serão exibidas nos detalhes da atividade, no agrupamento "Cabeçalhos HTTP", para preenchimento dos valores dos campos do header. Exemplo:

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.

Conteúdo da Requisição

Informe somente uma das propriedades caso deseje enviar algum conteúdo pela requisição, que pode ser binário, post ou texto.

Nome

Descrição

Dados (Binário)

Informe o conteúdo da requisição em formato binário. Adicionalmente o tipo de conteúdo poderá ser definido através da propriedade “Tipo de Conteúdo da Requisição”.

Dados (Post)

Informe os nomes dos parâmetros do Post, normalmente esta opção será utilizada quando o método de requisição for Post. Você deve informar um parâmetro por linha e para cada parâmetro informado será criada uma propriedade dinâmica para que o valor seja informado.

Dados (Texto)

Informe o conteúdo da requisição em formato texto. Adicionalmente o tipo de conteúdo poderá ser definido através da propriedade “Tipo de Conteúdo da Requisição”.

Segurança/Autenticação

Nome

Descriçã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 do Header Authorization (autenticação padrão utilizada pelo Host), um usuário e senha devem ser informados através das respectivas propriedades.
  • UserName
    Faz a requisição utilizando autenticação padrão por 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

Nome

Descrição

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 através do 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. Por padrão o sistema irá utilizar o tipo “application/x-www-form-urlencoded”.

Para mais informações consulte:

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

Resposta

As propriedades de resposta contêm os dados retornados pela execução da requisição.

Nome do Parâmetro

Descrição do Parâmetro

Obrigatório

Resposta (Binário)

Contém o conteúdo da resposta da requisição no formato binário.

Não

Resposta (Código)

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

Não

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.

Não

Informações
iconfalse
Informações
iconfalse

Produto: Framework

Informações
iconfalse

Versão: 12.1.20 ou Superior

Informações
iconfalse

Processo: Atividade "Executar Requisição HTTP" da Fórmula Visual

Informações
iconfalse
Informações
iconfalse

Status: Finalizado

Informações
iconfalse

Data:  

Informações
iconfalse

Autores:

Rogerio De Resende Ohashi


Informações
iconfalse