Histórico do Projeto

Não conseguir aceder facilmente a uma perspetiva histórica do percurso de desenvolvimento de um projeto é, com bastante frequência, uma fonte de frustração para designers e gestores de produto. Muitas vezes, um designer tem de lidar com ferramentas externas de gestão de VCS, que podem exigir um nível considerável de conhecimentos para serem utilizadas — algo bastante moroso quando se pretende executar tarefas básicas de gestão de projetos. Mesmo que tenha competência na utilização de ferramentas externas de VCS, estas apenas tratam determinados aspetos do projeto — ações relacionadas com VCS, como abrir, clonar e reverter. Mas e quanto ao âmbito mais alargado da gestão do projeto, incluindo versões e trocas MCAD? Além disso, não nos esqueçamos de que, normalmente, a maior parte disto exigiria estar preso ao computador de secretária.

Ao disponibilizar uma solução elegante para a necessidade de ver este tipo de informação e interagir com ela a partir de um único local, o Altium 365 Workspace facilita o conceito de Project History. Acessível através da interface de navegador do Workspace (uma parte integrante da interface principal da Altium 365 Platform Interface) ou a partir do Altium Designer, uma History vista dedicada fornece uma cronologia progressiva dos principais eventos relacionados com o projeto — a sua criação, commits, versões, clones e trocas MCAD — com várias ações suportadas, quando aplicável (como visualizar uma captura do código-fonte do design).

Aceder ao Histórico do Projeto

O acesso à History vistaHistory de um projeto é obtido a partir da página de gestão detalhada desse projeto. Clique na entrada History no painel do lado esquerdo.

A própria página de gestão detalhada é aberta selecionando o projeto pretendido (na Projects página da interface), clicando no controlo acima da lista de projetos e escolhendo a entrada Open no menu associado. Em alternativa, faça duplo clique diretamente na entrada do projeto pretendido na lista. A página será aberta num novo separador do navegador. Para mais informação, consulte Management of a Specific Project.

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

