使用变量管理对话框

在“变量管理”对话框中创建和配置变量。要打开该对话框，请从“项目”菜单中选择“变量”（快捷方式：C、V），或在“项目”面板中右键单击项目名称，然后选择“变量”。

该对话框有两个主要区域：

• 上方的项目组件区域，其中列出了基础设计中的所有组件，如适用，则竖列显示已应用变量。

• 下方的组件参数区域，其中详细说明了上方区域中当前选定组件的所有参数，如果适用，则列出已应用变量。

在“变量管理”对话框中创建和配置变量。

创建新变量

单击“变量管理”对话框中的按钮以创建基础设计的新变量。将打开“编辑项目变量”对话框。

至少，在描述字段中输入变量的名称，默认情况下将包含 <ProjectName> 的条目变量。如果需要从设计中生成制造变量，请在编辑项目变量对话框中启用允许制造输出变量选项。如果需要为包含带有“未安装”组件的变量的设计生成粘贴掩模输出，请启用允许粘贴掩模变量选项。这些组件的焊盘上将不再包含粘贴掩模。

您还可以为变量定义参数。有关如何执行此操作以及变量级参数如何适应 Altium Designer 中的参数层次结构的详细信息，请参阅Working with Variant Parameters。

根据需要定义变量后，单击确定。然后，变量管理对话框右侧会出现一个附加列，新变量名称作为列标题。所有单元格均为空，空单元格表示此组件已安装且与基本设计相同。现在可以为新变量配置组件。下图显示了一个已创建两个变量（BGA 和 TSOP）的项目。

区域 1 详细说明基本设计中的组件，区域 2 详细说明 BGA 变量中的组件，区域 3 详细说明 TSOP 变量中的组件。

变量管理对话框包含许多界面功能，可帮助显示有用信息。这些功能可通过右键单击上下文菜单进行配置。

有用的命令包括：​​

• Columns:

  •  Hierarchy Path 列  - 显示组件在设计层次结构中的位置。

  • Original Library Link 列 - 详细说明基础组件的来源。

   

• Set Selected As - 用于选择变量类型的子菜单（已安装、未安装、替代）。可用于代替单击组件单元中的控件。仅在右键单击变量的组件单元时可用。

• Only Show Varied Parameters - 在变量管理对话框中仅显示应用了某种形式变量的组件。

• Filter - 子菜单，用于控制在变量管理对话框中显示哪些类型的变量（各种参数、未安装、替代）。与仅显示各种参数命令结合使用效果很好。

定义组件变量

一旦创建了变量本身，每个组件的状态就可以变化了。这可以通过单击变量列中的组件单元来显示控件，或者右键单击该单元并从“设置为选定项”上下文子菜单中选择所需的条目来完成。

控件将打开“编辑组件变量”对话框。

提供三个选项：

• Fitted – 基本设计中使用的原始组件也安装/用于该设计的此变量中。对于新添加的变量，所有组件默认已安装，并且这些已安装组件的单元为空。请注意，也可以为已安装的组件改变单个参数，只需在对话框的“组件参数”区域中为该变量输入新参数值即可。

• Not Fitted – 基础设计中使用的原始组件未安装/未用于该设计的此变量。对于“未安装”组件状态，单元格将显示“未安装”文本，对话框下方的“组件参数”区域将为空白。

• Alternate Part – 此选项允许选择不同的（备用）部件。对话框将展开以包含用于浏览和查找所需替换组件的控件。选择该部件后，单元格将显示备用部件的源链接。对话框下方的“组件参数”区域将显示备用部件中的所有参数。有关更多信息，请参阅下一节。

选择备用部件

选择“备用部件”选项后，“编辑组件变量”对话框将展开以显示现有部件的基础参数。使用按钮在替换组件对话框中浏览并找到所需的替代部件组件 - 组件面板的模式对话框版本。支持所有 Altium Designer 的组件存储模型，例如独立库、数据库库以及工作区库组件（如下例所示）。

替代部件变量的示例。

可以在设计空间中重新检查新应用的替代组件。在该组件的适用原理图中，切换到已编译的选项卡视图，然后在项目面板的项目变量部分中选择所需的变量。

原理图编辑器将使用替代组件的符号图形，但是，如果组件引脚兼容且图形相似，则可能几乎没有明显的变化。

