管理包

在 Orchestrator 中查看、下载和管理自动化包及其版本。

下载包版本

1. 在“包”下，根据您的包类型选择所需的选项卡。在网格中，为包选择“更多操作” ，然后选择“查看版本” 。系统将显示包版本窗口。
2. 对于要下载的相应包版本，选择“更多操作” > “下载包” 。包以 .nupkg 格式下载到浏览器中配置的默认位置。您可以从此处将其上传到另一个 Orchestrator 实例。
   备注：

   仅当您使用本地订阅源并且您具有包的“查看”权限时，才会启用“下载”按钮。

手动将包上传到 Orchestrator

默认情况下，最大包大小限制为 300MB。

备注：

要手动上传带有标签的包，您需要标签的“创建”权限。如果您没有标签的“创建”权限，则上传的包不带有标签。

1. 在“包”下，根据您的包类型选择所需的选项卡，然后选择“上传”按钮 。显示“添加包”窗口。
2. 选择“浏览” ，然后选择要上传到 Orchestrator 的包（扩展名为.nupkg ）。
3. 选择“我想知道有哪些流程可升级”，以显示使用上传的包的早期版本的所有流程。
4. 选择“ 上传” 。Orchestrator 会自动确定包（输入），并在“租户” > “包”下的相应网格中显示上传的包。如果您选择了“我想知道有哪些流程可以升级”选项，系统会显示“升级多个流程”窗口，其中显示了可以升级到较新包版本的流程的列表。

图 1. 升级多个流程

5. 使用复选框选择要升级的流程，然后选择“升级” 。所需流程将更新为新的包版本，并且窗口会关闭。仅更新包版本。如果要自定义流程参数或入口点，请编辑流程。

删除包

如果包的所有版本均已删除，则只能将其从 Orchestrator 中删除。如果包版本处于“非活动”状态（即未部署到流程），则可以将其删除。

1. 在“包”下，根据您的包选择所需的选项卡。输入并在列表中找到您的包。从包的“更多操作”菜单中，选择“查看版本” 。系统将显示包版本窗口。

图 2. 包版本

2. 选择一个或多个版本，然后选择“删除” 。或者，对于要删除的包版本，选择“更多操作” > “删除” 。系统将删除选定的包版本。
3. 选择“删除所有不活动的” ，以删除所选流程的所有不活动的版本。如果包版本是流程的一部分（处于活动状态），则不会删除该包版本。如果所有版本都处于不活动状态，则将其全部删除。

显示一个包版本的发行说明

1. 在“包”下，根据您的包类型选择所需的选项卡。在列表中，选择包的“更多操作” ，然后选择“查看版本” 。系统将显示包版本窗口。
2. 在“版本”选项卡上，您可以查看所选包的所有包版本。
3. 对于所需的版本，请选择“更多操作”>“显示发行说明”。此时将显示“发行说明”窗口，您可以在这里查看在 Studio 中为相应版本添加的说明。

除此之外，您还可以查看在 Studio 中添加的说明，以及相应包版本使用的 Windows 应用程序（按字母顺序显示）。如果包使用无法识别的应用程序，则会在括号内显示一个“未知应用程序”条目，并以未识别的应用程序数量作为后缀。

如果无法检索到任何应用程序，则系统会显示“无法检索此包的应用程序”这一消息。这很可能是由于以下原因之一：

• 您的 Studio 版本低于 2023.2。
• 您的 Studio 版本为 2023.2，但由于存在监管规则，可防止记录此信息。
• 您的包从外部订阅源上传。只有内部订阅源中的包可以提供此信息。
• 该包不使用任何应用程序。

这些详细信息也会显示在其基础包的流程窗口中。

图 3. 包详细信息

请注意，您还可以选择从“发行说明”窗口中手动下载包版本。该过程类似于从“版本”选项卡中下载包版本。

显示所有包版本的发行说明

1. 在“包”下，根据您的包类型选择所需的选项卡。在包列表中，选择包的“更多操作” ，然后选择“查看版本” 。系统将显示包版本窗口。
2. 选择“更改日志”选项卡。您可以查看库的所有包版本，还可以查看每个版本的相应发行说明，其中包含与不同版本之间的更改相关的信息。

图 4. 包版本的更改日志

请注意，您还可以选择从“更改日志”选项卡中手动下载包版本。该过程类似于从“版本”选项卡中下载包版本。

查看包的参数

1. 在“包”下，根据您的包类型选择所需的选项卡。为包选择“更多操作” ，然后选择“查看版本” 。系统将显示包版本窗口。
2. 针对所需的包版本选择“更多操作” > “显示参数” 。显示所选包版本的输入和输出参数。

请注意，您不能在此级别上编辑参数的值，只能在流程、作业和触发器级别进行编辑。

查看包流程

您可以在以下位置单击“查看流程”，查看与包关联的流程：

• 在租户级别所需包的上下文菜单中，这将显示与该包的所有版本关联的流程。
• 在租户级别包版本的上下文菜单中，这将显示与您选择的特定包版本关联的流程。

上述两个选项都会显示“包流程”窗口，其中列出了包含该流程的文件夹。

您只能查看您有权查看的文件夹，不受其中可能包含该进程的任何其他文件夹的影响。“编辑”选项仅适用于您也具有编辑权限的文件夹。

为包添加标签

您可以在设计时在 Studio 中将标签应用于包。要了解如何向包添加标签，请参阅《Studio 指南》中的关于发布自动化项目。

