KB: Lỗi phát hành và tạo linh kiện do lỗi tạo HRID
Updated: September 08, 2026
Người dùng có thể gặp lỗi khi tạo hoặc phát hành linh kiện nếu Altium không thể tạo Hierarchical Revision ID (HRID) hợp lệ. Trường hợp này thường xảy ra khi mẫu linh kiện áp dụng quy tắc đặt tên xung đột với quy tắc đặt tên ở cấp thư mục, hoặc khi dải HRID khả dụng bị dùng hết do mẫu đánh số quá giới hạn. Việc cập nhật quy tắc đặt tên của mẫu, bật hành vi ghi đè, kiểm tra cài đặt đặt tên của thư mục, mở rộng dải số và giữ nguyên các trạng thái vòng đời trong quá trình đồng bộ sẽ khắc phục sự cố và giúp ngăn ngừa các lỗi tạo HRID trong tương lai.
Chi tiết giải pháp
Tạo hoặc phát hành linh kiện thất bại do lỗi HRID
Khi tạo hoặc phát hành một linh kiện, Altium hiển thị lỗi sau:
Failed to generate HRID for content type=altium-component folder=BBXXXXXX naming scheme=$CONTENT_TYPE_CODE-000-{0000}.
Lỗi này ngăn không cho linh kiện mới được tạo hoặc đồng bộ chính xác trong workspace.
Xung đột giữa quy tắc đặt tên của mẫu và thư mục
Altium sử dụng các quy tắc đặt tên để tạo HRID duy nhất. Mặc dù quy tắc đặt tên ở cấp thư mục thường xác định định dạng HRID, các linh kiện được tạo từ mẫu sẽ kế thừa quy tắc đặt tên được cấu hình trong mẫu. Nếu Allow override bị tắt, quy tắc đặt tên ở cấp thư mục sẽ bị bỏ qua và các quy tắc xung đột hoặc lỗi thời có thể được áp dụng.
Ngoài ra, một mẫu số như {0000} chỉ cung cấp số lượng ID khả dụng giới hạn. Khi phạm vi đó bị dùng hết, Altium không thể tạo thêm HRID.
Các thay đổi cấu hình bắt buộc
- Cập nhật quy tắc đặt tên HRID trong mẫu linh kiện.
- Tăng khối số từ {0000} lên {00000}.
- Bật Allow override trong mẫu.
- Xác minh quy tắc đặt tên của thư mục đích.
- Bật Preserve lifecycle state trong quá trình cập nhật hàng loạt và đồng bộ hóa.
- Xem lại các ánh xạ đồng bộ hóa và sử dụng ánh xạ Item khi cần giữ nguyên vòng đời.
- Áp dụng các thay đổi cấu hình nhất quán trên tất cả các mẫu liên quan.
Cập nhật cài đặt mẫu và xác thực việc tạo HRID
-
Open the Component Template
- Đi tới Tools » Data Management » Component Templates.
- Mở mẫu được dùng cho loại linh kiện bị ảnh hưởng.
-
Update the Naming Scheme
- Xác định trường Component Naming Scheme.
- Cập nhật quy tắc đặt tên để khớp với tiêu chuẩn của workspace.
- Thay đổi khối số từ {0000} thành {00000}.
- Lưu mẫu.
-
Enable Allow Override
- Mở Component Options của mẫu.
- Bật Allow override.
- Lưu các thay đổi.
-
Verify the Folder Naming Scheme
- Mở thư mục linh kiện đích.
- Xem lại Item Naming Scheme đã được cấu hình.
- Xác nhận rằng định dạng này khớp với tiêu chuẩn HRID dự kiến và cung cấp đủ dung lượng đánh số.
- Cập nhật quy tắc đặt tên của thư mục nếu cần.
-
Apply Changes to Related Templates
- Lặp lại các cập nhật về quy tắc đặt tên và ghi đè cho tất cả các mẫu sử dụng cùng logic HRID.
- Xác minh tính nhất quán trên tất cả các mẫu linh kiện.
-
Preserve Lifecycle State During Synchronization
- Mở Batch Component Editor.
- Bật Preserve lifecycle state.
- Nếu đang sử dụng đồng bộ hóa PLM, hãy xem lại các ánh xạ tham số và sử dụng ánh xạ Item khi cần giữ nguyên trạng thái vòng đời.
- Tiếp tục đồng bộ hóa hoặc phát hành.
-
Validate the Resolution
- Tạo một linh kiện mới và xác nhận rằng việc tạo HRID thành công.
- Đồng bộ các linh kiện hiện có và xác minh rằng các thiết lập tên gọi và vòng đời được giữ lại.
- Xác nhận rằng các linh kiện mới tạo nhận được HRID dựa trên quy tắc đặt tên mong muốn.
Lưu ý bổ sung
- Lỗi HRID thường xảy ra khi dung lượng của quy tắc đặt tên bị dùng hết hoặc khi tồn tại các quy tắc đặt tên xung đột giữa mẫu và thư mục.
- Việc mở rộng khối số thành {00000} sẽ làm tăng đáng kể phạm vi HRID khả dụng.
Người dùng làm việc với các mẫu được lưu đệm cục bộ có thể cần làm mới hoặc tải lại các mẫu đã cập nhật. - Nếu sự cố vẫn tiếp diễn sau khi cập nhật các quy tắc đặt tên, hãy xác minh rằng Item ID được yêu cầu chưa bị dành trước bởi một item hiện có hoặc một item đã từng bị hủy bỏ trước đó.