Creating & Editing Content

Os Items são criados diretamente num Workspace ligado, e todos os dados necessários para fabricar/representar um Item ficam depois armazenados nesse Workspace, associados a esse número de Item. Dependendo do tipo de conteúdo, um Item pode ser criado manualmente ou automaticamente como parte de um processo de guardar/carregar/publicar. Todos os tipos de conteúdo podem ser criados no Altium Designer através do Explorer panel. Ao trabalhar com componentes, a criação também é possível através do Components panel.

Os Items são criados num Workspace ligado. A partir do Altium Designer, o painel Explorer fornece a interface completa para o seu Workspace.

Criar um Item

Depois de definir as pastas necessárias, pode avançar para a criação do conteúdo no Workspace. Para criar um Item, selecione a pasta apropriada, clique com o botão direito na região da grelha de Items do painel e escolha um dos comandos do submenu Create Item. Em alternativa, se a pasta estiver vazia, use o controlo Add an item no centro da região para aceder ao menu.

Clique com o botão direito na região da grelha de Items do painel Explorer para aceder aos comandos relacionados com a criação de conteúdo.

A caixa de diálogo Create New Item será apresentada, fornecendo todos os controlos necessários para definir totalmente o Item.

Especifique os detalhes do novo Item na caixa de diálogo Create New Item.

Para muitos tipos de conteúdo, tem a opção de editar e publicar o documento de projeto aplicável na revisão inicial desse conteúdo, após a criação. Para o fazer, ative a opção Open for editing after creation, na parte inferior da caixa de diálogo Create New Item (que está ativada por predefinição). O Item será criado e o editor temporário relevante será aberto, pronto para criar os dados para esse Item. Para mais informações sobre como trabalhar com um determinado tipo de conteúdo, leia a respetiva página dedicada, cuja ligação é fornecida na table.

Uma nota sobre o Item ID...

Um aspeto importante da pasta principal em que o conteúdo é criado é o Item Naming Scheme utilizado para a mesma. Isto define o formato do ID único para cada Item criado nessa pasta específica. Ao definir o Item Naming Scheme ao nível da pasta, o conteúdo pode ser criado rapidamente nessa pasta, respeitando ao mesmo tempo o esquema correto de nomenclatura de ID. Isto é especialmente importante quando os Items são criados automaticamente "on-the-fly", em vez de serem publicados em Items existentes que foram criados manualmente diretamente no Workspace de destino.

Estão disponíveis vários esquemas de exemplo predefinidos, utilizando o código abreviado para o tipo de pasta ou para o tipo de conteúdo (consulte a table anterior neste documento para obter uma lista de códigos). Ao usar um esquema de nomenclatura predefinido, o software atribuirá automaticamente o próximo ID único disponível, com base nesse esquema, depois de analisar todo o Workspace e os identificadores do conteúdo existente.

Em alternativa, caso exista a necessidade de ter controlo manual total sobre a nomenclatura de um Item, selecione a entrada [NO ITEM NAMING SCHEME]. Nesse caso, terá de ser definido um Identificador único para um Item como parte da sua criação. Tenha em atenção que o sistema não permitirá a criação de um Item com um identificador duplicado, pelo que a atribuição manual de um identificador requer conhecimento de quais os identificadores que já foram utilizados.

O Esquema de Nomenclatura de Itens da pasta principal é aplicado ao ID Único de cada Item criado nessa pasta.

Independentemente da definição de Item Naming Scheme ao nível da pasta, pode sempre substituir qualquer ID determinado automaticamente ao nível do Item. Modifique qualquer ID desse tipo conforme necessário, através da caixa de diálogo Create New Item.

Escolher um Esquema para IDs de Itens

