Modelos de componentes

Para ajudar a otimizar a criação dos seus componentes, o Altium Designer, em conjunto com o seu Workspace conectado, oferece suporte à criação e definição de Component Templates (Itens de Modelo de Componente) nesse Workspace. Assim como um modelo de esquemático pode ser usado para predefinir informações em folhas esquemáticas que o referenciam, um modelo de componente é referenciado por um componente de biblioteca do Workspace e fornece configurações predefinidas para uso ao definir esse componente.

Em particular, os modelos de componente foram desenvolvidos com foco firme em informações paramétricas, permitindo que você defina, em um único local, um "conjunto-base" de parâmetros que ficarão disponíveis para o componente que faz a referência. Por meio do modelo, você pode controlar quais desses parâmetros ficarão visíveis, preencher valores padrão e até mesmo marcar como obrigatórios os parâmetros exigidos. Verificações de validação são executadas no momento de salvar o componente, para garantir a conformidade.

Os valores padrão especificados para muitas das configurações do modelo podem ser bloqueados como somente leitura ou disponibilizados seletivamente para substituição pelo projetista ao definir um componente.

Um modelo de componente também é a base para criar um componente genérico. Para saber mais, consulte a página Criando Componentes Genéricos.

O acesso a modelos de componente dependerá do licenciamento do software. Para mais informações, consulte a Note caixa no lado direito da página.

Esses modelos de componente são criados diretamente de dentro do Workspace. Depois que um modelo de componente for criado (e os dados forem salvos em uma revisão dele), ele poderá ser reutilizado na criação de um ou mais componentes.

Tipo de Pasta

Ao criar a pasta na qual armazenar modelos de componente, você pode especificar o tipo da pasta. Isso não afeta o conteúdo da pasta — liberar um modelo de componente sempre resultará em um Item de Modelo de Componente correspondente. Isso simplesmente fornece uma "indicação" visual do que está armazenado em uma pasta e pode ser útil ao navegar em um Workspace em busca de conteúdo específico. Para definir o uso de uma pasta como contêiner para modelos de componente, ajuste seu Folder Type como Component Templates, ao definir as propriedades da pasta na caixa de diálogo Editar Pasta.

Especificar o tipo da pasta — seu uso pretendido — fornece uma indicação visual do conteúdo dessa pasta ao navegar pelo Workspace.
Especificar o tipo da pasta — seu uso pretendido — fornece uma indicação visual do conteúdo dessa pasta ao navegar pelo Workspace.

Tipo de Conteúdo

Ao criar um Item de Modelo de Componente de destino no qual armazenar seu modelo de componente, certifique-se de que seu Content Type esteja definido como Component Template, na caixa de diálogo Criar Novo Item. Se você estiver criando o Item em uma pasta do tipo Component Templates, esse tipo de conteúdo estará disponível no menu de contexto do botão direito ao criar o Item.

Criando um modelo de componente em uma pasta Component Templates — o Content Type correto está disponível no menu de contexto.
Criando um modelo de componente em uma pasta Component Templates — o Content Type correto está disponível no menu de contexto.

Salvando um Modelo de Componente

Related page: Criando & Editando Conteúdo

Até aqui, discutimos o suporte a um modelo de componente no Workspace, em termos de tipos relacionados de pasta e conteúdo. Salvar um modelo de componente efetivamente definido em uma revisão desse Item de Modelo de Componente pode ser feito de forma simplificada.

Um modelo de componente pode ser editado e salvo na revisão inicial de um Item de Modelo de Componente recém-criado, graças ao suporte do Workspace para edição direta. A edição direta elimina a dependência de dados-fonte separados com controle de versão. Você pode simplesmente editar um tipo de conteúdo compatível usando um editor temporário carregado com a fonte mais recente diretamente do próprio Workspace. E, quando a edição é concluída, a entidade é salva (ou salva novamente) em uma revisão planejada subsequente de seu Item pai, e o editor temporário é fechado. Não há arquivos no seu disco rígido, não há dúvida se você está trabalhando com a fonte correta ou mais recente, e não há necessidade de manter um software de controle de versão separado. O Workspace cuida de tudo isso, com grande integridade e de uma forma que acelera bastante as alterações em seus dados.

Ao criar um Item de Modelo de Componente, você tem a opção de editar e salvar um modelo de componente na revisão inicial desse Item após a criação. Para fazer isso, habilite a opção Open for editing after creation, na parte inferior da caixa de diálogo Criar Novo Item (que vem habilitada por padrão). O Item será criado e o Editor temporário de Modelo de Componente será aberto, apresentando um documento .CMPT como o documento ativo na janela principal de projeto. Esse documento será nomeado de acordo com o formato Item-Revisão: <Item><Revision>.CMPT (por exemplo, CMPT-0001-1.CMPT).

