添加 Integration Service 活动

Integration Service 活动旨在使用 Integration Service 提供的连接器创建与第三方应用程序的连接，并轻松实现这些连接的自动化。这样可以更快地集成到软件即服务 (SaaS) 平台中。

我们支持广泛的第三方应用程序，并且支持的应用程序在不断增加。本指南包含 UiPath™ 创建的仅能与 Integration Service 一起使用的所有活动。同时使用 Integration Service 和基于作用域的连接的活动单独记录在生产力活动指南（例如，Microsoft OneDrive、Outlook 或 Google 活动）和IT 自动化活动指南（例如，Amazon WebServices、Azure 或 VMWare）中。

使用 Integration Service 活动

Studio Web

在 Studio Web 中，默认情况下会在活动浏览器中提供最新活动。有关更多信息，请参阅 Studio Web 用户指南中的向项目添加活动。

您还可以使用任何可用的触发器来启动自动化。有关详细信息，请参阅如何启动自动化。

Studio 2025.0.161

从Studio 2025.0.161开始Integration Service 连接器直接在“管理包”窗口中列出。这样可以更轻松地将连接器及其活动添加到项目中。有关详细信息，请参阅《Studio 用户指南》中的管理连接器。

Studio 桌面版 2023.10 或更高版本

从桌面版 Studio 2023.10 开始，Integration Service 活动通过统一的 UiPath.IntegrationService.Activities 包提供。

Studio 中“活动”面板的“可用”部分列出了所有 Integration Service 活动和触发器。

备注：

确保在“活动”面板中启用“可用”筛选器。

将“可用”列表中的任何活动添加到工作流时，系统会自动将UiPath.IntegrationService.Activities包作为项目依赖项安装。这使您可以访问 Integration Service 中的任何连接器，包括自定义连接器。

UiPath.IntegrationService.Activities 是动态活动包，这意味着您无需手动更新它。活动包会自动更新。您始终可以访问最新的连接器、触发器和活动，以及已在使用的活动的最新版本。

要了解更多信息，请参阅常见问题解答。

提示：

要访问预览版活动，请确保启用预览包和活动。如果您使用的是 Studio Web，请查看《Studio Web 用户指南》中的“预览活动和包”部分。如果您使用的是 Studio 桌面版，请查看《Studio 用户指南》中的“管理包”部分。

Studio 2023.4 版本或更低版本

如果您使用的是 Studio 2023.4 或更低版本，请使用包管理器下载特定连接器的单个活动包。有关详细信息，请参阅 Studio Desktop 用户指南中的“管理活动包”。

每个 Integration Service 连接器都有一个相应的包，形式为 UiPath.[ConnectorName].IntegrationService.Activities。例如 UiPath.Jira.IntegrationService.Activities。

重要提示：

要享受我们为 Integration Service 连接器和活动提供的最新更新的好处，我们建议您升级到 Studio 2023.10 或更高版本。

项目兼容性

通过统一的 UiPath.IntegrationService.Activities 包交付的所有活动均与 Windows 和跨平台项目兼容。

	Windows - 旧版	Windows	跨平台
UiPath.IntegrationService.Activities	❌	✅	✅

Integration Service 活动包的独立版本也可能与“Windows - 旧版”项目兼容。请检查单个包文档，以查看特定项目的兼容性。

限制

本节介绍影响所有 Integration Service 连接器和/或活动的平台级别限制和其他限制。

数据处理限制

Integration Service 在检索响应方面有平台限制。数据处理的最大限制为 8 MB。这意味着，对于某些 API 调用，检索到的响应数量可能会超过 8 MB 的限制，并引发以下错误消息：“响应内容太大”。

备注：

8 MB 的限制适用于 JSON 格式的数据。这包括以 Base64 格式将文件作为 JSON 数据的一部分发送或接收的情况。对于以 JSON 以外的格式处理的文件，此限制为 1 GB。

解决方法

您可以采取以下步骤来确保不超出数据处理限制：

• 将活动级别的“最大记录数”字段调整为较小的数字。
• 向查询添加筛选。提供筛选参数可以限制响应数量。

活动超时

对于基于 Integration Service 连接器的所有活动和触发器，全平台范围内的超时都为 90 秒。这意味着，如果未在 90 秒内从 API 收到响应，则活动将失败并显示超时错误。

错误代码

本节概述了您在使用统一 Integration Service 活动包中的活动时可能遇到的错误代码。

错误代码范围为 [1000, 3999]，分为三类：

• 运行时 (RT) - [1000、1999]
• 设计时 (DT) - [2000, 2999]
• 常规（可在运行时和设计时发生）- [3000, 3999]

在错误消息中，显示的代码会包含类别前缀，例如。 “帐户 ID”字段为必填项。 DAP-RT-1003。

有关常见错误代码的说明，请参阅下表。

错误代码	类别	消息	描述
1001	运行时间	服务提供程序为 null。	活动无法启动，因为未加载所需服务。如果问题仍然存在，请重新启动 Studio或联系支持团队。
1002	运行时间	连接 ID 为空。	未在活动中找到连接 ID。
1003	运行时间	“{fieldName}”字段为必填项。	必需的活动参数没有设置值。
1005	运行时间	服务响应的对象与活动的输出类型不符。	API 调用的响应与在设计时定义的输出架构不匹配。
1051（含）	运行时间	触发器执行失败。	触发器 API 调用返回了故障代码，或者响应为空。
1052（含）	运行时间	触发器活动找不到任何匹配项。	触发器未检测到任何匹配的事件。请检查筛选条件设置，或尝试在实时环境（而不是调试模式）中运行。
1101	运行时间	请求失败，出现错误: {0} 。状态代码: {1} 。	Integration Service 或供应商端的 API 调用失败。
1103	运行时间	如果没有自定义消息，将显示基础异常消息。	API 请求在执行期间失败。查看详细的错误消息并验证您的网络或 API 凭据。
2000	设计时	元数据 API 请求失败，出现错误“{0}”。状态代码：{1}。	此活动无法从服务中获取架构或配置。请检查您的网络连接和权限，然后重试。
2002 年	设计时	无法再通过当前连接访问对象“{0}”。请验证您的权限，或为此连接选择一个有效的对象，或选择一个包含此对象的连接。	引用的对象已删除，或无法使用当前凭据访问。文件可能已被删除，或者您的权限已更改。请刷新或选择/配置有效的对象。
2050（推荐）	设计时	查询 API 请求失败，出现错误“{0}”。状态代码：{1}。	API 调用无法提取下拉列表或其他类似控件的数据。可能的原因： 调用元素服务时构建的路径不正确。 供应商端点已关闭（通常返回 502 代码）。 缺少正确调用 API 的作用域。 该请求查找不存在的键（返回 404 代码）。 缺少标头（返回 400 代码）。
2151	设计时	重复的字段名称 "{0}"	有两个对象的名称相似，例如ID和Id 。
3000	常规	连接检索失败。请考虑使用其他连接。	连接客户端组件调用失败。可能有多种原因，例如连接无效。
3004	常规	未能获取资源{0}的访问令牌。	通常表示系统无法检索有效的安全令牌，通常是因为现有令牌已过期。
3005	常规	连接已禁用。请启用连接以继续操作。	连接已禁用，必须启用。