KB: Fehler bei der Komponentenfreigabe und -erstellung, verursacht durch Fehler bei der HRID-Generierung

Lösungsdetails

Erstellung oder Freigabe von Komponenten schlägt mit HRID-Fehler fehl

Beim Erstellen oder Freigeben einer Komponente zeigt Altium den folgenden Fehler an:

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

Der Fehler verhindert, dass neue Komponenten korrekt im Workspace erstellt oder synchronisiert werden.

Vorlagen- und Ordner-Benennungsschemata stehen in Konflikt

Altium verwendet Benennungsschemata, um eindeutige HRIDs zu generieren. Während Benennungsschemata auf Ordnerebene in der Regel das HRID-Format definieren, übernehmen aus Vorlagen erstellte Komponenten das in der Vorlage konfigurierte Benennungsschema. Wenn Allow override deaktiviert ist, wird das Benennungsschema auf Ordnerebene ignoriert und es können widersprüchliche oder veraltete Regeln angewendet werden.

Außerdem bietet ein numerisches Muster wie {0000} nur einen begrenzten Pool verfügbarer IDs. Sobald dieser Bereich ausgeschöpft ist, kann Altium keine zusätzlichen HRIDs mehr generieren.

Erforderliche Konfigurationsänderungen

• Aktualisieren Sie das HRID-Benennungsschema in der Komponentenvorlage.
• Erhöhen Sie den numerischen Block von {0000} auf {00000}.
• Aktivieren Sie Allow override in der Vorlage.
• Überprüfen Sie das Benennungsschema des Zielordners.
• Aktivieren Sie Preserve lifecycle state bei Stapelaktualisierungen und der Synchronisierung.
• Überprüfen Sie die Synchronisierungszuordnungen und verwenden Sie Item-Zuordnungen, wenn die Beibehaltung des Lifecycle-Status erforderlich ist.
• Wenden Sie konsistente Konfigurationsänderungen auf alle zugehörigen Vorlagen an.

Vorlageneinstellungen aktualisieren und HRID-Generierung validieren

1. Open the Component Template

   1. Navigieren Sie zu Tools » Data Management » Component Templates.
   2. Öffnen Sie die Vorlage, die für den betroffenen Komponententyp verwendet wird.

2. Update the Naming Scheme

   1. Suchen Sie das Feld Component Naming Scheme.
   2. Aktualisieren Sie das Benennungsschema, damit es dem Workspace-Standard entspricht.
   3. Ändern Sie den numerischen Block von {0000} auf {00000}.
   4. Speichern Sie die Vorlage.

3. Enable Allow Override

   1. Öffnen Sie die Component Options der Vorlage.
   2. Aktivieren Sie Allow override.
   3. Speichern Sie die Änderungen.

4. Verify the Folder Naming Scheme

   1. Öffnen Sie den Zielordner für die Komponente.
   2. Überprüfen Sie das konfigurierte Item Naming Scheme.
   3. Bestätigen Sie, dass das Format dem vorgesehenen HRID-Standard entspricht und ausreichende Nummerierungskapazität bietet.
   4. Aktualisieren Sie bei Bedarf das Benennungsschema des Ordners.

5. Apply Changes to Related Templates

   1. Wiederholen Sie die Aktualisierungen des Benennungsschemas und der Override-Einstellungen für alle Vorlagen, die dieselbe HRID-Logik verwenden.
   2. Überprüfen Sie die Konsistenz über alle Komponentenvorlagen hinweg.

6. Preserve Lifecycle State During Synchronization

   1. Öffnen Sie Batch Component Editor.
   2. Aktivieren Sie Preserve lifecycle state.
   3. Wenn Sie die PLM-Synchronisierung verwenden, überprüfen Sie die Parameterzuordnungen und verwenden Sie Item-Zuordnungen, wenn die Beibehaltung des Lifecycle-Status erforderlich ist.
   4. Fahren Sie mit der Synchronisierung oder Freigabe fort.

7. Validate the Resolution

   1. Erstellen Sie eine neue Komponente und bestätigen Sie, dass die HRID-Generierung erfolgreich ist.
   2. Synchronisieren Sie vorhandene Komponenten und überprüfen Sie, dass Benennungs- und Lifecycle-Einstellungen beibehalten werden.
   3. Bestätigen Sie, dass neu erstellte Komponenten HRIDs auf Basis des erwarteten Benennungsschemas erhalten.

Zusätzliche Hinweise

• HRID-Fehler treten häufig auf, wenn die Kapazität des Benennungsschemas ausgeschöpft ist oder wenn zwischen Vorlagen und Ordnern widersprüchliche Benennungsregeln bestehen.
• Die Erweiterung des numerischen Blocks auf {00000} erhöht den verfügbaren HRID-Bereich erheblich.
• Benutzer, die mit lokal zwischengespeicherten Vorlagen arbeiten, müssen aktualisierte Vorlagen möglicherweise neu laden oder erneut herunterladen.
• Wenn das Problem nach der Aktualisierung der Benennungsschemata weiterhin besteht, vergewissern Sie sich, dass die angeforderte Item-ID nicht bereits durch ein vorhandenes oder zuvor verworfenes Element reserviert ist.

Referenzen

• KB: Beheben von HRID-Generierungsfehlern aufgrund von Einschränkungen des Benennungsschemas
• KB: Fehler durch doppelte Item-HRID bei neuem Release-Item
• KB: Beibehaltung des Lifecycle-Status während der Komponentensynchronisierung
• Komponentenvorlagen