Exemplo de edição da revisão inicial de um modelo de componente, diretamente do Workspace — o Editor temporário de Modelo de Componente fornece o documento com o qual definir seu modelo de componente.
Exemplo de edição da revisão inicial de um modelo de componente, diretamente do Workspace — o Editor temporário de Modelo de Componente fornece o documento com o qual definir seu modelo de componente.

Use o documento para definir o modelo de componente conforme necessário. Para mais informações sobre como fazer isso, consulte Definindo o Modelo.

Há três controles relevantes durante a edição direta, prontamente disponíveis em Quick Access Bar (no canto superior esquerdo da janela principal do aplicativo) ou na barra de ferramentas Component Template Standard:

  • Save Active Document. Use esse botão para salvar localmente quaisquer alterações feitas no documento. Isso permite salvar as alterações atuais, caso você deseje voltar posteriormente para fazer mais alterações antes de salvar definitivamente no Workspace.
  • /Save to Server. Use esse botão para salvar o modelo de componente definido no Workspace, armazenando-o na revisão inicial (planejada) do Item de Modelo de Componente de destino. A caixa de diálogo Edit Revision será exibida, na qual você poderá alterar Nome, Descrição e adicionar notas de liberação conforme necessário. O documento e o editor serão fechados após o salvamento. O documento que contém o modelo de componente de origem, *.CMPT será armazenado na revisão do Item.

    Um controle Save to Server também é convenientemente fornecido à direita da entrada do modelo de componente, no próprio painel Projects .
  • /Discard Local Changes. Use esse botão se desejar cancelar a edição e descartar quaisquer alterações feitas. O documento e o editor serão fechados, e nada será liberado para o Item de Modelo de Componente de destino.

Esses controles também estão disponíveis como comandos — Save (Atalho: Ctrl+S), Save to Server (Atalho: Ctrl+Alt+S) e Discard Local Changes — no menu principal File e no menu do botão direito da entrada do modelo de componente no painel Projects.

Os dados salvos armazenados no Workspace consistem no modelo de componente de origem, definido no arquivo de Modelo de Componente (<Item><Revision>.CMPT).

Exemplo de modelo de componente definido, salvo de volta no Workspace.
Exemplo de modelo de componente definido, salvo de volta no Workspace.

Herdando um Modelo de Componente

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

Você pode usar um template de componente do tipo de componente raiz se o subtipo não tiver um template de componente vinculado. Ao criar uma hierarquia de tipos de componente, os subtipos de componente herdarão o template de componente atribuído ao tipo de componente raiz/pai.

O Editor de CMPT (Component Template)

Para acessar o editor de Component Template no Altium Designer, a extensão de software Component Template Editor deve estar instalada. Essa extensão é instalada com o Altium Designer por padrão. Ela pode ser instalada ou removida manualmente.

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

Definindo o Template

O Component Template Editor é essencialmente dividido em duas regiões principais, ilustradas na imagem a seguir e resumidas depois.

O Component Template Editor pode ser dividido, de forma geral, em duas regiões principais.
O Component Template Editor pode ser dividido, de forma geral, em duas regiões principais.

  1. Upper Region – para definir opções no nível do componente (ciclo de vida, nomenclatura e opções de pasta) para um componente que referencia o template.
  2. Lower Region – para definir os parâmetros a serem usados por um componente que referencia o template.

Especificando Opções do Componente

A metade superior do editor é dedicada à definição de valores padrão para as seguintes propriedades do componente:

  • Lifecycle Definition – escolha a definição de ciclo de vida a ser aplicada a um componente criado usando o template. O campo suspenso lista todas as definições configuradas para o Workspace e que são permitidas para uso por um componente.
  • Revision Naming – escolha o esquema de nomenclatura de revisão a ser aplicado a um componente criado usando o template. O campo suspenso lista todos os esquemas definidos para o Workspace e que são permitidos para uso por um componente.
Se a opção para controlar o uso de definições de ciclo de vida e esquemas de nomenclatura de revisão por tipo de conteúdo estiver habilitada para quaisquer definições/esquemas, e o tipo de conteúdo Component não estiver configurado para usar uma definição/esquema específico, então essa definição/esquema não estará disponível na lista suspensa aplicável.
  • Component Naming – use este campo para definir um Item Naming Scheme padrão para um componente criado usando o template, garantindo um ID exclusivo para o componente resultante no Workspace. A entrada aqui será usada como template para nomear automaticamente o componente (em seu campo associado Id (ao usar o Component Editor no modo Single Component Editing), ou no campo Item ID (ao usar o Component Editor no modo Batch Component Editing)). O software atribuirá automaticamente o próximo ID exclusivo disponível, com base nesse esquema, após verificar todo o Workspace e os identificadores do conteúdo existente. Um esquema padrão de nomeação de Item – CMP-{00000} – é fornecido, mas você pode, é claro, criar seu próprio esquema digitando-o no campo, garantindo que a parte variável esteja entre chaves (por exemplo, CMP-001-{0000}).
  • Default Folder – para especificar uma pasta padrão dentro do Workspace de destino na qual armazenar um componente salvo. Faça isso clicando no botão Choose para acessar a caixa de diálogo Choose Folder (uma versão do painel Explorer panel), de onde você pode navegar até uma pasta existente no Workspace e escolhê-la, ou criar uma nova instantaneamente.
