Histórico do Projeto

Updated: May 15, 2023 | Applies to version: 6.0

Now reading version 6.0. For the latest, read: Histórico do Projeto for version 8.1

O Workspace do Enterprise Server oferece uma solução elegante para a necessidade de uma perspetiva histórica da atividade do projeto, sob a forma de uma vista History dedicada e interativa. Acessível através da interface do navegador do Workspace ou a partir do Altium Designer, a History vista do projeto fornece uma linha temporal progressiva dos principais eventos relacionados com o projeto. Os eventos incluem a criação do projeto, commits, releases, clones e trocas MCAD, que, por sua vez, disponibilizam comandos de ação de evento quando aplicável.

Aceder ao Histórico do Projeto

O acesso à History vista de um projeto é obtido a partir da página detalhada de gestão centrada em CAD desse projeto – a página Projects Management. Clique na opção History no painel do lado esquerdo.

A própria página Projects Management é aberta a partir da página principal Projects, fazendo duplo clique numa entrada de projeto, clicando no respetivo título ou escolhendo a opção Open no menu

. Para mais informações, consulte Gestão de um Projeto Específico.

Aceda ao histórico de um projeto a partir da página detalhada de gestão desse projeto.

A Historyvista do projeto gerada pelo Workspace também está disponível no Altium Designer. Para carregar a vista no Altium Designer, selecione a opção History & Version Control » Show Project History no menu de contexto aberto com o botão direito sobre o nome do projeto no painel Projects. A vista também pode ser aberta a partir da opção de menu History na vista de projeto aberta do painel Explorer.

Note que as ações de evento de History disponíveis no lado do Altium Designer diferem das disponíveis no lado da interface do navegador. Especificamente, no lado do Altium Designer pode reverter o projeto para um snapshot previamente submetido (Revert to) e também abrir uma release no ambiente de edição (Open Snapshot).

► Consulte Histórico do Projeto no Altium Designer para mais informações.

Linha Temporal do Histórico – Visão Geral

