Serviço da Web REST pacote

Use as ações no pacote Serviço da Web REST como métodos (DELETE, GET, PATCH, POST ou PUT) para enviar solicitações e receber respostas de uma API.

Como trabalhar com ações Serviço da Web REST

Forneça as seguintes informações para enviar uma solicitação REST e receber uma resposta. Nem todos os parâmetros são necessários para todos os métodos.

Digite o URI: um endereço exclusivo para um recurso de API.

Configuração de proxy: Para definir o proxy, selecione a guia Sistema ou Personalizar da configuração Proxy.


Opção	Descrição
Sistema	Proxy do sistema é o proxy configurado na máquina executora bot onde o bot está sendo executado. Se esta opção for selecionada, o Agente de bot utiliza o proxy do sistema.
Personalizar	Esta opção permite definir configurações de proxy personalizadas dentro das ações de Serviço da Web REST. Por exemplo, se uma API REST precisar ser roteada por meio de um proxy diferente do proxy do sistema, você poderá selecionar a opção Customizado fornecer detalhes do proxy nas ações ações REST. Forneça os seguintes detalhes: Host: O nome do host ou endereço IP do proxy Porta: O número da porta do proxy Nome de usuário (opcional): O nome de usuário usado para a autenticação de proxy Senha (opcional): A senha usada para a autenticação do proxy Nota: Se o proxy a ser configurado for um proxy autenticado, você deverá fornecer credenciais de autenticação nos campos Nome de usuário e Senha. Para os campos Host, Porta, Nome do usuário, e Senha escolha entre a guia Credencial, Variável, ou String insegura: Credencial: Use um valor disponível no cofre de credenciais. Variable (Variável): Use uma variável que armazena um valor de credencial em uma variável definida pelo usuário. String insegura: Especifique manualmente o valor que você deseja usar.

Modo de autenticação: há suporte para três modos de autenticação:
- Sem Autenticação: Use esta opção para acessar os terminais que não requerem autenticação para acessar seus servidores.
- básico: Básico é a maneira mais simples de autenticar usuários. Ao selecionar esta opção, você digitará o nome de usuário e a senha. Essa técnica usa um cabeçalho chamado Authorization, com uma representação codificada em base64 do nome de usuário e da senha inseridos.
- Usuário logado do AD: usuários do Active Directory (AD) autorizados a acessar a API correspondente são autenticados por meio do AD. Nenhuma credencial é necessária na solicitação.
- Autenticação (usuário do AD) do Windows NT LAN Manager (NTLM): método de autenticação de desafio/resposta que permite aos clientes fornecer o nome de usuário e senha como credenciais ou texto sem formatação criptografados. Recomenda-se usar as credenciais armazenados no Credential Vault Automation Anywhere.
Cabeçalho: nem todos os métodos exigem um cabeçalho. Os cabeçalhos representam os metadados associados à solicitação.
Tipo de conteúdo: quando um cabeçalho contém um tipo de conteúdo, ele define a negociação de conteúdo entre o cliente e o servidor. As ações do Serviço da Web REST oferecem suporte aos seguintes tipos de conteúdo:
- application/x-www-form-urlencoded: Codificar os parâmetros na URL.
- JSON (application/json): Insira um corpo de solicitação JSON.
- XML (application/xml): Insira um corpo de solicitação XML.
- Text (text/plain)
- XML (text/xml)
- HTML (text/html)
- multipart/form-data: Envie dados binários, na maioria dos casos para carregar arquivos para o servidor.
Adicionar substituição: Permite inserir variáveis no corpo da solicitação REST. Uma variável é uma representação simbólica de dados e permite que você acesse um valor sem precisar inseri-lo manualmente sempre que precisar. Por exemplo, considere a seguinte solicitação de corpo REST:
```
{
   "name":"{{name}}",
   "email":"{{email}}",
   "status":"Active"
}
```
No corpo da solicitação acima, você pode substituir as variáveis entre colchetes clicando em Adicionar substituição e adicionando os valores necessários.
Opções avançadas:
- Capturar resposta de falha: marque esta caixa de seleção para capturar a resposta de falha, exceto para a resposta Êxito/Ok. Os detalhes da resposta de falha são capturados no corpo de resposta.
- Permitir conexão insegura ao usar https: marque esta caixa de seleção para permitir uma conexão insegura ao usar https.
Aguarde a ação para concluir: você pode definir um valor de tempo esgotado ao enviar uma solicitação REST e receber uma resposta. Ao executar ações ,tais como POST, PUT, DELETE, PATCH e GET, no campo Aguarde a ação para conclui, você pode especificar o tempo de espera (em milissegundos). Por padrão, o tempo de espera é de 60000 milissegundos.
Variáveis de saída: a saída de resposta é capturada em uma variável de dicionário. Uma variável de dicionário é um par de valores chave. Use o nome do cabeçalho de resposta como chave para retornar o valor do cabeçalho, ou o “Corpo”, como a chave para retornar o corpo de resposta.
Nota: A chave de resposta, com seu valor, está disponível na variável de dicionário para exibição do status de resposta da API REST.
Para obter uma lista dos nomes de cabeçalho para o recurso da API, execute estas etapas:
1. Insira uma ação Loop após a ação Serviço da Web REST.
2. Selecione o iterador Para cada chave no dicionário.
3. No campo Variável de dicionário, selecione a variável que contém a saída da ação Serviço da Web REST.
4. Atribua o valor de cada chave a $prompt-assignment$ .
5. Insira uma ação de Registrar em Arquivo.
6. Forneça o caminho do arquivo para armazenar a lista de nomes de cabeçalho em um arquivo de texto.
7. Insira $prompt-assignment$ no campo Digite o texto para registrar.
8. Selecione a opção Substituir arquivo existente.
9. Clique em Salvar.
  Quando você executa o bot, ele imprime os nomes de cabeçalho do recurso da API para o arquivo selecionado.

