Histórico do projeto

Num relance

Explore como a visualização de Histórico do Projeto do Altium Designer ajuda você a acompanhar a evolução de um projeto conectado a um Workspace por meio de uma linha do tempo gráfica de criação, commits, liberações, cópias e trocas com MCAD. Este artigo explica como acessar e navegar pela linha do tempo, entender os blocos de eventos e usar as ações de commit para inspecionar alterações, visualizar revisões anteriores, comparar dados de projeto e gerenciar tags. Também esclarece por que o controle de versão nativo do Workspace é importante para acessar o histórico de commits. Continue lendo para aproveitar melhor o histórico do seu projeto.

- 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.
Aprofunde-se com a IA:

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.

Para aproveitar ao máximo esse recurso, seu projeto deve ser totalmente gerenciado, garantindo que ele esteja sob o VCS (Git) integrado do próprio Workspace.

Se o seu projeto estiver sob controle de versão externo, você poderá convertê-lo em um projeto totalmente gerenciado hospedado no Altium 365 Workspace, migrando-o para o VCS nativo do Workspace. Para obter informações detalhadas sobre como fazer isso, consulte Migração de um VCS externo para o VCS nativo do Workspace.

Para obter informações sobre como trabalhar com a visualização History de um projeto pela interface do Workspace no navegador, consulte Histórico do projeto.

Para acessar os recursos de histórico do projeto no Altium Designer, a extensão de software Project History deve estar instalada. Essa extensão é instalada por padrão com o Altium Designer. Ela pode ser instalada ou removida manualmente.

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

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).

Para um projeto do seu Workspace que já existia antes da chegada do recurso de histórico do projeto, o histórico inicialmente estará incompleto. A reindexação dos dados de eventos desse projeto será realizada automaticamente quando a visualização History for acessada pela primeira vez para ele. Uma notificação aparecerá na parte inferior da visualização quando a reindexação for concluída — clique no controle para atualizar a linha do tempo com todos os dados históricos de eventos.
Para acessar a visualização History de um arquivo de um projeto do Workspace, ou seja, a linha do tempo dos principais eventos do projeto relacionados ao arquivo, clique com o botão direito do mouse no arquivo no painel Projects e escolha o comando History & Version Control » Show File History no menu de contexto.

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 .Identificação dos três componentes principais da visualização History .

  1. 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.
  2. 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).
  3. 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.

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.

A pesquisa não diferencia maiúsculas de minúsculas.

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.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.

Uma caixa acima da seleção filtrada informa quantos eventos estão sendo exibidos e apresenta controles para remover rapidamente o filtro/texto de pesquisa.

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).
Para remover a filtragem atual e retornar à linha do tempo completa, limpe o campo de pesquisa – selecionando o texto atual e pressionando a tecla Backspace ou clicando no controle na extremidade direita do campo. Como alternativa, clique no controle Clear Filter na caixa que informa quantos eventos estão sendo exibidos (na parte superior da visualização).

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.

Também é possível atualizar manualmente clicando no controle no canto superior direito da visualização.

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.

A partir do menu Reports

O histórico do projeto pode ser exportado para PDF selecionando Reports » Project History nos menus principais. A caixa de diálogo Project History Report Configuration  é aberta, permitindo definir o Period para o qual o relatório deve ser exportado: todo o histórico do projeto ou um intervalo entre liberações específicas do projeto (ou a mais recente). Clique em Export e insira um nome para o PDF exportado na janela Explorer que será aberta. Em seguida, clique em Save. O relatório PDF será aberto em um navegador.
AI-LocalizedLocalizado por IA
Caso encontre um problema, selecione o texto/imagem e primaCtrl + Enterpara nos enviar o seu feedback.
Nav
Contents
Disponibilidade de Recursos

Os recursos disponíveis para você dependem de qual solução Altium você possui – Altium Develop, Altium Agile Teams, Altium Agile Enterprise ou Altium Designer (com assinatura ativa).

Se você não vir um recurso documentado no software que está usando no momento, entre em contato com a equipe de vendas da Altium para saber mais.

Documentação Legada

A documentação do Altium Designer já não é versionada. Se precisar de aceder à documentação de versões anteriores do Altium Designer, visite a secção Documentação Legada da página de Outros Instaladores.

Contents