使用变量管理器

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

使用变量

创建新变量

要添加新变量，请使用 Add Variant 按钮。 Variant Manager按钮。 Variants按钮。如下图所示，网格区域将出现一个带有默认标题的附加变量列。新列的所有单元格都将是空的，其中空单元格表示该组件是 "拟合 "的，与基本设计保持一致。

添加新变量时，默认情况下所有组件都是 "装配 "的。

您可以使用对话框过滤变量管理器中显示的变量。 Variants Filter对话框过滤显示在变量管理器中的变量，单击右上角的 即可进入该对话框。要过滤显示的变量，请启用与希望显示的变量相关的复选框。单击对话框中的确定后，将根据启用的复选框过滤变量。应用筛选时，筛选按钮显示为 。要删除或更改筛选，请单击筛选按钮重新打开 "变量筛选 "对话框，然后更新复选框。当 Project Variants 复选框启用时，将显示项目中的所有变量。

配置变量属性

要更改变量选项，请使用 Properties面板的 Variant模式下使用面板，右键单击所需变量的列标题并选择 Properties.

访问 Properties面板 Variant模式下访问面板，更改变量的选项。

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

  也可以使用 Rename Variant 对话框更改名称，方法是单击变量列标题将其选中，然后单击对话框左上角的 。 Variant Manager或右键单击变量列标题，然后选择 Rename Variant.

• 您可以使用以下选项选择是否需要更改备用零件在原理图上的符号或将其基底面添加到 PCB 上：

  • Do not overwrite schematic symbol- 启用后，在变量中选择了替代零件的元件将使用非变量符号。

    请注意，该选项仅影响原理图工作表上的符号表示。在建立设计连接性模型时会考虑备用零件符号。因此，即使启用了该选项，基本元件和备用元件也需要引脚兼容。有关引脚兼容的更多信息，请参阅 "定义组件变化"部分。

  • Do not overwrite PCB footprint- 启用该选项后，在变量中选择了替代零件的组件将使用非变量基底面。应用于变量的替代零件的基底面不会作为 PCB 更新的一部分转移到 PCB 上（不会生成将基底面添加到 PCB 的 ECO）。

  无论是否启用这两个参数，所选替代零件的参数都会如实显示在 ActiveBOM 中。

• 如果需要从设计中生成制造变量，请启用 Allow variation of fabrication outputs选项。如果一个输出任务有一个指定用于制造输出的变量，而该变量确实启用了 not选项，则作业的变量名称将显示为红色。请注意，红色变量名称只是一个警告标志，特定变量的输出文件仍会生成。

  如果需要为包含有 "未装配 "组件的变量的设计生成粘贴掩模输出，请启用 Allow variation for paste mask选项。这些元件的焊盘上将不再包含粘贴掩膜。

  有关如何在输出任务文件中添加和查看变量的信息，请访问 "使用输出任务准备制造数据"页面。

• 使用 Variant's Parameters区域来定义变量级参数列表。

  通过放置特殊字符串，可在原理图或 PCB 文档中显示变量参数。进一步了解原理图上的特殊字符串和PCB 上的特殊字符串。

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

  1. 变量（最高优先级）
  2. 示意图文件
  3. 项目

  这种安排意味着在原理图文档中定义的参数值优先于在项目选项中定义的值，而在变量中定义的参数值优先于在原理图文档中定义的值。

变量属性

右键单击单元格，然后选择 Properties 打开 Properties 面板，显示所选变量的详细信息。 Component/Group.可根据需要编辑 Component Parameters可根据需要编辑变量的内容。

也可以通过在网格中选择一个组件，然后展开网格底部出现的 Parameter 区域。

定义组件变量

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

• Fitted- 创建新变量时的默认设置。
• Not Fitted- 在基本设计中使用的原始组件不在该设计的变量中安装/使用。
• 装配时修改了组件参数，如组件值。
• Alternate Part- 用一个组件完全替换另一个组件。

