知识库:将本地项目元件替换为工作区或服务器托管元件
Updated: 十月 23, 2026
将现有本地项目迁移到 Altium 365 工作区或 Altium 本地部署企业服务器后,原理图元件可能仍引用非托管的本地库元件。如果本地元件与托管元件之间存在共同参数,可以使用 Item Manager 的自动匹配功能,将这些元件替换为工作区或服务器中的托管元件。如果没有合适的匹配参数,则可以使用“查找相似对象”功能分组替换元件。完成替换后,可以使用 Item Manager 识别并核查所有剩余的非托管元件。
解决方案详情
现有元件仍使用本地引用
将项目及其库迁移到 Altium 365 工作区或 Altium Enterprise Server 后,已放置在原理图设计中的元件可能仍引用非托管的本地库元件,而不是工作区或服务器中的托管元件。
迁移会导入库,但会保留元件链接
将本地库导入工作区或服务器会创建托管元件,但现有原理图元件不会自动重新链接到这些托管条目。元件关联必须单独更新。
选择适当的替换方法
- 当本地元件与托管元件具有共同参数时,使用 Item Manager Auto Match。
- 常用的匹配参数包括制造商料号、内部料号,或两个元件都具有的其他唯一标识符。
- 应用更新前,请检查所有建议的匹配结果,尤其是在匹配参数不唯一的情况下。
- 如果没有合适的匹配参数,请使用 Find Similar Objects 成组替换元件。
- 请在已备份的项目中或在源代码版本控制下执行替换操作,以便在必要时撤销更改。
将本地元件替换为托管元件
- 使用库导入器将现有本地库元件迁移到工作区或服务器。
- 打开 Tools » Item Manager。
- 创建匹配规则,将本地元件参数映射到相应的托管元件参数。
- 单击 Auto Match。
- 检查建议的元件匹配结果。
- 应用更新,将本地元件替换为工作区或服务器中的托管元件。
如果没有匹配参数,请按以下步骤操作:
- 在原理图中选择其中一个元件。
- 右键单击并选择 Find Similar Objects。
- 将 Design Item ID 设置为 Same。
- 启用 Select Matching。
- 将范围从 Current Documents 更改为 Project Documents。
- 启用 Open Properties。
- 单击 Apply,然后单击 OK。
- 确认所有原理图图纸中具有相同设计条目 ID 的元件均已选中。
- 在 Properties 面板中,单击 Design Item ID 旁边的 ... 按钮。
- 搜索用于替换所选元件的托管元件。
- 应用替换并确认更改。
- 根据需要,对其他元件组重复此操作。
- 编译项目并检查工程变更单(ECO)结果,确认元件链接已正确更新,且未发生意外的设计更改。
- 打开 Tools » Item Manager。
- 检查 Unmanaged 部分,找出尚未匹配或替换的本地元件。
- 根据需要重复替换过程,直到所有目标元件均已纳入托管。
补充说明
条目管理器提供可配置的自动匹配功能,尝试将每个本地设计元件与已连接工作区中的元件进行匹配。找到匹配项后,系统会建议使用相应的工作区元件进行更新。