Importando Bibliotecas Existentes para o Seu Workspace Conectado

Num relance

Transfira suas bibliotecas de componentes existentes para o Workspace conectado usando o Library Importer do Altium Designer. Este artigo explica como o modo Simples do importador automatiza importações comuns e como o modo Avançado oferece maior controle sobre os tipos de componentes, os parâmetros e as configurações de importação. Também aborda os formatos de biblioteca compatíveis, os dados transferidos e as verificações de validação que ajudam a identificar problemas de importação. Continue lendo para encontrar a abordagem de importação mais adequada às suas bibliotecas e dar o próximo passo rumo ao gerenciamento centralizado de componentes.

- Saiba como acessar o Library Importer e escolher entre os modos Simples e Avançado.
- Entenda quais bibliotecas e dados de componentes podem ser importados, além das principais limitações.
- Explore as prévias de importação, a classificação de componentes, as configurações de parâmetros e os relatórios para revisar e aprimorar suas importações.
Aprofunde-se com a IA:

O Altium Designer, em conjunto com seu Workspace conectado, oferece um processo simplificado e altamente automatizado para importar rapidamente suas bibliotecas existentes para esse Workspace. A interface desse processo – o Library Importer – apresenta uma solução de um clique que analisa automaticamente as bibliotecas selecionadas e as importa para o Workspace ao qual você está conectado.

Compatível com todos os tipos de bibliotecas relacionados a metodologias mais antigas de gerenciamento de componentes (SchLib, PcbLib, IntLib, DbLib, SVNDbLib), o Importador de Bibliotecas é uma solução dedicada à criação rápida da biblioteca de componentes do Workspace da sua empresa, para que você possa aproveitar suas diversas vantagens: armazenamento e gerenciamento centralizados e de alta integridade, facilidade de reutilização de projetos e informações da cadeia de suprimentos em tempo real.

O Importador de Bibliotecas oferece um modo de interface Simple minimalista, no qual as bibliotecas de componentes selecionadas, baseadas em arquivos ou bancos de dados, são importadas como componentes do Workspace em uma única etapa, enquanto o importador cuida automaticamente da classificação por tipo, da pasta de origem de destino, da inclusão de parâmetros e do tipo de valor, além da transferência de todos os dados relevantes. A interface também está disponível em um modo Advanced que oferece uma prévia completa da importação proposta e acesso aos dados e às configurações relacionados. E, embora a importação seja um processo de um único clique por padrão, o importador também oferece opções de configuração avançadas por meio do painel Propriedades, para maior controle sobre a forma exata como a importação é realizada.

O que é importado?

Todas as informações presentes na biblioteca de origem são importadas para os componentes do Workspace, incluindo todos os modelos de domínio referenciados (símbolos esquemáticos, footprints de PCB, modelos de simulação), informações paramétricas, opções de peças atribuídas, arquivos de folhas de dados etc. Modelos de componentes também são criados quando necessário e podem ser refinados e usados em importações de bibliotecas posteriores.

Se seus componentes originais tiverem vários footprints de PCB definidos, o Importador de Bibliotecas transferirá esses modelos e manterá o footprint padrão atual. E, se você trabalha apenas com bibliotecas de PCB – sua única preocupação é o layout de PCB –, o Importador de Bibliotecas permite importar somente essas bibliotecas ou pode ser alternado para um modo de importação apenas de modelos, no qual os tipos de modelos especificados são importados de bibliotecas integradas ou de bancos de dados. Bibliotecas que incluem vários tipos de componentes (bibliotecas monolíticas) também são detectadas e processadas automaticamente.

Embora o processo de importação de bibliotecas precise lidar com fontes de bibliotecas baseadas em arquivos e bancos de dados que podem usar diversos padrões de formatação, seus processos de análise automatizada detectam os tipos de componentes na biblioteca de origem (resistor, capacitor etc.), bem como os nomes dos parâmetros e seus tipos de valor (Volts, Ohms etc.). O sistema realiza e gerencia uma série de validações, por exemplo, para garantir que não haja IDs duplicados nos componentes resultantes da biblioteca do Workspace ou que não sejam criados modelos ou modelos de componentes duplicados, e que essas entidades sejam reutilizadas entre os componentes (vinculadas a eles) quando necessário. E, se surgirem problemas, o sistema os sinaliza e apresenta sugestões de como resolvê-los, buscando retomar a importação da maneira mais rápida e tranquila possível.

Os tipos de bibliotecas que podem ser importados são:

  • Biblioteca de esquemáticos (*.SchLib).

  • Biblioteca de footprints de PCB (*.PcbLib).

  • Biblioteca integrada (*.IntLib)

  • Biblioteca de banco de dados (*.DbLib).

  • Biblioteca de banco de dados SVN (*.SVNDbLib).

Atualmente, a importação de informações de mapeamento de pinos (para modelos de simulação) não é compatível.

Acesso ao Importador de Bibliotecas

