Trabalhando com Pastas de Componentes e Itens

Altium Training

Altium Essentials: Workspace Folder Structure

This content is part of the official Altium Professional Training Program. For full courses, materials and certification, visit Altium Training.

Num relance

Saiba como funcionam as pastas e os itens de componentes em um Workspace conectado ao Altium Designer, desde as diferenças entre navegar por pasta e por Tipo de Componente até a personalização da exibição dos dados dos componentes. Este artigo aborda a criação e a importação de componentes, o acesso às verificações de integridade da biblioteca, o trabalho com componentes de múltiplas partes e a configuração da visibilidade dos parâmetros durante o posicionamento. Continue lendo para aproveitar melhor as ferramentas disponíveis para navegar pelos componentes do seu Workspace e gerenciá-los.

- Entenda como os Tipos de Componentes e as pastas padrão determinam onde os novos componentes são armazenados.
- Aprenda a personalizar a Visualização de Componentes com colunas, agrupamento, classificação e filtros, e a investigar problemas de integridade dos componentes na visualização de Integridade da Biblioteca.
- Explore como visualizar e posicionar componentes de múltiplas partes e controlar a visibilidade dos parâmetros ao posicionar componentes do Workspace.
Aprofunde-se com a IA:

Uma distinção importante entre o painel Explorer e o painel Components:

  • No painel Explorer, você navega na árvore à esquerda por Folder Name. Ao clicar em uma pasta no painel Explorer, os componentes stored nessa pasta são listados no painel. Esses componentes do not precisam ser do mesmo tipo de componente. 

  • Ao navegar pelos componentes do seu Workspace no painel Components (ou pela interface baseada em navegador), você navega por Component Type — não pelo nome da pasta em que os componentes estão armazenados. O painel Components e a interface baseada em navegador pesquisam automaticamente todas as pastas de componentes no Workspace e agrupam os componentes por tipo de componente.

A associação entre o tipo de componente e a pasta de componentes é definida na página Data Management - Component Types da caixa de diálogo Preferences. Essas configurações são usadas quando você cria um novo componente. Ao criar um componente, você seleciona um tipo de componente na caixa de diálogo Create new component. O novo componente recebe o tipo de componente que você acabou de escolher e é armazenado na pasta padrão definida para esse tipo de componente na caixa de diálogo Preferences. Essas configurações podem ser verificadas expandindo a seção Advanced Settings das propriedades do componente durante a edição. (mostrar imagem)

Controles de pastas do tipo componente

Quando uma pasta do tipo Components ainda não contém componentes, vários controles são apresentados aqui para ajudar você a preencher a pasta com componentes.

Use esses controles para executar a ação apropriada:

  • Import Library – clique para abrir a caixa de diálogo padrão Open do Windows e selecionar uma biblioteca de banco de dados ou baseada em arquivos salva em uma pasta local ou de rede. Após a abertura de um arquivo de biblioteca, o Library Importer no modo Simple será iniciado com a biblioteca selecionada carregada.
  • Create Component – clique para abrir o Component Editor no modo de edição de um único componente, pronto para definir um novo componente.
  • Create Other Item Type – clique para abrir a caixa de diálogo Create New Item e criar um novo item de qualquer tipo.

Independentemente de haver ou não componentes na pasta, essas ações também podem ser executadas usando as opções do menu associado ao botão Add Component no canto superior direito do painel.

Visualização da integridade da biblioteca

Este recurso está disponível quando a opção LibraryHealth está habilitada na caixa de diálogo Advanced Settings.

Ao navegar pelo conteúdo de um Workspace do Altium 365 conectado, o painel Explorer fornece acesso à visualização Library Health, na qual você pode executar verificações de integridade e inspecionar problemas de integridade dos componentes. Selecione a entrada Library Health na região Server Folder do painel para acessar essa visualização no painel.

A visualização Library Health acessada pelo painel Explorer
A visualização Library Health acessada pelo painel Explorer

A região superior da visualização apresenta um resumo da integridade dos seus componentes desde a última execução de uma verificação de integridade. Abaixo estão as análises de verificação de integridade compatíveis, agrupadas em várias Issue Themes. Clicar no bloco de uma análise de verificação de integridade apresenta uma descrição mais detalhada da verificação, com etapas para resolver os problemas (quando disponíveis), além de uma lista detalhada de todos os componentes que não passaram nessa verificação.