您可以选择一个替代部件，而无需更改原理图上的符号或需要在PCB上添加封装。在“属性”面板中，根据需要启用“不覆盖原理图符号”和/或“不覆盖PCB封装”选项，如下图所示。所选替代部件的参数将在ActiveBOM中准确显示。

为了便于直观地识别不同的组件，不同参数（例如组件注释字符串）的颜色和字体也可以改变。这在“变量选项”对话框中配置。单击“变量管理”对话框中的“绘图样式”以打开对话框。请注意下面动画中用于替代组件的绿色斜体字体。

图形识别不同的组件；在此示例中，两个变量都使用相同的组件符号，但 BGA 变量使用不同大小的 SRAM。

符号显示模式

如果基础组件使用默认常规模式以外的图形显示模式，并且它在变量中还定义了替代组件，则替代组件将尝试使用相同的图形显示模式。相反，如果替代组件不包含此图形显示模式，则使用常规模式。

零件视图模式在原理图库编辑器中定义，并在属性面板的图形部分中为放置的组件选择，如下所示。在此示例中，基础零件符号使用模式，Alternate 1。

替代零件将尝试使用与基础零件相同的图形显示模式编号。

使用 DbLink 文件时的变量

Altium Designer 支持多种存储和使用组件的方式，包括在项目中使用 DBLink 文件。DBLink 文件是原理图上的组件与公司数据库之间的接口。

DBLink 模型并非仅仅创建从每个组件到特定数据库记录的引用（通常在您从 DBLib 类型的库中放置组件时这样做），而是依赖于设计人员根据一个或多个组件参数启动查询操作。然后，软件在数据库中搜索包含匹配值的字段的记录，当匹配发生时，该记录中的其他字段值（例如零件编号）可以返回到 Altium Designer 组件。组件参数到数据库字段的映射在 DBLink 文档中定义，目标数据库也是如此。

► 了解有关Database Libraries的更多信息

在未使用变量的设计中，查询操作是通过Update Parameters from Database命令执行的，也可以在 BOM 生成期间通过启用“从数据库包含参数”选项（见下文）来执行，以提取特定于 BOM 的组件数据，例如价格。

对于包含变量的设计，用于查询数据库的参数在“变量管理”对话框中有所不同。由于这些参数值仅存在于“变量管理”对话框中，因此不使用“从数据库更新参数”命令来检索数据库信息 - 而是在生成 BOM 时从数据库中提取参数。

变量管理对话框数据的显示

“变量管理”对话框包含帮助控制显示数据量的功能，这在处理大型设计时特别有用。

• 要删除不感兴趣的列，请右键单击对话框的上半部分，然后使用上下文菜单中的“列”选项切换任何列的可见性。

• 要仅显示正在变化的组件，请右键单击对话框的上半部分，然后从上下文菜单中选择“仅显示变化的组件”选项。

• 当选择“仅显示变化的组件”模式时，再次右键单击并配置过滤器选项。在下图中，过滤器已配置为仅显示使用备用零件的组件。

• 要更改列出的变量的顺序，请选择变量列标题并将其拖动到新位置。将其与“适合宽度”复选框结合使用，以定位和调整感兴趣的变量的大小。

“变量管理”对话框，其中的列被隐藏，并且应用了过滤器以仅显示使用备用部件的组件。

重置和更新变量数据

“变量管理”对话框中设置的设计变量最终保存在项目文件中。这包括“未适配”状态、适配组件的本地参数变量以及备用部件的参数值。实际的备用部件存储在 [ProjectName].PrjPcbVariants 文件中。“变量管理”对话框包括用于重置参数和更新组件的命令，这有助于确保它们与源组件库同步。

更新各种参数

在“变量管理”对话框中本地修改的参数可以通过右键单击“变量参数”列表中的已修改参数（以粗体显示）并从上下文菜单中选择“重置所选”来恢复到其原始值 - 如下所示。请注意，可以一次选择多个参数，然后在单个操作中重置，或使用“重置全部”重置该组件的所有参数。

可以使用“重置所选”命令恢复已修改的参数的值。

更新备用零件参数

如果用作备用零件的库组件在库中的参数已更改，那么您可以通过右键单击该变量的参数列表并从菜单中选择“从库更新值”将这些更改直接带入项目中的变量定义（如下所示）。请注意，这会更新参数，如果您需要更新图形，请使用下面描述的技术。

