Gerenciando documentos do projeto
Altium Essentials: Project Creation and Storage
This content is part of the official Altium Professional Training Program. For full courses, materials and certification, visit Altium Training.
Num relance
- Entenda os grupos de documentos, as referências a arquivos e a diferença entre a árvore do projeto e o armazenamento físico dos arquivos.
- Aprenda a adicionar, reordenar e transferir documentos, além de acessar as configurações do projeto.
- Identifique os indicadores de documentos abertos, modificados e bloqueados, assim como os rótulos de conexão com o Workspace e de compartilhamento.
Painel Projects
O painel Projects exibe todos os projetos abertos no momento, bem como os documentos e a estrutura que os compõem. Os menus de contexto do painel, acessíveis com o botão direito do mouse, oferecem a maioria dos comandos necessários para trabalhar com documentos de projeto.

O painel Projects
Observe que a apresentação dos documentos no painel Projects não reflete a forma como estão armazenados no disco rígido ou em outro local. O conteúdo do painel pode ser considerado uma representação lógica do projeto, enquanto a localização física e a organização do armazenamento dos arquivos de documentos (e seu tipo) ficam a seu critério – os documentos podem estar armazenados em uma pasta na sua máquina local ou em uma LAN e, é claro, hospedados em um repositório com controle de versão fornecido por um sistema VCS Git/SVN básico ou por um sistema totalmente gerenciado, como um Workspace.
Quando você está conectado a um Workspace, o ícone do Workspace / é exibido ao lado da entrada de nível mais alto desse Workspace. Quando a cópia de trabalho local de um projeto é aberta, mas não há conexão com o Workspace no qual o projeto está localizado, um ícone de Workspace esmaecido / é exibido.
Um projeto de um Workspace também pode ser compartilhado com você sem que você seja convidado para a equipe do Workspace no qual esse projeto está localizado. Um projeto aberto por meio de acesso compartilhado é identificado por um rótulo Shared with me associado, com o ícone ao lado.
Se um projeto foi compartilhado com você apenas para visualização, o rótulo View Only será exibido ao lado da entrada do projeto no painel para indicar essa condição – mostrar exemplo.
Os projetos locais são listados sob a entrada do grupo de projetos *.DsnWrk) – seja o padrão (Project Group 1.DsnWrk) ou um que você tenha criado ou aberto.
Para acessar o menu de contexto do Workspace ao qual você está conectado no momento, clique com o botão direito do mouse no nome do Workspace ou clique no controle
na extremidade direita. Esses comandos incluem:
- Open Project – abre a caixa de diálogo Open Project.
- Create Project – abre a caixa de diálogo Create Project.
- Show in Explorer – abre o painel Explorer.
- Show in Web Browser – abre a página Projects da interface web do Workspace no navegador padrão.
- Sign out – encerra sua sessão no Workspace.
- Sign in – inicia sua sessão no Workspace. Esse comando fica disponível desde que você tenha pelo menos um item do Workspace (por exemplo, um projeto) aberto no painel Projects e esteja desconectado do Workspace no qual esse item está localizado.
Você precisa estar conectado a um Workspace para acessar esses comandos. Quando estiver desconectado de um Workspace, clique com o botão direito do mouse no Workspace ao qual deseja se conectar e clique no comando Sign In.
Árvore de documentos do projeto
Quando você abre um projeto existente ou cria um novo, sua entrada aparece no painel Projects. Todos os documentos existentes que fazem parte de um projeto (e quaisquer novos documentos adicionados) aparecem em subpastas de acordo com sua finalidade e/ou tipo. Por exemplo, as seguintes pastas e tipos de documentos comuns podem aparecer em um projeto:
- Source Documents – documentos principais de projeto, como esquemáticos, PCBs etc.
- Settings – contém vários arquivos usados no projeto, incluindo arquivos de tarefas de saída, arquivos de definição de chicotes e documentos de anotação, entre outros arquivos pertinentes.
- Libraries – documentos locais de bibliotecas de origem. Os documentos são subdivididos de acordo com o tipo de biblioteca (por exemplo, bibliotecas de esquemáticos, bibliotecas de PCB etc.).
- Documentation – documentos adicionais que foram adicionados ao projeto, de um tipo reconhecido pelo Altium Designer (por exemplo, texto, PDF etc.).
- Other Documents – documentos adicionais que foram adicionados ao projeto, de um tipo não reconhecido pelo Altium Designer. Eles podem ser abertos pelo Altium Designer se o aplicativo associado for reconhecido pelo Windows (por exemplo, documentos do Word, planilhas do Excel etc.).
- Generated – documentos gerados como saída. Os documentos são subdivididos de acordo com o tipo (por exemplo, documentos de BOM, documentos de texto etc.). À medida que as saídas do projeto são geradas, as subpastas correspondentes na árvore principal são criadas e preenchidas.
- Components – esta pasta lista cada componente e o número de componentes em cada grupo. Valide o projeto se essa pasta não aparecer (Project » Validate). Por padrão, os componentes são agrupados pela primeira letra do designador – clique com o botão direito do mouse na entrada de um componente (ou na pasta de um grupo de componentes) e escolha o comando Component Grouping no menu de contexto para acessar rapidamente os controles Components Grouping do painel Projects e alterar o estilo de agrupamento ou desativá-lo, conforme necessário. Consulte a seção Pesquisa de componentes e redes na estrutura do projeto da página Criação de conectividade de circuitos nos seus esquemáticos para saber mais.
- Nets – esta pasta lista cada rede usada no projeto. Valide o projeto se essa pasta não aparecer (Project » Validate). Consulte a seção Pesquisa de componentes e redes na estrutura do projeto da página Criação de conectividade de circuitos nos seus esquemáticos para saber mais.
Notes on working in the documents tree:
- Todos os documentos independentes de um projeto aparecerão como Free Documents e serão exibidos nas subpastas correspondentes. Ao clicar com o botão direito do mouse em um documento avulso e escolher o comando Add to Project <ActiveProjectName> no menu de contexto, você pode adicionar um documento avulso atualmente aberto ao projeto ativo. Como alternativa, você pode arrastá-lo e soltá-lo sobre o nome do projeto desejado no painel Projects.
- Além de permitir que vários documentos estejam abertos para edição, o ambiente também permite que vários projetos estejam abertos ao mesmo tempo. Esses projetos podem ou não estar relacionados.
- Os documentos no painel Projects são organizados automaticamente em grupos lógicos ou “pastas”, como documentos de origem (esquemático, PCB etc.), documentos de configurações (Harness, Outjob etc.) e, no caso de um projeto hierárquico, documentos esquemáticos de nível superior. Por padrão, os documentos de cada grupo de pastas são exibidos na ordem em que foram adicionados, mas podem ser arrastados e soltos em uma nova posição dentro do grupo.
- No caso de um novo projeto hierárquico, a relação entre documentos pai e filho será exibida no painel. Observe que as relações de conectividade não podem ser definidas arrastando e soltando documentos esquemáticos, pois as conexões entre folhas e a hierarquia do projeto são, de fato, definidas por símbolos de folha e definições de portas.
- Clique com o botão direito do mouse em uma subpasta de documentos do projeto, expandida ou recolhida, para acessar comandos adicionais de gerenciamento de documentos, como abrir, fechar ou salvar todos os documentos da subpasta de documentos do projeto em foco.
- Os documentos podem ser transferidos entre projetos no painel clicando e arrastando. Não é necessário arrastar o documento para a subpasta correta; ele será posicionado corretamente na estrutura do projeto de forma automática.
- Os atalhos de teclado Up Arrow, Home, End e Down Arrow podem ser usados para exibir a entrada anterior, a primeira, a última e a próxima no painel, respectivamente. Use as teclas Right Arrow e Left Arrow para expandir e recolher uma entrada de nível superior ou sua subpasta, respectivamente.
- Para realizar uma sondagem cruzada a partir da entrada de componente ou rede selecionada no painel Projects até essa entidade no documento esquemático ou de PCB do projeto de PCB pai, clique com o botão direito do mouse na entrada e escolha o comando Cross Probe to Schematic ou Cross Probe to PCB no menu de contexto.
-
Para abrir uma instância do Windows Explorer no local em que um documento do projeto está armazenado, clique com o botão direito do mouse na entrada correspondente no painel Projects e selecione o comando Explore. Para o documento em foco no painel Projects, isso pode ser feito clicando no controle
na parte superior do painel.
Opções do projeto
Um projeto existente ou recém-criado está associado a um conjunto de configurações de opções específicas desse projeto. Elas são armazenadas no arquivo do projeto (*.PrjPcb, por exemplo) e variam de acordo com o tipo de projeto.
As configurações de opções são definidas na caixa de diálogo Opções do projeto, que pode ser acessada por Project » Project Options no menu principal ou clicando com o botão direito do mouse no nome do projeto no painel Projects e selecionando Project Options no menu de contexto. Para o projeto em foco no painel Projects, a caixa de diálogo pode ser acessada clicando no controle
na parte superior do painel.
Outras configurações do projeto definidas em outras caixas de diálogo e depois armazenadas no arquivo do projeto incluem:
- Configurações de anotação do esquemático.
- Configurações de saída, como relatórios, impressão, Gerber e assim por diante. Observe que essas são as configurações de saída acessadas pelos menus dos editores de esquemático ou PCB, e não as configurações de saída definidas em um documento OutJob.
Indicação do status dos documentos
Ao trabalhar com documentos de projeto no Altium Designer, o painel Projects fornece um resumo visual de quais arquivos de documentos foram modificados ou salvos por meio de ícones de status associados a cada documento de projeto e ao arquivo principal do projeto. Isso fornece um resumo visual rápido de quais documentos foram modificados ou salvos, se são do Workspace ou locais e qual é seu status de controle de versão. Os ícones dos documentos e seus significados estão listados abaixo.
Ícones de status aberto/modificado
| [em branco] | O documento está fechado. |
| |
Aberto – O documento está aberto como um documento em uma aba na janela do editor de projetos. |
| |
Aberto/modificado – O documento está aberto e foi modificado (ainda não foi salvo). |
| |
O arquivo do documento está aberto e bloqueado por esta instância do Altium Designer. |
| |
O arquivo do documento está aberto e foi bloqueado por outra instância do Altium Designer. |
| |
O documento está sendo editado por outro usuário. Essa condição de status é habilitada pelo recurso Visualização de colaboradores e prevenção de conflitos. |
| |
O documento que está sendo editado por outro usuário está atualmente aberto no editor. Essa condição de status é habilitada pelo recurso Visualização de colaboradores e prevenção de conflitos. |
| |
O documento está ausente (saiba mais sobre documentos ausentes). |
Ícones de status do controle de versão
O sistema de controle de versão basicamente monitora e compara os arquivos de documentos na pasta de trabalho com seus correspondentes no repositório de projetos. O Altium Designer solicita e troca informações com o sistema de controle de versão por meio de sua interface VCS e responde de acordo com os resultados da comparação do status dos arquivos. Na prática, isso se manifesta nos ícones de arquivo Projects, por meio de uma série de alertas do VCS e de alterações correspondentes nos comandos de gerenciamento de arquivos disponíveis.
Os ícones e seus significados são os seguintes:
| [em branco] | N/A | O documento não está sob controle de versão em um repositório VCS. |
![]() |
Sem modificações | A cópia local do documento corresponde ao documento no repositório e está atualizada. |
| |
Programado para adição | Um documento foi adicionado ao controle de versão, mas seu commit (check-in) no repositório VCS ainda não foi realizado. |
![]() |
Modificado | A cópia local do documento foi modificada e salva na pasta de trabalho. Faça o commit do documento para criar uma nova revisão no repositório. Para um documento PCB, você também pode usar a funcionalidade PCB CoDesign para comparar as alterações locais com o commit mais recente no Workspace usando o comando Local Changes to Remote Document Version no menu de contexto History & Version Control » Compare To do painel Projects ou no menu principal Projects » History & Version Control » Compare To. |
![]() |
Desatualizado | A cópia local do documento (na pasta de trabalho) é mais antiga que sua correspondente no repositório e, portanto, está desatualizada. Use o comando Update Project From Server no menu de contexto History & Version Control do painel Projects ou no menu principal Projects » History & Version Control para obter o documento mais recente do Workspace. Observe que salvar um documento nesse estado criará uma condição de conflito. Quando o projeto contiver apenas documentos nos estados Desatualizado e Sem modificações, você também poderá usar o controle Update from Server que aparece ao lado do nome do projeto no painel Projects para obter do Workspace as versões mais recentes dos documentos desatualizados – mostrar imagem. |
![]() |
Prevenção de conflitos | Outro usuário fez o commit do documento antes de você fazer o commit da sua própria versão editada e salva localmente desse documento. Use o comando Revert Local Changes de controle de versão para descartar as modificações locais do documento do projeto. Para um documento PCB, você também pode usar a funcionalidade PCB CoDesign para comparar e mesclar alterações. |
| |
Conflito detectado | Ao tentar salvar um projeto no Workspace quando ele contiver documentos no estado Conflict Prevention, esses documentos passarão para o estado Conflict Detected. A caixa de diálogo de informações Action Required será apresentada, listando os documentos com conflitos que precisam ser resolvidos. Use os seguintes comandos do menu de contexto History & Version Control » Resolve Conflict do painel Projects para resolver o conflito:
|
![]() |
À frente do servidor (Git) | O documento no repositório de trabalho local é mais recente que seu correspondente no repositório Git remoto. Isso ocorre quando um documento local foi modificado, salvo e teve seu commit realizado no repositório local, mas ainda não foi Pushed para o repositório remoto. |
![]() |
Programado para exclusão | O documento do projeto foi removido do controle de versão e será excluído do repositório VCS e do banco de dados durante o processo de commit do controle de versão. Esse ícone também aparece quando um documento está ausente da pasta de trabalho local (foi excluído, renomeado ou movido), o que é resolvido restaurando o conteúdo da pasta a partir do repositório com o comando Restore document from VCS do menu de contexto do VCS. |
![]() |
Mesclado | O documento PCB foi mesclado com uma revisão mais recente do repositório usando a funcionalidade PCB CoDesign. Faça o commit do projeto no Workspace para salvar o documento PCB mesclado no repositório do Workspace. |
Alterar a ordem dos documentos do projeto
Os documentos no painel Projects são organizados automaticamente em grupos lógicos ou “pastas”, como documentos de origem (esquemático, PCB etc.), documentos de configuração (Harness, Outjob etc.) e, no caso de um projeto hierárquico, documentos esquemáticos de nível superior. Os documentos em cada grupo de pastas são exibidos, por padrão, na ordem em que foram adicionados, mas podem ser arrastados e soltos em uma nova posição dentro do grupo.
No caso de um novo projeto hierárquico, a relação pai-filho entre os documentos será exibida no painel Projects . Observe que as relações de conectividade não podem ser definidas arrastando e soltando documentos esquemáticos, pois as conexões entre folhas e a hierarquia do projeto são, na verdade, definidas por símbolos de folha e definições de portas.
► Para obter mais informações sobre a hierarquia do projeto, consulte Criação de conectividade e a seção Net Identifier Scope na aba Opções da caixa de diálogo Project Options.
Renomeação de documentos
Você pode alterar diretamente o nome de qualquer documento de projeto que compõe um projeto de PCB (*.PcbDoc, *.SchDoc etc.), do próprio projeto de PCB (*.PrjPcb) ou do grupo de projetos (*.DsnWrk) usando o comando Rename – disponível no menu de contexto acessado com o botão direito do mouse sobre um projeto no painel Projects – e a caixa de diálogo Rename exibida em seguida.
Exemplos de renomeação de um projeto e de um de seus documentos de projeto, localmente no Altium Designer. Essas alterações serão sincronizadas com o Workspace quando você salvar e enviar as alterações para esse Workspace.
Após renomear, salve as alterações no Workspace usando o comando Save to Server (disponível no mesmo menu de contexto do projeto). A sincronização da renomeação de arquivos é mantida entre a cópia de trabalho local do projeto e sua correspondente no Workspace. Além disso, quando o nome do arquivo do projeto é alterado e o projeto é salvo no servidor, o Workspace altera automaticamente o parâmetro Nome do projeto gerenciado para que corresponda ao novo nome.
Da mesma forma, quando o nome de um projeto gerenciado é atualizado pela interface do Workspace no navegador, a alteração é propagada para o Altium Designer na próxima vez que o projeto for aberto.
Quando o projeto atualizado é aberto no Altium Designer (File » Open Project), uma caixa de diálogo inicial oferece a opção de alinhar o nome do arquivo local do projeto com o novo Nome do projeto ou forçar o Nome do projeto no servidor a corresponder ao nome do arquivo de projeto existente.
Opções disponíveis se você tiver renomeado o projeto no Workspace.
Compartilhamento de documentos entre projetos
Como um projeto do Altium Designer define e salva links para arquivos de documentos armazenados, é possível criar qualquer número de projetos vinculados a esses mesmos arquivos de documentos.
Embora essa possa ser uma maneira conveniente de reutilizar documentos de projeto existentes – por exemplo, incluindo um esquemático padrão de fonte de alimentação em vários projetos –, essa prática não é recomendada, pois uma alteração no documento afetará todos os projetos aos quais ele está vinculado. Uma abordagem muito melhor para a reutilização de projetos é estabelecer e aplicar Managed Sheets.
Para obter mais informações sobre a reutilização de documentos de projeto e folhas de esquemático gerenciadas, consulte a página Trabalhando com folhas de esquemático gerenciadas.
Gerenciamento de documentos ausentes
Se um documento de projeto definido no arquivo do projeto não for encontrado na pasta do projeto (por exemplo, se o documento tiver sido removido pelo Windows Explorer), ele será considerado ausente. Ao abrir um projeto que contenha um arquivo ausente, uma notificação correspondente será exibida no painel Messages. A entrada do documento ficará esmaecida e será marcada como ausente com um ícone específico no painel Projects.
Há comandos associados disponíveis que oferecem controle total sobre o tratamento de documentos ausentes. Use o menu acessado com o botão direito do mouse sobre um documento ausente no painel Projects para remover do projeto o arquivo ausente selecionado ou todos os arquivos ausentes, ou para atualizar o caminho do arquivo (ou seja, substituir o arquivo ausente por um arquivo selecionado). Para um projeto sob controle de versão, você também pode reverter as modificações locais para restaurar um arquivo ausente a partir do repositório VCS do projeto.
Ao adicionar um arquivo existente ao projeto usando o comando Add Existing to Project do menu acessado com o botão direito do mouse sobre a entrada do projeto, se o nome e o caminho do arquivo adicionado forem iguais ao nome e ao caminho de um arquivo ausente (o que pode ocorrer, por exemplo, quando o arquivo ausente foi adicionado à pasta do projeto após a abertura do projeto no Altium Designer), será exibida uma caixa de diálogo de confirmação perguntando se você deseja substituir o arquivo ausente pelo selecionado.
Comparação de documentos locais com dados de commit ou liberação
Para projetos hospedados em um Workspace, você pode comparar documentos de esquemático, PCB e BOM salvos localmente com os dados de um commit ou de uma liberação desse projeto. Os comandos para selecionar o conjunto de dados desejado com o qual os documentos locais devem ser comparados podem ser acessados nos seguintes locais:
- No menu History & Version Control » Compare To acessado com o botão direito do mouse sobre o documento do projeto no painel Projects.
- No menu do botão Compare na caixa de diálogo Save to Server.
-
No menu do controle
do bloco Local Changes da visualização Project History.
- Quando o comando Latest Commit ou Latest Release for selecionado, será iniciada a comparação dos dados do projeto com os dados da entrada de commit/liberação mais recente.
- Quando o comando Select Document Version or Release (do painel Projects) ou o comando Select Commit or Release (da caixa de diálogo Save to Server) for selecionado, a visualização Document History ou Project History, respectivamente, será aberta para o documento/projeto selecionado. Selecione o bloco de um commit ou de uma liberação para comparar os dados salvos localmente com os dados desse commit ou dessa liberação.
Após a conclusão, os resultados da comparação são apresentados na visualização Compare, que é aberta como uma nova aba no seu navegador padrão.
Painel Clipboard
O painel Clipboard pode ser usado para armazenar e exibir objetos copiados que podem ser adicionados (colados) aos documentos do Altium Designer a qualquer momento, permitindo várias operações de copiar/colar.
Visualize e aplique (cole) o conteúdo do painel Clipboard para todos os tipos de dados de projeto.
Conteúdo e uso do painel Clipboard
Conteúdo do painel
O painel Clipboard oferece suporte a diversos formatos de dados, dependendo da origem e do tipo de objeto. Ele pode ser configurado para exibir apenas objetos copiados ou recortados no ambiente do Altium Designer ou todo o conteúdo da área de transferência do Windows (essa configuração é acessada por meio de Preferences na página System - General da caixa de diálogo Preferences). Observe que nem todos os tipos de dados são compatíveis com cada editor de projeto (editor de PCB, editor de esquemáticos etc.).
Os tipos de dados compatíveis são:
- Qualquer objeto de projeto copiado ou recortado de um documento baseado em esquemático (esquemático/biblioteca de esquemáticos) ou em PCB (PCB/biblioteca de PCB).
- Texto Unicode copiado ou recortado de qualquer documento de texto (por exemplo, arquivo de texto, arquivo de script, arquivo de restrições, documento do Microsoft Word/Excel etc.).
- Imagens bitmap criadas a partir dos modos de visualização 3D para colagem em outros aplicativos.
- Formatos de imagem de metarquivo avançado do Windows (por exemplo, imagens bitmap simples ou textos recortados/copiados de documentos do Microsoft Word/Excel). Esse tipo de dado é compatível apenas com o editor de PCB.
Uso do painel
À medida que objetos ou textos são copiados/recortados, uma entrada correspondente aparece na área principal de listagem do painel em seu formato nativo, ou seja, gráfico ou texto.
Para colar um item no documento ativo na janela do editor de projeto, clique no item no painel Clipboard . O comportamento da colagem depende do objeto que está sendo colado e do tipo de documento de destino, conforme descrito abaixo:
- Ao colar objetos baseados em esquemático ou em PCB em um documento, o objeto aparecerá flutuando junto ao cursor. Posicione o objeto conforme necessário na área de trabalho e clique para posicioná-lo.
- Ao colar texto em um documento de texto, o texto será inserido na posição atual do cursor no documento.
Use o botão Paste All na parte superior do painel para colar todos os objetos do painel no documento ativo. Novamente, o comportamento da colagem depende do documento de destino:
- Somente objetos compatíveis com o tipo de documento de destino serão colados. Cada objeto do painel aparecerá, por sua vez, flutuando junto ao cursor na área principal de trabalho do projeto. Posicione cada objeto no local desejado e clique para posicioná-lo.
- Ao colar em documentos de PCB, se o objeto for redimensionável, serão exibidas alças que podem ser arrastadas para redimensioná-lo. Clique com o botão direito do mouse para ativar o redimensionamento e avançar para o próximo objeto a ser colado.
- Quando o documento de destino for um documento de texto, somente as entradas de texto serão coladas. Cada entrada de texto do painel será colada, em ordem, a partir da posição atual do cursor de texto.
Clique com o botão direito do mouse sobre uma entrada no painel para abrir um menu de contexto que permite colar ou excluir essa entrada.
Notas
- Você só pode colar objetos do painel se eles forem compatíveis com o documento de destino aberto (o documento ativo) na janela do editor de projeto. Por exemplo, se você tentar colar um objeto baseado em esquemático em um documento de texto, nada acontecerá, e vice-versa.
- Os objetos de texto copiados para o painel serão exibidos como se estivessem sem formatação. No entanto, ao serem colados, eles aparecerão com a formatação original que tinham antes de serem copiados.
- É recomendável posicionar o cursor de texto no local desejado antes de colar texto do painel em um documento de texto.
- Ao usar Paste All para colar várias entradas de texto em um documento de texto, o texto colado será, na prática, concatenado, ou seja, cada entrada de texto subsequente será colada imediatamente após a anterior.
- Clipboard O conteúdo do painel não é mantido entre as sessões de projeto. Todo o conteúdo será apagado quando o software for fechado e reiniciado.
).






).