Existe um número infinito de possíveis esquemas de nomes/numeração que podem ser utilizados para Itens; os mostrados nas imagens da documentação são apenas exemplos. Existem inúmeras discussões que pode ler sobre qual o melhor esquema de numeração a utilizar. Em geral, os especialistas concordam que um esquema de numeração curto, não significativo e apenas numérico é o melhor. Não significativo significa que não existe informação codificada no esquema de numeração, tal como a categoria do produto, subcategoria, localização, etc.; a cada novo Item é simplesmente atribuído o número seguinte da sequência.

O comprimento é importante porque, quanto mais longo for o identificador, maior é a probabilidade de um humano cometer um erro ao registar ou recordar o ID do Item. A experiência e os estudos académicos demonstraram que os erros de introdução de dados aumentam à medida que o número de caracteres aumenta. Acredita-se que sete dígitos é o número mágico em termos de fácil e fiável memorização por um humano. Para além de um certo comprimento, os erros aumentam a um ritmo crescente – aos 15 caracteres, a probabilidade de erro aproxima-se dos 100%.

Se for importante na sua organização criar identidade no ID do Item, então um identificador composto poderá ser a resposta. Neste caso, recomenda-se um código de prefixo de mercadoria alfanumérico simples. Por exemplo, considere o ID D-820-0001. Aqui, o D no código pode denotar Design, significando que este é um Item utilizado para designs. Nos 3 dígitos seguintes, o primeiro dígito pode denotar a categoria do produto, como por exemplo Peripheral Boards; o segundo e terceiro dígitos no bloco de três podem ser usados para denotar placas nuas (1X) ou assemblies (2X em diante). Os quatro dígitos finais no ID do Item são um número simples, não significativo, do tipo seguinte-na-fila.

Definir o ID da Revisão Inicial de um Item de Workspace

Mudar de um paradigma de design local para um paradigma de Workspace requer a migração dos dados existentes para um Workspace. Esses dados podem muito bem ter passado por múltiplas iterações e ter numeração de revisão atribuída que é reconhecida em toda a organização. Por exemplo, a rev.3 de uma placa Magno-Synthetic Digitizer pode muito bem já ter sido entregue, com melhorias a serem disponibilizadas na rev.4. Ao libertar para o Workspace, ter uma revisão inicial que recomeçasse em 1 seria, no mínimo, confuso – não apenas dentro da organização mas, mais importante ainda, para a sua base de clientes (que está à espera de uma versão posterior à sua rev.3 atual!).

Para esse fim, o Altium Designer disponibiliza a possibilidade de definir manualmente o ID da revisão inicial de um Item recém-criado num Workspace.

Definir o ID da Revisão Inicial

Crie o novo Item necessário no Workspace como habitualmente. Após a criação, clique com o botão direito do rato no Item e escolha Properties – obtendo acesso à caixa de diálogo Edit Item. Expanda a região Advanced da caixa de diálogo e clique no botão , à direita do campo Revision ID. Surgirá a caixa de diálogo Set Initial revision Id values, a partir da qual pode definir o ID de acordo com os seus requisitos. Serão disponibilizados campos, conforme aplicável, para modificar os vários níveis do ID, em conformidade com o Esquema de Nomenclatura de Revisão escolhido.

Para aceder aos Itens relacionados com o projeto (PCB Fabrication Data, PCB Assembly Data, PCB Project Design) no painel Explorer, certifique-se de que está a visualizar um projeto no seu Classic View. Poderá ter de mudar manualmente a partir de Project View – estão disponíveis comandos no menu associado ao botão , no canto superior direito do painel.

Defina os vários níveis do ID (conforme aplicável ao Esquema de Nomenclatura de Revisão utilizado).

Criar e Editar Conteúdo Diretamente através de um Workspace

O seu Workspace ligado fornece um método flexível e seguro para centralizar o armazenamento e a gestão de todos os tipos de dados de design utilizados no Altium Designer. Desde o modelo esquemático ao componente, desde folhas esquemáticas geridas até designs PCB concluídos, o Workspace oferece um método ideal para armazenar e gerir os seus dados de design eletrónico.

