Histórico do projeto
Num relance
- Aprenda a abrir o histórico de projetos e arquivos, navegar pelos eventos e filtrar a linha do tempo usando a pesquisa.
- Entenda os requisitos de configuração, incluindo a extensão de Histórico do Projeto e o controle de versão Git nativo do Workspace.
- Descubra como revisar alterações de commits, abrir revisões somente para leitura, comparar dados de esquemáticos, PCBs e BOMs e gerenciar tags de commits.
O Altium Designer, em conjunto com um Workspace conectado, permite visualizar e interagir com uma linha do tempo Project History avançada com orientação gráfica. A visualização History dedicada fornece uma linha do tempo progressiva dos principais eventos relacionados ao projeto de PCB, Multi-board ou de chicote elétrico — sua criação, commits, liberações, cópias e trocas MCAD — com suporte a várias ações, quando aplicável.
Acesso ao histórico do projeto
Para acessar a visualização History de um projeto do Workspace no Altium Designer, clique com o botão direito do mouse na entrada correspondente no painel Projects e escolha o comando History & Version Contol » Show Project History no menu de contexto. Como alternativa, selecione o comando History & Version Control » Show Project History no menu principal Project para abrir a visualização de histórico do projeto ativo do Workspace. A visualização History é apresentada como um documento em uma aba separada (<ProjectName>.PrjPcb History).
Linha do tempo do histórico — Visão geral
A visualização History apresenta uma linha do tempo dos eventos básicos que ocorreram durante a evolução do projeto. Ela pode ser dividida em três seções principais, conforme mostrado na imagem e nos detalhes a seguir.
Identificação dos três componentes principais da visualização History .
- Main trunk of the timeline. A ordem cronológica dos eventos segue de baixo para cima. O primeiro evento — a criação do projeto — aparecerá na parte inferior da linha do tempo. Os eventos subsequentes aparecem acima, com o mais recente (o evento mais atual) no topo da linha do tempo.
- Events. Sempre que um evento compatível (veja abaixo) ocorre em associação com o projeto, ele é adicionado à linha do tempo como um bloco dedicado. Cada tipo de evento terá um bloco de cor diferente e estará vinculado diretamente ao tronco principal da linha do tempo ou terá um ícone adicional ao lado (como ocorre com os eventos de troca MCAD).
-
Search. Clique no controle
no canto superior direito da visualização para acessar um campo de pesquisa que facilita pesquisas básicas no histórico do projeto. À medida que você digita o texto de pesquisa, a linha do tempo é filtrada para apresentar apenas os eventos relevantes para essa pesquisa. Para obter mais informações, consulte Pesquisa com filtros.
Eventos compatíveis
A linha do tempo mostra uma progressão de eventos que ocorrem durante a vida de um projeto. Cada um desses eventos aparece ao longo da linha do tempo como um “bloco de evento” dedicado. As seções expansíveis a seguir examinam os tipos de eventos atualmente compatíveis que podem ser apresentados como parte da linha do tempo histórica de um projeto.
Criação do projeto
Refer to: Criação de um projeto, Disponibilização de um projeto existente on-line
Quando um projeto é criado, o bloco de evento Project Created é adicionado à linha do tempo. Esse evento marca o início da linha do tempo histórica do projeto. Assim, ele sempre pode ser encontrado como a entrada na parte inferior da linha do tempo. O bloco desse evento pode aparecer em duas variações distintas:
- Quando um projeto é criado do zero no Workspace. O criador do projeto é apresentado pelo nome (e pela foto), junto com a data e a hora de criação do projeto. A descrição do projeto também é exibida no bloco, caso tenha sido inserida no momento da criação.
- Quando o projeto é uma cópia de um projeto existente. A pessoa que criou o projeto copiado é apresentada pelo nome, junto com a data e a hora de criação do projeto. A descrição do projeto também é exibida no bloco, caso tenha sido inserida no momento da cópia. É fornecido um link para o projeto original; ao clicar nele, você acessará a página de gerenciamento detalhado desse projeto pela interface do Workspace no navegador.
Commit do projeto
Sempre que você fizer commit de um projeto no Workspace (onde o projeto é gerenciado no Versioned Storage repositório Git interno do Workspace), um bloco de evento Project Committed será adicionado à linha do tempo. A pessoa que realizou o commit (Salvar no servidor) é identificada pelo nome (e pela foto), juntamente com a data e a hora. Se um comentário tiver sido adicionado no momento do commit e enviado por push — usando a caixa de diálogo Commit no controle de versão —, ele também será exibido no bloco.
Exemplo de bloco de evento inicial Project Committed.
O bloco também oferece suporte e apresenta informações de comparação de diferenças do projeto, mostrando com mais detalhes o que mudou entre o commit atual e o anterior. Os elementos compatíveis incluem arquivos, componentes, redes, variantes e estrutura da PCB. A seção de diferenças do bloco resume os vários elementos afetados pelo evento de commit, agrupados pelos seguintes estados:
– elemento adicionado.
– elemento removido.
– elemento modificado.
Clicar no controle
do bloco expandirá essa seção de diferenças para apresentar os elementos afetados por nome.
Clique no controle
no canto superior direito do bloco para acessar um menu com os seguintes comandos:
-
Download Sources - uUse para baixar e abrir essa revisão específica do projeto de PCB ou de chicote elétrico no painel Projetos. O nome do projeto incluirá a data e a hora em que o commit dessa revisão foi realizado. Observe que essa revisão é somente leitura; você pode visualizá-la, mas não editá-la.

