Use o tipo de solicitação de dados codificados em URL do formulário para adicionar vários parâmetros ao corpo da solicitação.

Ações

As seguintes ações de parâmetro estão habilitadas:

Adicionar
Para adicionar parâmetros ao corpo da solicitação.
Clique em Adicionar parâmetro ou no ícone Adicionar para adicionar um parâmetro. O número de parâmetros exibido no título da tabela Parâmetros é atualizado automaticamente.
Editar
Para editar os parâmetros existentes que estão disponíveis no corpo da solicitação.
Na tabela Parâmetros, passe o cursor sobre o ícone de reticências verticais do parâmetro que você deseja editar e, em seguida, clique no ícone Editar. Você pode editar a Chave e os valores dos parâmetros no modal Editar parâmetro.
Habilitar/Desabilitar
Para ativar ou desativar os parâmetros que estão disponíveis no corpo da solicitação. Você pode desativar um parâmetro para os seguintes cenários:
  • Quando a solicitação da API usa valores padrão.
  • Ao introduzir um novo recurso em uma implementação controlada do pacote de conectores.
  • Ao testar e iterar novos recursos em um pacote de conectores.
  • Ao solucionar problemas de um pacote de conectores que contém parâmetros com erros.
Na tabela Parâmetros, passe o cursor sobre o ícone de reticências verticais do parâmetro que você deseja ativar ou desativar e, em seguida, clique na opção Ativar/Desativar. O status do parâmetro é atualizado conforme necessário na tabela Parâmetros. Os parâmetros desativados não estão incluídos no pacote de conectores publicados.
Copiar
Para replicar os parâmetros existentes que estão disponíveis no corpo da solicitação.
Na tabela Parâmetros, passe o cursor sobre o ícone de reticências verticais do parâmetro apropriado e clique no ícone Copiar para duplicar o parâmetro selecionado. Insira uma nova chave no modal Copiar. Todos os outros atributos do parâmetro original são copiados para o novo parâmetro. Depois de copiado, o novo parâmetro é ativado por padrão. Use a opção Ativar/Desativar para desativar o parâmetro manualmente. O número de parâmetros no título da tabela Parâmetros é atualizado automaticamente quando um novo parâmetro é criado usando a opção Copiar.
Você pode alterar o Tipo de valor do parâmetro duplicado no modal Copiar.
Excluir
Para excluir os parâmetros que estão disponíveis no corpo da solicitação.
Faça uma das seguintes ações para excluir parâmetros:
  • clique na caixa de seleção Selecionar tudo no cabeçalho da tabela e, em seguida, clique no ícone Excluir que está disponível acima da tabela para excluir vários parâmetros.
  • Passe o cursor sobre o menu de reticências verticais de cada parâmetro e, em seguida, clique no ícone Excluir para excluir o parâmetro individualmente.

Tabela de parâmetros

O título da tabela Parâmetros exibe o número total de parâmetros de solicitação em uma ação. Este número inclui tanto os parâmetros habilitados quanto os desabilitados.

Visualize os seguintes detalhes do parâmetro na tabela.

Item da tabela Descrição
Chave Exibe a chave do parâmetro. O usuário do pacote não pode visualizar a chave no Bot editor ou no editor de API Task. A chave é enviada como parte do cabeçalho.
Valor Exibe o valor do parâmetro. O usuário do pacote pode visualizar e atualizar esse valor no Bot editor ou no editor de API Task.
O valor é fornecido pelo usuário Exibe o status do valor.
  • Sim: Se o valor é fornecido pelo usuário. O usuário do pacote deve inserir um valor apropriado ao configurar esse parâmetro no Bot editor ou no editor de API Task.
  • Não: Se o valor está codificado. O usuário do pacote não pode visualizar esse valor no Bot editor ou no editor de API Task. Este valor é enviado como parte do cabeçalho.
Status Exibe o status do parâmetro.
  • Habilitado: Se o parâmetro está habilitado.
  • Desabilitado: Se o parâmetro está desabilitado.
Rótulo Exibe o rótulo para valores Fornecidos pelo usuário. O usuário do pacote pode visualizar o rótulo do parâmetro no Bot editor ou no editor de API Task.
Descrição Exibe a descrição do parâmetro. O usuário do pacote pode visualizar a descrição do parâmetro no Bot editor ou no editor de API Task.

Adicionar parâmetros ao corpo da solicitação

Siga estas etapas para adicionar um parâmetro ao corpo da solicitação de dados codificados na URL do formulário:

  1. clique na guia Corpo da solicitação dentro do painel Configuração.
  2. Na lista suspensa Tipo, selecione Dados codificados em URL de formulário.
  3. Clique em Adicionar parâmetro quando não houver nenhum parâmetro ou no ícone de adição (+) na parte superior da tabela para adicionar um parâmetro.
  4. No modal Adicionar parâmetro, faça o seguinte.
    1. Chave: Insira um nome de chave apropriado. O nome da chave não é exibido para o usuário do pacote no Bot editor ou no editor de API Task. Esse nome é enviado como parte do cabeçalho.
    2. Selecione uma das seguintes opções na seção O valor será:
      Tipo Descrição
      Codificado Insira um valor codificado para o parâmetro. O usuário do pacote não pode visualizar esse valor no Bot editor ou no editor de API Task. Este valor é enviado como parte do cabeçalho.
      Fornecido pelo usuário
      1. Tipo de entrada de valor: Habilite esta caixa de seleção para proteger o tipo de entrada de valor. Ao selecionar seguro, você pode inserir o parâmetro por meio de uma credencial, variável ou string insegura.
      2. Este campo é obrigatório?: Selecione Não ou Sim dependendo dos requisitos do parâmetro.
      3. Valor (opcional): Insira um valor. O usuário do pacote pode visualizar e atualizar esse valor no Bot editor ou no editor de API Task.
      4. Rótulo: Insira um rótulo para o parâmetro. O usuário do pacote pode visualizar o rótulo do parâmetro no Bot editor ou no editor de API Task.
      5. Descrição (opcional): Digite uma descrição para o parâmetro. O usuário do pacote pode visualizar a descrição do parâmetro no Bot editor ou no editor de API Task. A descrição aparece como texto de ajuda no editor.
  5. Clique em Adicionar para adicionar o parâmetro ao corpo da solicitação.

    O novo parâmetro é exibido na tabela Parâmetros.

Repita as etapas para adicionar mais parâmetros ao corpo da solicitação.