KB: 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 を確認します。形式が意図した HRID 標準に一致し、十分な採番容量があることを確認します。
   3. 必要に応じてフォルダーの命名スキームを更新します。

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 が、既存または過去に破棄されたアイテムによってすでに予約されていないか確認してください。

参考資料

• KB: 命名スキームの上限による HRID 生成エラーの解決
• KB: 新規リリースアイテムの重複 Item HRID エラー
• KB: コンポーネント同期中にライフサイクル状態を保持する
• コンポーネントテンプレート