O Importador de Bibliotecas está disponível quando você está conectado a um Workspace. Para acessar o importador no modo Simple :

  • No painel Componentes, escolha a opção Import Library no menu  . Se uma biblioteca baseada em arquivos ou banco de dados estiver selecionada na coluna Categories do painel (ou no menu suspenso superior quando o painel estiver no modo compacto), o Importador de Bibliotecas será aberto para essa biblioteca. Quando um tipo de componente da biblioteca do Workspace estiver selecionado, a caixa de diálogo padrão Open do Windows será aberta para localizar e selecionar um arquivo de biblioteca a ser importado.

    As bibliotecas baseadas em arquivos e bancos de dados atualmente disponíveis no software podem ser visualizadas e gerenciadas na caixa de diálogo Preferências de Bibliotecas, acessada pela opção Libraries Preferences no menu do botão  no painel Componentes.

    Você também pode visualizar e gerenciar as bibliotecas baseadas em arquivos atualmente instaladas na página Gerenciamento de Dados – Bibliotecas Baseadas em Arquivos da caixa de diálogo Preferences.

  • Clique com o botão direito em um arquivo de biblioteca no painel Projetos e selecione Import Library no menu de contexto.

  • Selecione Tools » Import Library no editor de símbolos esquemáticos ou de footprints de PCB quando um arquivo de biblioteca local estiver aberto.

  • Selecione File » Import Library ou Tools » Import Library no Editor de Bibliotecas de Banco de Dados.

  • Na caixa de diálogo Preferências de Bibliotecas, selecione uma entrada de biblioteca na guia Installed e clique no controle Import .

  • Arraste um arquivo de biblioteca de uma pasta do Windows e solte-o no painel Explorador.

O modo Simples oferece opções para importar imediatamente a biblioteca selecionada () ou abrir o Importador de Bibliotecas no modo de interface gráfica completa ().

O Importador de Bibliotecas quando acessado no modo Simple de importação com um clique.
O Importador de Bibliotecas quando acessado no modo Simple de importação com um clique.

Para acessar diretamente o Importador de Bibliotecas no modo de interface Advanced, selecione File » Library Importer no menu principal.

O Importador de Bibliotecas, quando acessado no modo de interface Advanced completa, também permite um processo de importação com um clique.
O Importador de Bibliotecas, quando acessado no modo de interface Advanced completa, também permite um processo de importação com um clique.

Modo Simples

O modo Simples do Importador de Bibliotecas pré-seleciona todos os aspectos do processo de importação com base na análise da biblioteca de origem e do Workspace conectado. A caixa de diálogo Library Importer apresenta então um resumo da estrutura de importação, incluindo a contagem total de cada tipo de item. A importação da biblioteca é realizada em uma única etapa pelo comando .

Esse modo de interface Simples atende aos formatos de bibliotecas de origem mais comuns, que tendem a conter tipos de componentes comuns (resistores, capacitores, circuitos integrados etc.) e valores de parâmetros padronizados. Durante o processo de análise inicial, o sistema deduz o tipo dos componentes da biblioteca com base no designador ou em palavras-chave dos parâmetros (LD?, LED etc.) e, em seguida, localiza um modelo de componente correspondente no Workspace de destino (LED). Esse modelo é aplicado à importação desses componentes, definindo as configurações de importação, como pasta de destino (Components/LED), mapeamento de parâmetros, unidades dos valores dos parâmetros e assim por diante – modelos adequados estarão disponíveis no Workspace se a opção de incluir dados de exemplo tiver sido selecionada durante a ativação de um Workspace do Altium 365 ou a instalação do Altium On-Prem Enterprise Server.

Os resultados da importação da biblioteca, na forma de componentes recém-criados no Workspace, podem ser vistos nos painéis Explorer e Components. Os componentes importados incluem todos os modelos, os parâmetros conforme interpretados pelos Modelos de Componente aplicados, as Opções de Peças derivadas dos dados de origem dos Links de Fornecedor e quaisquer links ou arquivos de referência.

Todos os Modelos de Componente criados pelo Importador de Bibliotecas podem ser acessados na pasta Managed Content\Templates\Component Templates do painel Explorer.

Se, por algum motivo — como um resultado de importação insatisfatório —, você desejar excluir um conjunto de componentes, os componentes selecionados no painel Components poderão ser removidos por completo escolhendo a opção Delete no menu de contexto acessado com o botão direito do mouse. Além dos componentes selecionados, os modelos associados a eles também poderão ser excluídos (se não forem usados por outros componentes).

Alguns pontos importantes sobre o processo de importação de bibliotecas:

  • Bibliotecas monolíticas (aquelas que contêm vários tipos de componentes) são divididas automaticamente em subgrupos, nos quais cada grupo representa um tipo de componente encontrado na biblioteca. Os grupos são processados como bibliotecas individuais.

  • Uma biblioteca de origem com um tipo de componente não reconhecido (não detectado) será importada sem interpretação, com tipos de componentes não atribuídos, em uma pasta Components/Uncategorized do Workspace. Antes de executar a importação, isso pode ser resolvido aplicando o Mapeamento de Designadores ou o Agrupamento por Parâmetros no modo Advanced (interface completa). Como alternativa, você pode prosseguir com a importação e modificar as configurações e a pasta do componente posteriormente, por meio do painel Explorer.
  • O processo de importação de bibliotecas inclui uma etapa automática de Validação dos componentes. Os componentes que gerarem um erro de validação serão ignorados.
  • Se forem detectados modelos duplicados na biblioteca de origem a ser importada, apenas um desses modelos será importado e vinculado aos componentes resultantes no Workspace de destino. Uma notificação correspondente será exibida na parte superior da caixa de diálogo Library Importer.
  • Quaisquer erros encontrados durante o processo poderão ser visualizados em Importing Report, disponível pelo botão quando a importação for concluída.