Você pode abrir (somente para visualização) qualquer revisão específica do projeto — diretamente do bloco de evento Project Committed correspondente a essa revisão. -
Compare: Schematic to, PCB to, BOM to – permite comparar os dados de esquemático, PCB ou BOM do projeto de PCB neste commit com os de outro evento de commit ou de liberação. Use o submenu para comparar com o commit anterior ou selecionar entre todas as liberações e commits possíveis. Após escolher os dados para comparação, os resultados serão apresentados na visualização de diferenças correspondente, que será aberta em uma nova aba do seu navegador padrão. Para obter mais informações, consulte Design Data Comparisons (Workspace do Altium 365, Workspace do Enterprise Server).
-
Create Tag – adicione uma única tag com nome personalizado a qualquer commit de um projeto de engenharia (somente quando esse projeto estiver armazenado em um Workspace sob seu sistema VCS Git interno). Você só pode criar uma tag para um commit que já esteja salvo no Workspace. Após executar o comando, a caixa de diálogo Create Tag será aberta. Insira a tag desejada e clique em Create.
Quando uma tag inserida contém um caractere inválido, o ícone
aparece na caixa de diálogo Create Tag. Passe o cursor sobre o ícone para ver uma dica sobre quais caracteres são permitidos, ou seja, letras, números, ponto ('.'), hífen ('-'), cerquilha ('#') e sublinhado ('_'); atualize a tag conforme necessário.
Quando o projeto for liberado usando o Project Releaser e seu commit mais recente ainda não tiver uma tag, uma tag será atribuída automaticamente a esse commit. Essa tag terá o formato RELEASE_<RevisionID>, em que <RevisionID> é o número da revisão dos arquivos-fonte do projeto liberado (A.1, A.2, etc.), por exemplo, RELEASE_A.3.
Para renomear ou excluir uma tag, clique em
e passe o cursor sobre a entrada Tag . Será aberta uma caixa de diálogo na qual você poderá inserir o novo nome da tag. Se Remove for selecionado, a tag será excluída imediatamente.
- Criar uma cópia – use para criar uma cópia a partir dessa revisão específica do projeto. A caixa de diálogo Create Project Copy será aberta, na qual você deverá inserir um Project Name (por padrão, será o nome original do projeto com o sufixo ' - Copy'), Description (que não vem preenchido), o caminho Folder (dentro do Workspace) e o caminho Local Storage (para a cópia de trabalho). O projeto será criado e um bloco de evento Project Copied será adicionado à linha do tempo.
-
Revert to – use este comando para voltar a usar os dados dessa revisão específica do projeto. Os dados dos documentos-fonte do projeto nessa revisão específica substituem os dados da sua cópia de trabalho local do projeto. Na prática, o projeto é fechado momentaneamente e reaberto com os dados restaurados. Se quiser concluir a reversão e tornar esses dados a revisão mais recente (versão atual), você deverá fazer o commit e enviar o projeto de volta ao Workspace.
Você pode reverter para qualquer revisão específica do projeto diretamente pelo bloco de evento Project Committed correspondente a essa revisão.
Liberação do projeto
Related page: Liberação do projeto de design
Sempre que você libera uma versão do projeto de PCB usando o Project Releaser do Altium Designer, um bloco de evento Project Released é adicionado à linha do tempo. A pessoa que realizou a liberação é identificada pelo nome (e pela foto), junto com a data e a hora. Se uma nota de liberação tiver sido adicionada ao liberar os dados gerados para o Workspace, por meio da caixa de diálogo Confirmar liberação, ela também será exibida no bloco. Cada um dos conjuntos de dados incluídos na liberação também será listado.
Exemplo de bloco de evento Project Released.
Clique no controle
no canto superior direito do bloco para acessar um menu com os seguintes comandos:
- Download Sources – use este comando para baixar e abrir (no painel Projects ) a revisão específica do projeto a partir da qual este pacote de liberação foi gerado. O nome do projeto incluirá a versão da liberação. Observe que essa revisão é somente leitura: você pode visualizá-la, mas não pode editá-la de nenhuma forma.
- Compare: Schematic to, PCB to, Gerber to, BOM to – permite comparar os dados de esquemático, PCB ou BOM desta liberação com os de outra liberação ou evento de commit. Para arquivos Gerber gerados, você pode comparar os dados desta liberação com os de outra liberação ou, ao usar um Workspace do Altium 365, com um conjunto de arquivos Gerber carregado. Use o submenu para comparar com o conjunto de dados desejado. Após a seleção dos dados para comparação, os resultados são apresentados na visualização de diferenças correspondente, que é aberta em uma nova aba do seu navegador padrão. Para mais informações, consulte Design Data Comparisons (Workspace do Altium 365, Workspace do Enterprise Server).
Como copiar um projeto
Sempre que você copia o projeto, seja pela interface do Workspace no navegador ou pelo Altium Designer, um bloco de evento Project Copied é adicionado à linha do tempo. A pessoa que realizou a cópia é identificada pelo nome e pela foto, junto com a data e a hora. Se uma descrição tiver sido adicionada no momento da cópia pela janela Clone Project (no navegador) ou pela caixa de diálogo Create Project Copy (no Altium Designer), ela também será exibida no bloco. Um link para o projeto copiado é fornecido. Ao clicar nele, você acessará a página de gerenciamento detalhado desse projeto pela interface do Workspace no navegador.
Exemplo de bloco de evento Project Copied.
Trocas com MCAD
Related page: Altium MCAD CoDesigner
Ao trabalhar entre os domínios de projeto eletrônico e mecânico, o Workspace atua como uma ponte entre os dois, facilitando o codesign direto ECAD-MCAD. Sempre que alterações são feitas no projeto de PCB e enviadas ao Workspace pelo painel CoDesigner correspondente, um bloco de evento MCAD Changes Suggested é adicionado à linha do tempo. A pessoa que realizou o envio é identificada pelo nome (e pela foto), junto com a data e a hora. Se uma mensagem tiver sido publicada no momento do envio, pelo painel MCAD CoDesigner (Altium Designer) ou pelo painel Altium CoDesigner (no software MCAD compatível), ela também será exibida no bloco.
Exemplo de bloco de evento MCAD Changes Suggested.
Quando o engenheiro mecânico faz alterações na PCB em seu software MCAD compatível e as envia de volta ao Workspace, o evento de envio correspondente fica disponível na linha do tempo do histórico do projeto only após importar as alterações do Workspace para o Altium Designer.
Exemplo mostrando dois eventos relacionados ao MCAD. À esquerda do eixo da linha do tempo, o evento de envio do lado ECAD; à direita, o evento de envio do lado MCAD.
Alterações locais
Quando houver documentos do projeto de PCB salvos localmente, mas ainda não no Workspace, um bloco de evento Local Changes será adicionado ao topo da linha do tempo. A pessoa que salvou os documentos localmente (ou seja, o usuário atual) é identificada pelo nome (e pela foto).

