Solutions (解决方案)

在 Studio 中创建和管理解决方案，对自动化项目及其依赖项进行分组，并将其作为一个完整的端到端自动化跨租户部署。

解决方案将端到端业务流程自动化所需的一切都归为一组，使您能够开发自动化项目及其依赖项，并将其作为一个整体跨租户部署。

解决方案是云级容器，用于将端到端自动化建模为单个版本控制单元。在解决方案中，您可以创建和编排：

• RPA 工作流
• API 工作流
• Agents (智能体)
• 智能体流程
• 应用程序（配合人机协作验证）

所有这些组件都共享您在解决方案级别集中管理的解决方案作用域资源（资产、连接、队列、存储等）。解决方案还具有可移植性——打包一次，即可使用环境专属配置在租户和组织之间部署。

要了解更多信息，请参阅《Studio Web 用户指南》。如需有关解决方案如何构建、打包和部署的端到端视图，请参阅“解决方案开发生命周期”。

在 Studio 中创建解决方案

您可以直接在 Studio 中创建解决方案，该解决方案可以在“开始”页面中创建为空，也可以在您的第一个项目旁边创建。

从“开始”页开始

1. 在 Studio开始页面的“新建项目”下，选择“解决方案” 。
2. 在“新建解决方案”窗口中，输入解决方案的名称和位置，或保留预填充的值，然后选择“创建” 。
   备注：

   对话框中会拒绝与现有文件夹冲突的名称。

Studio 将创建一个空解决方案，并在“资源管理器”面板中将其打开。要添加项目，请选择“添加到解决方案”按钮，或打开解决方案根节点的上下文菜单，两者都提供相同的选项。

从新项目开始

1. 在 Studio 中，启动新的流程或模板项目。
2. 在新的项目配置中，启用创建新的解决方案。Studio 会创建解决方案，并以其第一个成员身份在资源管理器面板中打开您的项目。
3. 要将更多项目添加到解决方案，请选择资源管理器面板中的添加到解决方案按钮。您可以创建新的自动化项目或导入现有项目。
   备注：

   您还可以打开“资源管理器”面板的上下文菜单，以访问相同选项。

要继续使用最初在 Studio Web 中创建的解决方案，请在 Studio Web 中的工作区页面中打开该解决方案，然后选择在 Studio Desktop 中打开。有关更多选项，请参阅“在 Studio 和 Studio Web 中管理解决方案”。

“资源管理器”面板

“资源管理器”面板用于管理解决方案中的项目，以及每个项目中的项目文件。

在“资源管理器”面板中，您可以：

• Use the Add to Solution button to open a menu with two sections:
  • Add to Solution - Add a project to your solution:
    • 创建一个新的自动化项目。
    • Use Automation from Template to create an automation project from a template.
    • Create a new Maestro Flow or Maestro Automate project.
    • 导入现有自动化项目。
  • Add to Project - Add a new item to the current project:
    • A folder or a file.
    • A workflow file: sequence, flowchart, long running workflow, or state machine.
    • A form, a coded workflow, a coded test case, or a code source file.
    • A test case or a global handler.
    备注：

    您也可以通过在“解决方案”面板中右键单击来访问“添加到解决方案”窗口。

• 使用“搜索”栏在解决方案中查找特定项目、文件、页面、操作、变量或参数。
• 右键单击解决方案以重命名，在 Studio Web 中打开，对于空解决方案，添加项目 — 这些选项与“添加到解决方案”按钮提供的选项相同。
• Open the context menu of the solution and select Automation from Template to add a project based on a template. For more information, refer to Creating a project from a template.
• 右键单击项目，以：
  • 在 Studio 中打开项目，然后访问包含项目专属选项的项目的上下文菜单。
  • 在新的浏览器选项卡中打开 Studio Web 中的项目。
  • Add files and folders to the project, or open its folder with Open Project Folder. These options are available for every project type in the solution. Projects that aren't active offer only Add > Folder... and File..., while the active project offers the full project menu.
  • 从解决方案中移除项目。

When you open a solution in Studio, you can only make changes to the following project types:

• RPA projects
• Maestro Flow and Maestro Automate projects
• Data Fabric entity projects, which you edit with the UiPath Maestro extension

Other project types included in a solution cannot be modified from Studio and require you to continue editing the solution in Studio Web (this includes app projects, agentic processes, API projects, and agents).