Não há um campo para definir o Workspace de destino, pois ele será fixado para usar o mesmo Workspace em que reside a revisão do template de componente.

A opção Allow override para cada propriedade pode ser usada para controlar de forma independente se essa propriedade pode ser alterada (habilitada) ou não (desabilitada) pelo usuário ao definir um componente no Component editor.

Quando o template é referenciado, as entradas especificadas nesta região são usadas para preencher previamente os campos aplicáveis no Component Editor (quando disponíveis):

  • Single Component Editing mode – os campos Id e Folder, na área Advanced Settings da região Component.
  • Batch Component Editing mode – na guia Document Options da caixa de diálogo Document Options dialog e, consequentemente, os campos Item ID e FolderPath, na área Component da região de definições do componente.

Quando o template é referenciado, as entradas são usadas para preencher previamente os campos aplicáveis ao editar um componente no Component Editor no modo Single Component Editing (à esquerda) e no modo Batch Component Editing (à direita).
Quando o template é referenciado, as entradas são usadas para preencher previamente os campos aplicáveis ao editar um componente no Component Editor no modo Single Component Editing (à esquerda) e no modo Batch Component Editing (à direita).

Definindo Parâmetros

A metade inferior do editor é dedicada à definição e ao gerenciamento dos parâmetros que ficarão disponíveis para um componente que o referencia.

Exemplo de parâmetros definidos em um template de componente.
Exemplo de parâmetros definidos em um template de componente.

Parâmetros de Sistema Padrão

Vários parâmetros de sistema são incluídos por padrão ao criar um novo template de componente, conforme ilustrado na imagem a seguir e detalhado depois.

Parâmetros padrão em nível de sistema incluídos em um template de componente recém-criado.
Parâmetros padrão em nível de sistema incluídos em um template de componente recém-criado.

  • ComponentType – este parâmetro permite especificar o tipo de componente. Isso facilita pesquisas direcionadas por meio do poderoso recurso de Search facility do Workspace – um recurso que não apenas permite pesquisar por tipo de componente, mas também pesquisar de forma mais inteligente, com suporte a unit-aware component parameters. Ao navegar pelos componentes do seu próprio Workspace usando o painel Components panel, o agrupamento Categories dos componentes é derivado dos parâmetros ComponentType associados a cada componente. Clique no campo Default Value associado e, em seguida, clique no botão para acessar a caixa de diálogo Choose component type. Use-a para selecionar o tipo de componente necessário e clique em OK – o tipo escolhido será inserido como valor do parâmetro ComponentType, de volta na grade principal de parâmetros.

    A caixa de diálogo Choose component type reflete o conjunto de tipos de componente definidos na página Data Management – Component Types page da caixa de diálogo Preferences. Clique no botão na parte inferior da caixa de diálogo Choose component type para acessar essa página de preferências, a partir da qual você pode ajustar essa lista para atender melhor às suas necessidades – adicionando novos tipos e subtipos ou editando e removendo tipos existentes.

    Exemplo de Component Template, com o parâmetro de sistema ComponentType definido como Diodes.
    Exemplo de Component Template, com o parâmetro de sistema ComponentType definido como Diodes.

    O tipo de dado desse parâmetro é definido como ComponentType e não pode ser modificado. Além disso, o parâmetro ComponentType não pode ser copiado nem removido. Selecione a célula e use a tecla Delete para limpar o valor.
  • SCHLIB e PCBLIB – esses dois parâmetros permitem especificar modelos padrão de símbolo e footprint, respectivamente. Clique no campo Default Value associado a cada parâmetro e, em seguida, clique no botão para acessar uma caixa de diálogo na qual você pode escolher o modelo necessário.

    Observe que o que você está escolhendo é o modelo, e não uma revisão específica desse modelo. Dessa forma, um componente que usa o template sempre utilizará a revisão mais recente do modelo escolhido.

    Especifique modelos de símbolo e footprint como parte do seu template.
    Especifique modelos de símbolo e footprint como parte do seu template.

    Os tipos de dado desses parâmetros são definidos como SCHLIB e PCBLIB, respectivamente, e não podem ser modificados. Além disso, os parâmetros de modelo não podem ser copiados nem removidos. Selecione a célula e use a tecla Delete para limpar o valor.
  • Name e Description – esses dois parâmetros permitem definir, respectivamente, o nome e a descrição do componente. Insira as strings necessárias no campo Default Value associado a cada parâmetro.

    Especifique os parâmetros Name e Description como parte do seu template.
    Especifique os parâmetros Name e Description como parte do seu template.

    O tipo de dado de ambos esses parâmetros é definido como Text e não pode ser modificado. Além disso, esses parâmetros não podem ser copiados nem removidos.