Modo avançado

A interface gráfica completa do Importador de Bibliotecas é apresentada no modo Advanced, que oferece controle detalhado sobre o gerenciamento de bibliotecas, tipos de componentes e parâmetros de componentes. Em conjunto com o painel Properties, a importação de bibliotecas de componentes para o Workspace pode ser configurada de acordo com suas necessidades específicas. Observe que as configurações do importador podem ser salvas e restauradas por meio da exportação/importação de arquivos de configuração.

O modo avançado é ativado quando o Importador de Bibliotecas é aberto pelo comando File » Library Importer ou quando o botão é selecionado no modo simples. As bibliotecas são adicionadas à seção SOURCE LIBRARIES do importador (se ainda não estiver preenchida) arrastando e soltando um arquivo de biblioteca na área, clicando com o botão direito em <All Libraries> e selecionando Add Library no menu de contexto ou selecionando o botão .

A seção Import Preview lista os grupos de tipos de componentes identificados nas bibliotecas de origem — como Types () ou o Folder Structure proposto () — e inclui uma visualização em grade desses componentes baseada em parâmetros (Components). Os valores dos parâmetros na grade podem ser editados diretamente, evitando a necessidade de abrir e editar a biblioteca de origem. A área inferior Details inclui informações adicionais provenientes do componente selecionado no momento — Opções de Peças, Modelos e Folhas de Dados.

Você pode alterar o tipo de componente clicando com o botão direito em um tipo na lista Types e selecionando o comando Change Component Type.

Independentemente das opções detalhadas e dos dados apresentados na interface, a visualização avançada do importador pode ser usada da mesma forma que a visualização simples — basta clicar no botão para iniciar o processo de importação, sem intervenção. Assim como no processo da visualização simples, o importador já analisou a biblioteca, deduziu o tipo dos componentes que ela contém e aplicou o Modelo de Componente correto. Por sua vez, o modelo determina a pasta de destino no Workspace, os Esquemas de Nomenclatura e as Definições de Ciclo de Vida aplicados e o mapeamento/interpretação dos parâmetros.

  • Use o botão (no canto superior esquerdo) para atualizar o Importador de Bibliotecas. Isso recarregará todas as bibliotecas de origem e os dados do Workspace para incorporar quaisquer alterações ocorridas desde que o importador foi aberto.
  • Use o campo de pesquisa (no canto superior direito) para filtrar as entradas de componentes por um valor de parâmetro correspondente.

Bibliotecas monolíticas

As bibliotecas de origem que contêm vários tipos de componentes são detectadas pelas rotinas de análise do importador e separadas em grupos de sub-bibliotecas, nos quais podem ser processadas como bibliotecas individuais por tipo. A detecção do tipo de componente se baseia nos Designadores dos componentes de origem (R?, C? etc.) e também em palavras-chave (Resistor, Res etc.) contidas nos outros parâmetros principais dos componentes (Descrição, ID etc.).

No exemplo mostrado abaixo, a biblioteca de origem (ProjectABC.IntLib) foi “dividida” automaticamente de acordo com os tipos de componentes detectados (Capacitores, Resistores etc.), que podem ser selecionados na coluna Folder Structure (ou na coluna Types) para visualizar as entradas dos componentes que os compõem na grade Components.

Os tipos de componentes que ainda não existem no Workspace, mas que serão criados durante o processo de importação, são identificados com o ícone .

Observe que a apresentação da listagem Components pode ser alterada de várias maneiras:

  • Clique em um cabeçalho de coluna para reordenar a lista por essa coluna de parâmetro e clique novamente para inverter a ordem.

  • No menu de contexto acessado ao clicar com o botão direito no cabeçalho:

    • Escolha Clear Sorting para restaurar a ordenação padrão da listagem (pela coluna Name em ordem crescente).

    • Escolha Best Fit para ajustar a largura de uma coluna específica ao seu conteúdo.

    • Escolha Select Best Fit All Columns para ajustar a largura de todas as colunas disponíveis ao seu conteúdo.

    • Escolha Select Columns para acessar a caixa de diálogo Select Columns, na qual as colunas de parâmetros podem ser habilitadas, desabilitadas e reordenadas na lista.

  • Clique no ícone de filtro () de um cabeçalho para restringir a listagem a um valor disponível na coluna de parâmetro, a valores vazios/não vazios ou a uma configuração de filtro Custom. O filtro aplicado é mostrado na parte inferior da listagem, onde pode ser habilitado/desabilitado (usando a caixa de seleção associada), modificado em Filter Editor ou excluído. Selecionar All pelo ícone de filtro do cabeçalho () também removerá o filtro aplicado.

Componentes não categorizados

Se uma entrada de subgrupo de biblioteca tiver o nome Uncategorized (e estiver listada como Uncategorized em Types ou Folder Structure e acompanhada de  ícone), isso indica que o importador não conseguiu detectar e atribuir um tipo a esse grupo de componentes – o Tipo de componente está efetivamente definido como None. Neste caso, os componentes não detectados (CIs de lógica inversora) usam um prefixo de designador não reconhecido (U?) e seus parâmetros não contêm palavras-chave detectadas, como IC, logic etc.