A History vista apresenta uma linha temporal dos eventos básicos que ocorreram durante a evolução do projeto. Pode, essencialmente, ser dividida em três elementos-chave, conforme mostrado na imagem e informação seguintes.

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 – aparece na parte inferior da linha temporal. Os eventos subsequentes aparecem acima, sendo o mais recente (o evento mais atual) apresentado no topo da linha temporal.
Events. Sempre que ocorre um evento suportado (ver abaixo) associado ao projeto, este é adicionado à linha temporal como um bloco dedicado. Cada tipo de evento terá um bloco de cor diferente e estará diretamente ligado ao tronco principal da linha temporal, ou terá um ícone de associação ao lado (como acontece com os eventos 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 no histórico do projeto. À medida que escreve a sua cadeia de pesquisa, será aplicada filtragem à linha temporal para apresentar apenas os eventos relevantes para essa pesquisa. Para mais informações, consulte Pesquisa Filtrada.

Eventos Suportados

A linha temporal mostra uma progressão de eventos que ocorrem durante o ciclo de vida de um projeto. Cada um destes eventos aparece ao longo da linha temporal como um 'bloco de evento' dedicado. As secções seguintes analisam o conjunto de eventos atualmente suportados e apresentáveis como parte da linha temporal histórica de um projeto.

Criação do Projeto

Related pages: Criar um Novo Projeto do Workspace (interface do navegador / Altium Designer), Tornar um Projeto Existente Disponível Online, Clonar um Projeto (interface do navegador / Altium Designer)

Quando um projeto é criado, o bloco de evento Project Created será adicionado à linha temporal. Este evento marca o início da linha temporal histórica do projeto. Como tal, pode sempre ser encontrado como a entrada na parte inferior da linha temporal. O bloco para este evento pode surgir em duas variações distintas:

Quando o projeto é criado de novo no Workspace. O criador do projeto é apresentado pelo nome (e imagem/símbolo), juntamente com a hora da criação do projeto. A descrição do projeto, caso tenha sido introduzida no momento da criação, também é apresentada no bloco.

Quando o projeto é um clone de um projeto existente. A pessoa que criou o projeto clonado é apresentada pelo nome (e imagem/símbolo), juntamente com a hora da criação do projeto. A descrição do projeto, caso tenha sido introduzida no momento da clonagem, também é apresentada no bloco. É fornecida uma ligação para o projeto de origem original – ao clicar nela, acede à página detalhada de gestão desse projeto, que é aberta num separador separado do navegador.

O bloco de evento Project Created está fisicamente ligado ao tronco principal da linha temporal através de uma linha e nó de ligação azuis contínuos:

Commit do Projeto

Sempre que guardar o projeto no Workspace (onde o projeto é gerido no Versioned Storagerepositório Git interno do Workspace), será adicionado à linha temporal um bloco de evento Project Committed. A pessoa que executou o commit e push é apresentada pelo nome (e imagem), juntamente com a data e hora. Se tiver sido adicionado um comentário no momento do commit e push – através da caixa de diálogo Save to Server – esse comentário também será apresentado no bloco.

Se o projeto era um projeto local que foi subsequentemente disponibilizado online, então a descrição introduzida na caixa de diálogo Make Available Online será usada tanto no bloco de evento Project Created como no bloco de evento inicial Project Committed, uma vez que o commit e push do projeto é realizado como parte da disponibilização do projeto online – desde que, naturalmente, a opção Enable Formal Version Control estivesse ativada.

Exemplo de bloco de evento inicial Project Committed.

O bloco também suporta e apresenta informação de diffing 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 da PCB. A secção de diffing 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 diffing expande-se para apresentar os elementos afetados pelo nome.

Utilize os controlos disponíveis Show More e Show Less para analisar a listagem completa de cada tipo de elemento. Clique no controlo

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:

View – utilize este comando para abrir os dados do design de origem do commit selecionado no Web Viewer como um snapshot do design naquele momento.
Create Tag – adiciona um nome de tag VCS ao commit atualmente selecionado. As tags associadas a um commit aparecem no bloco da vista History respetivo, no cabeçalho da sua vista snapshot no Web Viewer e em quaisquer comentários associados a essa vista snapshot. Depois de uma Tag ser adicionada a um commit, o comando de menu do bloco muda para Tag e oferece subopções para modificar (Edit) ou eliminar (Remove) a tag do commit.

Selecione a opção de menu Create Tag para adicionar um nome de tag a um evento de histórico de commit.

Existe um conjunto de caracteres que não pode ser usado em tags VCS. Se tentar criar uma Tag que inclua caracteres ilegais, será alertado para isso através de informação de dica (ver exemplo).
Apenas pode ser aplicada uma Tag a um evento Commit – não são suportadas múltiplas tags.

A vista snapshot de um evento de histórico de commit etiquetado é identificada com o nome da tag.

Quando os comentários são visualizados no design WIP ativo, os criados no snapshot do design de um commit etiquetado incluirão o nome da tag associada. Selecione a ligação com o nome da tag para abrir o snapshot do commit relacionado. Consulte Comentários do Web Viewer para mais informações sobre como trabalhar com comentários.

Os comentários adicionados a um snapshot de um evento de commit etiquetado incluirão o nome da tag associada.

Schematic to – permite comparar os dados do Esquemático neste commit com os de outro evento de commit ou release. Utilize o submenu para comparar com os dados de origem do commit anterior, ou selecione de entre todos os commits ou releases possíveis. Depois de escolhida a release/commit de comparação, os resultados da comparação são apresentados na vista Compare, que abre como um novo separador no seu navegador web predefinido. Para mais informações, consulte Comparação de Esquemáticos.
BOM to – permite comparar os dados da BOM neste commit com os de outro evento de commit ou release. Utilize o submenu associado para comparar com os dados BOM do commit anterior, ou selecione de entre todos os commits/releases efetuados para o projeto. Depois de escolhido o destino da comparação, os resultados da comparação são apresentados como uma lista de entradas BOM codificadas por cores que representam itens que mudaram entre os eventos Commit/Release especificados. É gerado um resumo consolidado das alterações em formato CSV padrão e disponibilizado para transferência num ficheiro de arquivo ZIP. Para mais informações, consulte Comparação de BOM.

Clone – utilize este comando para criar um clone a partir dessa revisão específica do projeto. Será apresentada a janela Clone Project, na qual poderá determinar o Name do projeto, Description, e, nas opções de Advanced, o Server Folder e o Repository de destino. Note que o texto do cabeçalho da janela reflete a partir de que revisão do projeto o clone está a ser criado. Com a informação definida conforme necessário, clique no botão . O projeto será criado e será adicionado um mosaico de evento Project Cloned à cronologia.

Pode criar um clone a partir de qualquer revisão específica do projeto ativo – diretamente a partir do mosaico de evento Project Committed correspondente a essa revisão.

Download Sources – utilize este comando para descarregar o código-fonte do projeto dessa revisão específica do projeto, num arquivo Zip. O nome do ficheiro Zip e do ficheiro do projeto PCB incluirá a data e hora (em UTC) em que essa revisão do projeto foi submetida e enviada para o Workspace.

Um mosaico de evento Project Committed está fisicamente ligado ao tronco principal da cronologia por uma linha de ligação azul contínua e um nó:

. 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: Design Project Release

Sempre que efetuar uma release do projeto – utilizando o Project Releaser do Altium Designer – será adicionado um mosaico de evento Project Released à cronologia. A pessoa que efetuou a release é apresentada pelo nome (e fotografia), juntamente com a data e hora. Se tiver sido adicionada uma nota de release no momento em que os dados gerados foram enviados 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 na release também será listado.

Exemplo de mosaico de evento Project Released. 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:

View – abre um portal de fabrico dedicado (num separador separado do navegador) através do qual pode inspecionar mais de perto os dados libertados. Neste portal, pode ver e navegar pelos dados dos ficheiros libertados, inspecionar a BOM e ver e comentar a captura do próprio design; a origem desses dados libertados. Também terá acesso a controlos para descarregar dados de fabrico com vários níveis de granularidade (desde conjunto(s) de dados completos até ficheiro(s) de saída gerado(s) individuais). Uma release escolhida também pode ser enviada – como um Manufacturing Package – diretamente para o seu fabricante. Para mais informação, consulte a navegação num Release Package no Manufacturing Portal.

Aceder ao separador dedicado Manufacturing Portal, através do qual pode inspecionar mais de perto a release do projeto. Aceder ao separador dedicado Manufacturing Portal, através do qual pode inspecionar mais de perto a release do projeto.

Schematic to – permite comparar os dados de Esquemático desta release com os de outra release ou evento de commit. Utilize o submenu para comparar com os dados-fonte da release anterior, ou selecione de entre todas as releases e commits possíveis. Assim que a release/commit de comparação for escolhida, os resultados da comparação são apresentados na vista Compare, que é aberta como um novo separador no seu navegador predefinido. Para mais informação, consulte Schematic Comparison.
Gerber to – permite comparar os dados Gerber gerados para esta release com outro conjunto de dados Gerber. Utilize o submenu associado para comparar com os dados de fabrico da release anterior, selecionar de entre todas as releases feitas para o projeto (a cronologia será filtrada para mostrar apenas mosaicos de evento Project Released) ou comparar com um conjunto de ficheiros gerado localmente (e carregado) à sua escolha. Depois de escolhido o alvo da comparação, os resultados são apresentados na Gerber Compare vista, que é aberta num separador separado do navegador. Para mais informação, consulte Gerber Comparison.

BOM To – permite comparar os dados da Bill of Materials (BoM) desta release com os de outra release. Utilize o submenu associado para comparar com os dados BOM da release anterior, ou selecione de entre todas as releases feitas para o projeto. Assim que o alvo da comparação for escolhido, os resultados da comparação são apresentados como uma lista de entradas BOM codificadas por cores que representam itens alterados entre os eventos Commit/Release especificados. É gerado um resumo consolidado das alterações em formato CSV padrão e disponibilizado para descarga num ficheiro ZIP. Para mais informação, consulte BOM Comparison.
Download Outputs – permite-lhe escolher, através de uma subsequent window, quais os conjuntos de dados do pacote de release que pretende descarregar. Depois de feitas as escolhas, clique no botão . Será descarregado um único arquivo Zip, contendo pastas para cada um dos conjuntos de dados escolhidos.
Download Sources– permite descarregar a captura da versão do design que foi utilizada para criar esse pacote de release, sob a forma de um arquivo Zip.

Como a release de um projeto é um evento muito significativo, o mosaico de evento Project Released é apresentado com maior destaque – em vez de ser apenas um evento “ligado”, atravessa a cronologia como um evento “principal”.

Project Cloning

Related page: Clonar um Projeto (browser interface / Altium Designer)

Sempre que clonar o projeto – quer através da interface do navegador do Workspace, quer a partir do Altium Designer – será adicionado um mosaico de evento Project Cloned à cronologia. A pessoa que efetuou o clone é apresentada pelo nome (e fotografia), juntamente com a data e hora. É adicionada ao mosaico uma descrição gerada no momento da clonagem, que pode ser substituída através da introdução de uma nova descrição. É disponibilizada uma ligação para o projeto clonado – ao clicar nela, acederá à página de gestão detalhada desse projeto, que é aberta num separador separado do navegador.

Exemplo de mosaico de evento Project Cloned. Exemplo de mosaico de evento Project Cloned.

Os principais Clone comandos estão disponíveis nas opções de menu na página Projects da interface do navegador do Workspace, ou na vista History escolhendo a opção Clone no menu dentro de um mosaico de evento Project Committed. Esta última opção clonará essa revisão específica de um projeto, em vez da revisão mais recente (Head) do projeto.

No Altium Designer, clique com o botão direito do rato na entrada do projeto no painel Projects e escolha a opção Clone, ou, no painel Explorer, escolha a opção Clone no menu ao visualizar um projeto.

O mosaico de evento Project Cloned está fisicamente associado (mas não ligado) ao tronco principal da cronologia por uma linha de ligação verde tracejada e um nó sem preenchimento.

MCAD Exchanges

Related page: Altium MCAD CoDesigner

Ao trabalhar entre os domínios do design eletrónico e mecânico, o Workspace atua como ponte entre ambos – facilitando a 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 um mosaico de evento MCAD Changes Suggested à cronologia. 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.

Atualmente, apenas são suportados eventos Push.

Quando o engenheiro MCAD efetua alterações ao PCB no seu software MCAD suportado e as envia de volta para o Workspace, o evento de envio correspondente ficará disponível na cronologia do histórico do projeto only depois de extrair as alterações do Workspace para o Altium Designer.

Exemplo que mostra dois eventos relacionados com MCAD. O evento inferior no tronco da cronologia representa um evento de envio do lado ECAD, enquanto o evento superior é o reenvio a partir do lado MCAD.

O mosaico de evento MCAD Changes Suggested não está fisicamente ligado ao tronco principal da cronologia. Em vez disso, é utilizado um símbolo de seta direcional, apontando para o tronco.

Pesquisa Filtrada

Clique no controlo no canto superior direito da vista para aceder a um campo de pesquisa com o qual poderá encontrar rapidamente eventos de interesse ao longo da cronologia. A funcionalidade de pesquisa suporta a 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 é destacado.

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

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

É apresentada 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 realizou o evento.
Texto descritivo (o texto proveniente de um comentário/nota/descrição quando o evento relevante ocorreu).
Texto dos dados de diffing – 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 Cloned e num mosaico de evento Project Created (quando criado através de clonagem).

Para limpar a filtragem atual e regressar à cronologia 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 (na parte superior da vista).

Atualização com Novos Eventos

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