Adicionando um Novo Parâmetro de Usuário

Para adicionar um novo parâmetro de usuário à lista, clique no botão (ou use o comando Add no menu de contexto do botão direito) – o parâmetro é adicionado ao final da lista atual.

Exemplo de adição de um novo parâmetro de usuário ao template.
Exemplo de adição de um novo parâmetro de usuário ao template.

Cada parâmetro é apresentado na grade em termos das seguintes informações:

  • Name – use este campo para nomear o parâmetro, normalmente com um nome significativo que indique sua finalidade. Quando adicionados inicialmente, os parâmetros receberão nomes padrão (Parameter, Parameter 1, Parameter 2 e assim por diante).
  • Type – o tipo do parâmetro. Essa entrada será inicialmente definida como Text, mas há suporte a uma variedade de unit-aware data types, bem como ao tipo PCBLIB, que facilita a definition of multiple footprints, e a HarnessWiring, que facilita a definição de um harness wiring component. Tipos de parâmetro definidos por dicionários disponíveis também são suportados – saiba mais.
  • Visible – habilite esta opção (que é o estado padrão para um parâmetro recém-adicionado) para que a opção correspondente Show do parâmetro fique habilitada ao editar um ou mais componentes no Component Editor (configurado no modo Batch Component Editing). Isso, por sua vez, controla a exibição da coluna correspondente a esse parâmetro na região inferior do Component Editor, onde as próprias definições do componente são definidas. Essa propriedade não tem efeito ao definir um componente usando o modo Single Component Editing do editor.
  • Read Only – habilite esta opção para tornar o parâmetro somente leitura. Ao editar um componente que referencia o template, o valor do parâmetro ficará não editável.
  • Required – habilite esta opção para tornar o parâmetro um 'parâmetro obrigatório'. Ao editar um componente que referencia o template, o parâmetro deve ter um valor definido; caso contrário, não será possível salvar o componente. No Editor de Componentes, esse tipo de parâmetro é identificado pela célula de valor com uma borda vermelha (no modo Batch Component Editing) ou contendo o ícone (no modo Single Component Editing), quando nenhum valor tiver sido inserido.
  • Default Value – use este campo para inserir um valor padrão para o parâmetro.

    • Se o parâmetro estiver marcado como obrigatório (opção Required habilitada) e também estiver definido como somente leitura (opção Read Only habilitada), então um valor padrão MUST ser inserido. Caso contrário, ao editar um componente que referencia o template, o parâmetro será sinalizado como sem valor, mas isso não poderá ser resolvido porque o parâmetro não é editável por ser somente leitura. Uma nova revisão deste template de componente não poderá ser salva no Workspace até que isso seja resolvido.
    • Ao editar uma revisão de um componente, um parâmetro existente definido pelo usuário que tenha o mesmo nome de um parâmetro no template de componente vinculado será substituído pela versão do template. Qualquer valor existente para esse parâmetro será mantido (e não será sobrescrito pelo valor padrão no template).
    • Um modelo padrão de fiação de chicote só pode ser adicionado quando nenhum outro modelo padrão (SCHLIB ou PCBLIB) tiver sido adicionado ao template. E vice-versa, modelos padrão SCHLIB e PCBLIB não podem ser adicionados quando um modelo padrão de fiação de chicote tiver sido adicionado ao template.
  • Description – adicione qualquer descrição para o parâmetro, por exemplo, uma observação concisa sobre o que ele fornece. Se um parâmetro no template tiver uma descrição definida, então a coluna Description será apresentada na região Parameters do Editor de Componentes em seu Single Component Editing, de acordo.

A lista de parâmetros também suporta ações simples de copiar e colar, permitindo duplicar um ou mais parâmetros de usuário existentes. O(s) parâmetro(s) colado(s) será(ão) adicionado(s) ao final da lista.

Atalhos padrão de copiar (Ctrl+C) e colar (Ctrl+V) são suportados, e esses comandos também estão disponíveis no menu de clique com o botão direito. Vários parâmetros de usuário podem ser selecionados para operações de copiar e colar, usando as técnicas padrão de Ctrl+Click e Shift+Click.
Para excluir um ou mais parâmetros de usuário da lista, selecione cada parâmetro, depois clique no botão ou use o comando Remove no menu de contexto do clique com o botão direito.

Tipos de Dados de Parâmetros de Componentes Sensíveis a Unidade

O Editor de Template de Componentes fornece a capacidade de definir tipos de dados explícitos para parâmetros de componentes definidos em um template de componente (*.CMPT). Além disso, esses tipos de dados são sensíveis a unidade, com suporte a uma variedade de prefixos de unidade populares. Assim, você pode inserir o valor de um parâmetro em vários formatos — como 2.2k, 2k2, 4M, 2.5GHz — com o Workspace tendo a inteligência necessária para reconhecer o valor numérico por trás dessas entradas.

