用条目管理器管理内容

父级页面：使用互联工作区进行设计

Altium NEXUS与互联工作区一起提供将工作区中元件更新到现有电路设计中元件的功能。源于数据库和基于文件库的元件可以单独更新到工作区元件中，或通过Altium NEXUS的条目管理器用自动参数匹配进行批量更新。

借助高度可配置规则的系统瞄准工作区中的合适元件，“条目管理器”对话框提供了一种快速高效的方式，可将现有PCB项目转换成可使用工作区元件的的项目。

在电路设计项目中，条目管理器可提供两种与元件和可复用的原理图电路相关的重要功能。

• 移植——首先，它允许设计项目从按照传统方法使用元件和原理图转换到使用工作区的实体（元件和受管的图纸）。这一点可以视为提供转换到使用工作区数据的功能。
• 同步——其次，一旦设计被转换成使用工作区的内容后，当工作区中的源更新时，条目管理器就将它以一种简单的方法同步到设计中。这一点可以视为具备从工作区同步更新数据的功能。

就背景而言，请注意设计中的单个元件可以通过原理图编辑器中的属性面板直接更新成工作区元件。为此，请在原理图上选择元件，然后使用面板的“源”下拉菜单选择一个工作区作为元件的数据源——您需要连接到该工作区以便可访问。之后的“元件源”对话框在保留或替换元件标识（设计条目ID）的同时，会让您选择是从工作区选择目标元件或仅将元件连接到工作区。

如果工作区中的元件已被选定，被访问的元件数据将替换现有元件和模型，并更新元件参数。如下图所示，面板还将显示元件当前的生命周期状态和修订状态。

本地的元件可单个转换成工作区元件，也可使用条目管理器批量转换。您在此处可以看到原始元件。悬停在图片上可以看到该元件已经变成工作区的对应元件。

还有一种方法，就是通过项目的ActiveBOM文档（BomDoc）替换元件。

但即使在小型的电路板设计中，使用这种方法将所有设计的本地元件更新到工作区元件也是非常耗时的。条目管理器利用高级参数匹配（自动匹配）和批量更新方法能提供一种简单的自动化方法。条目管理器的一个典型应用就是变更现有电路板设计以使用从公司库中移植到工作区的元件和托管原理图。

访问条目管理器

从活动的原理图文档（工具 » 条目管理器）中进入主“工具”菜单就可以访问条目管理器对话框，它会列出活动电路板设计项目中发现的所有元件和图表符。

选择对话框的下方的“未托管”或“元件”选项卡，将元件清单写入现有设计中。实际上，当工作区的适当元件被分配给现有项目时，对话框左边显示的是活动项目的元件设置（现有设置），当工作区中分派适当的工作区元件后，元件右边的清单就会列出他们将要执行的变更（新设置）。若要查看和访问图表符，请选择“图表符”选项卡。

通过原理图编辑器的主工具菜单访问条目管理器。对话框将自动写入现有设计元件（和原理图）。

“条目管理器对话框”以哪种方式显示元件数据是高度可配置的，取决于数据栏位是否已激活或已分组。这允许将设计内容和他们的关联系统/用户参数清单以符合元件标识的特定方式显示出来——即所有的条目参数，例如公司专用的元件料号可以根据需要显示出来。

列

要配置在项目管理器中显示哪些列，请右键单击对话框的列标题区域并从上下文菜单中选择列 » 选择列。选择列对话框将提供所有可用参数，包括专门来自本地设计的参数（[当前设置]）和工作区中的内容（[新设置]）。使用条目左侧的“眼睛”控件来显示列 () 或不显示 ()。

所显示的列以及它们的顺序，可进行配置以适应您的工作区/元件库系统和首选项的需求。

将鼠标悬停在选定列标题上展示它的过滤器图标，使得条目管理器中的清单可被限制为特定条目类型或自定义创建的过滤器。

分组

若要利用特定参数列如元件类型类别或原理图文档等，对列举的内容数据进行分组，将期望的列标题入口拖拽到对话框顶部的标题行（如提示文本所述）。内容清单将会按照分配的参数列重新配置分类入口的分组。

任何数据列标题都能被拖拽到对话框的顶行，从而按照该参数对列举的入口进行分组。

移植设计内容到工作区

假设互联工作区已填入收集到的元件和托管原理图，当适当的匹配可用时，现有电路板设计项目可以转换成使用这些内容。从本地到工作区的配对可以手动进行，也可以通过基于可配置参数匹配的条目管理器以自动化过程进行。完成之后，本地元件的定义将被更新成工作区的同类。

手动选择工作区内容

若要利用工作区版本手动替换一个本地元件（或原理图），在条目管理器清单中选择它的入口，然后在它的右键单击上下文选项中选择“手动选择”。在之后的“替换元件”对话框中，浏览工作区并在其中选择匹配的条目（将使用该条目的最新版本）。

An example of manually choosing a Workspace component to use as the source for the existing design component in a design.

对话框关闭后（OK），所选的工作区元件信息将填入新设置区域清单的入口。请注意因为入口现在是一个未决的工作实体，更新后的入口会从未受托管选项卡下的清单转移到受托管理选项卡的清单中。