如果库中的备用零件组件已被修改，请使用“从库更新值”命令刷新项目中使用的副本。

执行“从库更新值”命令后，通过“浏览库”对话框浏览并找到源库中的组件，然后单击“确定”打开“从库更新项目变量”对话框。选择/取消选择“库中的参数组件”和“要更新的变量”，然后单击“确定”完成更新过程。

从源库更新变量组件。在这里，您可以配置要更新哪些参数，以及将更新应用于哪个变量。

所有参数都列在从库更新项目变量对话框的左侧 - 如果需要，可以取消选择任何参数以将其排除在更新过程之外。在对话框的右侧，可以更改目标项目变量（要更新的项目变量）。这将默认选择激活“从库更新值”命令时选择的变量。

完全更新备用部件

如果备用部件的源组件已在其库中编辑，则可以通过运行“从库更新”对话框在设计中更新它。

从原理图编辑器中的“工具”菜单启动，该对话框包含一个“包括变量”选项。启用此选项后，组件列表将展开以包含任何已用作备用部件的组件。选中列表中要更新的组件，然后完成向导以从源更新所需的部件。

要完全更新备用部件（包括其图形），请启用“包括变量”复选框并启用要更新的部件。

更改多个组件的多个参数

变量管理对话框支持多选，这意味着可以在对话框的上部（组件）部分同时选择任意数量的组件，然后在对话框的下部（参数）部分对任意数量的选定参数执行更新。该对话框还提供过滤器（通过右键单击上下文菜单），以进一步优化选择和显示的数据。

例如，要重置所有变量中所有组件的手动更改参数：

1. 在对话框的上部（组件）部分，使用仅显示各种组件的右键单击菜单选项与右键单击过滤器选项结合使用，以仅显示具有各种参数的组件。组件列表现在应该只显示那些具有手动更改参数的组件。

2. 右键单击组件列表并从上下文菜单中选择“全选”。将选择对话框上部当前显示的所有组件。

3. 然后右键单击对话框下部（参数）并从上下文菜单中选择“全选”。现在将选择所有组件的所有参数。请注意，可以选择“选择列”命令，这将允许将操作（例如重置）应用于特定变量（列）中的组件。

4. 再次右键单击参数列表并从上下文菜单中选择“重置所选”。将光标悬停在下图上以显示步骤 2、3 和 4。

重置所有变量中所有组件的所有手动更改的参数。将光标悬停在图像上以显示步骤 2、3 和 4。

使用变量参数

Altium Designer 支持项目各个级别的参数。例如，可以在原理图编辑器属性面板的“参数”选项卡中将文档级参数添加到每个原理图工作表（未选择任何内容时可用）。还可以在Project Options的“参数”选项卡中将项目级参数添加到项目中（项目»选项）。

此外，还可以通过Edit Project Variant对话框将参数添加到变量中。在“变量管理”对话框中，选择变量列并单击“编辑变量”按钮以打开此对话框。要添加新参数，请单击“添加”按钮。使用打开的“参数属性”对话框输入名称并设置新参数的值，然后单击“确定”。新参数现在显示在“编辑项目变量”对话框中。

在下图中，已为项目以及每个变量定义了一个名为 ProjectTitle 的参数。动画显示了 PCB 上的行为，因为变量选择器用于显示基础设计，然后是每个变量。

添加到项目中的 ProjectTitle 参数（通过“项目选项”对话框）也已添加到每个设计变量中，但每种情况下的值都不同。

特殊字符串 .ProjectTitle 已放置在 PCB 覆盖层上，它会自动链接到同名的项目和变量参数。

生成变量报告

单击“变量管理”对话框底部的“详细报告”按钮可访问“变量报告”对话框，允许您配置和生成已定义项目变量的详细 HTML 格式报告。

变量报告对话框

变量错误

变量设置存储在项目文件 (*.PrjPcb) 中，打开该对话框时，会读取、分析这些数据并将其加载到“变量管理”对话框中。如果在数据加载时检测到问题，例如元件标识符或元件 UID 之间不匹配，则会打开一个信息对话框来概述问题。

在继续设计过程之前，请先解决标识符和 UID 不匹配问题。

元件 UID 不匹配问题会自动解决，保存项目时会保留这些更正。必须在原理图级别更正重复的标识符。要解决这些问题，请验证项目（项目 » 验证 <项目名称>）并检查消息面板以获取警告/错误详细信息。