要更改设计变量中某个组件的状态，可以单击变量列中的组件单元格，然后访问提供三种选择的单元格下拉菜单：

• (Fitted) - 在基本设计中使用的原始组件也在该设计的变量中安装/使用。请注意，也可以更改拟合组件的单个参数，详见下文。

• Not Fitted- 基本设计中使用的原始部件在该设计的变量中没有装配/使用。

• Alternate Part- 该选项允许选择不同的（备用）部件。使用 Replace对话框（这是一个模式对话框版本的 Components面板的模式对话框）选择所需的备用零件。一旦选择了该零件，单元格就会显示备用零件的 ID。

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

您可以选择一个替代部件，而无需更改原理图上的符号或在 PCB 上添加基底面。在 Properties 面板中，启用 Do not overwrite schematic symbol 和/或 Do not overwrite PCB footprint选项。启用后者后，作为 PCB 更新的一部分，应用于变量的替代部件的基底面将不会转移到 PCB 上（不会生成将基底面添加到 PCB 上的 ECO）。所选替代元件的参数将如实显示在 ActiveBOM 中。

在网格中单击右键，选择 Set Selected As然后从相关菜单中选择所需的状态，如下图所示。

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

通过在面板中输入新的参数值，可以更改拟合或替代部件的单个参数。 Properties面板中输入新的参数值。单击所需变量列中的部件单元格，并使用所选变量列中的 Component Parameters区域的 Properties面板的 Component for variant模式下，使用面板区域中的所选变量列键入不同的参数值。对于足迹参数，如果为组件分配了多个足迹模型，则单击单元格下拉菜单选择足迹。与基本设计不同的参数值将显示为黄色，网格区域中的组件单元格将显示组件名称。

定义拟合组件替代参数的示例。如图所示，输入一个新的参数值。将光标悬停在图片上，即可看到定义新参数值后的组件单元格。

更新替代部件参数

如果作为替代零件使用的库组件在库中的参数发生了变化，那么可以将这些变化直接引入到项目中的变量定义中。从 Update Values from Library命令。 Parameter区域的右键菜单中选择该命令。 Variant Manager或 Component Parameters区域的 Properties在主网格区域选择所需的备用组件时，从该区域底部或面板区域的右键菜单中选择该命令，即可对库组件进行任何参数更改。

访问 Update Values from Library命令。 Variant Manager.这里显示的是当所需的组件条目被选中时，通过右键单击 Parameter区域的右键菜单。将光标悬停在图片上可查看 Properties面板访问。

在源代码库中通过 Replace对话框浏览并找到源代码库中的组件，然后单击 OK打开 Update Project Variants From Library对话框。对话框左侧列出了所有参数。 Update Project Variants From Library对话框左侧列出了所有参数--如果需要，可以取消选择任何参数，将其排除在更新过程之外。在对话框右侧，可以更改目标项目变量 (Project Variant To Update).这将默认为选择激活该命令时所选择的变量。 Update Values from Library命令激活时所选择的变量。单击 OK完成更新过程。

复制变量

您可以使用 Make a copy 命令复制一个变量。右键单击变量名称列的标题，然后选择 Make a copy 选项。就会添加一个数据和名称相同的新列（以"Copy"）。您可以使用 Rename选项为新列命名一个合适的标题。

删除变量

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

使用组

为便于管理大量的设计变量，您还可以使用 Variant Manager还允许您从所选原理图工作表、所选工作表符号引用的工作表或所选元件类别中创建元件组，并以功能为基础查看元件变化。您可以为每个组定义一个或多个 "选项"，这些选项基本上反映了该组中一个或多个组件的某些变化。然后，可以根据这些已定义的组和选项创建变量，并支持创建变量的层次结构。当需要更改时，编辑组选项中的值会立即反映到使用该组选项的所有变量中。

使用组的工作流程如下：

1. 切换到 Groups选项卡。 Variant Manager.

