连接器节点

在画布上直接将第三方服务与预构建操作集成的连接器节点。

内容是什么

连接器节点使您可以直接从画布中与第三方服务交互，而无需手动配置 HTTP。每个连接器都为特定服务（例如 GitHub、Salesforce、Slack、Microsoft 365）提供预构建节点，具有类型化输入和类型化输出，并通过 Integration Service 自动进行身份验证。

连接器节点显示在“连接器”类别下的节点面板中，并按服务分组。

How they work

连接器节点是从 UiPath 的 Integration Service 动态加载的。可用连接器取决于 Automation Cloud 组织中的配置内容。每个连接器节点都映射到目标服务上的特定 API 操作。

将连接器节点添加到画布时，流会获取其输入架构，并在属性面板中呈现动态配置表单。您填写必填字段，选择进行身份验证的连接，节点在运行时处理 API 调用。

配置

连接

每个连接器节点都需要一个连接，这是在 Integration Service 中管理的预配置身份验证凭据。配置节点时，在属性面板中选择连接。

连接会自动处理令牌刷新、OAuth 流程和凭据存储。身份验证标头和密码不受直接管理。

备注：

在 UiPath Automation Cloud Portal 的 Integration Service 下配置连接。有关设置说明，请参阅Integration Service 文档。

节点特定输入

根据其包含的 API 操作，每个连接器节点都有自己的输入字段。属性面板会动态呈现这些内容。即使在同一连接器中，“创建问题”节点与“列出存储库”节点也会看到不同的字段。

所有输入字段都支持变量表达式 ( $vars.<nodeName>.<property> )。

输出

连接器节点输出可在$vars.<nodeName>.output找到。输出形式取决于特定节点及其调用的 API。

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

错误处理

连接器节点支持错误句柄。如果 API 调用失败但已连接错误句柄，则执行路由到错误路径，并在$vars.<nodeName>.error处使用标准错误对象。

有关详细信息，请参阅“错误处理” 。

连接器触发器

某些连接器还提供“触发器”服务：开始事件，在外部服务中发生某些情况（例如，收到新电子邮件、提交表单）时触发。连接器触发器将显示在节点面板的“触发器”部分。

触发器输入由触发器所有，可作为$vars.<triggerName>.output.<inputName>访问。有关详细信息，请参阅触发器。

何时使用连接器，何时使用 HTTP 请求

在以下情况下使用连接器节点……	在以下情况下使用 HTTP 请求...
存在目标服务的连接器	不存在该服务的连接器
您需要带类型的输入和输出，无需手动配置	您需要对标头、查询参数和正文进行完全控制
您希望通过 Integration Service 自动进行身份验证	该 API 使用非标准身份验证方案
您需要一个可适应 API 更改的可维护流程	您正在针对新的或内部 API 进行原型设计

经验法则：节点面板是检查连接器的第一个地方。当目标服务的连接器不存在时，HTTP 请求是回退。

可用连接器

可用连接器的完整列表取决于您的 Automation Cloud 组织和 Integration Service 配置。有关连接器特定的文档，包括设置、身份验证和可用节点，请参阅 UiPath Integration Service 文档：

Integration Service 连接器文档

相关页面

• HTTP 请求节点：不存在连接器时的通用 API 调用
• 触发器: 基于连接器的触发器和其他触发器类型
• 错误处理: 处理连接器节点的故障
• 变量和数据流：使用$vars访问连接器输出