使用变量管理器

变量管理器是一个基于文档的用户界面，允许您查看、创建和管理 PCB 设计项目的设计变量。要访问变量管理器，请右键单击“项目”面板中的项目条目，然后选择“变量”，或从原理图或 PCB 编辑器的主菜单中选择“项目 »变量”。

使用变量 Copy Link Copied

创建新变量

要添加新变量，请在“变量”选项卡处于活动状态时使用位于变量管理器左上角的“添加变量”按钮。网格区域中将出现一个具有默认标题的附加变量列，如下图所示。新列的所有单元格将为空，其中空单元格表示此组件已安装且与基础设计没有变化。

默认情况下，将添加一个新变量，其中所有组件均已安装。

您可以使用变量过滤器对话框过滤在变量管理器中显示的变量，单击右上角即可访问该对话框。要过滤显示的变量，请启用与要显示的变量相关联的复选框。在对话框中单击确定后，将根据启用的复选框过滤变量。应用过滤器后，过滤器按钮显示为 。要删除或更改过滤，请单击过滤器按钮重新打开“变量过滤器”对话框，然后更新复选框。启用“项目变量”复选框后，将显示项目中的所有变量。

配置变量属性

要更改变量选项，请使用“变量”模式下的“属性”面板，可通过右键单击所需变量的列标题并选择“属性”来访问该面板。

在变量模式下访问“属性”面板以更改变量的选项。

• 使用“名称”字段为变量定义一个有意义的名称。

  还可以使用“重命名变量”对话框更改变量的名称，可通过单击变量列标题将其选中，然后单击变量管理器的左上角或右键单击变量列标题，然后选择“重命名变量”来访问该对话框。

• 如果需要从设计中生成制造变量，请启用“允许制造输出变量”选项。如果输出作业具有指定用于制造输出的变量，并且该变量未启用该选项，则作业的变量名称将以红色显示。请注意，红色变量名称只是一个警告标志，仍将生成特定于变量的输出文件。

  如果需要为包含带有“未安装”组件的变量的设计生成粘贴掩模输出，请启用“允许粘贴掩模变量”选项。这些组件的焊盘上将不再包含粘贴掩模。

  有关如何向输出作业文件添加和查看变量的信息，请访问 Preparing Manufacturing Data with Output Jobs 页面。

• 使用面板的变量参数区域来定义变量级参数列表。

  可以通过放置特殊字符串在原理图或 PCB 文档中显示变量参数。了解有关Special Strings on a Schematic 和 Special Strings on a PCB 的更多信息。

  Altium Designer 支持项目各个级别的参数：项目、原理图文档和变量。项目各个层级所包含的参数都存在于层次结构中，这意味着您实际上可以在项目的不同层级创建具有相同名称的参数，每个参数的值都不同。Altium Designer 使用优先级以以下方式解决这种情况：

  1. 变量（最高优先级）

  2. 原理图文档

  3. 项目

  这种安排意味着原理图文档中定义的参数值将覆盖项目选项中定义的值，而变量中定义的参数值将覆盖原理图文档中定义的值。请注意，原理图级参数在 PCB 或 BOM 中不可用 - 对于这些类型的输出，应使用项目或变量参数。

变量的属性

右键单击单元格，然后选择“属性”以打开“属性”面板，其中显示所选组件/组的详细信息。可以根据需要编辑变量的组件参数。

还可以通过选择网格中的组件，然后展开网格底部的参数区域来查看和编辑参数。

定义组件变量

基础设计中的每个组件都可以配置为：

• 已安装 - 创建新变量时的默认设置。

• 未安装 - 基础设计中使用的原始组件未安装/未用于该设计的此变量。

• 已安装，并修改了组件参数，例如组件的值。

• 备用零件 - 用另一个组件完全替换一个组件。

可以通过单击变量列中的组件单元并访问提供三个选项的单元下拉列表来更改设计变量中组件的状态：

• (Fitted) - 基本设计中使用的原始组件也安装/用于该设计的此变量中。请注意，已安装组件的各个参数也可以改变—— 见下文。

• Not Fitted – 基本设计中使用的原始组件未安装/用于该设计的此变量中。

• Alternate Part – 此选项允许选择不同的（备用）部件。使用替换对话框（组件面板的模态对话框版本）选择所需的备用部件。选择该部件后，单元将显示备用部件的 ID。

  选择备用部件后，软件将检查所选备用组件与原始基本设计组件之间的引脚兼容性。要实现引脚兼容，备用部件必须具有与原始组件相同的引脚数，并且这些引脚的位置和电气类型必须相同。两个元件符号中使用的图形基元无需匹配。如果软件检测到替代元件引脚不兼容，则必须关闭“确认”对话框，然后才能接受替换。在这种情况下，您需要注意对布线的潜在影响。

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

使用所需变量列单元格中的下拉菜单定义元件变量。选择“替代部件”选项时，使用“替换”对话框选择替代部件。

通过在“属性”面板中输入新参数值，可以更改适合或替代元件的各个参数。单击所需变量列中组件的单元格，并使用其变量模式的组件中属性面板的组件参数区域中所选变量的列输入不同的参数值。对于封装参数，如果为组件分配了多个封装模型，请单击单元格下拉菜单以选择封装。与基本设计不同的参数值将显示为黄色，网格区域中的组件单元格将显示组件名称。

定义已安装组件的替代参数的示例。输入新参数值，如图所示。定义新参数值后，将光标悬停在图像上以查看组件单元格。

更新备用零件参数

