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 中管理解决方案”。

“资源管理器”面板

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

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

• 使用“添加到解决方案”按钮，以打开包含两个部分的菜单：
  • 添加到解决方案- 将项目添加到您的解决方案中：
    • 创建一个新的自动化项目。
    • 使用基于模板的自动化，根据模板创建自动化项目。
    • 新建 Maestro Flow 或 Maestro Automate 项目。
    • 导入现有自动化项目。
  • 添加到项目- 将新项目添加到当前项目：
    • 文件夹或文件。
    • 工作流文件：序列、流程图、长时间运行的工作流或状态机。
    • 表单、编码工作流、编码测试用例或代码源文件。
    • 测试用例或全局处理程序。
    备注：

    You can also access the Add to Solution window from the context menu of the Solution panel.

• 使用“搜索”栏在解决方案中查找特定项目、文件、页面、操作、变量或参数。
• Open the context menu of the solution to rename it, open it in Studio Web, or, for an empty solution, add a project — the same options offered by the Add to Solution button.
• 打开解决方案的上下文菜单，然后选择“从模板自动化” ，以添加基于模板的项目。有关更多信息，请参阅根据模板创建项目。
• Open the context menu of the solution or a folder and select Add > Folder... to group projects into folders. For more information, refer to Organizing projects into folders.
• Open the context menu of a project to:
  • 在 Studio 中打开项目，然后访问包含项目专属选项的项目的上下文菜单。
  • 在新的浏览器选项卡中打开 Studio Web 中的项目。
  • 将文件和文件夹添加到项目中，或使用打开项目文件夹 打开其文件夹。这些选项适用于解决方案中的每种项目类型。非活动项目仅提供“添加” > “文件夹...”和“文件...” ，而活动项目提供完整的项目菜单。
  • 从解决方案中移除项目。

在 Studio 中打开解决方案时，您只能对以下项目类型进行更改：

• RPA 项目
• Maestro Flow 和 Maestro Automate 项目
• Data Fabric 实体项目，您使用UiPath Maestro扩展程序编辑

解决方案中包含的其他项目类型无法在 Studio 中修改，需要您继续在 Studio Web 中编辑解决方案（其中包括应用程序项目、智能体流程、API 项目和智能体）。

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

当另一个工具（例如UiPath Maestro扩展程序或uip solution projects add ）更改解决方案时，项目列表将刷新。

根据模板创建项目

您可以基于模板将新项目添加到解决方案中，而无需先在解决方案之外创建项目。

1. 在“资源管理器”面板中，打开解决方案的上下文菜单，然后选择“从模板实现自动化” 。
2. 选择模板，然后配置新项目。

Studio 在解决方案文件夹中创建项目，并将其添加到“资源管理器”面板的解决方案中。

创建 Maestro 项目

您可以将两种类型的 Maestro 项目添加到解决方案中：

• Maestro Flow- 跨智能体、人员和系统编排业务流程。
• Maestro Automate - 将 AI 智能体和 API 整合到单个工作流中。

要添加：

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

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

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

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

在 Maestro Flow 和 Maestro Automate 之间转换

这两种产品都使用相同的流程画布，因此您可以将现有项目从一个产品移动到另一个产品。

1. 在“资源管理器”面板中，打开 Maestro 项目的上下文菜单。
2. 根据当前项目类型，选择“转换为 Maestro Automate”或“转换为 Maestro Flow” 。
3. 确认转换。

转换后，项目中的每个流程都将发布，并在新项目类型的 Runtime 上运行。流本身不会更改。

将项目组织到文件夹中

You can group the projects of a solution into folders in the Explorer panel. Folders can be nested.

To add a folder:

1. In the Explorer panel, open the context menu of the solution or an existing folder.
2. Select Add > Folder....
3. Enter a name for the folder.

The context menu of a folder also offers the Add to Solution options:

• Automation - Create a new automation project in the folder.
• Automation from Template - Create an automation project from a template in the folder.
• Import Existing Project - Import an existing automation project into the folder.

You can rename and delete a folder from its context menu, with the following restrictions:

• A folder that contains projects of the solution can't be deleted. Remove the projects from the solution first.
• A folder that contains the open project can't be renamed or deleted. Close the project first.
• The folder that stores the solution's resource definitions can't be renamed or deleted from Studio.

