Criando e editando conteúdo

Os Itens são criados diretamente em um Workspace conectado, e todos os dados necessários para fabricar/representar um Item são então armazenados nesse Workspace sob aquele número de Item. Dependendo do tipo de conteúdo, um Item pode ser criado manualmente ou automaticamente como parte de um processo de salvar/upload/liberação. Todos os tipos de conteúdo podem ser criados no Altium Designer por meio do painel Explorer. Ao trabalhar com componentes, a criação também é possível por meio do painel Components.

Os Itens são criados em um Workspace conectado. No Altium Designer, o painel Explorer fornece a interface completa para o seu Workspace.

Criando um Item

Depois de definir as pastas necessárias, você pode prosseguir para criar o conteúdo no Workspace. Para criar um Item, selecione a pasta apropriada, clique com o botão direito na região da grade de Itens do painel e escolha um dos comandos do submenu Create Item. Como alternativa, se a pasta estiver vazia, use o controle Add an item no centro da região para acessar o menu.

Clique com o botão direito dentro da região da grade de Itens do painel Explorer para acessar comandos relacionados à criação de conteúdo.

A caixa de diálogo Create New Item aparecerá, fornecendo todos os controles necessários para definir completamente o Item.

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

Para muitos tipos de conteúdo, você tem a opção de editar e liberar o documento de projeto aplicável na revisão inicial desse conteúdo, 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 Create New Item (que está habilitada por padrão). O Item será criado e o editor temporário relevante será aberto, pronto para que você crie os dados para aquele Item. Para obter mais informações sobre como trabalhar com um tipo de conteúdo específico, leia sua página dedicada, cujo link é fornecido na tabela.

Uma observação sobre o ID do Item...

Um aspecto importante da pasta pai na qual o conteúdo é criado é o Item Naming Scheme usado para ela. Isso define o formato do ID exclusivo para cada Item criado naquela pasta específica. Ao definir o Esquema de Nomenclatura do Item no nível da pasta, o conteúdo pode ser criado rapidamente dentro dessa pasta, ao mesmo tempo em que segue o esquema de nomenclatura de ID correto. Isso é especialmente verdadeiro quando os Itens estão sendo criados automaticamente “em tempo real”, em vez de serem liberados para Itens existentes que foram criados manualmente diretamente no Workspace de destino.

Vários esquemas de exemplo padrão estão disponíveis, utilizando o código abreviado para o tipo de pasta ou para o tipo de conteúdo (consulte novamente a tabela anterior neste documento para obter uma lista de códigos). Usando um esquema de nomenclatura padrão, o software atribuirá automaticamente o próximo ID exclusivo disponível, com base nesse esquema, após examinar todo o Workspace e os identificadores do conteúdo existente.

Como alternativa, se houver necessidade de ter controle manual total sobre a nomenclatura de um Item, selecione a entrada [NO ITEM NAMING SCHEME]. Nesse caso, um Identificador exclusivo deverá ser definido para um Item como parte de sua criação. Observe que o sistema não permitirá a criação de um Item com identificador duplicado, portanto a atribuição manual de um identificador exige conhecimento de quais identificadores já foram usados.

O Esquema de Nomenclatura do Item da pasta pai é aplicado ao ID Exclusivo de cada Item criado nessa pasta.

Independentemente da configuração do Item Naming Scheme no nível da pasta, você tem liberdade para substituir qualquer ID determinado automaticamente no nível do Item. Modifique qualquer ID desse tipo conforme necessário por meio da caixa de diálogo Create New Item.

Escolhendo um Esquema para IDs de Itens

Existe um número infinito de possíveis esquemas de nome/numeração que podem ser usados para Itens; os mostrados nas imagens da documentação são apenas exemplos. Há inúmeras discussões que você pode ler sobre qual é o melhor esquema de numeração a usar. 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 há informações codificadas no esquema de numeração, como a categoria do produto, subcategoria, localização etc.; cada novo Item simplesmente recebe o próximo número da sequência.

O comprimento é importante porque, quanto maior o identificador, maior a chance de um ser humano cometer um erro ao registrar ou lembrar o ID do Item. A experiência e estudos acadêmicos mostraram que erros de entrada de dados aumentam à medida que o número de caracteres cresce. Acredita-se que sete dígitos seja o número mágico em termos de ser facilmente e confiavelmente lembrado por um ser humano. Além de certo comprimento, os erros aumentam a uma taxa crescente – com 15 caracteres, a probabilidade de erro fica próxima de 100%.

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

Definindo o ID da Revisão Inicial de um Item do Workspace