您无法从 Orchestrator 更改包的标签。标签特定于每个包版本。在 Orchestrator 的“包”页面上，您可以看到特定于最新包版本的标签，无论它是处于活动状态还是非活动状态。

从包中删除标签

您可以在设计时在 Studio 中删除包中的标签。要了解如何从包中删除标签，请参阅《Studio 指南》中的关于发布自动化项目。

您无法从 Orchestrator 更改包的标签。标签特定于每个包版本。在 Orchestrator 的“包”页面上，您可以看到特定于最新包版本的标签，无论它是处于活动状态还是非活动状态。

比较包和工作流

您可以查看包的任何两个选定版本之间的差异，了解更改的内容：添加、修改或删除 .xaml 文件，文件夹或依赖项列表中的更改。您还可以比较两个所选版本的工作流 .xaml 文件，结果以图形方式并排显示。此功能使 Orchestrator 管理器无需 Studio 访问权限即可查看包和工作流中的更改。

1. 在“包”下，根据您的包类型选择所需的选项卡，然后选择包旁边的“探索包”。此时将显示“探索包”窗口，为您提供所选包的所有版本。请注意，“探索包”选项仅在“自动化”和“测试自动化”网格中提供。
2. 选择“比较”按钮以切换比较模式。每个包版本的前面都会显示一个复选框。
3. 选中与您要比较的包版本相对应的框。您一次只能比较两个包版本。

或者，您可以比较对应于两个包版本的相同 .xaml 文件。为此，请一次展开一个包，然后选择工作流文件。

4. 选择包版本列表下方的“比较”按钮。选中两个复选框后，系统将激活此按钮。系统将显示“比较”窗口，其中包含结果列表、最新选定版本的工作流文件、项目作者和说明。在 Studio 中设置为“主要”的工作流文件会被相应标记，项目依赖项会显示在“依赖项”部分下。

或者，如果您在上一步中选择比较工作流文件，则两个工作流并排显示，最早的文件版本显示在左侧。

5. 通过选择窗口右上角的其中一个选项来筛选显示的差异：
   • 全部 - 显示比较的包版本或工作流文件之间的所有差异。默认情况下选中此选项，显示所有差异的摘要。
   • 已添加 - 在“比较”窗口中，以绿色突出显示已添加到包版本中的文件、文件夹或依赖项，或已添加到工作流文件中的容器、连接器和活动以及它们的确切数量。
   • 已修改 - 在“比较”窗口中，以黄色突出显示包版本中变更的文件、文件夹或依赖项，工作流文件中变更的容器、连接器和活动以及它们的确切数量。
   • 已删除 - 在“比较”窗口中，以红色突出显示已从包版本中删除的文件、文件夹或依赖项，或已工作流文件中删除的容器、连接器和活动以及它们的确切数量。

图 5. “比较”窗口

6. 选择“比较”按钮，从结果列表中的工作流文件旁边查看按钮。两个工作流并排显示，左边是最早的文件版本，每个工作流都有单独的滚动条。在容器、连接器或活动级别的两个包版本之间的文件中发生的所有更改都突出显示并以颜色进行编码，如下所示：
   • 绿色突出显示已添加的内容
   • 黄色高亮显示已修改的内容
   • 红色高亮显示已删除的内容。

图 6. 比较流程图

如果仅在工作流级别执行了较小的更改（例如活动或连接器的位置），则会通知您逻辑未更改。

7. （仅适用于容器）双击容器活动。“比较”窗口仅显示两个包版本中的活动，以获得重点突出的视图。如果活动仅存在于一个工作流文件中，则系统会将其显示在相应工作流的一侧。单击面包屑导航，从容器导航回工作流。

图 7. 比较流程图

8. 选择任何活动，以查看对其属性的更改。如前所述，系统将突出显示两个包版本之间的活动中发生的所有更改并以颜色进行编码。

探索包

您可以查看和探索包版本中任何 .xaml 文件的图形表示（如 Studio“设计器”面板）。此功能可使开发者和 Orchestrator 管理器之间的合作更加顺畅。

备注：

• 您无法使用此功能探索已编译的包。
• 您可以在包资源管理器中完整查看已上传的 Studio 包及其所有.xaml资源（即在“发布选项” > “编译设置”部分中选择的“包含源”选项）时，请在包资源管理器中完整查看这些源。该情况适用于 Windows 和跨平台项目。请参阅 Studio 指南，了解有关自动化项目的更多信息。

1. 在“包”下，根据您的包类型选择所需的选项卡，然后选择包旁边的“探索包”。此时将显示“探索包”窗口，为您提供所选包的所有版本。请注意，“探索包”选项仅在“自动化”和“测试自动化”网格中提供。
2. 选择您希望了解更多信息的版本。此时将显示项目中所有可用 .xaml 文件，以及项目作者、描述和上传到 Orchestrator 的日期。在 Studio 中设置为“主”的 .xaml 文件会被相应标记，项目依赖项会显示在“依赖项”部分下。
3. 选择 .xaml 文件。系统将显示工作流。
4. 要查看选定文件中可用的所有变量、参数或导入，请选择“变量”、“参数”或“导入”按钮。随即显示相应的面板，与 Studio 中的可用面板类似。

图 8. 查看选定文件中的所有可用变量、参数或导入

5. 选择任意作用域，以查看工作流的集中视图。

图 9. 工作流

6. 选择“全部展开”可以更好地查看工作流部分。
7. 选择任何活动以查看其属性。请注意，您还可以复制任何属性的值。

可以在“字段描述”页面中获取每个上述字段、按钮和面板的详细信息。