Project History

O Altium Designer, em conjunto com um Workspace ligado, permite-lhe visualizar e interagir com uma Project Historycronologia avançada orientada graficamente. A Historyvista dedicada fornece uma cronologia progressiva dos principais eventos relacionados com o projeto PCB, Multi-board ou Harness – a sua criação, commits, releases, cópias e trocas MCAD – com várias ações suportadas, quando aplicável.

Para tirar o máximo partido desta funcionalidade, é necessário que o seu projeto seja totalmente gerido, garantindo que está sob o VCS integrado do próprio Workspace (Git).

Se o seu projeto estiver sob controlo de versões externo, pode convertê-lo num projeto totalmente gerido e alojado no Altium 365 Workspace, migrando o projeto para o VCS nativo do Workspace. Para informações detalhadas sobre como o fazer, consulte Moving from External VCS to Workspace Native VCS.

Para obter informações sobre como trabalhar com a Historyvista de um projeto através da interface de navegador do Workspace, consulte Project History.

Para aceder às capacidades de histórico do projeto no Altium Designer, a extensão de software Project History tem de estar instalada. Esta extensão é instalada com o Altium Designer por predefinição. Pode ser instalada ou removida manualmente.

Para mais informações sobre a gestão de extensões, consulte a página Extending Your Installation (Altium Designer Develop, Altium Designer Agile, Altium Designer).

Aceder ao histórico do projeto

Para aceder à Historyvista de um projeto do Workspace a partir do Altium Designer, clique com o botão direito na respetiva entrada no painel Projects e escolha o History & Version Contol » Show Project History comando no menu de contexto. Em alternativa, selecione o History & Version Control » Show Project History comando no menu principal Projects para abrir a vista History do projeto ativo do Workspace. A History vista é apresentada como um documento com separador próprio (<ProjectName>.PrjPcb History).

No caso de um projeto no seu Workspace que já existisse antes da introdução da funcionalidade Project History, o respetivo histórico não estará inicialmente completo. A reindexação dos dados de eventos desse projeto será efetuada automaticamente quando a History vista for acedida pela primeira vez para esse projeto. Será apresentada uma notificação na parte inferior da vista assim que a reindexação estiver concluída – clique no controlo para atualizar a cronologia com os dados completos do histórico de eventos.
Para aceder à Historyvista de um ficheiro de um projeto do Workspace, isto é, à cronologia dos principais eventos do projeto relacionados com o ficheiro, clique com o botão direito no ficheiro no painel Projects e, em seguida, escolha o History & Version Control » Show File History comando no menu de contexto.

Cronologia do histórico – Visão geral

A History vista apresenta uma cronologia dos eventos básicos que ocorreram durante a evolução do projeto. Pode, essencialmente, ser dividida em três secções principais, conforme mostrado na imagem seguinte e descrito em detalhe.

Identificação dos três componentes principais da History vista.Identificação dos três componentes principais da History vista.

  1. Main trunk of the timeline. A direção da cronologia dos eventos é de baixo para cima. O primeiro evento – a criação do projeto – surgirá na parte inferior da cronologia. Os eventos subsequentes aparecem acima, sendo que o mais recente (o evento atual mais recente) surge no topo da cronologia.
  2. Events. Sempre que ocorrer um evento suportado (ver abaixo) associado ao projeto, esse evento é adicionado à cronologia como um bloco dedicado. Cada tipo de evento terá um bloco de cor diferente e estará ligado diretamente ao tronco principal da cronologia ou terá um ícone adicional ao lado (como acontece com os eventos de MCAD Exchange).
  3. Search. Clique no controlo no canto superior direito da vista para aceder a um campo de pesquisa que facilita a pesquisa básica do histórico do projeto. À medida que introduz o texto de pesquisa, será aplicada filtragem à cronologia para apresentar apenas os eventos relevantes para essa pesquisa. Para mais informações, consulte Filtered Searching.

Eventos suportados

A cronologia mostra uma progressão de eventos que acontecem ao longo da vida de um projeto. Cada um destes eventos surge ao longo da cronologia como um “bloco de evento” dedicado. As secções expansíveis seguintes analisam o conjunto de eventos atualmente suportados e apresentáveis como parte da cronologia histórica de um projeto.

Pesquisa Filtrada

Clique no controlo no canto superior direito da vista para aceder a um campo de pesquisa com o qual pode encontrar rapidamente eventos de interesse ao longo da linha temporal. A funcionalidade de pesquisa suporta pesquisa básica no histórico do projeto, com filtragem dinâmica aplicada à medida que escreve a sua cadeia de pesquisa – deixando apenas os eventos relevantes para essa pesquisa apresentados na página. O texto correspondente dentro de um mosaico de evento é realçado.