您可以在解决方案资源管理器中浏览其他不支持的项目类型，与 RPA 和 Flow 项目一起浏览。当您使用其中一个文件夹打开文件时，会显示一个上下文横幅，说明有限的编辑体验，并提供在 Studio Web 中进行编辑的链接。

The project list refreshes when another tool, such as the UiPath Maestro extension or uip solution projects add, changes the solution.

根据模板创建项目

You can add a new project based on a template to a solution, without creating the project outside the solution first.

1. In the Explorer panel, open the context menu of the solution and select Automation from Template.
2. Select a template, and then configure the new project.

Studio creates the project inside the solution folder and adds it to the solution in the Explorer panel.

Creating a Maestro project

You can add two kinds of Maestro projects to a solution:

• Maestro Flow - Orchestrates a business process across agents, humans, and systems.
• Maestro Automate - Brings AI agents and APIs together in a single workflow.

To add one:

1. 在“资源管理器”面板中，选择“添加到解决方案”按钮。
2. Select Maestro Flow or Maestro Automate.
3. 输入项目名称，然后选择“新建” 。

Studio 将项目构建到解决方案中（与在命令行中使用 uip maestro flow init 相同）并打开流程文件。

首次打开.flow文件时，Studio 会提示您安装UiPath Maestro扩展程序。安装以获取完整的可视化流画布；否则，文件将作为纯文本打开。

要了解如何构建流本身，请参阅《Maestro 用户指南》 。

在 Maestro Flow 和 Maestro Automate 之间转换

Both products use the same flow canvas, so you can move an existing project from one to the other.

1. In the Explorer panel, open the context menu of a Maestro project.
2. Select Convert to Maestro Automate or Convert to Maestro Flow, depending on the current project type.
3. Confirm the conversion.

After the conversion, every flow in the project publishes and runs on the runtime of the new project type. The flows themselves are not changed.

管理非 RPA 项目

右键单击任何不支持的项目，以在 Studio Web 中打开该项目，或将其从解决方案中删除。在 Studio Web 中所做的更改将保存到云，并在新的浏览器选项卡中打开项目。

The experience of designing and debugging RPA projects within a solution is the same as with standalone RPA projects, except when a project calls other projects of the solution through a Run Job activity. For more information, refer to Debugging projects that call other projects.

备注：

您无法将 Windows 旧版项目添加或导入解决方案。

The active project

RPA projects and Maestro Flow projects can be the active project of a solution. If the last active project can't be restored when you open a solution, Studio activates the first project in the solution that it can open, preferring RPA projects.

You can remove any project from the solution, including the active project, as long as at least one project remains in the solution. Removing a project deletes its files, so Studio asks you to confirm the removal first. When you remove the active project:

• The open files of the project are closed without prompting you to save them.
• Unsaved files from other projects still prompt you to save them. Canceling the prompt cancels the removal.
• No other project is activated automatically. Select the project you want to work on next.

Running and debugging in a solution

Debugging projects that call other projects

When you debug a file in a solution with more than one project, and the file calls another project of the solution through a Run Job activity, Studio prepares the solution automatically before debugging starts. Studio packs the solution, publishes it to your Personal Workspace, and deploys the called projects, so that they run as Orchestrator jobs when they are invoked. You don't need to publish the called projects or sync the solution to the cloud first.

Keep in mind the following:

• If Studio can determine that the file you debug never reaches a Run Job call, it skips this preparation, and debugging starts right away.
• If Studio cannot determine this, for example for coded workflows or dynamic invoke targets, it prepares the solution anyway.
• The file you debug runs locally. Breakpoints and stepping apply only to the project you debug. The called projects run remotely, and you cannot step into them.

Running and debugging Maestro flows

You can run and debug Maestro .flow files from the Studio ribbon, the same way as other files in the solution. The Run, Debug, Stop, Continue, Step Into, Step Over, and Step Out buttons control the flow session, and the output of the flow is displayed in the Output panel.

• Sessions that you start from the flow canvas are also controlled from the ribbon.
• Break is not available for flows.
• Breakpoints, stack frames, and variables are managed in the flow canvas.
• Running and debugging flows requires the UiPath Maestro extension.

“定义的资源”面板

