UiPath Documentation
studio
latest
false
重要 :
新发布内容的本地化可能需要 1-2 周的时间才能完成。

Studio 用户指南

上次更新日期 2026年5月22日

新式体验与传统体验之间的差异

录制器

Activities (活动)

默认情况下,每种体验中都有一组单独的活动。

无论为项目选择哪种体验,您都可以启用仅默认情况下在其他体验中可用的活动。单击“活动”面板顶部的“视图选项”,然后选择:

  • 显示新式活动以查看使用传统体验的项目中的新式活动

  • 显示传统活动以查看使用新式体验的项目中的传统活动。

下表列出了默认情况下,一种体验提供,而另一种体验不提供的活动。默认情况下,两种体验中都提供未在表中列出的用户界面自动化活动

新式活动传统活动
激活单击键盘快捷键键入
查看应用程序状态在元素出现时在元素消失时在图像出现时在图像消失时等待元素消失时等待图像消失时查找图像图像存在时元素存在时
选中/取消选中选中
单击单击单击图像
提取表格数据提取结构化数据获取全文获取可见文本
获取文本获取文本
转至 URL导航至
高亮显示高亮显示
悬停悬停悬停在图像上方
键盘快捷方式发送热键
浏览器导航关闭标签页返回前往转至主页刷新浏览器
选择项目选择项目
截取屏幕截图截取屏幕截图
键入输入信息输入安全文本
使用应用程序/浏览器打开应用程序打开浏览器附加窗口附加浏览器元素作用域关闭窗口启动流程
不适用锚点基准上下文感知锚点

异常

下表列出了每项经典版异常及其对应的新版异常,包括关系类型:直接重命名(新版的概念和作用域相同)、部分映射(新版的作用域更窄/更宽)或无对应新版异常(功能已移除、尚未移植或新版中不需要异常)。

