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 são

Os nós de conector permitem que você interaja com serviços de terceiros diretamente da tela, sem configuração HTTP manual. 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 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 estiver configurado 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 Flow 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 da API no runtime.

Configuração

Conexão

Cada nó de conector requer uma conexão, uma credencial de autenticação pré-configurada gerenciada no Integration Service. A conexão é selecionada no painel de propriedades ao configurar o nó.

As conexões lidam com atualização de tokens, fluxos do OAuth e armazenamento de credenciais automaticamente. Os cabeçalhos de autenticação e os segredos 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 os renderiza 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 são compatíveis com 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 são compatíveis com identificadores de erro. Se a chamada de API falhar e um identificador de erro estiver conectado, a execução roteará para o caminho do erro com o objeto de erro padrão $vars.<nodeName>.error.

Consulte Tratamento de erros para obter detalhes.

Gatilhos de conector

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

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

Quando usar um conector versus solicitação HTTP

Use um nó de conector quando...Use a Solicitação HTTP quando...
Existe um conector para seu serviço de destinoNão existe nenhum conector para o serviço
Você quer entradas e saídas digitadas sem configuração manualVocê precisa de controle total sobre cabeçalhos, parâmetros de consulta e corpo
Você deseja autenticação automática por meio do Integration ServiceA API usa um esquema de autenticação fora do padrão
Você quer um processo de fácil manutenção que se adapte às alterações de APIVocê está criando um protótipo de 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 nenhum 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 uma 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