Como passar valores com segurança

Você pode passar valores de forma segura do Credential Vault para o serviço da web especificando o cofre, as credenciais e o atributo nos seguintes campos de ação compatíveis:

URI
Cabeçalhos personalizados
Corpo: Para o tipo de conteúdo application/x-www-form-urlencoded, clique em Adicionar parâmetro para selecionar o valor do arquivo Credential Vault.
Para todos os outros tipos de conteúdo, selecione a opção Selecionar credencial como parâmetros e clique em Escolher.

Ações no Serviço da Web REST pacote


Ação	Descrição
Método DELETE	Remove o recurso identificado pelo URI.
Método GET	Recupera as informações identificadas pelos parâmetros incluídos no URI. Não há Tipo de conteúdo para o método GET, pois todos os parâmetros são passados como parte do URI. Limitações e características do método GET incluem: o comprimento do URI é limitado em 2.048 caracteres. Todos os parâmetros são passados no URI. O método GET expõe dados que estão no URI, o que faz dele menos seguro do que o método POST. O GET não altera nenhum dado, tornando-o seguro para todos os usuários, seja qual for sua autorização. Consulte Usando o método Get.
Método Patch	Modifica o recurso identificado pelo URI.
Método POST	Cria um novo recurso no URI. Os parâmetros são passados no corpo da solicitação. Não há limite de comprimento para o corpo da solicitação. Consulte Usar o método Post.
Método PUT	Atualiza ou substitui um recurso com base nos parâmetros passados no URI ou no corpo. Consulte Usar o método Put.

Suporte a proxy

Se o dispositivo estiver configurado com um proxy, todas as solicitações de saída desse pacote serão roteadas por meio do servidor de proxy. Consulte Conectar o Agente de bot a um dispositivo com um proxy.

Automation 360

Serviço da Web REST pacote