A visualização Library Health tem a mesma interface e as mesmas funcionalidades da página detalhada do painel Library Health, acessada pela interface do Workspace do Altium 365 no navegador. Consulte Acesso ao painel principal de integridade da biblioteca para obter mais informações sobre essa página.

Visualização de componentes

A pasta do tipo Components oferece dois modos de visualização: Classic View e Components View. O segundo, que é a visualização padrão para esse tipo de pasta, permite navegar pelos dados paramétricos associados a todos os componentes da pasta atual. Além disso, você pode configurar a visualização exatamente como preferir para diferentes pastas de componentes, e essas configurações serão mantidas entre as sessões.

Para alternar entre esses dois modos de visualização, navegue até uma pasta de componentes no painel Explorer, clique no botão no canto superior direito da lista de componentes e escolha o comando View » Classic View ou View » Components View no menu associado.

Acesse Components View para uma pasta do tipo Components, que apresenta os componentes com base em seus dados paramétricos. Passe o cursor sobre a imagem para ver o resultado da alternância de volta para Classic View.
Acesse Components View para uma pasta do tipo Components, que apresenta os componentes com base em seus dados paramétricos. Passe o cursor sobre a imagem para ver o resultado da alternância de volta para Classic View.

Consulte as seções a seguir para obter mais informações sobre como trabalhar com Components View.

Suporte a componentes com múltiplas partes

Ao visualizar o símbolo de um componente com múltiplas partes, a aba de visualização Preview apresentará cada parte — cada uma com sua própria representação gráfica de símbolo — em uma aba separada. Além disso, o menu Place apresentará um submenu com todas as partes aplicáveis que podem ser posicionadas para esse componente.

Controle da visibilidade dos parâmetros ao posicionar componentes

Ao posicionar componentes da biblioteca do Workspace (a partir do painel Components ou Explorer), o controle da visibilidade dos parâmetros associados a esses componentes — ou, mais especificamente, de seus valores — é realizado na caixa de diálogo de propriedades da pasta pai.

A pasta deve ser do tipo Components.

Clique com o botão direito na pasta pai e escolha o comando Properties. A caixa de diálogo Edit Folder será exibida. Ative a opção Configure Parameters Visibility on Add no lado direito. Os parâmetros, obtidos de todos os componentes da pasta, serão listados na região. Use a caixa de seleção Visible On Add associada a cada parâmetro para controlar sua visibilidade quando um componente que tenha esse parâmetro for posicionado em uma folha de esquemático.

O parâmetro Name/Comment também está incluído na lista. Esse é um parâmetro do sistema.
Os dados de visibilidade dos parâmetros são armazenados como parte das propriedades da pasta do Workspace, no próprio Workspace, e são globais para todos os usuários do Workspace com os quais as respectivas pastas foram compartilhadas. A hierarquia de pastas também é levada em consideração, de modo que a visibilidade dos parâmetros configurada para uma pasta pai será transmitida a todas as pastas filhas abaixo dela (herdada por elas).

Determine, no nível da pasta, quais parâmetros devem ficar visíveis quando os componentes que os utilizam forem posicionados em um projeto.
Determine, no nível da pasta, quais parâmetros devem ficar visíveis quando os componentes que os utilizam forem posicionados em um projeto.

Cópia de informações dos parâmetros de componentes para a área de transferência

As informações dos parâmetros de uma revisão de um componente podem ser copiadas para a área de transferência para uso posterior em outro local do projeto ou para serem coladas em um aplicativo externo (como o Microsoft Excel). Ao navegar na aba de visualização Preview de uma revisão de Item de Componente, selecione os parâmetros desejados — na região Parameters da visualização — e use o atalho de teclado Ctrl+C ou clique com o botão direito na região e use o comando Copy no menu de contexto.

Selecione vários parâmetros conforme necessário usando as técnicas padrão de seleção múltipla (Ctrl+Click, Shift+Click).

Copie as informações dos parâmetros de uma revisão de Item de Componente para a área de transferência, para uso em outro local conforme necessário.
Copie as informações dos parâmetros de uma revisão de Item de Componente para a área de transferência, para uso em outro local conforme necessário.

Alteração imediata do tipo de um componente liberado

É possível alterar o tipo de componente de um ou mais componentes após a liberação para um tipo completamente diferente, em tempo real. No painel Explorer, selecione as revisões dos componentes que deseja alterar, clique com o botão direito e escolha o comando Operations » Change component type no menu de contexto. A caixa de diálogo Choose component type será exibida, permitindo selecionar o novo tipo de componente.