Se a importação for executada, os componentes serão importados como um tipo não categorizado, sem interpretação. No entanto, se algum parâmetro principal/padrão estiver incluído (como Resistance, Capacitance, Tolerance etc.), o importador o definirá automaticamente com um tipo de unidade de parâmetro adequado (Ohm, Farad, Percent etc.).

Esse problema pode ser resolvido mapeando manualmente os designadores usados nesses componentes para o tipo de componente desejado na caixa de diálogo Library Splitting, acessada pelo botão – disponível quando a biblioteca de origem (ProjectABC.IntLib) está selecionada. A caixa de diálogo Library Splitting, com os valores padrão, oferece controles para definir opções personalizadas de agrupamento de bibliotecas para componentes não categorizados, com base no mapeamento de designadores por tipos de componente e na divisão baseada em parâmetros.

Com a opção Map Designators  da caixa de diálogo selecionada, escolha a opção de tipo de componente aplicável aos componentes não categorizados na lista suspensa Component Type (todos os tipos de componente disponíveis estão incluídos). Confirme o mapeamento entre tipo e designador (o tipo de componente Logic para os designadores U?) com o botão .

Com o tipo de componente agora especificado pelo mapeamento aplicado, o importador usará o Modelo de componente correspondente (Logic) para configurar a importação da biblioteca conforme definido nas configurações do modelo (pasta, nomenclatura etc.).

  • A caixa de diálogo Library Splitting também inclui a opção de agrupar componentes separados por um valor de parâmetro especificado (por exemplo, de um parâmetro Category ou Component_Type), caso ele esteja definido na biblioteca de origem. Para isso, selecione a opção Parameter Grouping da caixa de diálogo e, em seguida, um parâmetro adequado no menu suspenso.
  • Como alternativa, o Tipo de componente de uma biblioteca pode ser selecionado manualmente na seção General do painel Propriedades.
  • Para alterar o Tipo de componente de uma entrada individual na lista Components, clique na célula Component Type correspondente e escolha outro tipo no menu suspenso ou clique com o botão direito no tipo de componente e selecione Change Component Type no menu de contexto.

Observe que, graças à flexibilidade das configurações do Importador de bibliotecas, um novo tipo de biblioteca de componentes (não categorizado) pode ser importado com toda a infraestrutura necessária para futuras importações desse tipo de biblioteca. Ao escolher uma configuração de importação adequada – novo Tipo de componente, Modelo de componente, pasta de destino, mapeamento de parâmetros e tipos de unidade dos valores dos parâmetros –, o único requisito para a próxima importação desse tipo de biblioteca será selecionar o Tipo de componente definido anteriormente. O Tipo de componente selecionado determinará, então, todos os outros aspectos da importação.

Excluir do importador

Você também pode excluir tipos específicos de componente da importação. Para excluir um tipo de componente, na lista Types, clique com o botão direito no tipo de componente que deseja excluir e selecione Exclude from Importer no menu de contexto – altere a listagem da coluna de Folder Structure para Types, se desejar ().

O tipo de componente excluído ficará esmaecido na lista Types. Para visualizar os componentes excluídos na grade, clique em Show Excluded Component (n), em que n indica o número de componentes excluídos.

Incluir no importador

Se você excluiu um tipo de componente da importação usando o comando Exclude from Importer descrito acima e precisar incluí-lo novamente, clique com o botão direito no tipo de componente esmaecido na lista Types (ou Folder Structure) e selecione Include to Importer no menu de contexto. O tipo de componente voltará a ser exibido na lista Types, indicando que não está excluído.

Erros e avisos de validação

Os componentes que não serão importados corretamente para o Workspace, ou que não serão importados, são indicados por marcadores de aviso ou erro na interface avançada quando o Importador de bibliotecas é executado () ou quando uma Validação da importação é realizada (). A validação também verifica caminhos de pasta do Workspace vazios, parâmetros de sistema conflitantes e modelos duplicados. Um erro fatal bloqueará a importação.

Ao tentar realizar a importação, o painel Messages é preenchido com as violações detectadas, e uma caixa de diálogo oferece a opção de abandonar ou prosseguir com a configuração de importação atual. Neste último caso, os componentes inválidos não serão importados ou o processo de importação falhará.

No caso de uma importação cancelada ou quando a Validação manual é executada, todos os componentes que não passarem nas verificações de importação serão associados a ícones de erro/aviso, com informações adicionais na área inferior Details. Os ícones na coluna de visualização Status indicam as entradas específicas de componentes que violam as regras de verificação da importação.

As verificações de validação predefinidas disponíveis estão listadas abaixo.

As verificações definidas pelo usuário são configuradas na região Import Checks do painel Properties. Use o menu suspenso Report Mode para escolher um nível de relatório diferente para o tipo de violação associado. Essas verificações estão listadas abaixo.

Resolução de erros e avisos