Esse recurso de um template de componente facilita pesquisas direcionadas por meio do recurso Advanced Search facility do servidor — um recurso que não apenas permite pesquisar por tipo de componente, mas também pesquisar de forma mais inteligente, com pesquisas por faixa. Usando o poder dos parâmetros de componentes sensíveis a unidade, você pode definir rapidamente uma pesquisa para, por exemplo, encontrar todos os capacitores com capacitância entre 47uF e 220uF.

Parâmetros sensíveis a unidade também são usados para filtragem inteligente ao pesquisar seus próprios componentes usando o painel Components panel.

Use as seções recolhíveis a seguir para saber mais sobre parâmetros sensíveis a unidade.

Tipos de Dados de Parâmetro Definidos por Dicionário

Dicionários são tipos de parâmetro personalizados com vários valores definidos. Os dicionários são gerenciados por administradores do Workspace na página Settings – Vault – Dictionaries da interface do navegador do Workspace, que pode ser acessada a partir do Component Template Editor escolhendo a opção Add New Dictionary no menu suspenso Type ou clicando no controle Manage Dictionaries no canto superior direito da região Parameters.

  • A página Settings – Vault – Dictionaries também pode ser acessada pela página Data Management – Dictionaries da caixa de diálogo Preferences, clicando no controle Manage Dictionaries, e pela página Data Management – Servers da caixa de diálogo Preferences, clicando no controle Properties do Workspace ativo ou de um Workspace conhecido e selecionando a entrada Dictionaries no menu.

  • Quando um tipo definido por dicionário é selecionado para um parâmetro, a página Settings – Vault – Dictionaries também pode ser acessada clicando dentro da célula do parâmetro na coluna Type e, em seguida, clicando no botão  ().

Acesse a página para gerenciar dicionários na interface do navegador do Workspace a partir do Component Template Editor.
Acesse a página para gerenciar dicionários na interface do navegador do Workspace a partir do Component Template Editor.

Saiba mais sobre o gerenciamento de dicionários pela interface do navegador do Workspace (Altium 365 Workspace, Enterprise Server Workspace).

Os dicionários definidos estão disponíveis como tipos de parâmetro no menu suspenso Type.

Selecione um tipo de parâmetro definido por dicionário no menu suspenso Type.
Selecione um tipo de parâmetro definido por dicionário no menu suspenso Type.

Os valores definidos para o tipo selecionado definido por dicionário estão disponíveis no menu suspenso Default Value. Selecione um valor necessário para usar como padrão do parâmetro ou selecione <None>.

Selecione um valor padrão entre aqueles definidos para o tipo selecionado definido por dicionário.
Selecione um valor padrão entre aqueles definidos para o tipo selecionado definido por dicionário.

  • Os valores padrão são validados ao salvar o template de componente no Workspace. Se o valor padrão se tornar inconsistente com o dicionário (por exemplo, o valor foi removido do dicionário e depois o template que usa esse valor foi aberto para edição), esse valor padrão será destacado em vermelho na coluna Default Value, e uma mensagem de erro será exibida no painel Messages ao tentar salvar o template de volta no Workspace.

  • Se o valor de um parâmetro de componente se tornar inconsistente com o dicionário (por exemplo, o tipo desse parâmetro foi alterado de Text para um tipo definido por dicionário no template de componente, e o valor atual do componente não corresponde a nenhum valor do tipo definido por dicionário selecionado), esse parâmetro será destacado ao editar o componente no Component Editor: um ícone de ponto de exclamação será exibido ao lado do valor inconsistente do parâmetro ao editar o componente no modo Single Component Editing do editor, e o valor do parâmetro será destacado em vermelho ao editar o componente no modo Batch Component Editing do editor. Certifique-se de que todos os parâmetros do componente sejam consistentes com os valores do template; caso contrário, você não poderá salvar o componente para a próxima revisão.

  • Se os dicionários tiverem sido alterados na interface do navegador do Workspace conectado, você precisará se desconectar e se reconectar ao Workspace para que essas alterações sejam refletidas no Altium Designer. Consulte a página Accessing Your Workspace para saber mais.

Definindo Múltiplos Footprints

O Component Template Editor também oferece suporte para definir múltiplos footprints de PCB como parte de um template de componente. Qualquer número de links de modelo de footprint pode ser especificado, e isso será um recurso bem-vindo para quem deseja criar componentes que façam referência a 3 footprints, atendendo aos requisitos IPC para diferentes níveis de densidade: L (menor, ou cobre mínimo), M (maior, ou cobre máximo) e N (nominal, ou cobre médio).

Para adicionar uma definição adicional de modelo de footprint ao template, clique em para adicionar um novo parâmetro e, em seguida, escolha a entrada PCBLIB no menu suspenso associado ao campo Type.