如果用作备用零件的库组件在库中的参数已更改，则可以将这些更改直接带入项目中的变量定义中。在主网格区域中选择所需的备用组件后，从变量管理器底部的参数区域或属性面板的组件参数区域的右键单击菜单中选择“从库更新值”命令，以将所做的任何参数更改带到库组件中。

在变量管理器中访问“从库更新值”命令。此处显示的是选择所需组件条目后从参数区域的右键菜单访问。将光标悬停在图像上，可查看选择备用零件条目后从属性面板访问。

通过替换对话框浏览并找到源库中的组件，然后单击确定以打开“从库更新项目变量”对话框。所有参数都列在“从库更新项目变量”对话框的左侧 - 如果需要，可以取消选择任何参数以将其排除在更新过程之外。在对话框的右侧，可以更改目标项目变量（要更新的项目变量）。这将默认选择激活“从库更新值”命令时选择的变量。单击确定以完成更新过程。

复制变量

您可以使用“制作副本”命令复制变量。右键单击变量名称列的标题，然后选择“制作副本”选项。将添加一个具有相同数据和名称（附加“复制”）的新列。您可以使用重命名选项为新列命名合适的标题。

删除变量

要删除变量，请选择标题，然后使用图标。右键单击上下文菜单还包含删除此或所有变量的功能，如下所示。删除前会打开一个对话框供确认。

使用组 Copy Link Copied

为了方便管理大量设计变量，变量管理器还允许您从所选原理图图纸、所选图纸符号引用的图纸或所选组件类创建组件组，并提供基于功能的组件变量视图。对于每个组，您可以定义一个或多个“选项”，这些选项基本上反映了组中一个或多个组件的某种变化。然后可以基于这些定义的组和选项创建变量，并支持创建变量层次结构。当需要更改时，编辑组选项中的值会立即反映在使用该组选项的所有变量中。

使用组的工作流程如下：

1. 使用变量管理器顶部的控件切换到“组”选项卡。

2. 使用“添加组”按钮的下拉菜单，选择要为其创建组的原理图文档、图表符号或组件类。

   
   添加一个组以便于基于此组进行进一步的变量管理。

3. 变量管理器左侧窗格中将列出一个新组，而右侧将列出所选组的组件。

   默认情况下，所选原理图图表、图表符号或组件类的名称将分配给新创建的组。使用组列表区域底部的“重命名”按钮根据需要重命名组。

   使用“添加选项”按钮为当前选定的组添加选项。网格区域中将出现一个具有默认标题的附加选项列。新列的所有单元格都将为空，其中空单元格表示此组件已安装并且与基础设计相同。

   
   为所选组添加一个选项，如图所示。将光标悬停在图像上以查看默认选项列。

4. 通过更改默认名称为新创建的选项分配一个有意义的名称。单击选项的列标题以选择它，然后单击网格区域底部的重命名按钮，或右键单击标题并选择重命名以访问对话框以输入新名称。

   
   为选项设置一个有意义的名称。

5. 使用所需选项列中的组件单元格，配置组件变量。该过程与为变量定义组件变量时相同。

   
   为所选选项配置组件变量。

   不建议手动更改组件参数。此外，强烈建议使用备用组件。要使用备用封装，请在使用组时使用单独的组件。

   可以使用右键单击上下文菜单中的相应命令或使用适当的快捷键（分别为 Ctrl+C、Ctrl+V、Ctrl+X）复制、粘贴或剪切变量组选项的单元格内容。

6. 通过在网格区域中右键单击并选择添加选项，为所选组添加更多选项。根据需要配置新选项。

   
   根据需要添加和配置更多选项。

7. 在变量管理器的变量选项卡中，已创建组的组件将显示在网格区域中的相应条目下。使用组条目单元格的下拉菜单，在组选项卡上选择为此组创建的选项。将应用为此组中的组件配置的变量。

   
   为所选组添加一个选项，如图所示。将光标悬停在图像上以查看默认选项列。

复制组选项

要复制变量组的选项，请在“组”选项卡上右键单击 <新选项> 列标题，然后选择“制作副本”。将添加一个具有相同数据和名称的新列（附加“复制”）。您可以使用“重命名”选项为新列命名合适的标题。

注意 Copy Link Copied

• 配置变量时，设置将保存在项目文件中。这包括未安装状态、安装组件的局部参数变化以及备用零件的参数值。备用零件存储在文件 <ProjectName>.PrjPcbVariants 中。

• 可以固定变量列以首先显示它们，位于未固定列的左侧。要固定变量列，请将光标悬停在其标题上并单击。

• 双击组件或右键单击，然后选择“交叉探测”选项以跳转到原理图上的该组件。

• 使用“变量”选项卡或“参数”区域的网格区域右键菜单中的“全选”命令快速选择所有网格内容。

• 使用“变量”选项卡或“参数”区域的网格区域右键菜单中的“反选”命令快速选择未选条目并取消选择已选条目。

• 单击“变量管理器”左下角的“查看报告”按钮，使用打开的“变量报告”对话框生成 HTML 格式的详细变量报告。

• 右键单击“变量”选项卡或“参数”区域的网格区域，然后使用上下文菜单的以下命令生成报告文件：

  • 单击打开“报告预览”对话框以创建网格的打印输出。

  • Save All – 单击打开对话框，将所选组件的所有组件/所有参数的列表保存为制表符格式的文本文件 (*.txt)。

  • Save Selected – 单击打开对话框，将所选组件/所选参数的列表保存为制表符格式的文本文件 (*.txt)。

   

• 当原理图发生更改时，变量管理器顶部会显示相应的通知。单击通知旁边的刷新控件以更新变量管理器中的数据。

• 右键单击单元格时找到的删除选项可用于删除变量、组或选项。