Um aspeto poderoso de um Workspace é o seu suporte para Direct Editing. O que significa exatamente isso, “Edição Direta”? Significa que pode clicar com o botão direito do rato num modelo, ou num componente, ou até mesmo numa folha gerida no Workspace e selecionar Edit. Sim, é aberto um ficheiro no Altium Designer pronto para editar – aberto num editor temporário – mas quando terminar, basta guardá-lo de volta no Workspace. Quanto ao ficheiro que acabou de editar, não precisa de se preocupar com ele, já não é necessário, uma vez que as suas edições são armazenadas com segurança de volta no Workspace, pelo que é destruído e a instância do editor temporário é fechada.

A edição direta liberta-o das limitações de dados de origem separados e controlados por versão. Pode simplesmente editar um tipo de Item suportado utilizando um editor temporário carregado com a origem mais recente diretamente do próprio Workspace. E, uma vez concluída a edição, a entidade é libertada (ou novamente libertada) para uma revisão planeada subsequente do seu Item principal, e o editor temporário é fechado. Não existem ficheiros no seu disco rígido, não há dúvidas sobre se está a trabalhar com a origem correta ou mais recente, e não há necessidade de manter software de controlo de versões separado. O Workspace trata de tudo com grande integridade e de uma forma que acelera significativamente as alterações aos seus dados.

Tipos de Conteúdo Suportados para Edição Direta

Os seguintes tipos de conteúdo do Workspace são suportados no que respeita à Edição Direta:

• Componente

• Modelo de Componente

• Modelo de Documento Draftsman

• Modelo de Folha Draftsman

• Footprint

• Cablagem de Arnês

• Empilhamento de Camadas

• Folha Esquemática Gerida

• Outputjob

• Excerto PCB

• Modelo de Projeto

• Bloco de Reutilização

• Excerto Esquemático

• Modelo Esquemático

• Modelo de Simulação

• Símbolo

Editar a Revisão Inicial de um Item

A partir do painel Explorer panel, quando cria um Item de um dos tipos de conteúdo suportados, tem a opção de editar e libertar a entidade de dados associada para a revisão inicial desse item, após a criação. Assim, em vez de criar os dados de origem fora do Workspace e libertá-los, pode começar a trabalhar na origem diretamente a partir do momento em que o Item vazio é criado, graças à edição direta. E quando essa edição estiver concluída, a entidade é libertada para a revisão inicial planeada do seu Item principal, e o editor temporário é fechado.

Para tirar partido desta funcionalidade, ative a opção Open for editing after creation, encontrada na parte inferior da caixa de diálogo Create Item dialog. Antecipando a utilidade desta funcionalidade, a opção está ativada por predefinição. O Item será criado e o editor temporário relevante abrir-se-á, apresentando o documento relevante como documento ativo na janela principal de design. Este documento será nomeado de acordo com o Item-Revisão, no formato: <Item>-<Revision>.<DocumentExtension>.

A imagem abaixo mostra isto em ação para a criação de um novo Symbol Item (SYM-001-0031). É aberto um editor temporário de Schematic Symbol, apresentando um documento para definir o símbolo conforme necessário.

Exemplo de edição da revisão inicial de um Symbol Item, diretamente a partir do Workspace – o editor temporário de Schematic Symbol fornece o documento com o qual pode definir o seu símbolo esquemático.

Controlos de Edição Direta

Existem três controlos relevantes na edição direta, prontamente disponíveis na Quick Access Bar (no canto superior esquerdo da janela principal da aplicação), ou na barra de ferramentas Standard do editor temporário ativo (quando disponível):

• ​ – Save Active Document. Utilize este botão para guardar quaisquer alterações feitas ao documento. Isto permite-lhe guardar as alterações atuais se pretender voltar mais tarde para efetuar mais alterações antes de, por fim, libertar para o Workspace.

