Trabalhando com Pastas de Componentes e Itens
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
- 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.
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
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 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.
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.
Consulte as seções a seguir para obter mais informações sobre como trabalhar com Components View.
Controle da exibição de colunas
Cada coluna da visualização corresponde a um parâmetro específico. A configuração de quais colunas são exibidas — e, portanto, quais informações paramétricas são apresentadas — é realizada na caixa de diálogo Select Columns. Acesse essa caixa de diálogo clicando com o botão direito na área dos cabeçalhos das colunas e escolhendo o comando Select Columns no menu de contexto exibido.

A caixa de diálogo Select Columns é o ponto central para definir quais dados paramétricos são apresentados em Components View.
Options and Controls of the Select Columns Dialog:
- Search - digite caracteres na caixa de texto para filtrar a lista de colunas, mostrando apenas as colunas cujo nome contém os caracteres digitados.
- Visibility column - a coluna mais à esquerda é usada para controlar se uma coluna está visível no painel Explorer. Clique no ícone de olho para alternar uma coluna entre visível e não visível As colunas visíveis são sempre listadas na parte superior da caixa de diálogo.
- Column Name - esta coluna exibe o título da coluna no painel Explorer .
- Up / Down - estes botões são usados para mover a coluna selecionada para cima ou para baixo na lista. Como resultado, a coluna será movida para a esquerda ou para a direita no painel Explorer quando OK for clicado. Observe que somente as colunas visíveis podem ter sua posição na ordem alterada.
-
- clique para abrir uma lista suspensa e escolha o item desejado pelo qual filtrar a região da grade.
Ordenação e dimensionamento de colunas
A ordem das colunas é personalizável. Clique no cabeçalho de uma coluna e arraste-o horizontalmente para a nova posição desejada. As posições válidas são destacadas por setas verticais de posicionamento.
Agrupamento de componentes
Os componentes podem ser agrupados com base em qualquer um dos cabeçalhos de coluna visíveis. Para isso, clique e mantenha pressionado um cabeçalho de coluna e, em seguida, arraste-o e solte-o sobre o texto que diz Drag a column header here to group by that column.

Um exemplo de agrupamento personalizado (pelos parâmetros Case/Package e Value).
Ordenação
Os parâmetros podem ser ordenados por uma coluna específica clicando no cabeçalho dessa coluna. Clique uma vez para ordenar em ordem crescente (com base no conteúdo dessa coluna). Clique novamente para ordenar em ordem decrescente.
Você pode ordenar por várias colunas. Com os parâmetros já ordenados por uma coluna específica, Shift+Click em outra coluna para aplicar uma ordenação secundária pelo conteúdo dessa coluna.
Filtragem por coluna
Assim como em uma planilha do Excel, os parâmetros podem ser filtrados ainda mais pelo conteúdo de cada coluna. Para isso, clique no pequeno ícone de funil (filtro) que aparece à direita do cabeçalho de uma coluna ao passar o cursor sobre ele Um menu será exibido contendo uma caixa de seleção para cada valor presente nessa coluna. Marque as caixas de seleção desejadas e clique em OK para reduzir a lista aos parâmetros com esse valor (ou esses valores).
Quando um filtro de coluna é aplicado, o ícone de filtro é exibido em azul , indicando que há uma filtragem aplicada com base nessa coluna. A filtragem pode ser aplicada a várias colunas de dados. Cada filtro de coluna torna-se uma condição combinada pelo operador lógico E no filtro geral. Uma representação textual da filtragem em vigor será apresentada na parte inferior da região.
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.
Pré-visualização
Navegue até o Item de Componente com múltiplas partes desejado no Workspace e certifique-se de que a aba de visualização Preview esteja ativa. O símbolo de cada parte distinta pode ser visualizado na região de visualização de símbolos. Clique em uma aba na parte inferior para alternar entre as partes.

Visualização das partes de um componente com múltiplas partes, no nível do componente.
Clique duas vezes na entrada do símbolo filho para visualizar as partes que compõem o componente no nível do símbolo. Novamente, certifique-se de que a aba de visualização Preview esteja ativa.

Visualização das partes de um componente com múltiplas partes, no nível do símbolo filho.
Posicionamento
Ao posicionar uma revisão de um componente com múltiplas partes em uma folha de esquemático, clicar com o botão direito na entrada da revisão e passar o cursor sobre o comando Place no menu exibirá um submenu contendo todas as partes desse componente. Selecione a parte desejada para posicionar.

Um submenu de posicionamento oferece todas as partes de um componente com múltiplas partes.
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.
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.

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.

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!
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.
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.
-
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:
- Editando um componente para acessar sua definição em uma instância temporária do Editor de Componentes.
-
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.
- 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.
- 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).
- 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.

A visualização Search — uma interface de usuário dedicada no painel Explorer.
- Campo de pesquisa genérica — permite realizar pesquisas padrão. Insira um texto de pesquisa e pressione Enter.
- 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.
- Resultados da pesquisa.
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.
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. -
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. -
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
Componentserã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 (*)
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.
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.
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.
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.



).
).