No caso de um projeto no seu Workspace que já existia 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. Surgirá 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 históricos completos dos 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 detalhado depois.

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 surgem acima, sendo que o mais recente (o evento atual mais recente) aparece no topo da cronologia.
2. Events. Sempre que ocorre um evento suportado (ver abaixo) associado ao projeto, esse evento é adicionado à cronologia como um mosaico de evento dedicado. Cada tipo de evento terá um mosaico de cor diferente e estará ligado diretamente ao tronco principal da cronologia, ou terá algum ícone adicional junto a si (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 permite efetuar pesquisas básicas no histórico do projeto. À medida que introduz a cadeia de pesquisa, será aplicada filtragem à cronologia para apresentar apenas os eventos relevantes para essa pesquisa. Para mais informação, consulte Filtered Searching.

Eventos Suportados

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

Criação do Projeto

Related pages: Criar um Novo Projeto Gerido (interface de navegador / Altium Designer), Disponibilizar Online um Projeto Existente, Clonar um Projeto (interface de navegador / Altium Designer)

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

• Quando o projeto é criado de novo no Workspace. O criador do projeto é apresentado pelo nome (e fotografia), juntamente com a data e hora de criação do projeto. A descrição do projeto também é apresentada no mosaico, caso tenha sido introduzida no momento da criação.

• Quando o projeto é um clone de um projeto existente. A pessoa que criou o projeto clonado é apresentada pelo nome (e fotografia), juntamente com a data e hora de criação do projeto. A descrição do projeto também é apresentada no mosaico, caso tenha sido introduzida no momento da clonagem. É disponibilizada uma ligação para o projeto original — ao clicar nela, acederá à página de gestão detalhada desse projeto, que será aberta num separador separado do navegador.

O mosaico de evento Project Created está fisicamente ligado ao tronco principal da cronologia através de uma linha de ligação azul contínua e de um nó: .

Commit do Projeto

Sempre que efetuar um Commit & Push do projeto para o Workspace (quando o projeto é gerido no repositório Git interno Versioned Storage do Workspace), será adicionado à cronologia um mosaico de evento Project Committed. A pessoa que efetuou o commit e o push é apresentada pelo nome (e fotografia), 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 Commit to Version Control dialog — esse comentário também será apresentado no mosaico.

Exemplo de mosaico de evento inicial.

O mosaico 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 os commits atual e anterior. Os elementos suportados incluem ficheiros, componentes, nets, variantes e estrutura da PCB. A secção de diferenças do mosaico 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 mosaico, esta secção de diferenças será expandida para apresentar os elementos afetados por 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 mosaico para regressar à apresentação resumida.

Clique no controlo no canto superior direito do mosaico para aceder a um menu com os seguintes comandos:

• View – utilize este comando para abrir os dados de origem do design do commit selecionado no Web Viewer como uma captura do design nesse momento.
• Create Tag – adicione um nome de etiqueta VCS ao commit atualmente selecionado. As etiquetas associadas a um commit aparecem no mosaico da vista History, no cabeçalho da respetiva vista de captura no Web Viewer e em quaisquer comentários associados a essa vista de captura. Depois de uma etiqueta ter sido adicionada a um commit, o comando de menu do mosaico muda para Tag e oferece subopções para modificar (Edit) ou eliminar (Remove) a etiqueta do commit.

Selecione a opção de menu Create Tag para adicionar um nome de etiqueta a um evento de History de commit.

A vista de captura de um evento de commit de History etiquetado é identificada com o nome da etiqueta.

Quando os comentários são visualizados no design WIP ativo, os que foram criados na captura do design de um commit etiquetado incluirão o nome da etiqueta associada. Selecione a ligação do nome da etiqueta para abrir a captura do commit relacionada. Consulte Web Viewer Comments para mais informações sobre como trabalhar com comentários.

Os comentários adicionados a uma captura de um evento de commit etiquetado incluirão o nome da etiqueta associada.

O evento de Commit associado a uma Release do projeto, tal como criado pelo Project Releaser do Altium Designer, é etiquetado automaticamente com o Release Revision ID. Se necessário, a etiqueta de commit de revisão resultante pode posteriormente ser editada ou eliminada. Consulte Releasing to a Workspace para informações relacionadas.

O Commit associado a uma Release é automaticamente etiquetado com o ID da Release pelo Altium Designer.

• Schematic to – permite-lhe comparar os dados do esquema 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 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 é aberta como um novo separador no seu navegador web predefinido. Para mais informações, consulte Schematic Comparison.
• PCB to – permite-lhe comparar os dados da PCB 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 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 é aberta como um novo separador no seu navegador web predefinido. Para mais informações, consulte PCB Comparison.
• BOM to – permite-lhe 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 de BOM do commit anterior, ou selecione entre todos os commits/releases efetuados para o projeto. Depois de escolhido o alvo da comparação, os resultados da comparação são apresentados como uma lista de entradas de BOM codificadas por cores que representam itens que mudaram entre os eventos de 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 BOM Comparison.
• Clone – utilize este comando para criar um clone a partir dessa revisão específica do projeto. Será apresentada a janela Clone Project, através da qual poderá determinar o Name, o Description do projeto e a Parent Folder (dentro do Workspace). Tenha em atenção que o texto do cabeçalho da janela reflete a revisão do projeto a partir da qual o clone está a ser criado. Com as informações definidas 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 transferir a origem 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 a hora (em UTC) em que essa revisão do projeto foi submetida em commit e enviada para o Workspace.

Um mosaico de evento Project Committed está fisicamente ligado ao tronco principal da cronologia por uma linha e nó de ligação azuis contínuos: . A revisão mais recente do projeto (ou seja, o último commit) distingue-se por ter um preenchimento branco no respetivo nó: .

Release do projeto

Related page: Release do projeto de design

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 imagem), juntamente com a data e a hora. Se tiver sido adicionada uma nota de release no momento da disponibilização dos dados gerados 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, com indicação do estado do ciclo de vida.

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 do navegador separado) através do qual pode inspecionar mais detalhadamente os dados libertados. A partir deste portal, pode visualizar e navegar pelos dados dos ficheiros libertados, inspecionar a BOM e visualizar e comentar a captura do próprio design; a origem desses dados libertados. Terá também acesso a controlos para transferir dados de fabrico em vários níveis de granularidade (desde conjunto(s) de dados completos até ficheiro(s) de saída gerados individualmente). Uma release escolhida também pode ser enviada – como um Manufacturing Package – diretamente para o seu fabricante. Para mais informações, consulte Browsing a Release Package through the Manufacturing Portal.

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

• Schematic to – permite-lhe comparar os dados do esquema nesta release com os de outro evento de release ou commit. Utilize o submenu para comparar com os dados de origem da release anterior, ou selecione entre todas as releases e commits possíveis. Depois de escolhida a release/commit de comparação, os resultados da comparação são apresentados na vista Compare, que é aberta como um novo separador no seu navegador web predefinido. Para mais informações, consulte Schematic Comparison.

Comparação dos dados do esquema entre duas releases do projeto de design.