Um exemplo de alteração do tipo de componente para revisões selecionadas de Itens de Componente que já foram liberadas — com o tipo errado desde o início, para destacar o recurso!
Um exemplo de alteração do tipo de componente para revisões selecionadas de Itens de Componente que já foram liberadas — com o tipo errado desde o início, para destacar o recurso!

Pesquisa de componentes

O painel Explorer oferece funcionalidades avançadas de pesquisa. Você pode realizar pesquisas genéricas ou pesquisas direcionadas usando configurações de pesquisa salvas. Estas últimas permitem pesquisar seus componentes por um tipo específico de componente e também usar pesquisas por intervalo — um recurso útil possibilitado pelos tipos de dados de parâmetros de componentes que reconhecem unidades (compatíveis por meio de um modelo de componente referenciado). Além disso, você pode adicionar um atalho de teclado às pesquisas salvas para realizar uma pesquisa rapidamente fora do painel Explorer.

Embora o recurso de pesquisa oferecido pelo painel Explorer seja avançado, o painel Components oferece uma opção muito mais conveniente — exatamente onde você precisa e no mesmo painel que normalmente usa no dia a dia para gerenciar e posicionar componentes nos seus projetos. O painel Components permite inserir uma expressão de pesquisa e/ou usar as seleções de categorias e filtros do painel para restringir a lista de componentes às suas necessidades específicas. Os filtros estão disponíveis apenas para a Biblioteca do Workspace e, assim como o painel Manufacturer Part Search, o painel Components oferece filtros de pesquisa que reconhecem unidades (conversão de texto em número).

Pré-requisitos para a pesquisa

Related pages: Criação e manutenção de componentes e bibliotecas, Modelo de componente

Para aproveitar e utilizar plenamente todos os aspectos do recurso de pesquisa do painel Explorer ao pesquisar seus componentes, você precisa atender aos seguintes requisitos:

  • Estar executando o Altium Designer e garantir que as extensões de software Component Template Editor e Explorer estejam instaladas como parte dessa instalação.

    Essas extensões de software são instaladas com o Altium Designer por padrão. Elas podem ser instaladas ou removidas manualmente.

    Para obter mais informações sobre o gerenciamento de extensões, consulte a página Extending Your Installation (Altium Designer Develop, Altium Designer Agile, Altium Designer).

  • Usar um Workspace para armazenar seus componentes do Workspace.

  • Se você ainda não criou seus componentes com modelos de componentes referenciados — que oferecem suporte a tipos de dados de parâmetros de componentes que reconhecem unidades — precisará editá-los e salvá-los novamente no Workspace. Isso pode ser feito da seguinte forma:

    1. Editando um componente para acessar sua definição em uma instância temporária do Editor de Componentes.
    2. Criando e liberando um modelo de componente (CMPT) com:
      • Revisões padrão do símbolo e do footprint principal (conforme já utilizados no componente).
      • O Valor Padrão do parâmetro de sistema ComponentType definido adequadamente (por exemplo, Resistors, se estiver editando um resistor genérico). Vários tipos de componentes predefinidos estão disponíveis, com a possibilidade de criar novos tipos quando necessário.
      • Parâmetros de componente definidos que correspondam a todos os parâmetros atualmente definidos para o componente (dessa forma, os valores existentes serão mantidos, sem duplicar nenhum parâmetro).
      • Para os parâmetros relevantes (por exemplo, Value, Tolerance, Power, etc.), defina o tipo de dados adequadamente — fazendo com que esses parâmetros reconheçam unidades. Diversos tipos de dados de parâmetros de componentes que reconhecem unidades são compatíveis.
    3. Atribuindo esse modelo de componente ao componente que está sendo editado — pelo campo Template em Advanced Settings, ao usar o Editor de Componentes no modo Single Component Editing, ou pelo submenu Add » Templates associado à região Required Models/Parameters, ao usar o Editor de Componentes no modo Batch Component Editing.
    4. Ajustando os valores de quaisquer parâmetros exibidos em vermelho (ou seja, com valor inválido ou marcados como obrigatórios, mas ainda não definidos).
    5. Enviando o componente ao Workspace, na próxima revisão do componente.

     

Acesso ao recurso de pesquisa

A interface do recurso de pesquisa — a visualização Search — é acessada pelo painel Explorer, clicando na aba Search no canto inferior esquerdo do painel. A visualização é composta por três elementos principais, conforme mostrado na imagem a seguir e detalhado posteriormente.