• / – Save to Server. Utilize este botão para libertar (na prática, guardar e libertar) o documento para o Workspace, armazenando-o na revisão inicial (planeada) ou na revisão seguinte do Item de destino. Será apresentada a caixa de diálogo Create Revision dialog (ou Edit Revision dialog), na qual pode alterar o Nome e a Descrição, e adicionar notas de libertação conforme necessário. O documento e o editor serão fechados após a libertação.

  Quando aplicável e se assim o pretender, as revisões dos itens principais relacionados com (que referenciam) a revisão atual do item que está a ser guardado também podem ser atualizadas. Isto é controlado pela opção Update items related to <ItemRevision> , que está ativada por predefinição. Tenha em atenção que esta opção só é apresentada quando:

  • é criada uma nova revisão de um modelo de domínio (símbolos, footprints, modelos de simulação, modelos de cablagem de harness) referenciado por revisões de itens de componente.

  • é criada uma nova revisão de um modelo de componente referenciado por revisões de itens de componente.

  • é criada uma nova revisão de um modelo 3D referenciado por revisões de itens de modelo de footprint.

  Se quiser manter todos os Items principais relacionados a utilizar a revisão atual do Item, desative esta opção. Nesse caso, apenas o próprio item será guardado.

  Ao guardar um componente ou modelo de domínio editado (símbolo, footprint, modelo de simulação, modelo de cablagem de harness) no seu Workspace, pode preservar o seu estado de ciclo de vida atual. Este controlo é disponibilizado pela opção Preserve lifecycle state (not recommended), disponível na caixa de diálogo Edit Revision / Create Revision ao voltar a guardar. Quando a opção está ativada, a nova revisão será automaticamente definida com o estado de ciclo de vida da revisão anterior. Esta funcionalidade está disponível para utilizadores com a permissão operacional Allow to skip lifecycle state change for new revisions atribuída (saiba mais em Setting Global Operation Permissions for a Workspace).

  Para guardar no Workspace um documento que está a ser editado, também pode utilizar o controlo Save to Server junto à entrada do documento no painel Projects panel.

• / – Discard Local Changes. Utilize este botão se pretender cancelar a edição. O ficheiro temporário (utilizado apenas para facilitar a edição) será eliminado, a sua entrada será removida do painel Projects , e nada será libertado para o Item de destino.

  Com o ficheiro temporário aplicável utilizado numa sessão de edição direta, não tem de concluir o processo de atualização numa única sessão de edição — pode guardar o seu trabalho e fechar o ficheiro, se assim o desejar. O Altium Designer reconhece que este é um ficheiro especial, pelo que o mantém na pasta <SourceWorkspaceName> do painel Projects , para que o possa reabrir quando estiver pronto e concluir o processo de atualização e nova libertação.

Estes controlos também podem ser acedidos como comandos a partir do menu do botão direito do rato da entrada do documento no painel Projects. Para muitos editores, estes controlos também estão disponíveis como comandos – Save (atalho: Ctrl+S), Save to Server (atalho: Ctrl+Alt+S) e Discard Local Changes – a partir do menu principal File.

Edição de uma Revisão Existente de um Item

Em qualquer fase, pode voltar a qualquer revisão de um Item de um tipo de conteúdo suportado no Workspace (através do painel Explorer panel) e editá-la diretamente. Clique com o botão direito do rato na revisão e escolha o comando Edit no menu de contexto. Mais uma vez, o editor temporário será aberto, com o documento contido na revisão aberto para edição. Faça as alterações conforme necessário e, em seguida, confirme a libertação do documento na revisão seguinte do item.

Exemplo de acesso ao comando para iniciar a edição direta de um Draftsman Document Template existente.

O Comportamento dos Ficheiros Temporários

Para poder editar dados do Workspace, tem de ser criado algo para editar no Altium Designer. O que acontece é que são criados ficheiros temporários. Por exemplo, quando clica com o botão direito do rato num Symbol Item e seleciona Edit, é criado um ficheiro SchLib temporário e aberto no Altium Designer. Quando termina e efetua um Save to Server, este ficheiro é destruído assim que os dados do Workspace são atualizados.