“定义的资源”面板显示解决方案中包含的资源。面板可以折叠。资源会在活动使用时自动添加到解决方案中，并按以下类别分组：

• Apps - 由自动化提供支持的用户界面，允许您构建连接到数据的自定义业务应用程序。
• 资产- 可以在不同自动化项目中使用的共享变量或凭据。
• 业务规则- 用于存储和管理决策模型和标记 (DMN) 文件的对象。
• 连接-有助于在单个用户和外部应用程序之间建立任务的 Integration Service 连接。
• 上下文- 提供许可知识库访问权限的上下文基础索引。
• 流程- 链接到特定文件夹的包版本。
• 队列- 队列是容器，可用于存储不限数量的项目。
• 存储桶- 创建自动化项目时利用的基于文件夹的存储解决方案。
• 任务目录- 操作容器，您可以在其中根据各种条件对操作进行分类。在创建操作时，使用 Studio Web 中的操作创建活动来设置存储操作的目录。
• 依赖项- 上下文链接到特定项目的活动类别。

可以从 Studio 和 Studio Web 中创建、定义或删除资源。要删除资源，请在解决方案资源管理器中右键单击该资源，然后单击“移除”。要了解更多信息，请参阅《Studio Web 指南》中的“解决方案资源”。

活动了解解决方案的上下文。在处理解决方案资源的活动中（例如，“添加队列项目”），资源选取器小组件会显示所有可用资源（资产、队列、连接等）。您还可以使用“打开 Orchestrator”按钮在 Orchestrator 中管理平台资源。

在 Studio 和 Studio Web 中管理解决方案

对解决方案所做的更改始终会同步到云，使您能够在 Studio 和 Studio Web 之间无缝切换。

在 Studio Web 中创建解决方案后，您可以选择继续在 Studio 中工作。在 Studio Web 中的“工作区”页面中，打开解决方案右侧的菜单，然后选择“在 Studio Desktop 中打开”。或者，在 Studio Web 中打开解决方案，在解决方案资源管理器中右键单击解决方案名称，然后选择“在 Studio Desktop 中打开”。

打开在 Studio Web 中创建的解决方案后，在状态栏中选择“Cloud 解决方案”标签打开下拉菜单，其中包含可供您管理解决方案的选项：

• 在浏览器中打开 - 在 Studio Web 中打开解决方案。如果解决方案被 Studio Web 锁定，会显示错误，并以只读模式在新的选项卡中打开解决方案。
• 与云同步 - 推送您在 Studio 中进行的更改，并继续在 Studio Web 中构建解决方案。

您可以通过选择状态栏中的“添加到来源控件”标签，在 Git 版本控制下添加解决方案。这样您可以在解决方案级别管理提交和分支。

备注：

• Studio 会检测项目何时是解决方案的一部分。打开作为解决方案一部分的本地项目会自动打开整个解决方案上下文。
• 在将跨平台项目转换为 Windows 兼容版本时，项目会直接转换，不会提供创建原始项目副本的选项。

在 Studio 和 Studio Web 中使用解决方案

在 Studio 和 Studio Web 中使用解决方案时，请记住以下差异：

• 目前仅 Studio Web 支持重命名单个项目。
• From Studio, you can publish the whole solution, or only the active project or its test cases. For more information, refer to Publishing a solution.
• 某些项目类型（智能体流程、应用程序、API 工作流或智能体）只能在 Studio Web 中打开和编辑。您可以使用 Studio 获得强大的 RPA 设计和调试体验，使用 Studio Web 访问智能体自动化功能。
• Support for solutions will be added to CI/CD integrations with UiPath CLI in the future.
• 您可以在 Studio Web 中的解决方案资源管理器中查看 Windows 项目，但只有在 Studio 中打开解决方案时才能对其进行编辑。
• 一次只有一个用户可以处理解决方案。我们引入了解决方案级锁，以防止无法解决的冲突（例如，一个用户在 Studio Web 中构建 API 工作流项目，而另一个用户在 Studio 中编辑 RPA 项目时）。如果没有此锁，稍后同步到云可能会覆盖一组更改。一旦 Studio Web 支持本地工作区（将整个解决方案保存到磁盘），此限制将消除，以便使用标准 Git 流安全地解决冲突。
  提示：

  • 在解决方案级别使用 Git 对自动化项目及其配置进行版本调整。