Histórico do projeto
Altium Designer, em conjunto com um Workspace conectado, permite visualizar e interagir com uma Project Historylinha do tempo avançada orientada graficamente. A Historyvisualização dedicada fornece uma linha do tempo progressiva dos principais eventos relacionados ao projeto de PCB, Multi-board ou Harness – sua criação, commits, releases, cópias e trocas MCAD – com várias ações suportadas, quando aplicável.
Acessando o Histórico do Projeto
Para acessar a HistoryvisualizaçãoHistory de um projeto do Workspace de dentro do Altium Designer, clique com o botão direito em sua entrada 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 History do projeto ativo do Workspace. A History visualização é apresentada como um documento com abas distinto (<ProjectName>.PrjPcb History).
Linha do Tempo do Histórico – Visão Geral
A History visualização apresenta uma linha do tempo dos eventos básicos que ocorreram durante a evolução do projeto. Ela pode essencialmente ser dividida em três seções principais, como mostrado na imagem e nos detalhes a seguir.
Identificando os três componentes principais da History visualização.
- Main trunk of the timeline. A direção da cronologia dos eventos é 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 atual) aparecendo no topo da linha do tempo.
- Events. Cada vez que um evento suportado (veja abaixo) ocorre em associação com o projeto, esse evento é adicionado à linha do tempo como um bloco de evento dedicado. Cada tipo de evento terá um bloco de cor diferente e estará diretamente vinculado ao tronco principal da linha do tempo ou terá algum ícone adicional ao lado (como é o caso dos eventos de MCAD Exchange).
-
Search. Clique no controle
no canto superior direito da visualização para acessar um campo de pesquisa que facilita a busca básica no histórico do projeto. À medida que você digita a sequência de pesquisa, a filtragem será aplicada à linha do tempo para apresentar apenas os eventos relevantes para essa pesquisa. Para mais informações, consulte Filtered Searching.
Eventos Suportados
A linha do tempo mostra uma progressão de eventos que acontecem ao longo da 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 o conjunto de eventos atualmente suportados e apresentáveis como parte da linha do tempo histórica de um projeto.
Project Creation
Refer to: Criando um Projeto, Tornando um Projeto Existente Disponível Online
Quando um projeto é criado, o bloco de evento Project Created será adicionado à linha do tempo. Esse evento marca o início da linha do tempo histórica do projeto. Como tal, 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 é recém-criado dentro do Workspace. O criador do projeto é apresentado pelo nome (e imagem), juntamente com a data e a hora de criação do projeto. A descrição do projeto também é exibida dentro do 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, juntamente com a data e a hora da criação do projeto. A descrição do projeto também é exibida dentro do bloco, caso tenha sido inserida no momento da cópia. Um link é fornecido para o projeto original; clicar nele abrirá a página de gerenciamento detalhado desse projeto por meio da interface de navegador do Workspace.
Project Commit
Cada vez que você faz Commit de um projeto no Workspace (quando o projeto é gerenciado sob o repositório interno Versioned Storage Git do Workspace), um bloco de evento Project Committed será adicionado à linha do tempo. A pessoa que realizou o commit (Save to Server) é apresentada pelo nome (e imagem), juntamente com a data e a hora. Se um comentário tiver sido adicionado no momento do commit e enviado – usando a caixa de diálogo Commit to Version Control dialog – ele também será exibido dentro do bloco.
Exemplo de bloco de evento inicial Project Committed.
O bloco também suporta e apresenta informações de comparação de diferenças do design, mostrando informações mais detalhadas sobre o que mudou entre o commit atual e os commits anteriores. Os elementos suportados incluem arquivos, componentes, nets, 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
no 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 Harness no painel Projects. O nome do projeto incluirá a data e a hora em que essa revisão foi submetida por commit. 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 àquela revisão. -
Compare: Schematic to, PCB to, BOM to – permite comparar os dados de Schematic, PCB ou BOM deste commit com os de outro evento de commit ou release. Use o submenu para comparar com o commit anterior ou selecione entre todos os releases e commits possíveis. Depois que os dados forem escolhidos para comparação, os resultados da comparação serão apresentados na visualização de diferenças associada, que será aberta como uma nova aba no seu navegador padrão. Para mais informações, consulte Design Data Comparisons (Altium 365 Workspace, Enterprise Server Workspace).
-
Create Tag – adiciona uma única tag personalizada a qualquer commit de um projeto de design (e somente quando esse projeto estiver armazenado em um Workspace sob seu sistema VCS Git interno). Você pode criar uma tag apenas para o commit que já está 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 for inserida contendo um caractere ilegal, o ícone
aparecerá na caixa de diálogo Create Tag. Passe o cursor sobre o ícone para visualizar 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 é liberado usando o Project Releaser e seu commit mais recente ainda não possui uma tag, uma tag será atribuída automaticamente a esse commit mais recente. Essa tag terá o formato RELEASE_<RevisionID>, em que <RevisionID> é o número de revisão dos fontes liberados do projeto (A.1, A.2, etc.,), por exemplo, RELEASE_A.3.
Para renomear ou excluir uma tag, clique em
e depois passe o cursor sobre a entrada Tag . Uma caixa de diálogo será aberta, na qual você poderá inserir o novo nome da tag. Se Remove estiver selecionado, a tag será excluída imediatamente.
-
Fazer 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 é aberta, na qual você insere um Project Name (por padrão, este será o nome original do projeto com o sufixo ' - Copy'), Description (que não é pré-preenchido), o caminho de
(dentro do Workspace) e o caminho de (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 reverter para o uso dos dados daquela 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 é momentaneamente fechado e depois reaberto com esses dados revertidos. Se você quiser concluir a reversão e tornar esses dados a Head Revision (versão atual), deverá fazer commit e push do projeto de volta para o Workspace.
Você pode reverter para qualquer revisão específica do projeto diretamente do bloco de evento Project Committed correspondente àquela revisão.
Project Release
Related page: Release de Projeto de Design
Cada vez que você realiza um release do projeto de PCB – usando o Project Releaser do Altium Designer – um bloco de evento Project Released será adicionado à linha do tempo. A pessoa que realizou o release é apresentada pelo nome (e imagem), juntamente com a data e a hora. Se uma nota de release tiver sido adicionada no momento da publicação dos dados gerados no Workspace – por meio da caixa de diálogo Confirm Release dialog – ela também será exibida dentro do bloco. Cada um dos conjuntos de dados incluídos no release 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 depois abrir (no painel Projects ) a revisão específica do projeto a partir da qual esse pacote de release foi gerado. O nome do projeto incluirá a versão do release. Observe que essa revisão é somente leitura; você pode visualizá-la, mas não editá-la de forma alguma.
- Compare: Schematic to, PCB to, Gerber to, BOM to – permite comparar os dados de Schematic, PCB ou BOM deste release com os de outro evento de release ou commit. Para Gerber gerado, você pode comparar os dados deste release com os de outro release 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. Depois que os dados forem escolhidos para comparação, os resultados da comparação serão apresentados na visualização de diferenças associada, que será aberta como uma nova aba no seu navegador padrão. Para mais informações, consulte Design Data Comparisons (Altium 365 Workspace, Enterprise Server Workspace).
Copying a Project
Toda vez que você copia o projeto, seja por meio da interface de navegador do Workspace ou de dentro do Altium Designer, um bloco de evento Project Copied é adicionado à linha do tempo. A pessoa que realizou a cópia é apresentada com nome, imagem, data e hora. Se uma descrição tiver sido adicionada no momento da cópia por meio da janela Clone Project (baseada em navegador) ou da caixa de diálogo Create Project Copy (Altium Designer), ela também será exibida dentro do bloco. Um link é fornecido para o projeto copiado. Clicar nele abrirá a página detalhada de gerenciamento desse projeto por meio da interface de navegador do Workspace.
Exemplo de bloco de evento Project Copied.
MCAD Exchanges
Related page: MCAD CoDesigner da Altium
Ao trabalhar entre os domínios de projeto eletrônico e mecânico, o Workspace atua como a ponte entre os dois – facilitando o codesign direto ECAD-MCAD. Sempre que alterações são feitas no projeto de PCB do projeto e essas alterações são enviadas ao Workspace por meio do painel CoDesigner relevante, um bloco de evento MCAD Changes Suggested será adicionado à linha do tempo. A pessoa que realizou o envio é apresentada pelo nome (e imagem), juntamente com a data e a hora. Se uma mensagem tiver sido publicada no momento do envio – por meio do painel MCAD CoDesigner (Altium Designer), ou do painel Altium CoDesigner (no software MCAD suportado) – ela também será exibida dentro do bloco.
Exemplo de bloco de evento MCAD Changes Suggested.
Quando o engenheiro de MCAD faz alterações na PCB no software MCAD compatível e as envia de volta para o Workspace, o evento de envio correspondente ficará disponível na linha do tempo do histórico do projeto only após puxar as alterações do Workspace para o Altium Designer.
Exemplo mostrando dois eventos relacionados a MCAD. À esquerda do tronco da linha do tempo, o evento de envio do lado ECAD; à direita, o evento de envio do lado MCAD.
Local Changes
Quando houver documentos do projeto PCB salvos localmente, mas ainda não no Workspace, um bloco de evento Local Changes será adicionado no topo da linha do tempo. A pessoa que realizou o salvamento local (ou seja, o usuário atual) é apresentada por nome (e 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 release. Use o submenu para comparar com os dados de origem do release anterior, com os dados de origem do commit anterior, ou selecionar entre todos os releases e commits possíveis. Depois que os dados forem escolhidos para comparação, os resultados da comparação serão apresentados na visualização de diferenças associada, que é aberta como uma nova guia no seu navegador padrão. Para mais informações, consulte Design Data Comparisons (Altium 365 Workspace, Enterprise Server Workspace).
Pesquisa filtrada
Clique no controle
no canto superior direito da visualização para acessar um campo de pesquisa com o qual você pode localizar rapidamente eventos de interesse ao longo da linha do tempo. O recurso de pesquisa oferece suporte à pesquisa básica no histórico do projeto, com filtragem dinâmica aplicada à medida que você digita o texto de pesquisa, deixando exibidos na página apenas os eventos relevantes para essa pesquisa. O texto correspondente dentro de um 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 diferenciar maiúsculas de minúsculas), com as entradas correspondentes destacadas em cada bloco de evento relevante.
O recurso de pesquisa funciona com as seguintes informações:
- Título do bloco de evento.
- Nome da pessoa que executou o evento.
- Texto descritivo (texto proveniente de um comentário/nota/descrição quando o evento relevante ocorreu).
- Texto de dados de comparação – 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, esse evento será detectado e disponibilizado automaticamente na visualização History . Uma notificação aparecerá na parte inferior da visualização pouco depois que o evento ocorrer – clique no controle
para atualizar a linha do tempo com o novo evento.
Criação de um relatório do histórico do projeto
Um relatório de Histórico do Projeto em formato PDF pode ser criado para um projeto do Workspace. O relatório exibe todas as informações sobre o histórico do projeto, incluindo criação, commits e releases, bem como uma descrição das alterações em relação ao evento anterior. Você também pode definir o período do relatório (descrito abaixo), para obter o relatório definitivo de que precisa.
De um OutJob
Para criar o relatório, no arquivo OutputJob (*.OutJob), clique com o botão direito no [Add New Report Output] associado à entrada Report Outputs e escolha Project History, como 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 na saída criada e selecionando Configure. Ative o Period de tempo desejado: For all time (desde a criação do projeto até o presente) ou Specific releases (use as listas suspensas do campo From/To para definir os releases desejados). O relatório exportado conterá as informações referentes ao período selecionado.
Depois que o relatório tiver sido criado, vinculado a um contêiner de saída PDF e configurado, na região do contêiner PDF, clique em Generate content, ou, se desejar, você pode gerar o relatório de histórico do projeto como parte do processo de project release.


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