No entanto, se não o libertar e, em vez disso, Save e Close o ficheiro, este permanecerá no painel Projects panel. Isto é feito para que não tenha de concluir o processo de atualização numa única sessão de edição — pode guardar o seu trabalho e fechar o ficheiro, se assim o desejar. O Altium Designer reconhece que este é um ficheiro especial, pelo que o mantém na entrada <WorkspaceName> do painel Projects (por exemplo, /) para que o possa reabrir quando estiver pronto e concluir o processo de atualização e nova libertação.

Os documentos temporários permanecem acessíveis para que não tenha de concluir as suas alterações numa única sessão de edição.

Edição Direta de Componentes a partir do Painel Components

Na gestão diária dos seus componentes, a edição direta está disponível a partir do painel Components panel – que tenderá a utilizar mais do que o painel Explorer no que diz respeito a esse tipo de conteúdo específico. Procure o componente pretendido, selecione-o e, em seguida, clique com o botão direito do rato e escolha o comando Edit no menu de contexto. Será aberta uma instância temporária do Component Editor – no seu modo Single Component Editing – pronta para que possa efetuar as alterações necessárias.

Um exemplo de edição direta a partir do painel Components.

Edição Direta de Modelos a partir do Component Editor

Ao editar um componente utilizando o Component Editor no seu modo Single Component Editing, pode editar os modelos de domínio associados utilizando o paradigma de edição direta. Para modificar um modelo que está atualmente a ser utilizado (referenciado) pelo componente, clique no controlo  no canto superior direito da sua pré-visualização. O editor temporário correspondente a esse tipo de modelo será aberto, pronto para que possa fazer as alterações necessárias ao modelo. Quando estiver pronto, basta guardar e fechar o editor — o modelo modificado surgirá novamente associado na região Models. Após a libertação do componente, o modelo modificado também será automaticamente libertado para o Workspace, na revisão seguinte do seu Item principal.

Um exemplo de edição direta de um modelo existente que está a ser referenciado por um componente que, ele próprio, está a ser diretamente editado, utilizando o Component Editor no seu modo Single Component Editing.

Carregar Dados para uma Nova Revisão de um Item

A maioria dos tipos de conteúdo suporta a criação de uma nova revisão através do carregamento do ficheiro de dados aplicável.

O carregamento de dados para uma nova revisão de um Item pode ser realizado de duas formas.

Menu Upload

Um ficheiro pode ser carregado clicando com o botão direito do rato no Explorer panel sobre o Item pretendido e escolhendo o comando Upload no menu de contexto. Será apresentada a caixa de diálogo Create New Revision, na qual pode alterar o Nome, a Descrição e adicionar notas de lançamento, conforme necessário. Utilize a área Sources da caixa de diálogo para carregar o ficheiro pretendido. Isto pode ser feito arrastando e largando o ficheiro do Windows Explorer para essa área. Em alternativa, clique no botão – será apresentada a caixa de diálogo Add Files (uma caixa de diálogo padrão do Windows do tipo abrir). Utilize-a para navegar até ao ficheiro pretendido e abri-lo.

Exemplo de carregamento. Neste caso, especificando manualmente um ficheiro de modelo 3D para carregar para um Item de Modelo 3D de destino.

Assim que o ficheiro pretendido for largado ou selecionado e se clicar no botão Open, aparecerá uma entrada correspondente na área Sources.

Para um tipo de conteúdo que suporte o carregamento de vários ficheiros para uma sua revisão, como o Binary File, o(s) ficheiro(s) escolhido(s) será(ão) adicionado(s) e listado(s) na área Sources da caixa de diálogo. Se precisar de ajustar o conteúdo da lista, adicionar ficheiros adicionais ou selecionar e remover ficheiros (clicando no botão  ), faça-o conforme necessário. A área Sources suporta a seleção de múltiplos ficheiros utilizando técnicas padrão de seleção múltipla (Ctrl+Click, Shift+Click e clicar-e-arrastar).

