KB: HRID 생성 실패로 인해 발생하는 구성요소 릴리스 및 생성 오류
Updated: September 08, 2026
사용자는 Altium이 유효한 계층형 리비전 ID(HRID)를 생성하지 못할 때 컴포넌트 생성 또는 릴리스 실패를 겪을 수 있습니다. 이는 일반적으로 컴포넌트 템플릿이 폴더 수준의 명명 체계와 충돌하는 명명 체계를 강제하거나, 제한된 번호 패턴으로 인해 사용 가능한 HRID 범위가 모두 소진되었을 때 발생합니다. 템플릿 명명 체계를 업데이트하고, 재정의 동작을 활성화하고, 폴더 명명 설정을 확인하고, 숫자 범위를 확장하고, 동기화 중 라이프사이클 상태를 유지하면 이 문제를 해결하고 향후 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 생성 검증
-
Open the Component Template
- Tools » Data Management » Component Templates(으)로 이동합니다.
- 영향을 받는 구성요소 유형에 사용되는 템플릿을 엽니다.
-
Update the Naming Scheme
- Component Naming Scheme 필드를 찾습니다.
- 명명 체계를 워크스페이스 표준에 맞게 업데이트합니다.
- 숫자 블록을 {0000}에서 {00000}(으)로 변경합니다.
- 템플릿을 저장합니다.
-
Enable Allow Override
- 템플릿의 Component Options을(를) 엽니다.
- Allow override을(를) 활성화합니다.
- 변경 사항을 저장합니다.
-
Verify the Folder Naming Scheme
- 대상 구성요소 폴더를 엽니다.
- 구성된 Item Naming Scheme을(를) 검토합니다.
- 형식이 의도한 HRID 표준과 일치하고 충분한 번호 용량을 제공하는지 확인합니다.
- 필요한 경우 폴더 명명 체계를 업데이트합니다.
-
Apply Changes to Related Templates
- 동일한 HRID 논리를 사용하는 모든 템플릿에 대해 명명 체계 및 재정의 업데이트를 반복합니다.
- 모든 구성요소 템플릿 전반에서 일관성을 확인합니다.
-
Preserve Lifecycle State During Synchronization
- Batch Component Editor을(를) 엽니다.
- Preserve lifecycle state을(를) 활성화합니다.
- PLM 동기화를 사용하는 경우 매개변수 매핑을 검토하고 라이프사이클 상태 유지가 필요한 경우 Item 매핑을 사용합니다.
- 동기화 또는 릴리스를 진행합니다.
-
Validate the Resolution
- 새 구성요소를 생성하고 HRID 생성이 성공하는지 확인합니다.
- 기존 구성요소를 동기화하고 명명 및 라이프사이클 설정이 유지되는지 확인합니다.
- 새로 생성된 구성요소가 예상된 명명 체계를 기반으로 HRID를 받는지 확인합니다.
추가 참고 사항
- HRID 실패는 일반적으로 명명 체계 용량이 소진되었거나 템플릿과 폴더 간에 충돌하는 명명 규칙이 있을 때 발생합니다.
- 숫자 블록을 {00000}(으)로 확장하면 사용 가능한 HRID 범위가 크게 증가합니다.
- 로컬에 캐시된 템플릿으로 작업하는 사용자는 업데이트된 템플릿을 새로 고치거나 다시 다운로드해야 할 수 있습니다.
- 명명 체계를 업데이트한 후에도 문제가 지속되면 요청된 Item ID가 기존 항목 또는 이전에 중단된 항목에 의해 이미 예약되어 있지 않은지 확인합니다.