知识库：参数名称不匹配时，替换元件后参数不再显示

替换后可见参数信息缺失

通过 Item Manager 将本地原理图元件替换为受管元件后，数值、电压和容差等参数可能不再显示在原理图编辑器中。在受影响的设计中，替换完成后只有元件位号仍然可见。

参数名称不匹配导致数据被移除

当原理图元件使用的参数名称与受管元件中定义的参数名称不匹配时，就会出现此问题。在替换过程中，Item Manager 会评估参数匹配规则，并可能使用受管源中的数据更新或覆盖元件参数。目标受管元件中没有同名匹配项的原理图参数可能会被移除，导致参数不再可见。

替换前统一参数名称

• 运行 Item Manager 之前，重命名原理图参数，使其与受管元件的参数名称一致。
• 使用 Parameter Manager 直接重命名参数。
• 使用 Find Similar Objects 在整个项目中更新参数。
• 如果在迁移过程中更改了参数名称，请更新受管元件模板，使其与原始命名约定一致。
• 执行元件替换之前，请检查 Item Manager 中的参数匹配和更新行为。

更新参数并替换元件

迁移前核实参数命名。

1. 将本地库元件迁移到服务器或工作区时，确保参数名称保持一致。
2. 除非已定义映射策略，否则请勿在迁移过程中重命名参数。

场景 1：简单的参数名称差异

示例：原理图使用 VALUE_TXT，而受管元件使用 Value。

1. 打开原理图图纸。
2. 选择 Tools » Parameter Manager。
3. 比较原理图和受管元件中使用的参数名称。
4. 选择 VALUE_TXT 列，右键单击列标题，然后选择 Rename Column。
5. 将该列重命名为 Value。
6. 应用更改并执行 ECO。
7. 打开 Tools » Item Manager。
8. 运行 Automatch，检查建议的参数映射，接受更改并执行 ECO。

场景 2：多个参数映射到同一个受管参数

1. 确定需要映射到同一个受管元件参数的原理图参数。
2. 使用 Parameter Manager 将这些参数重命名为一致的名称。
3. 替换元件之前核实映射。
4. 使用 Item Manager 替换元件。

场景 3：受管元件包含额外参数

1. 在原理图中选择一个参数值（例如 10VAC）。
2. 右键单击并选择 Find Similar Objects。
3. 将参数值匹配条件设置为 Same。
4. 启用 Select Matching 并选择 Project Documents。
5. 依次选择 Apply、OK 和 Select。
6. 打开 Properties Panel。
7. 将该参数重命名为 AC Voltage。
8. 对需要更改为 DC Voltage 的参数重复此过程。
9. 利用 Find Similar Objects 在整个项目中选中的对象，更新所有匹配的元件。
10. 使用 Item Manager 替换元件。

场景 4：重命名受管元件模板中的参数

1. 记录原理图中当前显示的所有可见参数名称。
2. 创建数据库库参数名称与受管元件参数名称之间的映射列表。
3. 打开 Panels » Explorer » Managed Content » Component Templates。
4. 打开适用的元件模板。
5. 重命名模板参数，使其符合数据库库的命名约定。
6. 启用 Update linked components，然后将模板保存到服务器。
7. 在批量编辑器中核实参数更新并保存更改。
8. 确认关联元件已更新，因为重命名模板参数可能不会自动更新现有元件。
9. 如果生命周期状态不同，请在发布时启用 Preserve lifecycle state。
10. 统一参数名称后，使用 Item Manager 替换元件。

最终核验检查点

替换 ECO 完成后，核实数值、电压和容差等所有预期参数在原理图中均可见且显示正确。

补充说明

• 此方法可能会影响 Altium 示例项目中的参数可见性。
• 为了便于更新，请尽可能确保元件处于草稿生命周期状态。

参考资料

• 条目管理器文档
• 参数管理器文档
• 查找相似对象工具