Trabalhar com Snippets

A funcionalidade snippets permite-lhe guardar qualquer seleção de circuitaria numa única folha esquemática ou circuitaria num design PCB, incluindo os componentes e o encaminhamento, e depois reutilizá-la em qualquer design. O painel Design Reuse permite-lhe aceder rapidamente a todos os controlos necessários para trabalhar com e gerir a sua coleção de snippets.

Criar um Snippet

Um novo snippet esquemático ou PCB pode ser criado a partir de uma circuitaria existente numa folha esquemática ou num documento PCB:

1. Selecione a circuitaria pretendida no editor esquemático ou PCB.

2. Selecione o comando Tools » Convert » Create Snippet from selected objects nos menus principais (no editor PCB, também pode clicar com o botão direito do rato na seleção e escolher Snippets » Create Snippet from selected objects no menu de contexto).

3. Será apresentada a caixa de diálogo New Schematic Snippet ou New PCB Snippet, na qual pode definir o Name, a Description, o destino de gravação (Save to – o Workspace ligado ou uma pasta local) e a pasta onde o novo snippet será guardado (Path).

   

   Clique no botão à direita do campo Path na caixa de diálogo para aceder à caixa de diálogo Choose Folder (ao guardar um snippet no Workspace) ou à caixa de diálogo Choose Snippet Folder (ao guardar um snippet numa pasta local), que lhe permite selecionar uma pasta existente onde o snippet será guardado ou criar uma nova pasta de imediato.

   • Na caixa de diálogo Choose Snippet Folder, clique em o botão e utilize a caixa de diálogo Folder Properties que se abre para adicionar uma nova subpasta à estrutura geral de pastas locais de snippets (). Na caixa de diálogo, pode especificar um nome para a nova pasta e determinar sob que pasta principal esta deve ser criada.

   • Para obter informações sobre como organizar snippets locais em pastas, consulte a secção Organizing Local Snippets abaixo.

4. Clique em na caixa de diálogo para guardar o snippet.

Pesquisar e Colocar um Snippet

Os snippets do Workspace e locais estão disponíveis para colocação a partir do painel Design Reuse.

• Quando o painel está definido para apresentar recursos do Workspace (), pode ser utilizado para aceder a snippets armazenados no Workspace ligado.

• Quando o painel está definido para apresentar recursos locais (), fornece acesso a snippets armazenados em pastas no seu disco rígido (as pastas são configuradas conforme descrito acima).

Pode navegar nas pastas do Workspace/locais para encontrar o snippet pretendido. Em alternativa, utilize o campo Search no topo do painel para procurar um snippet pelo seu nome ou descrição.

Clique no controlo Details na parte inferior do painel para expandir o painel Details, que apresenta detalhes do bloco de reutilização selecionado, incluindo:

• Nome do snippet.

• O ícone do estado do ciclo de vida e a revisão (apenas para um snippet do Workspace; clique na ligação para abrir a vista detalhada do Histórico do item Reuse Block com a revisão mais recente selecionada).

• Descrição do snippet.

• Informações gerais do snippet.

• Imagens de pré-visualização do snippet.

Antes de colocar um snippet, certifique-se de que tem aberto o documento de destino correto como documento ativo. O comando de colocação só funcionará se o snippet puder ser corretamente colocado nesse documento, ou seja, o tipo de snippet e o tipo de documento têm de ser os mesmos.

Para colocar um snippet, passe o cursor sobre a respetiva entrada no painel Design Reuse, clique no botão (ou clique com o botão direito do rato na entrada) e selecione o comando Place (para um snippet esquemático ou PCB) ou Place as Sheet Symbol (apenas para um snippet esquemático) no menu. Quando este último é selecionado, o snippet será colocado na folha esquemática ativa como um símbolo de folha. O símbolo de folha colocado incluirá entradas de folha correspondentes às portas no snippet. O conteúdo do snippet será colocado numa folha esquemática filha criada automaticamente e referenciada pelo símbolo de folha.

Organizar Snippets Locais

Os snippets locais podem ser organizados em pastas de snippets, para que snippets relacionados possam ser agrupados, facilitando a sua localização. As pastas de snippets são pastas Windows existentes que não podem ser criadas a partir do painel Design Reuse. Em vez disso, são “abertas” ou “fechadas” ao navegar pelos snippets locais que contêm. Estas pastas só podem ser criadas diretamente no seu disco rígido ou rede, fora do Altium Designer.