Transforme um parâmetro recém-adicionado em uma definição de modelo de footprint configurando seu Type como PCBLIB.
Transforme um parâmetro recém-adicionado em uma definição de modelo de footprint configurando seu Type como PCBLIB.

O nome do parâmetro mudará de Parameter para PCBLIB n, em que n é o próximo número inteiro disponível para distinguir entre múltiplos modelos de footprint (por exemplo, PCBLIB 1, PCBLIB 2 e assim por diante). O modelo padrão será aquele associado à entrada PCBLIB. Quando os Footprints forem trazidos para o Component Editor, ao definir um componente, o modelo Footprint padrão será identificado pelo ícone no canto superior esquerdo da janela de visualização do modelo (quando em modo Single Component Editing) e pela entrada PCBLIB (default) na região Required Models/Parameters (quando em modo Batch Component Editing).

Um exemplo de componente definido no Component Editor (modo Single Component Editing), usando um Component Template referenciado. O template tem três modelos de footprint definidos, que são trazidos para a definição do componente. Observe que a entrada de modelo PCBLIB no template é usada como o modelo de footprint padrão (identificado por um ícone no canto superior esquerdo) ao definir o componente. Passe o mouse sobre a imagem para ver o mesmo componente sendo definido com o Component Editor no modo Batch Component Editing. Nesse caso, o footprint padrão é chamado de PCBLIB (default).
Um exemplo de componente definido no Component Editor (modo Single Component Editing), usando um Component Template referenciado. O template tem três modelos de footprint definidos, que são trazidos para a definição do componente. Observe que a entrada de modelo PCBLIB no template é usada como o modelo de footprint padrão (identificado por um ícone no canto superior esquerdo) ao definir o componente. Passe o mouse sobre a imagem para ver o mesmo componente sendo definido com o Component Editor no modo Batch Component Editing. Nesse caso, o footprint padrão é chamado de PCBLIB (default).

Importação e Exportação de Component Template

Um arquivo de template de componente existente (*.CMPT) ou um arquivo de biblioteca de componentes (*.CMPLIB) pode ser importado para o editor de template de componente, e o template de componente em edição pode ser exportado para um arquivo de template de componente (*.CMPT). Use os comandos File » Import » Component TemplateFile » Import » Component Library e File » Export do menu principal do editor de componentes para selecionar a ação desejada e a caixa de diálogo padrão do Windows que se abre para navegar até o local necessário e selecionar um arquivo para importar ou definir o nome do arquivo que será exportado.

Reutilizando um Component Template

O uso de uma revisão de um template de componente — ou melhor, a referência a uma a partir da revisão de um componente que você está editando no momento — pode ser realizado das seguintes maneiras.

Um componente só pode referenciar um template de componente por vez.

Ao Criar um Novo Componente

Ao criar um novo componente usando o comando File » New » Component nos menus principais, você pode escolher o template na caixa de diálogo Create new component.

Vinculando rapidamente um template de componente a partir de uma lista de todos os templates disponíveis, ao criar um novo componente.
Vinculando rapidamente um template de componente a partir de uma lista de todos os templates disponíveis, ao criar um novo componente.

Manualmente de Dentro do Component Editor

A reutilização de uma revisão de um template de componente a partir do Component Editor depende do modo de operação do Editor.

No Modo Single Component Editing

Ao editar um único componente nesse modo do Component Editor, escolha o Component Template necessário no menu suspenso associado ao campo Template — parte do agrupamento Advanced Settings, na região Component do Editor. Todos os templates de componente atualmente disponíveis no mesmo Workspace em que o próprio componente reside são listados — por nome — com suas revisões mais recentes indicadas entre parênteses. Escolha o template necessário para aplicá-lo.

Vinculando rapidamente um template de componente a partir de um menu com todos os templates disponíveis, ao editar a revisão de um componente usando o Component Editor em seu modo Single Component Editing.
Vinculando rapidamente um template de componente a partir de um menu com todos os templates disponíveis, ao editar a revisão de um componente usando o Component Editor em seu modo Single Component Editing.

No Modo Batch Component Editing

