管理包

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

下载包版本

1. Under Packages, select the desired tab depending on your package type. In the grid, select More Actions for a package, then Select View Versions. The Package Versions window is displayed.
2. Select More Actions > Download package for the corresponding package version you want to download. The package is downloaded to the default location configured in your browser, in the .nupkg format. From here, you can upload it to another Orchestrator instance.
   备注：

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

手动将包上传到 Orchestrator

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

备注：

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

1. 在“包”下，根据您的包类型选择所需的选项卡，然后选择“上传”按钮 。显示“添加包”窗口。
2. Select Browse and select the packages (with the .nupkg extension) you want to upload to Orchestrator.
3. 选择“我想知道有哪些流程可升级”，以显示使用上传的包的早期版本的所有流程。
4. Select Upload. Orchestrator automatically determines the package Enter and displays the uploaded package in the corresponding grid under Tenant > Packages. If you selected the I would like to see which processes can be upgraded option, the Upgrade multiple processes window is displayed, showing a list of the processes that can be upgraded to a newer package version.

图 1. 升级多个流程

5. Use the checkboxes to select which processes to upgrade and Select Upgrade. The selected processes are updated to the new package version, and the window closes. Only the package version is updated. If you want to customize the process parameters or entry points, edit the process.

删除包

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

1. Under Packages, select the desired tab depending on your package Enter and locate your package in the list. From the More Actions menu for the package, select View Versions. The Package Versions window is displayed.

图 2. 包版本

2. Select one or more versions and Select Remove. Alternatively, Select More actions > Delete for the package version you want to delete. The selected package versions are removed.
3. Select Remove All Inactive to delete all inactive versions of the selected process. If a package version is part of a process (it is active), it is NOT going to be deleted. If all the versions are inactive, they are all deleted.

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

1. Under Packages, select the desired tab depending on your package type. In the list, select More Actions for a package, then Select View Versions. The Package Versions window is displayed.
2. 在“版本”选项卡上，您可以查看所选包的所有包版本。
3. 对于所需的版本，请选择“更多操作”>“显示发行说明”。此时将显示“发行说明”窗口，您可以在这里查看在 Studio 中为相应版本添加的说明。

In addition to that, you can see the note added in Studio, as well as the Windows applications used by the respective package version, displayed in alphabetical order. If the package uses applications that cannot be identified, an Unknown apps entry is displayed, suffixed by the number of unidentified apps, in parentheses.

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

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

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

图 3. 包详细信息

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

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

1. Under Packages, select the desired tab depending on your package type. In the package list, select More Actions for a package, then Select View Versions. The Package Versions window is displayed.
2. 选择“更改日志”选项卡。您可以查看库的所有包版本，还可以查看每个版本的相应发行说明，其中包含与不同版本之间的更改相关的信息。

图 4. 包版本的更改日志

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

查看包的参数

1. Under Packages, select the desired tab depending on your package type. Select More Actions for a package, then Select View Versions. The Package Versions window is displayed.
2. Select More Actions > Show Arguments for the desired package version. The input and output parameters of the selected package version are displayed.

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

查看包流程

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

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

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

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

为包添加标签

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

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

从包中删除标签

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

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

比较包和工作流

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

1. 在“包”下，根据您的包类型选择所需的选项卡，然后选择包旁边的“探索包”。此时将显示“探索包”窗口，为您提供所选包的所有版本。请注意，“探索包”选项仅在“自动化”和“测试自动化”网格中提供。
2. Select the Compare button above the list of package versions to toggle the compare mode. A checkbox appears in front of each package version.
3. 选中与您要比较的包版本相对应的框。您一次只能比较两个包版本。

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

4. Select the Compare button below the list of package versions. This button is activated after you select two checkboxes. The Comparing window is displayed, containing a list of results with the newest selected version's workflow files, along with the project author, and description. The workflow file set as Main in Studio is marked accordingly, and the project dependencies are displayed under the Dependencies section.

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

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

图 5. “比较”窗口

6. Select the Compare button next to a workflow file from the list of results. The two workflows are displayed side by side, the earliest file version on the left, and with an individual scroll for each workflow. All the changes that happened in the file between the two package versions at the container, connector, or activities level are highlighted and color-coded as follows:
   • 绿色突出显示已添加的内容
   • 黄色高亮显示已修改的内容
   • 红色高亮显示已删除的内容。

图 6. 比较流程图

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

7. (For containers only) Double-Select a container activity. The Comparing window displays only the activity within both package versions, for a focused view. If the activity exists in only one of the workflow files, then it is displayed in the corresponding workflow's side. Navigate back from the container to the workflow by clicking the breadcrumb trail.

图 7. 比较流程图

8. Select any activity to view the changes to its properties. All the changes that happened in the activity between the two package versions are highlighted and color-coded, as mentioned before.

探索包

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

备注：

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

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

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

5. Double-Select any scope to see a focused view of the workflow.

图 9. 工作流

6. Select Expand All to get a better view of a workflow section.
7. 选择任何活动以查看其属性。请注意，您还可以复制任何属性的值。

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