Exemplo de bloco de evento Local Changes.
Clique no controle
no canto superior direito do bloco para acessar um menu com o seguinte comando:
- Compare: Schematic to, PCB to, BOM to – permite comparar os dados de esquemático, PCB ou BOM salvos localmente neste commit com os de um evento de commit ou de liberação. Use o submenu para comparar com os dados-fonte da liberação anterior, com os dados-fonte do commit anterior ou selecionar entre todas as liberações e commits disponíveis. Depois que os dados para comparação forem escolhidos, os resultados serão apresentados na visualização de diferenças correspondente, que é aberta em uma nova aba do navegador padrão. Para obter mais informações, consulte Design Data Comparisons (Altium 365 Workspace, Enterprise Server Workspace).
Pesquisa com filtro
Clique no controle
no canto superior direito da visualização para acessar um campo de pesquisa que permite encontrar rapidamente eventos de interesse na linha do tempo. O recurso de pesquisa permite realizar buscas básicas no histórico do projeto, com filtragem dinâmica à medida que você digita o texto de pesquisa – deixando na página apenas os eventos relevantes para essa pesquisa. O texto correspondente em cada bloco de evento é destacado.
Exemplo de pesquisa no histórico de um projeto. A linha do tempo é filtrada dinamicamente à medida que você digita o termo de pesquisa (sem distinção entre maiúsculas e minúsculas), com as correspondências destacadas em cada bloco de evento relevante.
O recurso de pesquisa considera as seguintes informações:
- Título do bloco de evento.
- Nome da pessoa que realizou o evento.
- Texto descritivo (o texto proveniente de um comentário/nota/descrição registrado quando o evento correspondente ocorreu).
- Texto dos dados de comparação de diferenças – em um bloco de evento Project Committed.
- Nome do conjunto de dados – em um bloco de evento Project Released.
- Nome do projeto – em um bloco de evento Project Copied e em um bloco de evento Project Created (quando criado por cópia).
Atualização com novos eventos
Sempre que ocorrer um evento compatível relacionado ao projeto, ele será detectado e disponibilizado automaticamente na visualização History . Uma notificação aparecerá na parte inferior da visualização logo após a ocorrência do evento – clique no controle
para atualizar a linha do tempo com o novo evento.
Criação de um relatório do histórico do projeto
É possível criar um relatório do histórico do projeto em formato PDF para um projeto do Workspace. O relatório exibe todas as informações sobre o histórico do projeto, incluindo criação, commits e liberações, além de uma descrição das alterações em relação ao evento anterior. Você também pode definir o período do relatório (conforme descrito abaixo) para obter exatamente o relatório de que precisa.
A partir de um OutJob
Para criar o relatório, no arquivo OutputJob (*.OutJob), clique com o botão direito do mouse em [Add New Report Output] associado à entrada Report Outputs e escolha Project History, conforme mostrado abaixo.
Conecte o relatório recém-criado a um contêiner de saída PDF. Defina o período do relatório clicando com o botão direito do mouse na saída criada e selecionando Configure. Habilite o período Period desejado: For all time (da criação do projeto até o presente) ou Specific releases (use as listas suspensas do campo From/To para definir as liberações desejadas). O relatório exportado conterá as informações do período selecionado.
Depois de criar o relatório, vinculá-lo a um contêiner de saída PDF e configurá-lo, clique em Generate content, na área do contêiner PDF ou, se preferir, gere o relatório do histórico do projeto como parte do processo de liberação do projeto.


para abrir a caixa de diálogo Choose Folder (uma versão simplificada do painel Explorer) e alterar a pasta conforme necessário. O Local Storage será configurado, por padrão, para usar o local definido na página 