Erros de parâmetros, como no exemplo mostrado aqui, em que o valor Forward Voltage do componente não pode ser interpretado como uma tensão válida, podem ser resolvidos das seguintes formas:

  • Editando o valor do parâmetro problemático – localize e edite sua célula para um formato válido.

  • Alterando a unidade do parâmetro mapeado Type, conforme determinado pelo modelo de componente aplicado, de Voltage para não interpretado Text – selecione a biblioteca de origem na interface do importador e, em seguida, altere o Forward Voltage Type na lista do painel Propriedades Parameter Mapping (na aba General).

  • Removendo o componente do processo de importação – clique com o botão direito na entrada correspondente e escolha a opção Exclude from Importer .

Um erro de arquivo ausente, como o arquivo de folha de dados não localizado mostrado aqui, pode ser resolvido das seguintes formas:

  • A solução óbvia de localizar e restaurar o arquivo ausente no local esperado.
  • Desativando a importação de arquivos de folhas de dados – altere a opção Migrate na seção do painel Propriedades Datasheet (na aba Advanced).
  • Excluindo o componente do processo de importação da biblioteca – conforme descrito acima.

Use o campo Search (no canto superior direito) se desejar encontrar entradas de componentes específicas. A pesquisa filtra a lista de itens pelos valores de parâmetros correspondentes ao tipo de componente selecionado no momento – selecione All em Types (Folder Structure) para que a pesquisa se aplique a todos os componentes nas bibliotecas de origem disponíveis.

Importação de biblioteca de esquemáticos

Se você encontrar um erro de “modelo não encontrado” (como Footprint <footprint name> not found in available libraries) ao tentar importar uma biblioteca de esquemáticos, isso significa que o Importador de Bibliotecas não consegue localizar os modelos vinculados aos componentes no SCHLIB.

No Modo Simples, esses erros serão exibidos no Importing Report baseado em HTML, acessível pelo botão , que fica disponível após a execução da importação. No Modo Avançado, os erros são indicados por ícones de status na interface principal () e como entradas no painel Messages – isso ocorre ao executar uma verificação de validação () ou ao tentar importar a biblioteca ().

Os footprints ausentes são detectados corretamente pelo processo de validação, que também fornece uma opção Choose a Library em seu relatório de erros (no menu suspenso Details). Caso mais de um footprint de componente tenha sido detectado como ausente, uma caixa de diálogo Apply PcbLib Selection oferece opções para usar a PcbLib especificada para essa instância ou para todos os componentes com footprints ausentes.

Outra forma de resolver (ou evitar) esse problema é garantir que os arquivos de biblioteca de modelos necessários estejam disponíveis no Altium Designer. As bibliotecas são instaladas pela página Gerenciamento de dados – Bibliotecas baseadas em arquivos da caixa de diálogo Preferences.

Como alternativa, se você não desejar instalar várias bibliotecas de modelos, será necessário colocá-las no caminho padrão de bibliotecas do software (ou editar o caminho) e verificar se a biblioteca de origem dos modelos está especificada para os componentes da biblioteca de esquemáticos:

  • Inclua a biblioteca de modelos no local do caminho de pesquisa padrão do software. Adicione a biblioteca de modelos, como uma biblioteca de PCB correspondente, ao local especificado pelo caminho padrão de bibliotecas do sistema. Para verificar esse local, consulte a entrada Library Path na página Sistema – Locais padrão da caixa de diálogo Preferences. Se um arquivo de biblioteca tiver sido adicionado/copiado para esse caminho, talvez seja necessário reiniciar o Altium Designer para registrar a alteração.
  • Especifique o nome da biblioteca de modelos de destino para os componentes da biblioteca de esquemáticos. Para que a biblioteca de modelos vinculada a um componente da biblioteca de esquemáticos seja reconhecida pelo Importador de Bibliotecas, especifique seu nome na caixa de diálogo Modelo de PCB da biblioteca.

Observe que não é necessário, nem mesmo desejável, importar uma biblioteca de PCB junto com sua biblioteca de esquemáticos correspondente, pois a importação e a vinculação dos modelos necessários serão realizadas pelo próprio Importador de Bibliotecas. O processo de importação identifica, localiza e transfere os modelos corretos de cada componente para criar um componente unificado no Workspace de destino.

Detecção de duplicatas

O Importador de Bibliotecas também inclui mecanismos para evitar a criação de componentes duplicados no Workspace de destino. Isso é feito durante a validação, comparando os parâmetros de identificação dos componentes e as Escolhas de Peças da biblioteca de origem com os dos componentes no Workspace de destino e nas bibliotecas de origem a serem importadas. Com as configurações padrão do importador, uma etapa de Validação () sinalizará uma mensagem Warning quando for detectada a mesma entrada de componente Name ou Part Choices (indicando um possível componente duplicado). A mensagem de aviso/erro exibida inclui o tipo de violação de duplicidade (parâmetro ou Escolha de Peça), o nome do componente da biblioteca que apresenta a violação e o componente (por ID) com o qual ele está em conflito.

Duas possíveis duplicidades detectadas pelo processo de Validação, em que o Name do componente (imagem superior) ou seu Part Choice (imagem inferior) já existem em componentes do Workspace.
Duas possíveis duplicidades detectadas pelo processo de Validação, em que o Name do componente (imagem superior) ou seu Part Choice (imagem inferior) já existem em componentes do Workspace.