所选工作区的条目详情显示格栅的新设置区域，列在托管选项卡下方。

自动匹配元件

若要自动选择匹配工作区内容的过程，条目管理器提供了一个可配置的自动匹配功能，可以为每一个本地设计元件匹配互联工作区中的元件。当匹配找到后，工作区的元件将提议更新。

条目管理器自动化参数匹配能力的关键是更新规则和条目管理器选项对话框中可用的选项，可通过条目管理器对话框按钮访问。可配置的规则决定了活动（本地）设计中哪个元件参数与所选源服务器中所有的工作区元件参数相匹配。

创建简单或复杂的规则以准确匹配本地元件与工作区内合适的元件。

这些规则在完成本地与工作区元件匹配过程中的有效性取决于可用的元件参数，而这些参数应满足公司系统要求或个人喜好。在最简单但也许不太可能出现的情况下，评论或元件名称参数入口可能会匹配到本地和工作区相同元件。在理想情况下，本地与工作区的元件都将共用公司参考或制造商元件料号参数。

若要创建一个这样的料号规则——例如，选择和修改现有规则（也可以重命名）或使用按钮创建一个新规则——必须是一个经过挑选（检查）以便编辑的规则。请注意本地参数和服务器参数选项的下拉菜单清单是独立的，因此允许推荐完全不同名称的参数——在下面的例子中，本地的库引用参数和工作区的料号参数代表公司的元件引用编号。

复杂、多参数的规则要求所有指定元件参数必须与工作区的元件匹配。

运行上述元件或引用编号匹配规则很可能会在本地和工作区元件之间创建一个近乎完整的匹配。规则建立的同时，就可以利用条目管理器对话框中的按钮启动匹配过程。

之后的“自动匹配条目”对话框将显示带状态图标的正向匹配并包含对成功规则的名称的引用。

使用基于通用料号的单个规则成功为多个元件完成本地到工作区的配对示例

如果找不到匹配，入口将变成带状态图标的红色文本，并含一段描述说明错误或配对失败原因，这时就需要创建一个不同的或额外的规则实现这些元件的成功配对。请注意一个规则可能会探测到不止一个工作区元件作为匹配，这种情况会被称为匹配成功但需要手工干预解决问题。这种冲突会被视为“模糊”结果，可以在条目管理器对话框中解决，请查看以下内容。

自动匹配过程完成后，关闭自动匹配项目对话框 (OK) 以使用建议的新元件设置填充项目管理器对话框。将应用于匹配条目的待处理 Workspace 内容与未匹配的内容一起列在对话框的 Managed 选项卡下或 Components 选项卡下的 New Settings 区域中。

工作区内容的待决变更在对话框的新设置区域有详细介绍。

若要解决通常由多项匹配导致的模糊内容，请选择模糊条目（或模糊封装）标签，然后从对话框的新设置区域（默认情况下显示<未选择>）的修订HRID单元的下拉菜单中做出正确的选择。请注意多个匹配以及因此可用的选项有可能是同一元件的不同修订版本。问题解决后（不再归类为模糊），元件入口就会转移到受托管/元件选项卡的清单。

一个规则检测到多个匹配时，模糊条目标签具有推荐一种选择的功能。匹配超过六个时会导致规则错误。

高级匹配规则

如上文所述，条目管理器规则为本地项目元件和工作区元件之间建立参数匹配。你可以创建的规则数量无限制，多个规则将按照降序运行。如果首个规则（优先级最高）失败，那么就使用下一个规则，即顺序的布尔 OR 关系。规则只有在相关复选框启用时才处于活动状态。

当自动匹配过程进行时，自动匹配条目对话框中的状态备注列会说明寻找匹配时哪些规则已失败。这种情况下，需要一个不同或全新的规则满足可用的参数的匹配。

基本规则为所有元件寻找匹配时可能会失败，可以创建更具体的参数规则以获得全面匹配的结果。

使用条目管理器选项对话框的按钮创建新的规则，并用关联的按钮应用多参数匹配条件。由于每一个参数条件都已添加，规则就变得越来越具体，在规则匹配完成前要满足所有的条件 - 实际上是布尔 AND 条件。

这里显示的例子，当元件不能通过料号或参考编号参数匹配时，创建一个新规则以为下方列出的未匹配电容匹配合适的规格。

规则按照从上到下的顺序运行直至找到匹配。多参数规则匹配时必须满足所有条件。

更新选项

条目管理器选项对话框提供一系列内容更新选项，可用来进一步完善工作区元件如何自动匹配当前电路板设计。

条目管理器更新选项为定义哪些参数需要更新以及在何种条件下更新，提供了一种灵活的方式。

选项通过ECO过程应用于当前设计，过程如下：