Quando o painel Design Reuse está definido para apresentar recursos locais (clique no ícone mais à esquerda na barra de endereço no topo do painel e selecione a entrada Local – o ícone será apresentado como ), as pastas de snippets podem ser abertas e fechadas a partir da caixa de diálogo Available Snippets Folders, acedida clicando no botão no canto superior direito do painel e selecionando o comando Snippet Folders no menu.

• Clique em para navegar até à pasta pretendida no seu disco rígido ou rede. A pasta selecionada será adicionada à lista na caixa de diálogo e aparecerá posteriormente no painel Design Reuse.

• Para remover uma pasta de snippets da lista (essencialmente fechando-a do ponto de vista da navegação), selecione a pasta na lista na caixa de diálogo Available Snippets Folders e, em seguida, clique em .

Editar um Snippet

Para editar um snippet do Workspace, passe o cursor sobre a respetiva entrada no painel Design Reuse, clique no botão (ou clique com o botão direito do rato na entrada) e selecione o comando Edit no menu. Será aberto um editor temporário, com o snippet de documento contido na revisão mais recente do item Snippet aberto para edição. Efetue as alterações necessárias e, em seguida, guarde o snippet na revisão seguinte do item (File » Save to Server).

Para editar o conteúdo de um snippet local, abra o documento <SCHSnippetName>.SchDoc ou <PCBSnippetName>.PcbDoc a partir da pasta Windows onde o snippet está armazenado (utilizando o comando File » Open nos menus principais do Altium Designer ou através do Windows Explorer), faça as alterações necessárias e, em seguida, guarde o documento (File » Save).

As propriedades de um snippet local (o respetivo nome, descrição e caminho) podem ser editadas através da caixa de diálogo Snippet Properties. Para aceder a esta caixa de diálogo,  passe o cursor sobre a respetiva entrada no painel Design Reuse e clique no botão (ou clique com o botão direito do rato na entrada) e selecione o comando Edit no menu de contexto. Utilize a caixa de diálogo para efetuar as alterações necessárias.

Outras Ações de Snippet

O menu do botão (e o menu do botão direito do rato) de uma entrada de snippet no painel Design Reuse também fornece acesso aos seguintes comandos:

• Move (apenas para um snippet do Workspace) – utilize para alterar a localização do item Snippet na estrutura de pastas do Workspace. Ao executar o comando, terá acesso à caixa de diálogo Move Item, na qual pode selecionar a pasta de destino onde o item deverá ser colocado.

• Share (apenas para um snippet do Workspace) – utilize para definir as permissões de partilha do snippet. Depois de selecionar o comando, será aberta a caixa de diálogo Share For Item, na qual pode configurar a partilha conforme necessário. Saiba mais sobre partilha ao nível do item.

• Operations (apenas para um snippet do Workspace) – utilize para aceder a um menu pendente de funções adicionais para snippets, conforme descrito abaixo.

  • Make a Copy – utilize para copiar o snippet. Será aberto um editor temporário do snippet, com o mesmo conteúdo do snippet original. Faça as alterações necessárias e guarde o snippet no Workspace. 

  • Change Revision State – utilize para alterar o estado de revisão da revisão mais recente do snippet. Após selecionar o comando, abre-se a caixa de diálogo Alteração de estado em lote, que lhe permite alterar o estado de revisão do snippet.

  • Download – utilize para transferir os dados armazenados no snippet. Os dados associados serão transferidos para uma subpasta dentro da diretoria escolhida, com o nome do ID da Revisão do Item. O ficheiro pode ser encontrado na(s) pasta(s) Released aí contida(s).

• Delete – utilize para eliminar o snippet.

  • Para um snippet do Workspace, será apresentada a caixa de diálogo Delete Items, na qual poderá confirmar a eliminação.

    A ação é, na verdade, uma "eliminação suave", através da qual o snippet será movido para a área Trash do Workspace. Saiba mais sobre eliminação suave.

  • Para um snippet local, será apresentada a caixa de diálogo Confirm para confirmar a eliminação. A ação removerá os ficheiros do snippet do disco rígido.

• History (apenas para um snippet do Workspace) – utilize para aceder a uma vista detalhada do snippet, aberta como uma nova vista em separador no Altium Designer.