Prossiga com o carregamento clicando no botão OK. Conforme aplicável ao tipo de conteúdo, as informações relativas ao(s) ficheiro(s) carregado(s) serão apresentadas nos separadores de vista de aspeto Details e/ou Preview para a Revisão do Item, no painel Explorer.

Navegue pela revisão guardada do Item (mostrada aqui para um Item de Modelo 3D), novamente no painel Explorer. Mude para o separador de vista de aspeto Preview para ver a sua representação gráfica (quando aplicável).

Arrastar e Largar a partir do Windows Explorer

O(s) ficheiro(s) de dados relevante(s) também pode(m) ser carregado(s) arrastando o(s) ficheiro(s) selecionado(s) de uma pasta de origem no Windows Explorer e largando-os sobre o Item de destino pretendido no Explorer panel. Será apresentada a caixa de diálogo Create New Revision, com o ficheiro arrastado listado na área Sources. Adicione quaisquer Release Notes conforme necessário, e depois clique no botão OK.

Para alguns tipos de conteúdo, terá de modificar o Name (que será o nome do ficheiro, incluindo a extensão (para vários ficheiros, as entradas serão separadas por ponto e vírgula)) e a Description (que estará no formato Uploaded from <FileNameandPath>, Size <FileSize>, Created on <FileCreationDate> (para vários ficheiros, as entradas serão separadas por ponto e vírgula)). Para os tipos de conteúdo que suportam vários ficheiros, se precisar de adicionar ficheiros adicionais isso pode ser feito clicando no botão e navegando até ao(s) ficheiro(s), ou arrastando e largando ficheiro(s) sobre a área Sources. Se precisar de remover ficheiros, selecione-os na lista e clique no botão  .

Carregamento utilizando o método de arrastar e largar, mostrado aqui para um Modelo 3D.

Clonar o Conteúdo do Workspace

O painel Explorer disponibiliza a capacidade de clonar uma variedade de Items do Workspace. Assim, em vez de criar de raiz o componente, modelo de domínio, folha esquemática ou modelo pretendido, pode simplesmente cloná-lo. Direct Editing garante que quaisquer alterações necessárias – numa cópia dos dados de origem da Revisão do Item original – sejam efetuadas de forma simplificada, sendo as alterações resultantes lançadas numa revisão inicial de um novo Item do mesmo tipo. Feito num instante, pode expandir rapidamente o conteúdo do seu Workspace sem enfrentar uma tela em branco.

Os seguintes tipos de conteúdo podem ser clonados:

• Componente
• Footprint
• Símbolo
• Modelo de Simulação
• Modelo de Componente
• Folha Esquemática Gerida
• Modelo Esquemático
• Modelo de Projeto
• Modelo de Documento Draftsman
• Modelo de Folha Draftsman
• Empilhamento de Camadas
• OutputJob

O comando para clonar um dos tipos de conteúdo suportados é acedido a partir do painel Explorer das seguintes formas:

• Clicando com o botão direito sobre a entrada da Revisão do Item de origem e escolhendo o comando Operations » Clone no menu de contexto.
• Selecionando a entrada da Revisão do Item de origem e utilizando o atalho de teclado Ctrl+D.

O comando Clone está disponível em todo o painel Explorer, sempre que a Revisão do Item aplicável for apresentada, incluindo:

• A listagem principal de Items dentro de uma pasta.
• Children separador de vista de aspeto (ao visualizar um Item de Folha Esquemática Gerida).
• Where-used separador de vista de aspeto (ao visualizar um Item de Componente, Item de Símbolo, Item de Footprint, Item de Modelo de Simulação, Item de Modelo de Componente ou Item de Modelo Esquemático).
• Preview separador de vista de aspeto (ao visualizar um Item de Componente, Item de Folha Esquemática Gerida ou Item de Modelo Esquemático).