使用 Content Cart 获取工作区数据

工作区的数据获取功能提供了一种便捷的实用工具，可用于在两个工作区之间复制数据（查看兼容性信息）。完成此操作的工具，也就是用于访问数据获取服务的界面，是 Content Cart。您可以在这里集中指定要从源工作区获取哪些内容，并将其传输到指定的目标工作区——就像一辆可靠的搬家货车，在已有的工作区之间“搬运”您指定的数据。

要说明一项功能如何运作，最好的方式莫过于举例。因此，为了说明 Content Cart 的各项细节及其在获取数据时的用法，本文将介绍如何在以下工作区之间获取一些元件：

• Source Server – 名为 Company Workspace 的工作区。
• Target Server – 名为 Secondary Company Workspace 的第二个工作区。

访问内容购物车

可从 Explorer 面板中访问 Content Cart 对话框。在浏览要从中获取数据的源工作区时，右键单击要获取的条目修订版，然后从右键菜单中选择 Operations » Add to Content Cart 命令。您可以添加一个或多个选定的条目修订版，甚至整个条目文件夹。首次访问内容购物车时，会将源工作区中当时选定的条目修订版加载到购物车中：

• 某个条目的单个特定修订版。
• 同一条目的多个特定修订版。
• 多个条目的最新修订版。
• 选定文件夹（及其子文件夹结构）中所有条目的最新修订版。这样，您就可以将整个文件夹加载到购物车中，同时保留其文件夹结构。要获取某个文件夹（及其子文件夹结构），请在源工作区的 Server Folders 区域（位于 Explorer 面板中）选择该文件夹，然后右键单击并从右键菜单中选择 Operations » Add to Content Cart 命令。

访问 Content Cart 的示例。

指定源工作区和目标工作区

参与获取的两个工作区在 Content Cart 对话框的顶部区域指定。源工作区 会根据您指定要获取的项修订版所在的位置自动确定，通常是您当前登录的工作区（本例中为 Company Workspace ）。如果已连接到多个工作区，请单击目标工作区的名称，或其右侧的 控件，打开当前已连接工作区的下拉列表。根据需要切换工作区。

指定参与获取的源工作区和目标工作区。

请注意，接收内容数据的工作区（目标工作区）必须能够连接到源工作区。这意味着本地部署的 Altium Enterprise Server 无法作为 Altium 365 工作区的内容数据源，因为后者无法连接到前者——前者位于本地 LAN/WAN 内，未向互联网开放。

工作区之间的数据获取概览：

源		目标	是否支持
Altium 365 工作区	→	Altium Enterprise Server 工作区
Altium Enterprise Server 工作区	→	Altium Enterprise Server 工作区
Altium Enterprise Server 工作区	→	Altium 365 工作区
Altium 365 工作区	→	Altium 365 工作区

另请注意，内容数据无法在 Altium 365 工作区与 Altium 365 GovCloud 工作区之间传输。

为购物车命名

从源工作区获取的数据将复制到目标工作区中项的新修订版内。默认情况下，这些项将位于目标工作区中新创建的指定文件夹结构中。用于存放这些获取内容的顶层文件夹以购物车本身的名称命名。默认名称格式为 Content Cart - <Current Date> - <Current Time>，在访问购物车时确定。您可以根据需要单击购物车名称右侧的 Change 控件，将其更改为更有意义的名称。

在随后出现的 Content Cart Name Selection 对话框中，直接输入所需的购物车名称。或者，您也可以在目标工作区中选择一个文件夹，用于存放购物车中的内容。此文件夹可以是现有文件夹，也可以是即时创建的全新文件夹。单击 Content Cart Name 字段最右侧的 按钮，打开 Choose Folder 对话框，浏览并选择用于存放购物车内容的现有文件夹。或者，使用右键菜单中的命令，在文件夹结构中创建一个新文件夹。