Mudar de um paradigma de projeto local para um paradigma de Workspace exige migrar os dados existentes para um Workspace. Esses dados podem muito bem ter passado por várias iterações e ter uma 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 entregues na rev.4. Ao liberar 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, para sua base de clientes (que espera uma versão posterior à sua rev.3 atual!).

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

Definindo o ID da Revisão Inicial

Crie o novo Item necessário no Workspace como de costume. Após a criação, clique com o botão direito 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. A caixa de diálogo Set Initial revision Id values aparecerá, de onde você poderá definir o ID para atender às suas necessidades. Serão fornecidos campos, conforme aplicável, para modificar os vários níveis do ID, de acordo com o Revision Naming Scheme escolhido.

Para acessar Itens relacionados ao projeto (PCB Fabrication Data, PCB Assembly Data, PCB Project Design) no painel Explorer, certifique-se de que você esteja visualizando um projeto em seu Classic View. Pode ser necessário alternar manualmente a partir de Project View – há comandos disponíveis 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 empregado).

Criando e Editando Conteúdo Diretamente por meio de um Workspace

Seu Workspace conectado fornece um método flexível e seguro de centralizar o armazenamento e o gerenciamento de todos os tipos de dados de projeto usados no Altium Designer. Do modelo esquemático ao componente, de folhas esquemáticas gerenciadas a projetos de PCB concluídos, o Workspace oferece um método ideal para armazenar e gerenciar seus dados de projeto eletrônico.

Um aspecto poderoso de um Workspace é seu suporte a Direct Editing. Mas o que isso significa exatamente, “Edição Direta”? Significa que você pode clicar com o botão direito em um modelo, ou em um componente, ou mesmo em uma folha gerenciada no Workspace e selecionar Edit. Claro, um arquivo é aberto no Altium Designer pronto para você editar – aberto em um editor temporário – mas, quando terminar, basta salvá-lo de volta no Workspace. Quanto ao arquivo que você acabou de editar, bem, você não precisa se preocupar com ele, pois ele não é mais necessário, já que suas edições são armazenadas com segurança de volta no Workspace; assim, ele é destruído e a instância do editor temporário é fechada.