A funcionalidade de pesquisa não distingue maiúsculas de minúsculas.

Exemplo de pesquisa no histórico de um projeto. A linha temporal é filtrada dinamicamente à medida que escreve o seu termo de pesquisa (sem distinção entre maiúsculas e minúsculas), com as entradas correspondentes realçadas em cada mosaico de evento relevante.Exemplo de pesquisa no histórico de um projeto. A linha temporal é filtrada dinamicamente à medida que escreve o seu termo de pesquisa (sem distinção entre maiúsculas e minúsculas), com as entradas correspondentes realçadas em cada mosaico de evento relevante.

É disponibilizada uma caixa acima da seleção filtrada que resume quantos eventos estão atualmente a ser mostrados, juntamente com controlos para remover rapidamente o filtro/cadeia de pesquisa.

A funcionalidade de pesquisa funciona com a seguinte informação:

  • Título do mosaico de evento.
  • Nome da pessoa que executou o evento.
  • Texto descritivo (o texto proveniente de um comentário/nota/descrição quando o evento relevante ocorreu).
  • Texto de dados de diferenças – num mosaico de evento Project Committed.
  • Nome do conjunto de dados – num mosaico de evento Project Released.
  • Nome do projeto – num mosaico de evento Project Copied e num mosaico de evento Project Created (quando criado através de cópia).
Para limpar a filtragem atual e regressar à linha temporal completa, limpe o campo de pesquisa – quer selecionando o texto atual e premindo a tecla Backspace , quer clicando no controlo na extremidade direita do campo. Em alternativa, clique no controlo Clear Filter na caixa que resume quantos eventos estão a ser mostrados (no topo da vista).

Atualização com Novos Eventos

Sempre que ocorre um evento suportado relacionado com o projeto, esse evento será detetado e disponibilizado automaticamente na vista History . Surgirá uma notificação na parte inferior da vista pouco depois de o evento ocorrer – clique no controlo para atualizar a linha temporal com o novo evento.

Também é disponibilizada uma atualização manual clicando no controlo no canto superior direito da vista.

Criar um Relatório do Histórico do Projeto

Pode ser criado um relatório do Histórico do Projeto em formato PDF para um projeto do Workspace. O relatório apresenta toda a informação sobre o histórico do projeto, incluindo criação, commits e releases, bem como uma descrição das alterações desde o evento anterior. Também pode definir o período temporal para o relatório (descrito abaixo), para obter o relatório definitivo de que necessita.

A partir de um OutJob

Para criar o relatório, no ficheiro OutputJob (*.OutJob), clique com o botão direito no [Add New Report Output] associado à entrada Report Outputs e escolha Project History, como mostrado abaixo.

Ligue o relatório recém-criado a um contentor de saída PDF. Defina o período temporal para o relatório clicando com o botão direito na saída criada e selecionando Configure. Ative o Period temporal pretendido: For all time (desde a criação do projeto até ao presente), ou Specific releases (utilize as listas pendentes do campo From/To para definir os releases pretendidos). O relatório exportado conterá a informação referente ao período temporal que selecionou.

Depois de o seu relatório ter sido criado, ligado a um contentor de saída PDF e configurado, na região do contentor PDF, clique em Generate content, ou, se pretender, pode gerar o relatório do histórico do projeto como parte do processo de release do projeto.

A partir do Menu Reports

O Histórico do Projeto pode ser exportado para PDF escolhendo Reports » Project History nos menus principais. Abre-se a caixa de diálogo Project History Report Configuration , onde pode definir o Period para o qual o relatório deve ser exportado: todo o histórico do projeto ou desde/até um release específico (ou o mais recente) do projeto. Clique em Export e depois introduza um nome para o PDF exportado na janela Explorer que se abre, e em seguida clique em Save. O relatório PDF abre num navegador.
AI-LocalizedAI-localized
If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
Feature Availability

The features available to you depend on which Altium solution you have – Altium Develop, an edition of Altium Agile (Agile Teams or Agile Enterprise), or Altium Designer (on active term).

If you don’t see a discussed feature in your software, contact Altium Sales to find out more.

Legacy Documentation

Altium Designer documentation is no longer versioned. If you need to access documentation for older versions of Altium Designer, visit the Legacy Documentation section of the Other Installers page.

Conteúdo