您可以根据需要为 Content Cart 命名。可以更改购物车的名称（其内容将存放到以该名称命名的顶层文件夹中），也可以选择将购物车内容存放到指定文件夹中。

指定要获取的项

Content Cart 对话框的主区域显示一个“获取网格”，其中列出了您选择从源工作区获取的所有条目修订版。可以将任意数量的数据条目修订版“加载”到 Content Cart 中，以便从源工作区获取。首次访问内容车时，会加载当时在源工作区中选定的条目修订版，但您也可以加载任意数量的其他条目。为此，请点击对话框右上角的 Add More Items 控件，然后选择 Select 选项，以打开 Choose Item 对话框（Explorer 面板的“精简版”）。您可以在此浏览源工作区，查找更多条目。请记住，您可以选择添加：

• 某个条目的单个指定修订版。
• 同一条目的多个指定修订版。
• 多个条目的最新修订版。
• 所选文件夹（及其下级结构）中所有条目的最新修订版。

或者，选择 Add manually 选项以打开 Add new items 对话框。此对话框允许您粘贴所需条目的外部列表（每行一个条目），然后使用选定的搜索条件（GUID、Item ID、Name 或 MPN）在源工作区中搜索这些条目。

主获取网格，列出了所有选定要从源工作区获取的条目修订版。

选中任意条目修订版并点击 按钮，即可将其从列表中移除。

内容车准备

选定源条目修订版后，现在需要对 Content Cart 进行“交付准备”，以便将其交付到目标工作区。为此，请点击 按钮。此操作会为目标工作区的获取操作做好准备，检查所选条目修订版的状态（确认它们之前是否已被获取）以及父子链接，并提出应执行的操作。此准备阶段的结果将显示在主获取网格中。

已准备就绪、可交付到目标工作区的 Content Cart 示例。

对于获取操作涉及的每个条目修订版，网格中的 Source 区域会展开，显示所有适用的子条目修订版，并可选择显示它们在源工作区中所在的文件夹。对于每个条目修订版（包括父条目和子条目的修订版），网格的 Target 区域可显示以下信息：

• Revision ID – 目标工作区中条目修订版的完整标识符，基于为该条目类型定义的条目命名方案和修订版命名方案生成。
• Folder – 目标工作区中的目标文件夹，获取的条目修订版将在其中创建或交付。
• Life Cycle – 为父条目定义的生命周期定义。
• Naming Scheme – 为标识父条目的各修订版而定义的修订版命名方案。
• Note – 可选备注，可供其他人在您的工作区中浏览已获取的内容时，了解有关此次获取的有用信息。

• Status – 条目修订版在目标工作区中的当前状态。可能的状态包括：

  • Not found – 从未获取过此条目修订版。
  • Already Exists – 之前已获取过此条目修订版。

• Action – 为实现源工作区与目标工作区之间的同步而需要执行的操作。可能的操作包括：

  • Transfer new revision and item – 用于全新获取，即之前从未获取过该条目的情况。也就是说，创建一个该类型的条目以及一个新的计划修订版，以接收源数据。
  • Transfer new revision of existing item – 用于获取条目的另一个修订版，且之前已获取过该条目的某个修订版的情况。
  • Nothing to do – 之前已获取过所选条目修订版。

内容车结构

在准备阶段，内容车会使用为每种可获取条目类型定义的默认设置。这些设置在 Content Cart Structure 对话框中定义，点击 Content Cart 对话框右下角的 Change Settings 控件即可打开该对话框。

默认获取设置在 Content Cart Structure 对话框中定义。

这些设置用于确定目标工作区中新建条目修订版的属性。这些修订版会预先创建并处于计划状态，以便接收源工作区中原始条目修订版的数据。设置包括目标工作区中的默认文件夹，以及默认生命周期定义、条目和修订版命名方案及起始索引。此外，还会定义一条默认备注，格式为 Acquired from <SourceWorkspaceName>。