O par nome-valor do parâmetro usado para detectar violações de duplicidade é especificado na região Duplicates Detection do painel Properties, na aba Advanced. Use o menu suspenso Unique Field (definido como Name por padrão) para selecionar um dos parâmetros disponíveis na biblioteca de origem. Essa seleção é particularmente útil para configurações de bibliotecas corporativas que usam um campo de identificação proprietário integrado ao sistema empresarial mais amplo.

Uma violação de duplicidade detectada em que o valor de um parâmetro especificado (ERP-REF) é o mesmo para um componente da biblioteca local e um componente do Workspace.
Uma violação de duplicidade detectada em que o valor de um parâmetro especificado (ERP-REF) é o mesmo para um componente da biblioteca local e um componente do Workspace.

É possível definir um tipo diferente de sinalização de status para as violações de duplicidade selecionando uma alternativa em Report Mode, na região Import Checks, na aba General do painel Properties.

A detecção de duplicidades também é realizada para modelos de símbolos dos componentes. Se os componentes a serem importados tiverem modelos de símbolos com a mesma geometria nas bibliotecas de origem, apenas um desses modelos será importado.

Este recurso está disponível quando a opção LibraryMigrator.DuplicatedModelCheck está habilitada na caixa de diálogo Configurações Avançadas.

Bibliotecas com Modelo Único

A detecção automática de duplicidades também é usada para processar bibliotecas de origem que utilizam um modelo de símbolo comum para todos os componentes. Essas bibliotecas tendem a ser compostas por um único tipo de componente com diferentes estilos e valores, como resistores de um determinado formato de encapsulamento, em que o símbolo de cada um é uma representação gráfica padrão.

Essa condição de modelo único e comum é detectada pelo Importador de Bibliotecas, que então configura a importação para transferir um modelo de símbolo aplicável a todos os componentes importados, em vez de um símbolo correspondente com nome individual para cada componente. O símbolo a ser importado adota o nome de um dos símbolos a serem importados, e todos os parâmetros dos componentes permanecem inalterados.

O símbolo de biblioteca importado (que tem um nome genérico e o campo Descrição em branco) pode ser editado para atender às suas necessidades. No painel Componentes, use a opção Edit do menu de contexto para executar a ação. Durante o processo, selecione a opção Update items related to <symbol ID> na caixa de diálogo Create Revisions for Item para garantir que os componentes importados usem a nova revisão do símbolo.

Mesclar Tipos de Componentes

O conjunto de Tipos de Componentes registrados no sistema — ou, na prática, no Workspace conectado — pode ser visualizado e gerenciado na página Gerenciamento de Dados – Tipos de Componentes da caixa de diálogo Preferences. Os tipos são listados com seus respectivos Template de componente e Folder do Workspace e incluirão todos os novos tipos criados quando o Importador de Bibliotecas tiver importado arquivos de biblioteca para o Workspace.

A criação de vários novos Tipos de Componentes pode ocorrer, em geral, quando uma configuração do Importador de Bibliotecas usa o Agrupamento por Parâmetro (o valor de um parâmetro de componente designado) para determinar o Tipo de cada componente importado. Por exemplo, o parâmetro Categories pode ser Resistor-0608 para um conjunto de componentes importados e Resistor-0402 para outro, e assim por diante. Nesse caso, o ideal seria agrupar todos sob o único Tipo de Componente Resistors para uso futuro.

Em vez de alterar manualmente todos os Tipos de Componentes nessas circunstâncias, a página Tipos de Componentes em Preferences permite mesclar as entradas de Tipo selecionadas em uma única entrada especificada. Para saber mais, consulte a seção Mesclando Tipos de Componentes da página Tipos de Componentes.

O resultado dessa mesclagem é que, quando Resistors for escolhido como o tipo de componente importado no Importador de Bibliotecas, ele será aplicado se você selecionar qualquer um dos Templates mesclados (Resistor_0402 etc.) como alternativa.

Importação Somente de Modelos

O Importador de Bibliotecas pode ser alternado para um modo de importação especial Models Only, que detecta e processa os modelos de componentes disponíveis em uma biblioteca de origem.

Este recurso está disponível quando a opção LibraryMigrator.ModelsOnlyMode está habilitada na caixa de diálogo Configurações Avançadas.

No modo Somente Modelos, o processo de análise do importador detectará todos os modelos de Símbolo, Footprint e Simulação disponíveis em uma biblioteca de origem (IntLib, SchLib, PcbLib etc.) e, em seguida, importará esses modelos para o Workspace usando os locais, os esquemas de nomenclatura e as definições de ciclo de vida padrão do sistema.

Quando o Importador de Bibliotecas é alternado para o modo Avançado () ou aberto nesse modo (File » Library Importer), ficam disponíveis todos os detalhes da importação de modelos proposta. A região Import Preview mostra o Folder Structure que será usado no Workspace de destino, cujas configurações padrão podem ser modificadas no campo Folder para cada tipo de modelo no painel Properties. Os esquemas de nomenclatura e a definição de Ciclo de Vida aplicados a cada modelo podem ser selecionados entre os tipos disponíveis no sistema (consulte o painel Propriedades, abaixo).

A importação de modelos de componentes para o Workspace pode ser limitada por tipo, se desejado, desabilitando (ou habilitando) tipos de modelo específicos no painel Properties por meio de seus respectivos botões .