Há duas maneiras de “ligar” uma revisão de um Component Template à revisão do componente que está sendo editada no momento:

  • Na aba Template da caixa de diálogo Document Options (Edit » Document Options). Clique no botão Choose à direita do campo Item Revision. Isso dá acesso à caixa de diálogo Choose Item (uma encarnação do painel Explorer). Use essa caixa de diálogo para navegar até a revisão do template de componente desejado e selecioná-la. Após clicar em OK, será criado um link entre a revisão do componente e a revisão de destino do template de componente. A evidência desse link pode ser vista de volta na aba Template da caixa de diálogo Document Options.

    Vinculando manualmente um componente a uma revisão de um template de componente no Workspace de destino.
    Vinculando manualmente um componente a uma revisão de um template de componente no Workspace de destino.

    O template de componente em uso pode ser alterado a qualquer momento — clique em Choose e selecione uma revisão de um template de componente diferente.
    O status da revisão do Item de Component Template vinculado é refletido na aba Template da caixa de diálogo Document Options. Se uma revisão mais recente do Item vinculado estiver disponível, clique no botão para usar essa revisão mais recente.
  • A partir do menu Add associado à região Required Models/Parameters do Editor de Componentes. O submenu Templates lista todos os templates de componente – por nome – atualmente disponíveis no mesmo Workspace em que o próprio componente está localizado, com suas revisões mais recentes indicadas entre colchetes. Clique em uma entrada para criar um vínculo com a revisão mais recente desse template de componente. Mais uma vez, a verificação do vínculo pode ser vista na aba Templates da caixa de diálogo Document Options.

    Vinculando rapidamente um template de componente a partir de um menu com todos os templates disponíveis.
    Vinculando rapidamente um template de componente a partir de um menu com todos os templates disponíveis.

Herdado da pasta Components do Workspace

Você pode especificar um template de componente para ser usado automaticamente em todos os componentes (e respectivas revisões) armazenados em uma pasta Components dentro do Workspace.

Um template de componente padrão só pode ser definido para uma pasta do tipo Components.

Especifique o template necessário usando o campo Component Template, ao definir as propriedades da pasta, na caixa de diálogo Edit Folder dialog. A lista suspensa associada ao campo relaciona todos os templates de componente – por nome – atualmente disponíveis no mesmo Workspace em que a própria pasta Components está localizada, com suas revisões mais recentes indicadas entre colchetes. Escolha uma entrada para criar um vínculo com a revisão mais recente desse template de componente para cada componente subsequente criado dentro dessa pasta.

Especifique um template de componente padrão, a ser aplicado a todos os componentes criados dentro da pasta Components pai.
Especifique um template de componente padrão, a ser aplicado a todos os componentes criados dentro da pasta Components pai.

Para não usar esse recurso, deixe/defina o campo Component Template como None.

Se um Template de Componente for escolhido no nível da pasta, esse mesmo template será usado por padrão quando componentes forem criados nas subpastas filhas abaixo. Isso facilita a herança rápida do template para todos os componentes nas pastas filhas.

Quando uma revisão de um componente for salva no Workspace, ela essencialmente fixará a revisão específica do Template de Componente usado, criando um vínculo forte com essa revisão, a menos que seja alterado manualmente.

Impacto nos modelos e parâmetros do componente ao usar um Template de Componente

Ao editar uma revisão de um componente, e uma revisão de um template de componente estiver vinculada/referenciada, o seguinte acontece no Editor de Componentes com relação a modelos e parâmetros:

  • Os modelos definidos no template referenciado são adicionados à região Models (modo Single Component Editing) e à região Model Links (modo Batch Component Editing).
  • Um modelo referenciado existente será mantido, e o componente continuará usando esse modelo, a menos que seja alterado manualmente de propósito.
  • Os parâmetros definidos no template referenciado são adicionados à região Parameters (modo Single Component Editing) e à região Required Models/Parameters (modo Batch Component Editing).

    Exemplo de parâmetros após a vinculação a uma revisão de um template de componente, usando o Editor de Componentes no modo Single Component Editing (à esquerda) e no modo Batch Component Editing (à direita).
    Exemplo de parâmetros após a vinculação a uma revisão de um template de componente, usando o Editor de Componentes no modo Single Component Editing (à esquerda) e no modo Batch Component Editing (à direita).

    Todos os parâmetros originados do template de componente referenciado são identificados pelo uso do ícone (modo Single Component Editing) e do ícone (modo Batch Component Editing). Além disso, e somente para o modo Batch Component Editing, a opção Show para cada parâmetro baseado em template segue o estado da opção Visible correspondente no template.
    Parâmetros baseados em template não podem ser removidos.
    Você pode adicionar parâmetros de usuário adicionais conforme necessário.
  • Somente no modo Batch Component Editing, os parâmetros baseados em template configurados para serem exibidos são agrupados na área de definições do componente do editor, com Template Parameters usado como texto do cabeçalho.

    Aparência de parâmetros de exemplo baseados em template na área onde as próprias definições do componente são definidas, ao usar o Editor de Componentes em seu modo Batch Component Editing.
    Aparência de parâmetros de exemplo baseados em template na área onde as próprias definições do componente são definidas, ao usar o Editor de Componentes em seu modo Batch Component Editing.

  • Os campos de valor dos parâmetros baseados em template que tiverem sido marcados como somente leitura não poderão ser editados. Para todos os demais parâmetros baseados em template que não tiverem sido marcados como somente leitura, você poderá alterar os valores conforme necessário.

    Com o Editor de Componentes no modo Single Component Editing, um parâmetro de template somente leitura é identificado na região Parameters pelo uso do ícone .
  • Se um parâmetro baseado em template tiver sido marcado como obrigatório, mas não tiver recebido um valor no template, seu campo de valor aparecerá com uma borda vermelha (no modo Batch Component Editing) ou contendo o ícone (no modo Single Component Editing), alertando você para o fato de que um valor é necessário para esse parâmetro. Você não poderá salvar um componente no Workspace até que valores sejam definidos para todos os parâmetros obrigatórios.

    Com o Editor de Componentes no modo Single Component Editing, um parâmetro de template obrigatório é identificado na região Parameters pelo uso do ícone .