A edição direta liberta você das limitações de dados de origem separados e controlados por versão. Você pode simplesmente editar um tipo de Item compatível usando um editor temporário carregado com a origem mais recente diretamente do próprio Workspace. E, quando a edição é concluída, a entidade é liberada (ou liberada 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úvidas se você está trabalhando com a origem correta ou mais recente, nem 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 enormemente as alterações nos seus dados.

Tipos de Conteúdo Compatíveis com Edição Direta

Os seguintes tipos de conteúdo do Workspace são compatíveis com Edição Direta:

Editando a Revisão Inicial de um Item

A partir do Explorer panel, ao criar um Item de um dos tipos de conteúdo suportados, você tem a opção de editar e liberar 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 liberá-los, você pode começar a trabalhar diretamente na origem 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 será liberada na revisão inicial planejada de seu Item pai, e o editor temporário será fechado.

Para aproveitar esse recurso, habilite a opção Open for editing after creation, localizada na parte inferior da caixa de diálogo Create Item dialog. Antecipando a utilidade dessa funcionalidade, a opção vem habilitada por padrão. O Item será criado e o editor temporário relevante será aberto, apresentando o documento correspondente como documento ativo na janela principal de design. Esse documento será nomeado de acordo com o Item-Revisão, no formato: <Item>-<Revision>.<DocumentExtension>.

A imagem abaixo mostra isso em ação para a criação de um novo Item de Símbolo (SYM-001-0031). Um editor temporário de Símbolo Esquemático é aberto, apresentando um documento para definir o símbolo conforme necessário.

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

Controles de Edição Direta

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

• ​ – Save Active Document. Use este botão para salvar quaisquer alterações feitas no documento. Isso permite salvar as alterações atuais se você quiser voltar mais tarde para fazer alterações adicionais antes de finalmente liberar para o Workspace.

• / – Save to Server. Use este botão para liberar (efetivamente salvar e liberar) o documento para o Workspace, armazenando-o na revisão inicial (planejada) ou na próxima revisão do Item de destino. A caixa de diálogo Create Revision dialog (ou Edit Revision dialog) será exibida, na qual você poderá alterar o Nome e a Descrição, e adicionar notas de liberação conforme necessário. O documento e o editor serão fechados após a liberação.

  Quando aplicável e se desejado, as revisões dos itens pai relacionados a (que fazem referência à) revisão atual do item que está sendo salvo também podem ser atualizadas. Isso é controlado pela opção Update items related to <ItemRevision> , que é habilitada por padrão. Observe que essa opção só aparece quando:

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

  • se cria uma nova revisão de um template de componente referenciado por revisões de itens de componente.

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

  Se você quiser manter todos os Itens pai relacionados usando a revisão atual do Item, desabilite essa opção. Nesse caso, apenas o próprio item será salvo.

  Ao salvar um componente ou modelo de domínio editado (símbolo, footprint, modelo de simulação, modelo de fiação de harness) em seu Workspace, você pode preservar seu estado de ciclo de vida atual. Esse controle é fornecido pela opção Preserve lifecycle state (not recommended), disponível na caixa de diálogo Edit Revision / Create Revision ao salvar novamente. Quando a opção está habilitada, a nova revisão será automaticamente definida para o estado de ciclo de vida da revisão anterior. Esse recurso está disponível para aqueles 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 salvar no Workspace um documento que está sendo editado, você também pode usar o controle Save to Server ao lado da entrada do documento no painel Projects panel.

• / – Discard Local Changes. Use este botão se desejar cancelar a edição. O arquivo temporário (usado puramente para viabilizar a edição) será excluído, com sua entrada removida do painel Projects , e nada será liberado para o Item de destino.

  Com o arquivo temporário aplicável usado para uma sessão de edição direta, você não precisa concluir o processo de atualização em uma única sessão de edição — pode salvar seu trabalho e fechar o arquivo, se desejar. O Altium Designer entende que este é um arquivo especial, portanto o mantém na pasta <SourceWorkspaceName>  no painel Projects , para que você possa reabri-lo quando estiver pronto e concluir o processo de atualização e nova liberação.

Esses controles também podem ser acessados como comandos a partir do menu de clique com o botão direito da entrada do documento no painel Projects. Para muitos editores, 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.

Editando uma Revisão Existente de um Item

Em qualquer momento, você pode retornar a qualquer revisão de um Item de um tipo de conteúdo suportado no Workspace (por meio do Explorer panel) 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 documento contido na revisão aberto para edição. Faça as alterações conforme necessário e, em seguida, efetive a liberação do documento na próxima revisão do item.

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

O Comportamento dos Arquivos Temporários

Para poder editar dados do Workspace, algo precisa ser criado para que você o edite no Altium Designer. O que acontece é que arquivos temporários são criados. Por exemplo, quando você clica com o botão direito em um Item de Símbolo e seleciona Edit, um arquivo SchLib temporário é criado e aberto no Altium Designer. Quando você termina e executa um Save to Server, esse arquivo é destruído assim que os dados do Workspace são atualizados.

Entretanto, se você não o liberar e, em vez disso, Save e Close o arquivo, ele permanecerá no painel Projects panel. Isso é feito para que você não precise concluir o processo de atualização em uma única sessão de edição — você pode salvar seu trabalho e fechar o arquivo, se desejar; o Altium Designer entende que este é um arquivo especial, por isso o mantém sob a entrada <WorkspaceName> no painel Projects (por exemplo, /), para que você possa reabri-lo quando estiver pronto e concluir o processo de atualização e nova liberação.

Os documentos temporários permanecem acessíveis para que você não precise concluir suas alterações em uma única sessão de edição.

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

No gerenciamento diário dos seus componentes, a edição direta está disponível no painel Components panel – que você provavelmente usará mais do que o painel Explorer em relação a esse tipo específico de conteúdo. Procure o componente desejado, selecione-o e clique com o botão direito para escolher o comando Edit no menu de contexto. Uma instância temporária do Component Editor – em seu modo Single Component Editing – será aberta, pronta para que você faça as alterações conforme necessário.

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 usando o Component Editor em seu modo Single Component Editing, você pode editar os modelos de domínio vinculados usando o paradigma de edição direta. Para modificar um modelo que está sendo usado no momento (referenciado) pelo componente, clique no controle no canto superior direito da pré-visualização. O editor temporário correspondente para esse tipo de modelo será aberto, pronto para que você faça as alterações no modelo conforme necessário. Quando estiver pronto, basta salvar e fechar o editor – o modelo modificado aparecerá vinculado novamente na região Models. Ao liberar o componente, o modelo modificado também será automaticamente liberado para o Workspace, na próxima revisão de seu Item pai.

Um exemplo de edição direta de um modelo existente que está sendo referenciado por um componente que, por sua vez, está sendo editado diretamente, usando o Component Editor em seu modo Single Component Editing.

Carregando Dados em uma Nova Revisão de um Item

A maioria dos tipos de conteúdo oferece suporte à criação de uma nova revisão por meio do upload do arquivo de dados aplicável.

O upload de dados para uma nova revisão de um Item pode ser realizado de algumas maneiras.

Menu Upload

Um arquivo pode ser carregado clicando com o botão direito no Item desejado no Explorer panel  e escolhendo o comando Upload no menu de contexto. A caixa de diálogo Create New Revision será exibida, na qual você poderá alterar Nome, Descrição e adicionar notas de liberação conforme necessário. Use a região Sources da caixa de diálogo para carregar o arquivo desejado. Isso pode ser feito arrastando e soltando o arquivo do Windows Explorer sobre essa região. Como alternativa, clique no botão – a caixa de diálogo Add Files (uma caixa de diálogo padrão do Windows do tipo abrir) será exibida. Use-a para procurar e abrir o arquivo desejado.

Exemplo de upload. Neste caso, especificando manualmente um arquivo de modelo 3D a ser carregado para um Item de Modelo 3D de destino.

Depois que o arquivo desejado for solto ou selecionado e o botão Open for clicado, uma entrada correspondente aparecerá de volta na região Sources.

Para um tipo de conteúdo que suporte o upload de vários arquivos para uma revisão, como o Binary File, o(s) arquivo(s) escolhido(s) será(ão) adicionado(s) e listado(s) na região Sources da caixa de diálogo. Se você precisar ajustar o conteúdo da lista, adicione arquivos adicionais ou selecione e remova arquivos (clique no botão  ) conforme necessário. A área Sources oferece suporte à seleção de vários arquivos usando técnicas padrão de multisseleção (Ctrl+Click, Shift+Click e clicar e arrastar).

Prossiga com o upload clicando no botão OK. Conforme aplicável ao tipo de conteúdo, as informações sobre o(s) arquivo(s) carregado(s) serão apresentadas nas guias de visualização de aspecto Details  e/ou Preview para a Revisão do Item, no painel Explorer.

Navegue pela revisão salva do Item (mostrada aqui para um Item de Modelo 3D), de volta no painel Explorer. Mude para a guia de visualização de aspecto Preview para ver sua representação gráfica (quando aplicável).

Arrastar e Soltar a partir do Windows Explorer

O(s) arquivo(s) de dados relevante(s) também pode(m) ser carregado(s) arrastando o(s) arquivo(s) selecionado(s) de uma pasta de origem no Windows Explorer e soltando sobre o Item de destino desejado no Explorer panel. A caixa de diálogo Create New Revision será exibida, com o arquivo arrastado listado na região Sources. Adicione quaisquer Release Notes conforme necessário e, em seguida, clique no botão OK.

Para alguns tipos de conteúdo, será necessário modificar o Name (que será o nome do arquivo, incluindo a extensão; para vários arquivos, 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 arquivos, as entradas serão separadas por ponto e vírgula)). Para os tipos de conteúdo que oferecem suporte a vários arquivos, se você precisar adicionar arquivos adicionais, isso pode ser feito clicando no botão e procurando o(s) arquivo(s), ou arrastando e soltando arquivo(s) na área Sources. Se precisar remover arquivos, selecione-os na lista e clique no botão  .

