KB: HRID 생성 실패로 인해 발생하는 컴포넌트 생성 및 릴리스 오류

솔루션 세부 정보

HRID 오류로 인해 컴포넌트 생성 또는 릴리스가 실패하는 경우

컴포넌트를 생성하거나 릴리스할 때 Altium에 다음과 같은 오류가 표시됩니다:

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

이 오류로 인해 새 컴포넌트를 생성하거나 워크스페이스 내에서 올바르게 동기화할 수 없습니다.

템플릿 및 폴더 네이밍 체계(Naming Scheme) 충돌

Altium은 고유한 HRID를 생성하기 위해 네이밍 체계를 사용합니다.
일반적으로 폴더 레벨(Folder Level)의 네이밍 체계가 HRID 형식을 정의하지만, 템플릿에서 생성된 컴포넌트는 템플릿 내에 정의된 네이밍 체계(Naming Scheme)를 상속합니다.

Allow override가 비활성화되어 있으면, 폴더 수준의 명명 체계는 무시되고 충돌하거나 오래된 규칙이 적용될 수 있습니다.

또한 {0000}와 같은 숫자 패턴은 사용 가능한 ID 풀을 제한합니다. 이 범위를 모두 사용하면 Altium은 추가 HRID를 생성할 수 없습니다.

필수 설정 변경

• 컴포넌트 템플릿에서 HRID 네이밍 체계(Naming Scheme)를 업데이트합니다.

• 숫자 블록을 {0000}에서 {00000}로 확장합니다.

• 템플릿에서 Allow override을(를) 활성화합니다.

• 타켓 폴더의 네이밍 체계를 확인합니다.

• 일괄 업데이트 및 동기화 중에 Preserve lifecycle state를 활성화합니다.

• 동기화 매핑을 검토하고, 라이프사이클 유지가 필요한 경우 Item 매핑을 사용합니다.

• 동일한 HRID 규칙을 사용하는 모든 템플릿에 동일한 설정을 적용합니다.

템플릿 설정 업데이트 및 HRID 생성 검증

1. 컴포넌트 템플릿 열기

   1. Tools » Data Management » Component Templates(으)로 이동합니다.

   2. 영향을 받는 컴포넌트 유형(Component Type)에 사용되는 템플릿을 엽니다.

2. 네이밍 체계(Naming Scheme) 업데이트

   1. Component Naming Scheme 필드를 찾습니다.
   2. 네이밍 체계(Naming Scheme)를 워크스페이스 표준에 맞게 업데이트합니다.
   3. 숫자 블록을 {0000}에서 {00000}(으)로 변경합니다.
   4. 템플릿을 저장합니다.

3. Allow Override 활성화

   1. 템플릿의 Component Options을 엽니다.

   2. Allow override을(를) 활성화합니다.

   3. 변경 사항을 저장합니다.

4. 폴더 네이밍 체계(Naming Scheme) 확인하기

   1. 대상 컴포넌트 폴더를 엽니다.

   2. 구성된 Item Naming Scheme을 검토합니다.

   3. 형식이 의도한 HRID 표준과 일치하고 충분한 번호 용량을 제공하는지 확인합니다.

   4. 필요한 경우 폴더 네이밍 체계(Naming Scheme)를 업데이트합니다.

5. 관련 템플릿에 동일한 변경 적용하기

   1. 동일한 HRID 논리를 사용하는 모든 템플릿에 대해 네이밍 체계(Naming Scheme) 및 재정의 업데이트를 반복합니다.
   2. 모든 컴포넌트 템플릿 전반에서 일관성을 확인합니다.

6. 동기화 중 라이프사이클 상태 유지하기

   1. Batch Component Editor 를 엽니다.

   2. Preserve lifecycle state 를 활성화합니다.

   3. PLM 동기화를 사용하는 경우 매개변수 매핑을 검토하고 라이프사이클 상태 유지가 필요한 경우 Item 매핑을 사용합니다.

   4. 동기화 또는 릴리스를 진행합니다.

7. 문제 해결 여부 확인하기

   1. 새 컴포넌트를 생성하고 HRID 생성이 성공하는지 확인합니다.
   2. 기존 컴포넌트를 동기화하고 명명 및 라이프사이클 설정이 유지되는지 확인합니다.
   3. 새로 생성된 컴포넌트가 예상된 네이밍 체계(Naming Scheme)를 기반으로 HRID를 받는지 확인합니다.

추가 참고 사항

• HRID 실패는 일반적으로 네이밍 체계(Naming Scheme) 용량이 소진되었거나, 템플릿과 폴더 간에 충돌하는 명명 규칙이 있을 때 발생합니다.

• 숫자 블록을 {00000}로 확장하면, 사용 가능한 HRID 범위가 크게 증가합니다.

• 로컬에 캐시된 템플릿으로 작업하는 사용자는, 업데이트된 템플릿을 새로고침 하거나 다시 다운로드해야 할 수 있습니다.

• 네이밍 체계(Naming Scheme)를 업데이트한 후에도 문제가 계속되면,
  생성하려는 Item ID가 기존 항목이나 이전에 생성되었다가 중단된 항목에 의해 이미 사용 중인지 확인하십시오.

참조

• KB: 네이밍 체계(Naming Scheme) 제한으로 인한 HRID 생성 오류 해결하기

• KB: 새로운 Release Item 생성 시 발생하는 중복 Item HRID 오류 해결하기 

• KB: 컴포넌트 동기화 중 라이프사이클 상태 유지하기

• 컴포넌트 템플릿