StudioX 用户指南

上次更新日期 2025年9月3日

关于自动化项目

自动化项目是一系列活动，Robot 可以执行这些活动来自动化您在计算机上执行的一系列任务。您可以在 StudioX 的“设计器”选项卡中创建和查看自动化项目。

在 StudioX 中创建项目时，项目文件将保存在一个文件夹中，该文件夹包含项目名称并位于您选择的位置。默认情况下，项目保存在 %USERPROFILE%\Documents\UiPath 目录中。

默认情况下，项目文件夹包含以下文件和子文件夹：

文件
- 一个 Main.xaml 文件，其中包含您的主要工作流程。
- project.json 文件，包含有关自动化项目的信息。
- 一个 Excel 文件，默认为Project_Notebook.xlsx（如果未将项目配置为使用其他项目笔记本）。
一个 GlobalHandlerX.xaml 文件，其中包含专用于在遇到执行错误时确定项目行为的工作流。
一个 RuntimeExecutionError_Template.html 文件，其中包含在遇到执行错误时显示的错误消息的模板。
子文件夹
- .local - 包含为项目在本地缓存的数据。
- .screenshots - 如果在项目中使用了任何用户界面自动化活动，则包含在此等活动中生成的参考截图。
- .settings - 包含运行时使用的活动项目设置。

设置项目兼容性

创建新项目时，请根据要自动化的应用程序和运行项目的环境选择兼容性：

Windows - 对于涉及 Windows 应用程序（例如 Microsoft Office 桌面版）的自动化，请选择此选项。自动化可以在 Windows 计算机上运行。这是默认选项。
跨平台 - 对于涉及在线应用程序（例如 Microsoft Office 365 网页版和 Google Workspace）的自动化，请选择此选项。自动化可以在 Windows 和类 Unix 操作系统（如 Linux 和 macOS）上运行。要了解有关设计跨平台项目的更多信息，请参阅 Studio 指南中的跨平台项目。
Windows - 旧版 - 与 Windows 类似，但基于正在逐步淘汰的旧版技术。这是在先前版本中创建的 StudioX 项目中使用的兼容性。有关如何将现有项目转换为较新的 Windows 兼容性项目的信息，请参阅将 Windows 旧项目转换为 Windows 兼容性项目

用作 Unattended 的 StudioX 项目

StudioX 项目专为 Attended 使用而设计，我们不建议在开发用于 Unattended 的项目时使用 StudioX。您可以通过删除 GEH，在 Studio 配置文件中更新 StudioX 项目以供 Unattended 使用。我们建议让 RPA Developer 在发布项目以供 Unattended 使用之前对其进行审核，因为他们可能想要添加额外的日志记录和错误处理方式，并检查应存储为资产的硬编码值。

调整项目设置

要配置每个项目的设置，请在 StudioX 功能区中选择“项目” > “项目设置”。

设置窗口字段说明

字段	描述
名称	更改项目名称。此类名称可能包含空格字符。在命名项目时，请记住在发布时删除空格字符。该字段最多接受使用 128 个字符。
描述	更改项目说明。该字段最多接受使用 500 个字符。
项目标签	您可以通过创建新标签或重用 Orchestrator 中已定义的标签来向项目添加一个或多个标签。标签有两种类型：“标签”和“属性”（键值对）。标签包含在已发布的包中，它们有助于描述项目并对其进行分类。例如，它们可以引用自动化应用程序（`Excel` 标签）或部门（`department:accounting` 键值属性）。当您开始输入时，系统会根据已定义的标签建议可能的匹配项，您可以通过从匹配项列表中选择一个标签来重复使用它。对于属性匹配，首先显示后跟 `:`（冒号）字符的键，并在选择键后显示关联的值。要添加新标签，请在输入名称后，单击名称旁边带有加号的条目。通过使用 `:`（冒号）字符分隔字符串，您可以添加属性，而不包含 `:` 的条目则可以添加标签。标签和键值属性不得超过 256 个字符。标签名称不能包含以下字符：`<`、`>`、`%`、`&`、`\`、`?`、`/`、`:`。项目标签可以自动应用于 Orchestrator 中的流程。有关使用标签的更多信息，请参阅 Orchestrator 指南中的“使用标签组织资源”。
Automation Hub URL	链接到项目的 Automation Hub 概念的 URL。有关详细信息，请参阅将项目链接到 Automation Hub 中的概念。
程序包图标	（可选）定义项目的自定义图标。您可以浏览并选择一个文件，或者为大小至多 1MB 的 `jpeg`、`jpg` 或 `png` 文件输入路径或公共 URL。项目发布后，图标显示如下：对于任务自动化，在流程名称旁的 Assistant 中显示，以便更轻松地在流程列表中识别。对于模板，在“主页（Studio 后台视图）”>“模板”中的模板旁边显示。注意：如果将本地文件用于发布到 Orchestrator 的库或不支持嵌入式图标的订阅源，则此图标在“管理包”中不可见。在这种情况下，请使用 URL 指明该图标。
PiP 选项	指明项目是否已使用画中画 (PiP) 进行测试，以及是否应默认在 PiP 中启动项目。已针对 PiP 使用情况进行测试；在 PiP 中启动 - 已批准自动化在 PiP 模式下运行。运行时，默认情况下在 PiP 中启动。已针对 PiP 使用情况进行测试；默认情况下未在 PiP 中启动 - 已批准自动化在 PiP 模式下运行。运行时，默认情况下在主会话或桌面中启动。未针对 PiP 使用情况进行测试 - 未批准自动化在 PiP 模式下运行。运行时，默认情况下在主会话或桌面中启动。如果在 PiP 中运行，则会出现一个对话框，通知用户未使用此功能进行测试，并在继续之前提示您确认。
PiP 类型	选择以 PiP 运行项目时如何将自动化与用户会话隔离：“新建会话”（计算机上的子会话）或“新建桌面”（用户会话中的虚拟桌面）。

发布自动化项目

发布自动化项目意味着将该工作流和所有其他文件存档到文件夹，以便将其发送到 Robot，然后执行。

如果 Robot 已连接到 Orchestrator，则可以将 StudioX 项目发布到 Orchestrator，并从 Assistant 运行这些项目。如果 Robot 未连接到 Orchestrator，则可以将项目发布到 Robot Defaults，然后从 Assistant 运行项目。

StudioX 的发布流程与 Studio 相同。有关更多信息，请参见《Studio 指南》中“关于发布自动化项目”。