KB: Erros de liberação e criação de componentes causados por falhas na geração de HRID

Detalhes da solução

A criação ou liberação de componentes falha com erro de HRID

Ao criar ou liberar um componente, o Altium exibe o seguinte erro:

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

Esse erro impede que novos componentes sejam criados ou sincronizados corretamente no workspace.

Conflito entre os esquemas de nomenclatura do template e da pasta

O Altium usa esquemas de nomenclatura para gerar HRIDs exclusivos. Embora os esquemas de nomenclatura no nível da pasta normalmente definam o formato do HRID, os componentes criados a partir de templates herdam o esquema de nomenclatura configurado no template. Se Allow override estiver desativado, o esquema de nomenclatura no nível da pasta será ignorado e regras conflitantes ou desatualizadas poderão ser aplicadas.

Além disso, um padrão numérico como {0000} oferece um conjunto limitado de IDs disponíveis. Quando esse intervalo se esgota, o Altium não consegue gerar HRIDs adicionais.

Alterações de configuração necessárias

• Atualize o esquema de nomenclatura do HRID no template do componente.
• Aumente o bloco numérico de {0000} para {00000}.
• Ative Allow override no template.
• Verifique o esquema de nomenclatura da pasta de destino.
• Ative Preserve lifecycle state durante as atualizações em lote e a sincronização.
• Revise os mapeamentos de sincronização e use mapeamentos Item quando for necessário preservar o ciclo de vida.
• Aplique alterações de configuração consistentes em todos os templates relacionados.

Atualize as configurações do template e valide a geração do HRID

1. Open the Component Template

   1. Navegue até Tools » Data Management » Component Templates.
   2. Abra o template usado para o tipo de componente afetado.

2. Update the Naming Scheme

   1. Localize o campo Component Naming Scheme.
   2. Atualize o esquema de nomenclatura para corresponder ao padrão do workspace.
   3. Altere o bloco numérico de {0000} para {00000}.
   4. Salve o template.

3. Enable Allow Override

   1. Abra as Component Options do template.
   2. Ative Allow override.
   3. Salve as alterações.

4. Verify the Folder Naming Scheme

   1. Abra a pasta de componentes de destino.
   2. Revise o Item Naming Scheme configurado.Confirme que o formato corresponde ao padrão de HRID pretendido e fornece capacidade de numeração suficiente.
   3. Atualize o esquema de nomenclatura da pasta, se necessário.

5. Apply Changes to Related Templates

   1. Repita as atualizações do esquema de nomenclatura e das substituições para todos os templates que usam a mesma lógica de HRID.
   2. Verifique a consistência em todos os templates de componentes.

6. Preserve Lifecycle State During Synchronization

   1. Abra o Batch Component Editor.
   2. Ative Preserve lifecycle state.
   3. Se estiver usando sincronização com PLM, revise os mapeamentos de parâmetros e use mapeamentos Item quando for necessário preservar o estado do ciclo de vida.
   4. Prossiga com a sincronização ou liberação.

7. Validate the Resolution

   1. Crie um novo componente e confirme que a geração do HRID foi bem-sucedida.
   2. Sincronize os componentes existentes e verifique se as configurações de nomenclatura e de ciclo de vida foram mantidas.
   3. Confirme que os componentes recém-criados recebem HRIDs com base no esquema de nomenclatura esperado.

Notas adicionais

• Falhas de HRID ocorrem com frequência quando a capacidade do esquema de nomenclatura se esgota ou quando existem regras de nomenclatura conflitantes entre templates e pastas.
• Expandir o bloco numérico para {00000} aumenta significativamente o intervalo disponível de HRIDs.
• Usuários que trabalham com templates armazenados localmente em cache talvez precisem atualizar ou baixar novamente os templates atualizados.
• Se o problema persistir após a atualização dos esquemas de nomenclatura, verifique se o Item ID solicitado já não está reservado por um item existente ou anteriormente abandonado.

Referências

• KB: Como resolver erros de geração de HRID devido a limites do esquema de nomenclatura
• KB: Erro de HRID de item duplicado para novo item de liberação
• KB: Preservação do estado do ciclo de vida durante a sincronização de componentes
• Templates de componentes