传统新版 (UiPath.UIAutomationNext.Exceptions)映射注意
常规活动 (UiPath.Core.Activities)
ElementNotSetExceptionNotInitializedException部分经典版:上下文中未提供元素。新版:使用前 InUIElement 属性未初始化。概念相同;新版的范围仅限于 InUIElement 输入。
TextNotFoundExceptionNodeNotFoundException部分经典版:文本查找活动的专用异常。新版:所有“未找到”用例(包括文本目标)均折叠到 NodeNotFoundException 中。
RegistrationException(none)无相应异常在经典版中,不会在生产环境中抛出;新版中没有等效概念。
ActivityTimeoutExceptionRuntimeTimeoutException直接重命名概念相同;已重命名并移至 UiPath.UIAutomationNext.Exceptions 命名空间。
PropertyNotSetException(none)无相应异常设计时 ValidationError 仅适用于经典版项目。新版活动使用不同的验证机制。
BrowserNotSetExceptionBrowserNotFoundException直接重命名经典版:上下文中无浏览器。新版:未找到匹配的浏览器。概念相同;新版名称更具描述性。
WindowNotSetExceptionApplicationNotFoundException部分经典版:窗口作用域活动的上下文中没有窗口。新版:附加时未找到应用程序。最接近;新版异常更广泛(涵盖所有应用程序类型,而非仅限于 Windows)。
SAP (UiPath.Core.Activities)
SAPCallTransactionExceptionSAPCallTransactionException直接重命名名称和概念均相同;命名空间已从 UiPath.Core.Activities 移至 UiPath.UIAutomationNext.Exceptions
SAPLoginExceptionSAPLoginException直接重命名名称和概念均相同;命名空间已从 UiPath.Core.Activities 移至 UiPath.UIAutomationNext.Exceptions
CellScopeExceptionSAPTableCellScopeException直接重命名概念相同(表格单元格作用域失败);已重命名为“SAP 专用”,并明确其专用于表格。
ExpandALVTreeExceptionSAPExpandTreeException直接重命名概念相同(SAP 树扩展程序失败);简化了名称。
选取器 (UiPath.Core)
InvalidSelectorExceptionInvalidSelectorException直接重命名名称和概念均相同(无法解析的选取器);命名空间已从 UiPath.Core 移至 UiPath.UIAutomationNext.Exceptions
InvalidFilterSelectorException (内部)(none)无相应异常内部类;新版无等效异常。
SelectorOperationExceptionUiAutomationException部分经典版:选取器操作期间的 COM/解析失败被折叠。新版:这些失败显示为常规 UiAutomationException;无专用的选取器操作异常类型。
元素/节点 (UiPath.Core)
SelectorNotFoundExceptionNodeNotFoundException直接重命名概念相同(选取器未找到元素);新版名称涵盖了选取器以外的范围。在经典版中,SelectorNotFoundException 会扩展 FindElementException;新版则在“UiAutomationException”下使用单层结构。
FindElementExceptionRuntimeFindException部分经典版:查找期间出现不属于“未找到”的 COM 错误。新版:查找失败,显示失败的搜索步骤详情。最接近;新版包含更丰富的诊断信息。
InvalidUiElementExceptionNodeNotFoundException部分经典版:COM 错误 E_UINODE_INVALID_ELEMENT(引用过时/无效)。新版:COM 错误 E_UINODE_INVALID_IDENTIFIER 映射到 NodeNotFoundException。概念相同(过时元素);新版的异常类型不同。
UninitializedNodeExceptionUiNodeUninitializedElementException直接重命名概念相同(未初始化节点、COM 错误 E_UINODE_UNINITIALIZED_ELEMENT);重命名后添加了 UiNode 前缀,以确保一致性。
UiElementHasNoItemsExceptionUiNodeHasNoItemsException直接重命名概念相同(空列表/树/组合、COM 错误 E_UINODE_HAS_NO_ITEMS);将 UiElement 重命名,添加了 UiNode 前缀。
ElementOperationExceptionUiAutomationException部分经典版:范围广泛,全面涵盖元素操作(点击、输入、高亮显示等)的任何 COM 失败。新版:由基本 UiAutomationException 发挥相同的作用;无专用的元素操作异常类型。
浏览器 (UiPath.Core)
InvalidBrowserExceptionBrowserNotFoundException部分经典版:uiBrowser COM 引用为 null。新版:未找到匹配的浏览器实例。用户可见场景相同(浏览器不可用);新版名称体现了查找附加模型。
BrowserOperationExceptionUiAutomationException部分经典版:专用于浏览器 COM 操作失败的异常。新版:浏览器操作失败显示为 UiAutomationException;无专用的浏览器操作类型。
窗口 (UiPath.Core)
InvalidWindowExceptionApplicationNotFoundException部分经典版:操作前窗口 COM 引用为 null。新版:附加时未找到应用程序。最接近;新版的范围更广泛(所有应用程序类型)。
WindowOperationExceptionUiAutomationException部分经典版:专用于窗口 COM 操作失败(隐藏、关闭、最大化等)的异常。新版:显示为 UiAutomationException;无专用的窗口操作类型。
图像 (UiPath.Core)
InvalidImageExceptionUiAutomationException部分经典版:专用于无效图像数据的异常。新版:图像错误显示为 UiAutomationException;无专用的图像异常类型。
InvalidRegionExceptionUiAutomationException部分经典版:屏幕区域为 null 或为空。新版:没有专用区域异常;显示为 UiAutomationException
ImageOperationExceptionUiAutomationException部分经典版:专用于任何图像操作失败的“全部捕获”功能。新版:图像操作失败显示为 UiAutomationException;无专用类型。
抓取 (UiPath.Core)
InvalidScrapeOptionsException(none)无相应异常新版中不存在经典版抓取选项模式;抓取的处理方式有所不同,没有等效的选项对象。
ActiveX (UiPath.Core.Activities)
AutomateActiveXException(none)无相应异常ActiveX 自动化是只有经典版才具备的功能,在新版中不可用。
ActiveXOutputArgumentsNotSupportedException(none)无相应异常仅限 ActiveX 的功能。
ActiveXUnknownMethodException(none)无相应异常仅限 ActiveX 的功能。
ActiveXInvalidArgumentsException(none)无相应异常仅限 ActiveX 的功能。
InjectDotNet (UiPath.Core.Activities)
InjectDotNetMethodNotFoundException(none)无相应异常“注入 .NET 代码”活动仅适用于经典版;没有等效的新版活动。
InjectDotNetAmbiguousMethodException(none)无相应异常只有经典版才具备的功能。
InjectDotNetTypeNotFoundException(none)无相应异常只有经典版才具备的功能。
InjectDotNetTypeNotSupportedException(none)无相应异常只有经典版才具备的功能。
InjectDotNetAssemblyReflectionException(none)无相应异常只有经典版才具备的功能;也不会在生产环境中抛出。
InjectDotNetArgumentNotDefinedException(none)无相应异常只有经典版才具备的功能。

对象存储库

您只能在具有新式活动的新式体验中使用对象存储库

抓取向导

  • 新式经验 -“表格数据提取”向导可用于数据抓取。
  • 传统体验 - 可以使用“数据抓取”和“屏幕抓取”向导。
  • 录制器
  • Activities (活动)
  • 异常
  • 对象存储库
  • 抓取向导

此页面有帮助吗?

连接

需要帮助? 支持

想要了解详细内容? UiPath Academy

有问题? UiPath 论坛

保持更新