• PCB to – permite-lhe comparar os dados da PCB nesta release com os de outro evento de release ou commit. Utilize o submenu para comparar com os dados de origem da release anterior, ou selecione entre todas as releases e commits possíveis. Depois de escolhida a release/commit de comparação, os resultados da comparação são apresentados na vista Compare, que é aberta como um novo separador no seu navegador web predefinido. Para mais informações, consulte PCB Comparison.

Comparação dos dados da PCB entre duas releases do projeto de design.

• Gerber to – permite-lhe 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 entre todas as releases efetuadas 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 vista Gerber Compare , que é aberta num separador do navegador separado. Para mais informações, consulte Gerber Comparison.

Comparação dos dados Gerber gerados entre duas releases do projeto de design.

• BOM to – permite-lhe comparar os dados da BOM nesta versão com os de outro commit ou evento de release. Utilize o submenu associado para comparar com os dados da BOM do commit anterior, ou selecione entre todos os commits/releases efetuados para o projeto. Depois de escolhido o alvo da comparação, os resultados são apresentados como uma lista de entradas da BOM com código de cores, que representam os itens que foram alterados entre os eventos de Commit/Release especificados. É gerado um resumo consolidado das alterações em formato CSV padrão, disponibilizado para transferência num ficheiro de arquivo ZIP. Para mais informações, consulte Comparação de BOM.

Transferir uma comparação dos dados de BOM gerados entre dois eventos do projeto de design.

• Download Outputs – permite-lhe escolher, através de uma janela subsequente, quais os conjuntos de dados de saída no pacote de release que pretende transferir. Depois de feitas as escolhas, clique no botão . Será transferido um único arquivo Zip, contendo pastas para cada um dos conjuntos de dados escolhidos.
• Download Sources – permite-lhe transferir os dados de origem da versão do design que foi utilizada para criar esse pacote de release, como um arquivo Zip.

Clonagem de Projeto

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

Sempre que clonar o projeto — quer através da interface do navegador do Workspace, quer a partir do Altium Designer — será adicionado à cronologia um mosaico de evento Project Cloned. A pessoa que efetuou a clonagem é apresentada pelo nome (e fotografia), juntamente com a data e hora. Se tiver sido adicionada uma descrição no momento da clonagem — através da janela Clone Project (baseada no navegador) ou da caixa de diálogo Clone Project (Altium Designer) — essa descrição também será apresentada no mosaico. É disponibilizada uma ligação para o projeto clonado — ao clicar nela, acederá à página de gestão detalhada desse projeto, que será aberta num separador separado do navegador.

Exemplo de mosaico de evento Project Cloned.

Os principais Clone comandos, disponíveis na página Projects da interface do navegador do Workspace, ou no Altium Designer (clicando com o botão direito na entrada do projeto no painel Projects, ou clicando no botão no canto superior direito do painel Explorer ao navegar no projeto), atuam sobre a revisão mais recente (ou Head) do projeto. A partir da vista History , tem a possibilidade de clonar uma revisão específica de um projeto. Para o fazer, localize o mosaico de evento Project Committed correspondente à revisão pretendida do projeto e, em seguida, clique no controlo no canto superior direito do mosaico. No menu subsequente, escolha o comando Clone .

O mosaico de evento Project Cloned está fisicamente ligado ao tronco principal da cronologia através de uma linha de ligação verde pontilhada e de um nó não preenchido: .

Trocas MCAD

Related page: Mais sobre ECAD-MCAD CoDesign

Ao trabalhar entre os domínios do 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 efetua alterações à PCB no seu software MCAD suportado e envia essas alterações para o Workspace, o evento de envio correspondente será automaticamente apresentado na cronologia do histórico do projeto. Tenha em atenção que poderá ser necessário atualizar a página Histórico para que a alteração mais recente seja apresentada.

Exemplo que mostra dois eventos relacionados com MCAD. À esquerda do tronco da cronologia, o evento de envio do lado ECAD; à direita, o evento de envio 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 pode encontrar rapidamente eventos de interesse ao longo da cronologia. A funcionalidade de pesquisa suporta pesquisa básica no histórico do projeto, com filtragem dinâmica aplicada à medida que escreve a cadeia de pesquisa — deixando na página apenas os eventos relevantes para essa pesquisa. O texto correspondente dentro de um mosaico de evento é realçado.

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 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 obtido de um comentário/nota/descrição quando o evento relevante ocorreu).
• Texto de dados de diff — 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 — selecionando o texto atual e premindo a tecla Backspace , ou 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 ocorrer um evento suportado relacionado com o projeto, esse evento será detetado e disponibilizado automaticamente na vista History . 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.

É também disponibilizada uma atualização manual, efetuada clicando no controlo no canto superior direito da vista.