Histórico do Projeto

Parent page: Projetos do Workspace

O Workspace do Enterprise Server fornece uma solução elegante para a necessidade de uma visão 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 vista do projeto History fornece uma cronologia 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 sobre eventos, quando aplicável.

Aceder ao Histórico do Projeto

O acesso à vista History 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 de gestão detalhada desse projeto.

Linha Temporal do Histórico – Visão Geral

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

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

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 – aparece na parte inferior da linha temporal. Os eventos subsequentes aparecem acima, sendo que o mais recente (o evento atual mais recente) surge no topo da linha temporal.
2. Events. Sempre que ocorre um evento suportado (ver abaixo) associado ao projeto, este é adicionado à linha temporal como um mosaico de evento dedicado. Cada tipo de evento terá um mosaico de cor diferente e estará ligado diretamente ao tronco principal da linha temporal, ou terá um ícone de associação 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 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 dos eventos que acontecem durante o ciclo de vida de um projeto. Cada um destes eventos aparece ao longo da linha temporal como um 'mosaico 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 no 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 mosaico de evento Project Created será adicionado à linha temporal. Este evento assinala 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 mosaico deste evento pode aparecer em duas variantes 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 mosaico.

• 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 mosaico. É disponibilizada uma ligação para o projeto de origem original – ao clicar nela, acederá à página de gestão detalhada desse projeto, que é aberta num separador separado do navegador.

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

Commit do Projeto

Sempre que guardar o projeto no Workspace (onde o projeto é gerido no Versioned Storagerepositório Git internoVersioned Storage do Workspace), será adicionado à linha temporal um mosaico de evento Project Committed. A pessoa que efetuou o commit e o 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 mosaico.

Exemplo de mosaico de evento inicial Project Committed.

O mosaico também suporta e apresenta informação de comparação de diferenças 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 comparaçã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 comparação de diferenças será expandida para apresentar os elementos afetados pelo nome.

Use os controlos Show More e Show Less disponíveis para analisar a listagem completa de cada tipo de elemento. Clique no controlo no mosaico para regressar à visualização resumida.

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

• Clone – utilize este comando para criar um clone a partir dessa revisão específica do projeto. Será apresentada a janela Clone Project, com a qual poderá determinar o Name do projeto, Description, e, nas opções Advanced, o Server Folder e o Repository de destino. 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 a informação definida conforme necessário, clique no botão . O projeto será criado e será adicionado à linha temporal um mosaico de evento Project Cloned.

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 Snapshot – 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 por commit e push para o Workspace.

Um mosaico de evento Project Committed está fisicamente ligado ao tronco principal da linha temporal com uma linha de ligação e nó 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 Design da Placa

Sempre que efetuar um release do projeto – usando o Project Releaser do Altium Designer – será adicionado à linha temporal um mosaico de evento Project Released. A pessoa que efetuou o release é apresentada pelo nome (e imagem), juntamente com a data e hora. Se tiver sido adicionada uma nota de release no momento de libertar os dados gerados para o Workspace – através da caixa de diálogo Confirm Release – essa nota também será apresentada no mosaico. Cada um dos conjuntos de dados incluídos no release 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:

• View – abre um portal de fabrico dedicado (num separador separado do navegador) com o qual poderá inspecionar mais detalhadamente os dados libertados. A partir deste portal, pode ver e navegar os dados dos ficheiros libertados, inspecionar a BOM e ver e comentar o instantâneo do próprio design; a origem desses dados libertados. Também terá acesso a controlos para transferir dados de fabrico com vários níveis de granularidade (desde conjunto(s) de dados completos até ficheiro(s) de saída gerados individualmente). Um release escolhido também pode ser enviado – como um Manufacturing Package – diretamente para o seu fabricante. Para mais informações, consulte a navegação de um Release Package no Manufacturing Portal.

Aceder ao separador dedicado Manufacturing Portal, com o qual poderá inspecionar mais detalhadamente o release do projeto.

• BOM To – permite-lhe comparar os dados da Lista de Materiais (BoM) nesta versão com os de outra versão. Utilize o submenu associado para comparar com os dados da BOM da versão anterior, ou selecione entre todas as versões criadas para o projeto. A funcionalidade de comparação de dados deteta diferenças nos dados brutos da BOM entre versões especificadas do projeto, estando também acessível a partir da vista Releases do projeto no Workspace. Os resultados da comparação são disponibilizados através da transferência de um ficheiro CSV que detalha os dados da BOM que foram alterados – adicionados, removidos ou atualizados – entre as versões especificadas do projeto.

• Download – permite-lhe escolher, através de uma janela subsequente, quais os conjuntos de dados do pacote de versões a 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 Snapshot – permite-lhe transferir o instantâneo da versão do design que foi usada para criar esse pacote de versões, 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 à linha temporal um mosaico de evento Project Cloned. A pessoa que efetuou a clonagem é 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 introduzindo 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 um Project Cloned mosaico de evento.

Trocas MCAD

Related page: Altium MCAD CoDesigner

Ao trabalhar entre os domínios do design eletrónico e mecânico, o Workspace atua como ponte entre os dois – 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 à linha temporal 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.

Quando o engenheiro de MCAD faz alterações à PCB no seu software MCAD suportado e as envia de volta para o Workspace, o evento de envio correspondente ficará disponível na linha temporal 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 linha temporal representa um evento de envio do lado ECAD, enquanto o evento superior é o reenvio do lado MCAD.

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 a pesquisa básica do 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 linha temporal é filtrada dinamicamente à medida que escreve o termo de pesquisa (não sensível a maiúsculas/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 efetuou o evento.
• Texto descritivo (o texto proveniente de um comentário/nota/descrição quando ocorreu o evento relevante).
• Texto de dados de diferenciação – 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 à 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 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 linha temporal com o novo evento.

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