连接器节点

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

内容是什么

连接器节点可让您直接从画布中使用其他应用程序，而无需自行设置 HTTP 请求。每个连接器都为一个应用程序提供现成的节点（例如 GitHub、Salesforce、Slack 或 Microsoft 365），具有类型化的输入和输出，以及可为您处理登录的连接。

连接器节点位于“添加节点”面板的“连接器”类别中。该类别以HTTP 请求开头，该请求会调用任何网址，随后是从 Act! 365 起的应用程序。每个应用程序都会打开其操作列表。

可用连接器

可用的连接器取决于您的组织， “添加节点”面板的“连接器”类别列出了所有这些连接器。此类应用程序包括 Salesforce、ServiceNow 和 Slack 等应用程序。热门连接器链接到最常见的连接器，而 Integration Service 指南中的“连接器”记录了每个连接器，及其设置、登录和操作。

How they work

“添加节点”面板列出了组织中可用的连接器。每个连接器节点都映射到目标服务上的特定 API 操作。

When you add a connector node to the canvas, Maestro Orchestrate fetches its input schema and renders a dynamic configuration form in the properties panel. You fill in the required fields, select a connection for authentication, and the node handles the API call at runtime.

配置

连接

Every connector node needs a connection, which signs UiPath in to the app with your account. You select the connection in the properties panel when you set up the node. The connection field lists the existing connections, grouped by folder, with Add new connection to create one without leaving the canvas, and Open connections to review all of them. Create a connection has the steps.

Connections handle token refresh, OAuth workflows, and credential storage automatically. Auth headers and secrets are not managed directly. Connections are managed by Integration Service. Connections in the Integration Service guide describes how to share and manage them.

节点特定输入

根据其包含的 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 请求...
存在目标服务的连接器	不存在该服务的连接器
您需要带类型的输入和输出，无需手动配置	您需要对标头、查询参数和正文进行完全控制
您需要连接为您处理登录问题	该 API 使用非标准身份验证方案
您需要一个可适应 API 更改的可维护流程	您正在针对新的或内部 API 进行原型设计

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

后续步骤

• 热门连接器：最常见的应用程序，以及指向每个连接器的链接
• Create a connection: create a connection from the node
• HTTP 请求节点：不存在连接器时的通用 API 调用
• 触发器: 基于连接器的触发器和其他触发器类型
• 错误处理: 处理连接器节点的故障
• 变量和数据流：使用$vars访问连接器输出