2. 使用 Add Group按钮的下拉菜单，选择要创建组的原理图文档、工作表符号或组件类别。

   
   添加一个组，以便在该组的基础上进一步进行变量管理。

3. 新的组将列在"...... "按钮的左侧窗格中。 Variant Manager的左侧窗格中列出新组，而右侧则列出所选组的组件。

   默认情况下，所选原理图工作表、工作表符号或元件类别的名称将分配给新创建的组。使用 Rename按钮，根据需要重新命名组。

   使用 Add Option按钮为当前选定的组添加一个选项。网格区域会出现一个带有默认标题的附加选项列。新列中的所有单元格都将为空，空单元格表示该组件是 "拟合 "的，与基本设计保持一致。

   
   如图所示，为选定的组添加一个选项。将光标移动到图片上可查看默认选项列。

4. 通过更改默认名称为新创建的选项指定一个有意义的名称。单击选项的列标题将其选中，然后单击网格区域底部的 Rename按钮，或右键单击标题并选择 Rename进入对话框输入新名称。

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

5. 使用所需选项列中的组件单元格配置组件变化。操作步骤与为变量定义组件变量相同。

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

   不建议手动更改组件参数。此外，强烈建议使用备用组件。要使用备用脚印，在处理组时应使用单独的组件。
   变量组选项的单元格内容可以通过右键上下文菜单中的相应命令复制、粘贴或剪切，也可 以使用相应的快捷键（.Ctrl+C, Ctrl+V, Ctrl+X分别为 ）。

6. 右键单击网格区域并选择 Add Option.根据需要配置新选项。

   
   根据需要添加和配置其他选项。

7. 在 Variants选项卡中 Variant Manager的选项卡中，为其创建组的组件将显示在网格区域的相应条目下。使用组条目单元格的下拉菜单，选择为该组创建的选项。 Groups选项卡。为该组元件配置的变量将被应用。

   
   如图所示，为所选组添加一个选项。将光标移动到图片上可查看默认选项列。

复制组选项

要复制一个变量组的选项，请在 Groups 选项卡上，右键单击 列标题，然后选择 Make a copy.将新增一列，其数据和名称相同（后缀为"......"）。Copy"）。您可以使用 Rename选项为新列命名一个合适的标题。

备注

• 配置变量时，设置会保存在项目文件中。这包括 Not Fitted状态、某个 Fitted 的参数值。 Alternate Parts.备选部件保存在文件 .PrjPcbVariants.
• 变量列可以固定在未固定列的左侧，以便首先显示。要固定变量列，请将光标悬停在其标题上，然后单击 。
• 双击组件或右键单击，然后选择 Cross Probe选项跳转到原理图上的该组件。
• 使用 Select All命令。 Variants选项卡或 Parameter 区域的网格区域右键菜单中的命令，快速选择所有网格内容。
• 使用 Invert Selection命令。 Variants选项卡或 Parameter 区域的网格区域右键菜单中的命令，快速选择非选定项和取消选定项。
• 点击 View Report按钮 Variant Manager以生成 HTML 格式的详细变量报告。 Variants Report对话框生成 HTML 格式的详细变量报告。
• 右键单击 Variants选项卡或 Parameter 区域的网格区域中单击右键，然后使用上下文菜单中的以下命令生成报告文件：
  • Report- 单击打开 Report Preview对话框创建网格打印输出。
  • Save All- 单击打开对话框，将所选组件的所有组件/所有参数列表保存到制表符格式的文本文件 (*.txt).
  • Save Selected- 单击打开对话框，将选定组件/选定参数的列表保存为制表符格式的文本文件（ ）。*.txt).
• 更改示意图时，将在"...... "顶部显示相应的通知。 Variant Manager.点击 Refresh控制按钮，以更新.NET 图表中的数据。 Variant Manager.
• 右键单击单元格时找到的 Delete选项可用于删除变量、组或选项。