添加 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	常规	连接已禁用。请启用连接以继续操作。	连接已禁用，必须启用。