Após configurar o Importador de Bibliotecas, selecione o botão para concluir a importação dos modelos de componentes listados. Os resultados podem ser consultados no arquivo de log de importação, disponibilizado pela caixa de diálogo de progresso Library Importer (), ou pela visualização dos modelos importados no painel Componentes.

Importação Somente de Componentes

De modo semelhante ao modo de importação Models Only descrito acima, o Importador de Bibliotecas pode ser alternado para um modo de importação especial Components Only, que permite importar os componentes disponíveis em uma biblioteca de origem sem seus modelos vinculados.

Este recurso está disponível quando a opção LibraryMigrator.ReleaseComponentsWithoutModels está habilitada na caixa de diálogo Configurações Avançadas.

No modo Somente Componentes, o processo de análise do importador detectará todos os componentes, parâmetros e Escolhas de Peças em uma biblioteca de origem e, em seguida, importará esses componentes para o Workspace usando o local, o esquema de nomenclatura e a definição de ciclo de vida padrão do sistema.

Quando o Library Importer é alternado para o modo Avançado () ou aberto nesse modo (File » Library Importer), ficam disponíveis todos os detalhes da importação de componentes proposta. A pasta aplicada, os esquemas de nomenclatura e a definição de ciclo de vida podem ser selecionados entre os tipos disponíveis no sistema (consulte painel Properties, abaixo).

Após configurar o Library Importer, selecione o botão para concluir a importação dos componentes listados. Apenas itens de componentes serão criados no Workspace, sem modelos vinculados. Os resultados podem ser consultados no arquivo de log da importação, disponibilizado pela caixa de diálogo de progresso Library Importer (), ou visualizando os componentes importados no painel Components. 

Painel Properties

As configurações do painel Properties associado ao Library Importer oferecem controle avançado sobre a configuração de importação da biblioteca selecionada (ou do grupo de subbibliotecas). O painel pode ser acessado no modo Avançado do Library Importer selecionando a opção Properties no menu do botão  (no canto inferior direito da área de projeto), clicando no botão  no canto superior direito da visualização do Library Importer ou clicando no botão  ao lado de <All Libraries> ou de uma entrada de categoria específica na lista Source Libraries.

As opções do painel são definidas pelas configurações padrão do sistema ou pelas configurações especificadas pelo modelo de componente aplicado, que, por sua vez, é determinado pelo tipo de componente detectado na biblioteca — LED no exemplo mostrado aqui. As configurações também podem ser editadas pelo usuário, permitindo adaptar o processo de importação conforme necessário, e podem ser restauradas pelo link Reset to Default (no canto superior direito).

As seções da guia General do painel são as seguintes:

  • General:
    • Component Type – o tipo de componente detectado pelo importador para a biblioteca selecionada e, por associação, o modelo aplicado (consulte Component Template abaixo). Substitua essa configuração editando o campo, o que criará um novo tipo de componente, ou selecionando outro tipo nas opções do menu suspenso (ou pelo botão ) — essa é outra forma de resolver um problema de componente não categorizado. Escolha a opção [LibraryName] para definir o tipo como o nome da biblioteca selecionada.
    • Component Template – o modelo de componente do Workspace que será aplicado aos componentes importados e, por associação, sua configuração de tipo de componente. Substitua essa configuração selecionando outro modelo nas opções do menu suspenso (ou pelo botão ). Defina essa opção como [Create new] para criar automaticamente um modelo derivado dos parâmetros da biblioteca de origem e das configurações atuais do Library Importer, ou escolha [No Template] para impedir que um modelo seja aplicado ou criado.

      Observe que as configurações Component Type e Component Template ficam efetivamente vinculadas quando definidas como um tipo/modelo disponível — por exemplo, se uma delas for definida como Capacitors, a outra será automaticamente definida como Capacitors. No entanto, se, nesse caso, a configuração Component Template for alterada para [Create New], outro modelo Capacitors (nomeado com um sufixo de versão/revisão apropriado) será criado para atender às configurações atuais. Os modelos de componente existentes não são alterados pelo processo de importação.
  • Parameter Mapping – a correspondência entre os parâmetros da biblioteca e os do modelo de componente aplicado (ou as configurações padrão quando não há um modelo disponível), além do tipo de valor de cada parâmetro (texto ou um tipo com suporte a unidades). Use as opções do menu suspenso da coluna Source Library Parameter para alterar o mapeamento e as opções do menu da coluna Type para substituir a configuração existente, determinada pelo modelo ou pelos padrões. Escolha a opção <Skip> para não incluir um parâmetro. Qualquer parâmetro que não tenha sido automaticamente associado a um parâmetro da biblioteca de origem (definido como <Skip> pelo sistema) pode ser mapeado manualmente para um parâmetro adequado do modelo — por exemplo, o parâmetro de origem ROHS pode ser selecionado para corresponder ao parâmetro RoHS Compliant definido pelo modelo do Workspace. Os nomes dos parâmetros podem ser editados, e conjuntos de parâmetros podem ser adicionados, editados e removidos. Os parâmetros básicos do componente (ID, Name, Description) podem ser remapeados, mas, fora isso, são somente leitura.

    Para o parâmetro do Workspace ID, o parâmetro da biblioteca de origem é definido como <Auto>. Isso resulta na criação automática de IDs de componentes com base no Naming Template especificado na seção Component do painel, localizada na guia Advanced. O mapeamento do ID pode ser alterado para usar qualquer parâmetro da biblioteca de origem (que seja exclusivo para cada entrada de componente), escolhendo uma alternativa no menu suspenso de parâmetros da biblioteca de origem. Observe que os parâmetros básicos do componente (ID, Name, Description) podem ser remapeados, mas, fora isso, são somente leitura.
  • Part Choice Mapping – a lista de parâmetros de peças do fabricante ou de links de fornecedores reconhecidos pelo importador, que serão usados para gerar entradas de opções de peças para os componentes importados. Use as opções do menu suspenso para redefinir o mapeamento ou adicionar e excluir conjuntos de mapeamento. Observe que, por padrão, os parâmetros de peças do fabricante e de links de fornecedores não são incluídos (são ignorados) no processo de importação. Quando vários links de fornecedores estão incluídos em um componente da biblioteca, a referência do fornecedor principal (Supplier 1 / Supplier Part Number 1) é usada nas entradas do campo de opções de peças.
  • Import Checks – visualize ou defina a resposta de erro/aviso do importador às violações das regras de validação da importação. Use o menu suspenso Report Mode para alterar a resposta e o ícone de uma entrada Violation Type. Observe que, se o modo de relatório Fatal Error estiver selecionado, ele bloqueará o processo de importação quando essa violação for detectada.