Upload usando o método de arrastar e soltar, mostrado aqui para um Modelo 3D.

Clonando o Conteúdo do Workspace

O painel Explorer oferece a capacidade de clonar uma variedade de Itens do Workspace. Assim, em vez de criar do zero o componente, modelo de domínio, folha esquemática ou template necessário, você pode simplesmente cloná-lo. Direct Editing garante que quaisquer alterações necessárias – em uma cópia dos dados de origem da Revisão do Item original – sejam um processo simplificado, com as alterações resultantes sendo liberadas em uma revisão inicial de um novo Item do mesmo tipo. Feito rapidinho, você pode expandir rapidamente o conteúdo do seu Workspace sem encarar uma tela em branco.

Os seguintes tipos de conteúdo podem ser clonados:

• Component
• Footprint
• Symbol
• Simulation Model
• Component Template
• Managed Schematic Sheet
• Schematic Template
• Project Template
• Draftsman Document Template
• Draftsman Sheet Template
• Layerstack
• OutputJob

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

• Por meio de clique com o botão direito sobre a entrada da Item-Revisão de origem e escolhendo o comando Operations » Clone no menu de contexto.
• Selecionando a entrada da Item-Revisão de origem e usando o atalho de teclado Ctrl+D.

O comando Clone está disponível em todo o painel Explorer, onde quer que a Item-Revisão aplicável seja apresentada, incluindo:

• A listagem principal de Itens dentro de uma pasta.
• Children guia de visualização de aspecto (ao visualizar um Item de Managed Schematic Sheet).
• Where-used guia de visualização de aspecto (ao visualizar um Item de Component, Symbol, Footprint, Simulation Model, Component Template ou Schematic Template).
• Preview guia de visualização de aspecto (ao visualizar um Item de Component, Managed Schematic Sheet ou Schematic Template).