Como alternativa, a visualização Search é acessada ao realizar uma pesquisa genérica — usando o campo Search na parte superior do painel — ou ao acionar um atalho de teclado atribuído a uma pesquisa salva. A visualização também pode ser acessada pela visualização Folders, clicando na entrada Search Results, na região Server Folders (disponível após a realização de uma pesquisa).

A visualização Search — uma interface de usuário dedicada no painel Explorer.
A visualização Search — uma interface de usuário dedicada no painel Explorer.

  1. Campo de pesquisa genérica — permite realizar pesquisas padrão. Insira um texto de pesquisa e pressione Enter.
  2. Pesquisas salvas — permitem realizar pesquisas direcionadas que podem ser salvas para reutilização. Esses tipos de pesquisa podem localizar componentes pelo tipo e também permitem pesquisas avançadas com base nos valores de parâmetros que reconhecem unidades.
  3. Resultados da pesquisa.
Clicar duas vezes na entrada Generic Search no painel Saved Searches aplicará o último termo de pesquisa inserido no campo de pesquisa genérica na parte superior do painel Explorer. Isso se aplica apenas à sessão atual do software de projeto.

Criação de uma pesquisa salva

Para criar uma nova pesquisa salva, clique com o botão direito na região Saved Searches e escolha New no menu de contexto. A caixa de diálogo New Search será exibida para que você defina a pesquisa.

Criação de uma nova pesquisa salva.
Criação de uma nova pesquisa salva.

Use a caixa de diálogo para configurar uma pesquisa de componentes da seguinte forma:

  • Dê à pesquisa um nome significativo (por exemplo, Resistors) usando Saved Search Name.

    Não será possível adicionar uma nova pesquisa com o mesmo nome de uma pesquisa salva existente.
  • Defina um Shortcut de teclado opcional para acessar rapidamente a pesquisa (preencha o campo clicando dentro dele e, em seguida, pressionando a combinação de teclas desejada).

  • Defina o campo Content Type como Component. A lista suspensa inclui todos os tipos de conteúdo compatíveis com o Workspace (permitindo criar outras pesquisas com base em outros tipos de conteúdo).

    Selecione Componente na lista suspensa do campo Content Type para pesquisar componentes no Workspace.
    Selecione Componente na lista suspensa do campo Content Type para pesquisar componentes no Workspace.

  • Use a região Parameters para configurar os parâmetros de pesquisa conforme necessário. Todos os parâmetros detectados para o tipo de conteúdo Component serão listados. Para cada parâmetro, as três opções a seguir podem ser definidas:

    • Show Filter – habilite para mostrar um campo de filtro correspondente ao parâmetro, acima da Search Results região na Search aba. É por meio desse campo que você pode refinar suas pesquisas com base nos critérios de valor definidos para esse parâmetro.

    • Default Visibility – habilite para que uma coluna do parâmetro seja apresentada por padrão na Search Results região da Search aba. As colunas de dados paramétricos podem ser ocultadas ou exibidas a qualquer momento, diretamente na visualização.

    • Parameter - o nome do parâmetro. Pode ser um parâmetro do sistema ou um parâmetro do usuário. Lembre-se de que, para usar pesquisas por intervalo, os parâmetros devem ser definidos por meio de um modelo de componente atribuído e devem reconhecer unidades (ser de um tipo de dados específico).

    • Type - o tipo de dados do parâmetro. Para pesquisas por intervalo, o parâmetro deve ser configurado com um tipo de dados que reconheça unidades. Isso só pode ser feito por meio de um modelo de componente que seja então atribuído à biblioteca de componentes antes da liberação das definições dos componentes.

    • Default Value – use este campo para restringir o uso de um parâmetro a um valor ou intervalo específico. Uma pesquisa de cadeia de caracteres literal é realizada no conteúdo do campo, com suporte a caracteres curinga de um único caractere (?) e de vários caracteres (*) ().

      Ao definir um valor:

      • Um intervalo é representado pelo hífen, por exemplo, 1kOhm-10kOhm ou 1k-10k. Você também pode usar maior que (>) e menor que (<). Os limites de maior que e menor que são inclusivos.

      • É realizada uma pesquisa de cadeia de caracteres literal, com o campo oferecendo suporte a caracteres curinga de um único caractere (?) e de vários caracteres (*).

      • Para restringir a pesquisa a um tipo específico de componente, certifique-se de inserir o tipo no campo Default Value do parâmetro ComponentType (por exemplo, Resistors). É muito importante que o ComponentType tenha sido especificado para seus componentes antes de salvá-los no Workspace. Normalmente, isso é definido no modelo de componente referenciado, mas pode ser definido manualmente no Editor de Componentes durante a edição de um componente.

      • Lembre-se de que, para usar pesquisas por intervalo, os parâmetros devem ser definidos por meio de um modelo de componente atribuído e devem reconhecer unidades (ser de um tipo de dados específico).

      Exemplo de parâmetros de pesquisa definidos.
      Exemplo de parâmetros de pesquisa definidos.

     

  • Se quiser que qualquer usuário do seu Workspace veja e use sua pesquisa salva, mantenha a opção Public habilitada. Se quiser que a pesquisa seja privada, acessível apenas a você, desabilite essa opção.

