Histórico do projeto
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.
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).
para atualizar a cronologia com os dados completos do histórico de eventos.
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.
- 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.
- 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).
-
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.
Project Creation
Refer to: Criar um projeto, Tornar um projeto existente disponível online
Quando um projeto é criado, o bloco de evento Project Created será adicionado à cronologia. Este evento assinala o início da cronologia histórica do projeto. Como tal, pode sempre ser encontrado como a entrada na parte inferior da cronologia. O bloco para este evento pode surgir em duas variações distintas:
- Quando um projeto é criado de novo no Workspace. O criador do projeto é apresentado pelo nome (e fotografia), juntamente com a data e a hora de criação do projeto. A descrição do projeto também é apresentada no bloco, caso tenha sido introduzida 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 de criação do projeto. A descrição do projeto também é apresentada no bloco, caso tenha sido introduzida no momento da cópia. É fornecida uma ligação para o projeto original; ao clicar nela, acederá à página detalhada de gestão desse projeto através da interface de navegador do Workspace.
.
Project Commit
Sempre que fizer Commit de um projeto para o Workspace (em que o projeto é gerido no repositório interno Versioned Storage Git do Workspace), será adicionado à cronologia um bloco de evento Project Committed. A pessoa que efetuou o commit (Save to Server) é apresentada pelo nome (e fotografia), juntamente com a data e a hora. Se tiver sido adicionado e enviado um comentário no momento do commit – utilizando a caixa de diálogo Commit to Version Control dialog – esse comentário também será apresentado no bloco.
Exemplo de bloco de evento inicial Project Committed.
O bloco também suporta e apresenta informação de diff do design, mostrando informação mais detalhada sobre o que mudou entre o commit atual e o anterior. Os elementos suportados incluem ficheiros, componentes, nets, variantes e estrutura PCB. A secção de diff do bloco resume os vários elementos afetados pelo evento de commit, agrupados pelos seguintes estados:
– elemento adicionado.
– elemento removido.
– elemento modificado.
Ao clicar no controlo 
no bloco, esta secção de diff será expandida para apresentar os elementos afetados pelo nome.
no bloco para regressar à apresentação resumida.
Clique no controlo 
no canto superior direito do bloco para aceder a um menu com os seguintes comandos:
-
Download Sources - uUtilize-o para transferir e abrir essa revisão específica do projeto 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. Tenha em atenção que esta revisão é apenas de leitura; pode visualizá-la, mas não editá-la.
Pode abrir (apenas para visualização) qualquer revisão específica do projeto – diretamente a partir do bloco de evento Project Committed correspondente a essa revisão. -
Compare: Schematic to, PCB to, BOM to – permite-lhe comparar os dados de Esquemático, PCB ou BOM do projeto PCB neste commit com os de outro commit ou evento de lançamento. Utilize o submenu para comparar com o commit anterior ou selecione entre todos os lançamentos e commits possíveis. Depois de escolhidos os dados para comparação, os resultados da comparação são apresentados na vista de diferenças associada, que é aberta como um novo separador no seu navegador predefinido. Para mais informações, consulte Design Data Comparisons (Altium 365 Workspace, Enterprise Server Workspace).
-
Create Tag – adicione uma única etiqueta personalizada, com nome definido por si, a qualquer commit de um projeto de design (e apenas quando esse projeto estiver armazenado num Workspace sob o seu sistema interno Git VCS). Só pode criar uma etiqueta para um commit que já esteja guardado no Workspace. Depois de executar o comando, abre-se a caixa de diálogo Create Tag . Introduza a etiqueta pretendida e clique em Create.
Quando é introduzida uma etiqueta que contém um carácter ilegal, o ícone
aparece na caixa de diálogo Create Tag. Passe o cursor sobre o ícone para ver uma “dica” com os caracteres permitidos, ou seja, letras, números, ponto ('.'), hífen ('-'), cardinal ('#') e sublinhado ('_'); atualize a etiqueta conforme necessário.
Quando o projeto é lançado utilizando o Project Releaser e o seu commit mais recente ainda não tem uma etiqueta, será atribuída automaticamente uma etiqueta a esse commit mais recente. Esta etiqueta terá a forma de RELEASE_<RevisionID>, em que <RevisionID> é o número de revisão das fontes do projeto lançado (A.1, A.2, etc.), por exemplo, RELEASE_A.3.
Para mudar o nome ou eliminar uma etiqueta, clique em 
e depois passe o cursor sobre a entrada Tag . Abrir-se-á uma caixa de diálogo na qual pode introduzir o novo nome da etiqueta. Se Remove estiver selecionado, a etiqueta é eliminada imediatamente.
- Criar uma cópia – utilize para criar uma cópia a partir dessa revisão específica do projeto. Abre-se a caixa de diálogo Create Project Copy , na qual introduz um Project Name (por predefinição, será o nome original do projeto com o sufixo ' - Copy'), Description (que não é pré-preenchido), o caminho de Folder (dentro do Workspace) e o caminho de Local Storage (para a cópia de trabalho). O projeto será criado e será adicionado à cronologia um mosaico de evento Project Copied.
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 predefinição, definido para utilizar a localização definida na página System - Default Locations da caixa de diálogo Preferences. Clique em para abrir uma caixa de diálogo padrão do Windows com a qual poderá alterar esta localização conforme necessário.
-
Revert to – utilize este comando para reverter para os dados dessa revisão específica do projeto. Os dados dos documentos-fonte do projeto nessa revisão específica substituem os dados na sua cópia de trabalho local do projeto. Na prática, o projeto é momentaneamente fechado e depois reaberto com esses dados revertidos. Se pretender concluir a reversão e tornar esses dados na Head Revision (versão atual), tem de fazer commit e push do projeto novamente para o Workspace.
Pode reverter para qualquer revisão específica do projeto diretamente a partir do mosaico de evento Project Committed correspondente a essa revisão.
. A revisão mais recente do projeto (ou seja, o último commit) distingue-se por ter um preenchimento branco no respetivo nó: 
.
Project Release
Related page: Lançamento de projeto de design
Sempre que efetuar um lançamento do projeto PCB – utilizando o Project Releaser do Altium Designer – será adicionado à cronologia um mosaico de evento Project Released. A pessoa que efetuou o lançamento é apresentada pelo nome (e fotografia), juntamente com a data e hora. Se tiver sido adicionada uma nota de lançamento no momento em que os dados gerados foram lançados para o Workspace – através da caixa de diálogo Confirm Release dialog – essa nota também será apresentada no mosaico. Cada um dos conjuntos de dados incluídos no lançamento também será listado.
Exemplo de mosaico de evento Project Released.
Clique no controlo 
no canto superior direito do mosaico para aceder a um menu com os seguintes comandos:
- Download Sources – utilize este comando para transferir e depois abrir (no painel Projects ) a revisão específica do projeto a partir da qual este pacote de lançamento foi gerado. O nome do projeto incluirá a versão do lançamento. Tenha em atenção que esta revisão é só de leitura; pode visualizá-la, mas não pode editá-la de forma alguma.
- Compare: Schematic to, PCB to, Gerber to, BOM to – permite-lhe comparar os dados de Esquemático, PCB ou BOM neste lançamento com os de outro lançamento ou evento de commit. Para Gerber gerado, pode comparar os dados deste lançamento com os de outro lançamento ou, quando utiliza um Altium 365 Workspace, com um conjunto de ficheiros Gerber carregado. Utilize o submenu para comparar com o conjunto de dados pretendido. Depois de escolhidos os dados para comparação, os resultados da comparação são apresentados na vista de diferenças associada, que é aberta como um novo separador no seu navegador predefinido. Para mais informações, consulte Design Data Comparisons (Altium 365 Workspace, Enterprise Server Workspace).
Copying a Project
Sempre que copiar o projeto, quer através da interface do navegador do Workspace quer a partir do Altium Designer – é adicionado à cronologia um mosaico de evento Project Copied. A pessoa que efetuou a cópia é apresentada pelo nome, fotografia, data e hora. Se tiver sido adicionada uma descrição no momento da cópia através da janela Clone Project (baseada no navegador) ou da caixa de diálogo Create Project Copy (Altium Designer), essa descrição também será apresentada no mosaico. É disponibilizada uma ligação para o projeto copiado. Ao clicar nela, acederá à página de gestão detalhada desse projeto através da interface do navegador do Workspace.
Exemplo de mosaico de evento Project Copied.
no canto superior direito do mosaico. No menu subsequente, escolha o comando Make a copy .
.
MCAD Exchanges
Related page: Altium MCAD CoDesigner
Ao trabalhar entre os domínios de design eletrónico e mecânico, o Workspace atua como ponte entre ambos – facilitando o codesign ECAD-MCAD direto. Sempre que forem efetuadas alterações ao design PCB do projeto e essas alterações forem enviadas para o Workspace através do painel CoDesigner relevante, será adicionado à cronologia um mosaico de evento MCAD Changes Suggested. A pessoa que efetuou o envio é apresentada pelo nome (e fotografia), juntamente com a data e hora. Se tiver sido publicada uma mensagem no momento do envio – através do painel MCAD CoDesigner (Altium Designer) ou do painel Altium CoDesigner (no software MCAD suportado) – essa mensagem também será apresentada no mosaico.
Exemplo de mosaico de evento MCAD Changes Suggested.
Quando o engenheiro MCAD faz alterações à PCB no seu software MCAD suportado e as envia de volta para o Workspace, o evento push correspondente estará disponível na linha temporal do histórico do projeto only depois de obter as alterações do Workspace para o Altium Designer.
Exemplo que mostra dois eventos relacionados com MCAD. À esquerda do tronco da linha temporal, o evento push do lado ECAD e, à direita, o evento push do lado MCAD.
.
Local Changes
Quando existem documentos do projeto PCB guardados localmente, mas ainda não no Workspace, será adicionado um mosaico de evento Local Changes no topo da linha temporal. A pessoa que efetuou a gravação local (isto é, o utilizador atual) é apresentada pelo nome (e imagem).
Exemplo de mosaico de evento Local Changes.
Clique no controlo no canto superior direito do mosaico para aceder a um menu com o seguinte comando:
- Compare: Schematic to, PCB to, BOM to – permite comparar os dados de Esquemático, PCB ou BOM guardados localmente neste commit com os de um evento de commit ou release. Utilize o submenu para comparar com os dados de origem do release anterior, os dados de origem do commit anterior, ou selecionar entre todos os releases e commits possíveis. Depois de os dados terem sido escolhidos para comparação, os resultados da comparação são apresentados na vista de diferenças associada, que é aberta como um novo separador no seu navegador predefinido. Para mais informações, consulte Design Data Comparisons (Altium 365 Workspace, Enterprise Server Workspace).
.
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.
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.
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).
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.
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
Localizado por IA