Salvando novamente um Template de Componente

Em qualquer estágio, você pode voltar a qualquer revisão de um template de componente no Workspace e editá-la diretamente. Clique com o botão direito na revisão e escolha o comando Edit no menu de contexto. Mais uma vez, o editor temporário será aberto, com o template contido na revisão aberto para edição. Faça as alterações conforme necessário e, em seguida, salve o template de componente na próxima revisão do Item.

Clicar com o botão direito na entrada de nível superior do próprio template de componente editará a revisão mais recente desse template.

Acessando o comando para iniciar a edição direta de uma revisão existente de um template de componente.
Acessando o comando para iniciar a edição direta de uma revisão existente de um template de componente.

Baixando dados salvos

Baixe os dados armazenados em uma revisão de um template de componente clicando com o botão direito nessa revisão (no painel Explorer) e escolhendo o comando Operations » Download no menu de contexto. O arquivo do template de componente será baixado para uma subpasta dentro do diretório escolhido, nomeada usando o ID da revisão do Item. O arquivo pode ser encontrado na pasta Released dentro dela.

Acesse o comando Download a partir da entrada de nível superior do próprio template de componente para baixar o arquivo do template de componente armazenado na revisão mais recente desse template.
Clique no botão Explore na caixa de diálogo Download from Server para navegar rapidamente até a pasta de download.

Exclusão reversível

Quando conectado a um Workspace, está disponível uma funcionalidade flexível para remover um template de componente diretamente de dentro do Altium Designer, no painel Explorer panel. Clique com o botão direito na entrada do template de componente no painel e escolha o comando Delete Item no menu de contexto. A caixa de diálogo Delete Items será exibida para confirmar a exclusão. A ação é, na verdade, uma "exclusão reversível", pela qual o template de componente será movido para a área Trash do Workspace. A Trash é essencialmente uma lixeira para a qual qualquer conteúdo dentro do seu Workspace pode ser movido (por meio de uma ação de exclusão reversível). Ela fica isolada do restante do Workspace.

Com o recurso de exclusão reversível, você pode excluir um template de componente que esteja sendo usado no momento.
Vários templates de componente podem ser excluídos em uma única ação. Selecione todos os templates de componente necessários usando os controles padrão de multisseleção (Shift+Click, Ctrl+Click) e, em seguida, clique com o botão direito e escolha o comando Delete Items no menu de contexto.

Exclusão reversível de um template de componente. O template será movido para a área Trash do Workspace.
Exclusão reversível de um template de componente. O template será movido para a área Trash do Workspace.

Para prosseguir com a exclusão, clique no botão . O item será removido e uma caixa de diálogo Deletion Summary confirmará a exclusão bem-sucedida. Se houver algum problema com a exclusão, isso será sinalizado para você.

Todo o conteúdo excluído dessa maneira pode ser encontrado na página Trash da interface do navegador do Workspace. Observe que você só pode visualizar o conteúdo que excluiu reversivelmente pessoalmente. Os administradores poderão ver todo o conteúdo da página Trash – ou seja, todo o conteúdo que foi excluído reversivelmente.

Aspectos a considerar em relação a um template de componente excluído reversivelmente:

  • O template de componente não estará disponível no seu software de projeto nem na interface Web.
  • Em qualquer lugar em que o template de componente estivesse sendo usado, será refletido que ele foi excluído.
  • Um template de componente pode ser restaurado ou excluído permanentemente da página Trash, desde que você tenha direitos de edição. A exclusão permanente só é possível desde que ele não esteja sendo usado por um Item pai.
Observe que, se você tiver excluído reversivelmente um template de componente – movendo-o para a Trash – poderá criar novamente um novo template de componente com esse mesmo nome. Se posteriormente você restaurar o template de componente original e o nome original já estiver em uso, será usado um sufixo inteiro para manter seu nome exclusivo dentro do Workspace.
AI-LocalizedLocalizado por IA
Caso encontre um problema, selecione o texto/imagem e primaCtrl + Enterpara nos enviar o seu feedback.
Disponibilidade de Funcionalidades

As funcionalidades disponíveis dependem da solução Altium que possui – Altium Develop, uma edição do Altium Agile (Agile Teams ou Agile Enterprise), ou Altium Designer (com subscrição ativa).

Se não encontrar uma funcionalidade mencionada no seu software, contacte a equipa 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.

Conteúdo