Com a pesquisa definida conforme necessário, clique no botão Add. A pesquisa será salva como uma entrada em Generic Search, na região Saved Searches da visualização.

  • Um conjunto de pesquisas salvas pode ser gerado rapidamente clicando com o botão direito na região Saved Searches e escolhendo o comando Generate From Component Types no menu de contexto. O conjunto abrange todos os tipos de componentes compatíveis.

  • Ao habilitar os parâmetros CreatedBy e/ou ModifiedBy, você pode criar uma pesquisa salva que pesquise pelo usuário especificado que criou/modificou o conteúdo ().

Aplicar uma pesquisa salva

Uma pesquisa salva pode ser aplicada das seguintes maneiras:

  • Após clicar em Add para uma pesquisa recém-definida, ou em Save após modificar uma pesquisa existente, a pesquisa será aplicada automaticamente.
  • Selecione a pesquisa na região Saved Searches e pressione Enter.
  • Use o atalho atribuído para alternar para a pesquisa salva desejada e pressione Enter.
  • Clique duas vezes na entrada da pesquisa salva.

A filtragem dos componentes será realizada com base nos critérios de pesquisa definidos, e os resultados serão apresentados na região de resultados correspondente. Se algum parâmetro tiver a opção Show Filter habilitada como parte da pesquisa salva aplicada, campos específicos para esses parâmetros estarão disponíveis acima da lista de resultados.

Exemplo de resultados após a aplicação de uma pesquisa salva definida – Resistors. A pesquisa tem quatro parâmetros com a opção Show Filter habilitada; portanto, os campos desses parâmetros são apresentados como parte da interface de pesquisa.
Exemplo de resultados após a aplicação de uma pesquisa salva definida – Resistors. A pesquisa tem quatro parâmetros com a opção Show Filter habilitada; portanto, os campos desses parâmetros são apresentados como parte da interface de pesquisa.

Para os parâmetros cujos campos de filtro são exibidos:

  • Se o parâmetro tiver um valor padrão especificado como parte da pesquisa, seu campo será inicialmente preenchido com esse valor, e esse valor será aplicado quando a própria pesquisa for aplicada.

  • Um novo valor (específico ou em intervalo) pode ser especificado para o parâmetro inserindo-o diretamente no campo.

Faça os ajustes necessários e pressione Enter para aplicar a filtragem revisada.

Use os controles padrão disponíveis na região de resultados da pesquisa para ordenar, filtrar e agrupar os resultados conforme necessário:

  • Clique em um cabeçalho para ordenar por esse atributo – uma vez para ordenar em ordem crescente e novamente para ordenar em ordem decrescente.
  • Passe o cursor sobre um cabeçalho para acessar um controle de filtro que permite filtrar por esse atributo.
  • Clique e arraste um cabeçalho para alterar a ordem das colunas exibidas.
  • Arraste um cabeçalho de coluna para a região acima dos cabeçalhos para agrupar os resultados por essa coluna.

Editar uma pesquisa salva

Para modificar uma pesquisa salva existente, selecione-a na região Saved Searches, clique com o botão direito e escolha Edit no menu de contexto. A caixa de diálogo Edit: [<SavedSearchName>] será exibida, permitindo fazer as alterações necessárias na pesquisa.

Após fazer as alterações, clique no botão Save – a pesquisa será aplicada de acordo com as novas configurações.

Excluir uma pesquisa salva

Para remover uma pesquisa salva existente, selecione-a na região Saved Searches, clique com o botão direito e escolha Delete no menu de contexto. Clique em Yes na caixa de diálogo de confirmação exibida em seguida – a pesquisa será removida da lista de pesquisas salvas.

AI-LocalizedLocalizado por IA
Caso encontre um problema, selecione o texto/imagem e primaCtrl + Enterpara nos enviar o seu feedback.
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