CONNECTREQUEST

Esta página de ajuda é para Studio. Estas informações também estão disponíveis para Desktop Studio.

Uma tomada de entrada e uma de saída ao lado uma da outra com uma seta apontando para baixo.

Executa uma solicitação do Integration Hub. Se a conexão que usar com esta ação incluir segredos, você pode usá-los em um script que contém esta ação.

Clicar duas vezes nesta ação abre Integration Hub, onde você pode configurar a integração de conexão que deseja que esta ação use.

Dependências

  • Esta ação requer Integration Hub.
  • Esta ação é comumente usada com a ação ConnectAuth.
  • Cada instância dessa ação em um script pode executar uma conexão. Abra Integration Hub e clique no ícone de seleção An icon of a circle with a  checkmark in it. para atribuir a conexão desejada a essa ação.

  • Para solicitações Studio, a propriedade requestPayload deve ser preenchida com um objeto dinâmico que contém detalhes sobre a solicitação, incluindo URL, cabeçalhos, Verb, parâmetros, segredos, entre outros.Os conteúdos devem estar no formato JSON. Use uma ação Snippet para criar o objeto dinâmico e seus membros e para convertê-lo em JSON.

Tipos de script suportados

Um quadrado com uma linha saindo dele e indo em direção a três outros quadrados.

Icon of gray-green envelope

Ícone de balão de fala verde escuro

Icon of purple telephone handset

Ícone do símbolo de correio de voz na cor marrom-enferrujado, composto por dois círculos unidos por uma linha

Icon of pink document with lines of text

Ícone de um telefone celular verde com um balão de fala na tela

Genérico

E-mail Chat Telefone Correio de voz Item de trabalho SMS

Propriedades de entrada

Estas propriedades definem dados que a ação usa durante a execução.

Propriedade

Descrição

Adicionar legenda

Insira uma frase curta que identifique exclusivamente esta ação no script. A legenda aparece na tela do script no ícone da ação.

connectName Define a conexão específica para uso com esta ação. Você pode clicar duas vezes nesta ação para atribuir uma conexão do Integration Hub.
requestName Define a solicitação específica configurada no conector especificado para ser executada com esta ação. Você pode clicar duas vezes nesta ação para atribuir uma solicitação do Integration Hub.
requestPayload Insira a carga útil para a solicitação especificada no formato JSON. Você pode usar uma ação Snippet para converter a solicitação em JSON.

Propriedades de saída

As propriedades contêm variáveis que armazenam dados retornados pela execução da ação. Elas estão disponíveis para referência e uso quando a ação é concluída.

Propriedade

Descrição

requestBodyVarName (out) Mantém o corpo da solicitação. O padrão é requestBody.
requestErrorDetailsVarName (out) Contém os detalhes do erro, em caso de erro com a solicitação. O padrão é requestErrorDetails.
requestHeadersListVarName (out) Contém a lista de cabeçalhos de solicitação. O padrão é requestHeadersList.
requestProxyVarName (out) Mantém o proxy da solicitação. O padrão é requestProxy.

Condições do Ramo de resultado

As condições de ramificação de resultado permitem que você crie ramificações no seu script para tratar diferentes resultados quando uma ação é executada.

Condição

Descrição

Padrão Path taken unless the script meets a condition that requires it to take one of the other branches. It is also taken if the action's other branches are not defined.
OnError ```

O caminho seguido quando a ação não é executada adequadamente. Por exemplo, quando há um problema inesperado, como erros de sintaxe, códigos de erro HTTP e assim por diante. A variável ERR deve ser preenchida com uma explicação condensada do problema.

```
OnSuccess

Caminho seguido se a ação for concluída sem erros e quaisquer Chamadas de API ou retornos de dados foram bem-sucedidos (códigos de resposta 2xx).

OnTimeout

O caminho seguido se não houver resposta da solicitação para o número de milissegundos definido na configuração de solicitação em Integration Hub.