知识库：由 HRID 生成失败导致的元件发布和创建错误

解决方案详情

创建或发布元器件时出现 HRID 错误

在创建或发布元器件时，Altium 会显示以下错误：

Failed to generate HRID for content type=altium-component folder=BBXXXXXX naming scheme=$CONTENT_TYPE_CODE-000-{0000}.

该错误会导致无法在工作区中正确创建新元器件或进行同步。

模板与文件夹命名方案冲突

Altium 使用命名方案来生成唯一的 HRID。虽然文件夹级命名方案通常定义 HRID 格式，但从模板创建的元器件会继承模板中配置的命名方案。如果禁用 Allow override，则会忽略文件夹级命名方案，并可能应用冲突或过时的规则。

此外，像 {0000} 这样的数字模式可用 ID 数量有限。一旦该范围耗尽，Altium 将无法生成更多 HRID。

所需的配置更改

• 更新元器件模板中的 HRID 命名方案。
• 将数字块从 {0000} 增加到 {00000}。
• 在模板中启用 Allow override。
• 验证目标文件夹的命名方案。
• 在批量更新和同步期间启用 Preserve lifecycle state。
• 检查同步映射，并在需要保留生命周期时使用 Item 映射。
• 对所有相关模板应用一致的配置更改。

更新模板设置并验证 HRID 生成

1. Open the Component Template

   1. 导航到 Tools » Data Management » Component Templates。
   2. 打开用于受影响元器件类型的模板。

2. Update the Naming Scheme

   1. 找到 Component Naming Scheme 字段。
   2. 将命名方案更新为与工作区标准一致。
   3. 将数字块从 {0000} 更改为 {00000}。
   4. 保存模板。

3. Enable Allow Override

   1. 打开模板的 Component Options。
   2. 启用 Allow override。
   3. 保存更改。

4. Verify the Folder Naming Scheme

   1. 打开目标元器件文件夹。
   2. 检查已配置的 Item Naming Scheme。
   3. 确认该格式符合预期的 HRID 标准，并提供足够的编号容量。
   4. 如有必要，请更新文件夹命名方案。

5. Apply Changes to Related Templates

   1. 对所有使用相同 HRID 逻辑的模板重复执行命名方案和覆盖设置更新。
   2. 验证所有元器件模板之间的一致性。

6. Preserve Lifecycle State During Synchronization

   1. 打开 Batch Component Editor。
   2. 启用 Preserve lifecycle state。
   3. 如果使用 PLM 同步，请检查参数映射，并在需要保留生命周期状态时使用 Item 映射。
   4. 继续执行同步或发布。

7. Validate the Resolution

   1. 创建一个新元器件并确认 HRID 生成成功。
   2. 同步现有元器件，并验证命名和生命周期设置已保留。
   3. 确认新创建的元器件根据预期命名方案获得 HRID。

附加说明

• 当命名方案容量耗尽，或模板与文件夹之间存在冲突的命名规则时，通常会发生 HRID 失败。
• 将数字块扩展到 {00000} 可显著增加可用的 HRID 范围。使用本地缓存模板的用户可能需要刷新或重新下载已更新的模板。
• 如果在更新命名方案后问题仍然存在，请验证所请求的 Item ID 未被现有项目或先前已放弃的项目预留。

参考资料

• 知识库：因命名方案限制导致的 HRID 生成错误的解决方法
• 知识库：新发布项目的重复 Item HRID 错误
• 知识库：在元器件同步期间保留生命周期状态
• 元器件模板