• 更新“锁定标识符”字段——如果选中该选项，本地元件标识符字段的锁定状态会被所连接的工作区中元件的状态覆盖。
• 更新“锁定元件-ID”字段——如果选中该选项，本地元件的多部件元件的 ID 选项的锁定状态将会秉承与其连接的工作区元件的状态。
• 更新参数——选中以允许元件的参数更新成所连接工作区元件的参数。启用下列选项。
  • 按钮——打开元件库更新设置对话框（见下文）。
  • 保持参数位置——如果选中该选项，原理图中的可见参数将保持不变，而不是重设到连接工作区元件的默认位置。
  • 保持参数可见——如果选中该选项，参数的可见状态将保持不变，而不是采用所连接元件的可见状态。

元件库更新设置对话框包括当前电路板项目上所有元件对应的所有可用的参数的清单（单击右键访问批量开/关功能）。当本地元件被工作区元件替代或更新时，清单中选中的参数将会更新，这种更新行为由下述选项决定。

可以准确定义哪些元件参数需要升级。单击右键访问选择选项。

参数的替换（或增加）行为由对话框下方的两个选项决定：

• 不在图表中的库参数——当工作区元件（库）参数不在本地（图表）元件中时设置更新动作。
  • 添加——更新时将参数添加到元件。
  • 不添加——更新时不添加参数到元件。
  • 如果不为空则添加 ——- 仅当参数具有有效数据（其值条目不为空）时，才会在更新期间将参数添加到元件。
• 图纸参数不在库中 ——- 当链接的工作区元件（库）中不存在本地（图纸）组件参数时设置更新行为。
  • 移除——更新时将参数从元件中删除。
  • 不移除——更新时不从元件中删除现有参数。
  • 空白时移除——如果参数为无效数据（参数值入口为空白），现有参数将在更新时从元件中删除。

应用更新

通过生成和执行工程变化列表（ECO）将推荐的更新应用到当前电路板设计上。选择您希望更新的已列出的元件范围，从按钮菜单中选择期望的ECO选项，选项包括如下：

• 生成ECO——使用该命令通过工程变化列表对话框生成并执行ECO。在对话框中，您可以浏览将要采取的行为：根据需求变更或禁用任何行为。满足条件时，执行ECO，变更将投入应用。
• 应用ECO——使用该命令直接“安静地”创建和执行ECO（无需出现工程变化列表对话框）。

使用工程变化列表（ECO）执行变更，或通过对话框进行（如图所示）。

执行ECO的过程将会相应地更新项目元件，然后被当做最新工作区元件列入条目管理器对话框。请注意每一个入口（）先前的图标都已更改为指示对工作区元件 () 的引用。

条目管理器在PCB项目的设计内容中显示全新的设置。之前的本地设计元件已被工作区元件完全取代。

在原理图编辑器中，更新的元件连接到工作区中与他们匹配的元件——如果它已随之更新，活动连接信息将检测到工作区元件修订状态的变化。在设计区域选择一个元件，在属性面板上查看它的源和相关信息。

显示成功替换本地元件的示例，其中“属性”面板显示替换元件的工作区源和修订状态。

同步已变更的工作区内容

在产品研发期间，设计的源元件或托管原理图很有可能会发生变化。例如，元件模型可能要更新以满足新的制图标准，元件定义也可能要更新以添加新的参数。任何用于设计中的工作区元件和受托图标发生此类变化时，都需要被检测到并扩展到所有受影响的原理图中。

检测何时需要更新

对单个选定元件或图表符来说，属性面板上相应的元件和图表符的模式明确表示与工作区的源数据相比，目标已过期。使用相关的 或按钮从源工作区更新该对象的数据。

当项目被选定后，元件或托管原理图的过期状态就会出现在属性面板中。将选定项目升级到最新版本的按钮。

条目管理器不仅被用来检测和管理当前非工作区实体（标注为[未托管]和不来源于工作区）的元件和原理图，还用来检测和管理所有过期的内容。

当条目管理器被打开后，它会自动检测并列出所有元件和托管原理图（说明他们是否来源于工作区），然后对比原理图中每个工作区内容的条目修订和该内容在工作区上的可用版本。如果某个内容在工作区有一个更新的版本，它在条目管理器的修订状态列就会被标记为过期。

留意任意被检测为过期的元件或托管原理图，选择他们，然后单击右键进行更新。

更新内容

若要将过期内容更新为最新内容，必须先选中它，然后通过单击右键上下文菜单运行更新到最新版本命令。对话框中的新设置区域将会显示每一个新条目的详细信息。从ECO按钮菜单中选择“应用ECO”选项以生成变化列表并将新修订应用到元件的设计中，而不会弹出 ECO 对话框。

选择过期的内容，使用单击右键“更新到最新版本”命令将更新版本的明细加载到新设置区域。然后通过ECO将更新应用到设计的元件和托管原理图中。

条目管理器报表

在条目管理中进行元件更新或变更过程前，先使用对话框的导出功能生成当前所列出信息的快照会比较明智。若要达到这个目的，请在条目管理器的任何地方单击右键并从上下文菜单中选择导出，然后导航到适当的位置并根据需求命名报表。所生成的报表格式为HTML，显示时的布局与当前条目管理器相同。

从单击右键菜单中选择导出以便在条目管理器中生成报表。生成的报标格式为HTML，显示的是条目管理器完整清单的快照。