对于目标工作区中的目标文件夹，每种条目类型都会被获取到以下位置下的独立文件夹中：

• 以 Content Cart 本身命名的顶层父文件夹
• 通过 Content Cart Name 选择对话框指定的现有文件夹。

请根据目标工作区中这些条目类型所采用（以及您偏好）的方案，修改这些默认获取设置。点击单元格即可访问编辑控件。

Content Cart Structure 对话框中的获取设置是总体层面的默认设置。对于从未获取过的条目，即父条目及其初始修订版均为新建的情况（Action 为 Transfer new revision and item），您可以根据需要在单个条目层面定义属性，以实现更精细的控制。为此，请在主获取网格中选择一个条目修订版，然后点击 按钮。这将打开 Edit Item 对话框，您可以在其中根据需要修改条目属性，覆盖默认设置。

若要实现更精细的控制，可以在单个条目层面定义属性。

内容车交付

准备完成后，点击 按钮开始获取。此时将出现一个确认对话框，提示您即将把 Content Cart 从源工作区传输到目标工作区，点击 Yes 继续。第二个确认对话框将确认获取结果，您可以通过 Explorer 面板在目标工作区中浏览已获取的条目。

如果在关闭 Content Cart 对话框之前，再次执行准备操作（点击 ），Status 和 Action 字段将更新以反映结果，分别显示 Already Exists 和 Nothing to do。

获取的数据会指向其原始来源。切换到目标条目修订版的 Origin 视图选项卡，即可查看此来源关联信息。要快速跳转到原始来源条目修订版，请点击 按钮。

以 IntLib 格式获取数据

您还可以从工作区获取元件，并将其存入集成库（*.IntLib）。从此类集成库放置元件时，实际链接仍指向工作区中的元件。这样，您就可以离线使用公司工作区中的元件，同时确保设计仍与源工作区中的这些元件保持真实关联。

获取到 IntLib

在 Content Cart 对话框中，获取到 IntLib 的流程如下：

1. 点击 Select target server 链接，然后从菜单中选择 IntLib file。

   
   将 Content Cart 的目标设置为 IntLib 文件。

2. 指定生成的 IntLib 文件的名称和位置。默认情况下，文件将以 Integrated_Library - <Date> - <Time>.IntLib 格式命名，并生成在 \Users\Public\Documents\Altium\AD<Solution/Version>\Library\ExportCmpLib 位置。可根据需要通过 Save As 对话框进行修改，点击 Change 链接即可打开该对话框。

   
   接受默认的目标文件夹和文件名，或根据需要进行更改。

3. 如果需要将更多元件获取到同一个 IntLib 中，请点击 Add More Items 链接，并选择 Select 条目，以打开 Choose Item 对话框（Explorer 面板的“精简版”）。您可以在此浏览源工作区，查找更多条目。也可以选择 Add manually 条目，打开 Add new items 对话框。此对话框允许您粘贴所需条目的外部列表（每行一个条目），然后使用选定的搜索条件（GUID、Item ID、Name 或 MPN）在源工作区中搜索这些条目。

4. 准备就绪后，点击 按钮，开始生成 IntLib。系统将创建一个临时集成库包（*.LibPkg），并生成和添加源 SchLib 文件（包含符号、参数和模型链接）及 PcbLib 文件（包含封装模型）。随后编译该库包，在指定文件夹中生成 IntLib 文件。文件成功生成后，将弹出信息对话框予以确认。

   
   将获取清单中的内容输出到目标文件夹，其中将包含所需的集成库文件。

使用 IntLib

生成后，可将 IntLib 添加到软件可用的非工作区库中（通过 可用的文件库对话框中的 Installed 选项卡）。随后即可在 Components 面板中使用它。根据需要，将 IntLib 中的元件放置到设计中。虽然您实际上是在“离线”使用这些元件，但指向原始工作区元件的链接可确保在恢复直接从工作区“在线”工作时保持连续性。