UiPath Documentation
maestro
latest
false
Guia do usuário do Maestro
Importante :
A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.

Nós de conector

Nós de conector que integram serviços de terceiros diretamente na tela com operações pré-criadas.

O que eles são​

Os nós de conector permitem que você interaja com serviços de terceiros diretamente da tela, sem configuração manual de HTTP. Cada conector fornece nós pré-criados para um serviço específico (por exemplo, GitHub, Salesforce, Slack, Microsoft 365), com entradas digitadas, saídas digitadas e autenticação automática por meio do Integration Service.

Os nós de conector aparecem na paleta de nós na categoria de Conector, agrupados por serviço.

How they work​

Os nós de conector são carregados dinamicamente a partir do Integration Service da UiPath. Os conectores disponíveis dependem do que você configurou em sua organização do Automation Cloud. Cada nó de conector mapeia para uma operação de API específica no serviço de destino.

Quando você adiciona um nó de conector à tela, o Fluxo busca seu esquema de entrada e renderiza um formulário de configuração dinâmica no painel de propriedades. Você preenche os campos necessários, seleciona uma conexão para autenticação e o nó lida com a chamada de API no runtime.

Configuração​

Conexão​

Cada nó de conector requer uma conexão, uma credencial de autenticação pré-configurada que você gerencia no Integration Service. Selecionamos a conexão no painel de propriedades ao configurar o nó.

As conexões gerenciam a atualização de tokens, fluxos de OAuth e armazenamento de credenciais automaticamente. Cabeçalhos e segredos de autenticação não são gerenciados diretamente.

Observação:

As conexões são configuradas no portal do UiPath Automation Cloud em Integration Service. Consulte a documentação do Integration Service para obter instruções de configuração.

Entradas específicas do nó​

Cada nó de conector tem seus próprios campos de entrada com base na operação de API que ele envolve. O painel de propriedades renderiza esses elementos dinamicamente. Você verá campos diferentes para um nó "Criar problema" e para um nó "Listar repositórios", mesmo dentro do mesmo conector.

Todos os campos de entrada oferecem suporte a expressões de variável ($vars.<nodeName>.<property>).

Saída​

A saída do nó do conector está disponível em $vars.<nodeName>.output. A forma da saída depende do nó específico e da API que ele chama.

// Access the output of a GitHub connector node named "listBranches1"
$vars.listBranches1.output
// Access the output of a GitHub connector node named "listBranches1"
$vars.listBranches1.output

Tratamento de Erro​

Os nós de conector oferecem suporte a identificadores de erro. Se a chamada de API falhar e um Identificador de erro estiver conectado, a execução roteia para o caminho de erro com o objeto de erro padrão em$vars.<nodeName>.error.

Consulte Tratamento de erros para obter detalhes.

Gatilhos de conector​

Alguns conectores também fornecem gatilhos: eventos de início que disparam quando algo acontece no serviço externo (por exemplo, um novo e-mail chega, um formulário é enviado). Os gatilhos de conector aparecem na seção Gatilhos da paleta de nós.

As entradas de disparo pertencem ao gatilho e são acessadas como $vars.<triggerName>.output.<inputName>. Consulte Gatilhos para obter detalhes.

Quando usar um conector em vez de Solicitação HTTP​

Use um nó de conector quando...Use Solicitação HTTP quando...
Existe um conector para seu serviço de destinoNão existe conector para o serviço
Você quer entradas e saídas digitadas sem configuração manualVocê precisa de controle completo sobre os cabeçalhos, parâmetros de consulta e corpo
Você deseja a autenticação automática por meio do Integration ServiceA API usa um esquema de autenticação não padrão
Você deseja um processo sustentável que se adapte às alterações de APIVocê está criando um protótipo em relação a uma API nova ou interna

Regra geral: a paleta de nós é o primeiro lugar para verificar um conector. A Solicitação HTTP é o fallback quando não existe conector para o serviço de destino.

Conectores disponíveis​

A lista completa de conectores disponíveis depende da sua organização do Automation Cloud e da configuração do Integration Service. Para obter documentação específica do conector, incluindo configuração, autenticação e nós disponíveis, consulte a documentação do UiPath Integration Service:

Esta página foi útil?

Conectar

Precisa de ajuda? Suporte

Quer aprender? Academia UiPath

Tem perguntas? Fórum do UiPath

Fique por dentro das novidades