管理非 RPA 项目

From the context menu of any unsupported project, you can open it in Studio Web, publish it on its own, or remove it from the solution. Changes made in Studio Web are saved to the cloud and the project opens in a new browser tab. For publishing, refer to Publishing a Single Project.

在解决方案中设计和调试 RPA 项目的体验与独立 RPA 项目相同，项目通过“运行作业”活动调用解决方案的其他项目除外。有关更多信息，请参阅调试调用其他项目的项目。

备注：

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

活动项目

RPA 项目和 Maestro Flow 项目可以是解决方案的活动项目。如果在您打开解决方案时无法还原上一个活动项目，Studio 将激活可打开的解决方案中的第一个项目，尤其是 RPA 项目。

只要解决方案中至少保留一个项目，您就可以从解决方案中删除任何项目，包括活动项目。删除项目会删除其文件，因此 Studio 会先要求您确认删除。删除活动项目时：

• 系统将关闭项目中打开的文件，而不提示您保存这些文件。
• 其他项目中未保存的文件仍会提示您保存这些文件。取消提示将取消删除操作。
• 没有其他项目自动激活。选择您下一步要处理的项目。

在解决方案中运行和调试

调试调用其他项目的项目

当您在包含多个项目的解决方案中调试文件时，如果文件通过“运行作业”活动调用解决方案的另一个项目，Studio 会在调试开始之前自动准备解决方案。Studio 打包解决方案，将其发布到您的个人工作区，并部署调用的项目，以便它们在调用时作为 Orchestrator 作业运行。您无需先发布被调用的项目或将解决方案同步到云。

请记住以下几点：

• 如果 Studio 可以确定您调试的文件从未到达运行作业调用，则 Studio 会跳过此准备工作，并立即开始调试。
• 如果 Studio 无法确定这一点（例如对于编码工作流或动态调用目标），它仍会准备解决方案。
• 您调试的文件将在本地运行。断点和单步调试仅适用于您调试的项目。被调用的项目远程运行，您无法进入这些项目。

运行和调试 Maestro 流

您可以在 Studio 功能区中运行和调试 Maestro .flow文件，就像解决方案中的其他文件一样。运行、调试、停止、继续、进入、跳过和退出按钮控制流程会话，流程的输出显示在输出面板中。

• 您从流程画布启动的会话也可以通过功能区进行控制。
• “中断”不适用于流程。
• 断点、堆栈帧和变量在流画布中进行管理。
• 运行和调试流程需要UiPath Maestro扩展程序。

“定义的资源”面板

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

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

Resources can be created, defined, or deleted both from Studio and Studio Web. To delete a resource, open its context menu in the Solution Explorer and select Remove. To learn more, refer to Solution Resources in the Studio Web guide.

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

Editing a resource

1. In the Defined Resources panel, open the context menu of a resource and select Open.
2. Edit the resource in the tab that opens.

Changes are saved as you make them. When you rename a resource, the Defined Resources panel and the tab title show the new name.

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

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

After you create a solution in Studio Web, you have the option to continue working in Studio. From the Workspace page in Studio Web, open the menu on the right side of a solution and select Open in Studio Desktop. Alternatively, open the solution in Studio Web, open the context menu of the solution name in the Solution Explorer, and select Open in 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, a single project, or the test cases of the active project. For more information, refer to Publishing a solution.
• 某些项目类型（智能体流程、应用程序、API 工作流或智能体）只能在 Studio Web 中打开和编辑。您可以使用 Studio 获得强大的 RPA 设计和调试体验，使用 Studio Web 访问智能体自动化功能。
• 未来将在 CI/CD 与 UiPath CLI 的集成中添加对解决方案的支持。
• 您可以在 Studio Web 中的解决方案资源管理器中查看 Windows 项目，但只有在 Studio 中打开解决方案时才能对其进行编辑。
• 一次只有一个用户可以处理解决方案。我们引入了解决方案级锁，以防止无法解决的冲突（例如，一个用户在 Studio Web 中构建 API 工作流项目，而另一个用户在 Studio 中编辑 RPA 项目时）。如果没有此锁，稍后同步到云可能会覆盖一组更改。一旦 Studio Web 支持本地工作区（将整个解决方案保存到磁盘），此限制将消除，以便使用标准 Git 流安全地解决冲突。
  提示：

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