A guia Advanced do painel oferece configurações para todos os itens de objetos de dados do importador, conforme definido pelos padrões do sistema ou pelo modelo de componente aplicado. Isso inclui modelos de componentes, arquivos de folhas de dados e quaisquer modelos de componente criados. Com exceção da opção Datasheet (um controle para habilitar/desabilitar), as configurações de cada objeto de importação incluem:

  • Folder – a pasta de destino do Workspace para o objeto importado, que pode ser editada manualmente (por exemplo, para criar uma nova pasta de destino) ou selecionada pelo botão de navegação ().
  • Naming Scheme – a especificação de nomenclatura do objeto no Workspace, conforme definida pelo modelo de componente ou, na ausência de um modelo ativo, o esquema definido para a pasta de destino (ou inserido manualmente). Use o menu suspenso para escolher entre os esquemas de nomenclatura disponíveis. Observe que uma alteração no caminho da pasta de destino (Folder) pode ser acompanhada de uma alteração no esquema de nomenclatura aplicado, conforme definido pela própria pasta ou por um modelo de componente aplicado/associado.
  • Revision Naming Scheme – o padrão de nomenclatura usado para as revisões do objeto no Workspace, conforme definido pelo modelo aplicado ou selecionado nas opções do menu suspenso da entrada. Apenas os esquemas habilitados pelo sistema estarão disponíveis como opção.
  • Lifecycle Definition – o sistema de ciclo de vida usado para o objeto, conforme definido pelo modelo aplicado ou selecionado nas opções do menu suspenso da entrada. Somente as definições habilitadas pelo sistema estarão disponíveis como opção.
A seção do objeto Component inclui a configuração de Duplicates Detection, conforme descrito acima.

Exportação e importação da configuração

O Importador de Bibliotecas permite exportar um arquivo de texto detalhado que registra a configuração atual, incluindo todas as configurações de importação ajustáveis, como caminhos de destino, mapeamento de parâmetros, esquema de nomenclatura, definições de ciclo de vida, tipos de componentes de destino e assim por diante.

O arquivo de configuração do importador é salvo por meio do comando File » Export » Importer Config como um arquivo do tipo *.lmcfg e pode ser restaurado a qualquer momento pela opção de menu File » Import » Importer Config .

A capacidade de restaurar uma configuração é particularmente útil quando o banco de dados de origem ou a biblioteca baseada em arquivos tiver sido atualizado e essas alterações precisarem ser importadas para o Workspace. Se a configuração tiver sido exportada quando a biblioteca foi importada pela primeira vez, a configuração restaurada (importada) restabelecerá exatamente as configurações utilizadas, garantindo um esquema consistente de transferência de dados para essa biblioteca (ou bibliotecas).

Observe que um arquivo de configuração do importador exportado (salvo) inclui referências aos arquivos de biblioteca que estavam abertos como bibliotecas de origem quando a configuração foi exportada. Quando esse arquivo de configuração do importador for posteriormente importado (recarregado), uma ou mais das bibliotecas referenciadas na configuração deverão estar disponíveis — ou seja, deverão estar disponíveis naquele momento como bibliotecas de origem no Importador de Bibliotecas.
AI-LocalizedLocalizado por IA
Caso encontre um problema, selecione o texto/imagem e primaCtrl + Enterpara nos enviar o seu feedback.
Nav
Contents
Disponibilidade de Recursos

Os recursos disponíveis para você dependem de qual solução Altium você possui – Altium Develop, Altium Agile Teams, Altium Agile Enterprise ou Altium Designer (com assinatura ativa).

Se você não vir um recurso documentado no software que está usando no momento, entre em contato com a equipe de vendas da Altium para saber mais.

Documentação Legada

A documentação do Altium Designer já não é versionada. Se precisar de aceder à documentação de versões anteriores do Altium Designer, visite a secção Documentação Legada da página de Outros Instaladores.

Contents