Revisões de projeto
A página Design Reviews do projeto é o local central para que todas as partes interessadas do projeto executem e gerenciem revisões estruturadas de um projeto de design no Workspace. A interface permite a criação, o acesso e o gerenciamento de instâncias de Design Review por qualquer membro do Workspace, que por sua vez podem ser atribuídas a outros membros do Workspace como Revisores. O criador da Design Review (o Iniciador) pode adicionar anexos e itens de Checklist formalizados, e tem controle total sobre o processo de conclusão/aprovação da Design Review.
Crie, configure, gerencie e conclua Project Design Reviews avaliadas por membros especificados do Workspace.
As Design Reviews de projeto concluídas ajudam a identificar problemas de design, fornecem um registro rastreável de conformidade e garantem que o design atenda aos requisitos e padrões da empresa. Os projetos de design oferecem suporte a várias Design Reviews, que podem ser criadas a qualquer momento durante o desenvolvimento do projeto, como antes de sua Release, ou ao transferir o design para outra equipe ou contratado/fabricante.
O processo de Design Review, conforme descrito aqui, está disponível como um fluxo de trabalho de processo definido que pode ser duplicado e modificado para atender às suas necessidades específicas. Consulte Criando uma Design Review personalizada abaixo para obter detalhes. Clique no link Design Review no canto inferior direito de uma revisão para visualizar o diagrama do processo de revisão com as tarefas de revisão pendentes destacadas como nomes de usuários. 
Passe o cursor sobre o link para ver uma prévia.
Criando revisões
No Web Viewer do Workspace, as instâncias de Design Review do projeto são criadas e acessadas na página Design Reviews do projeto. A revisão será aplicada ao projeto atualmente aberto e estará disponível para todos os membros do Workspace que tenham acesso ao próprio projeto. Observe que somente membros do Workspace (e não usuários de External Share) podem participar de Design Reviews.
Selecione o botão 
para abrir a janela Create Design Review e configurar as principais definições da revisão. Quando finalizada e confirmada (
), a instância de revisão criada será aberta em seu visualizador dedicado para configuração adicional.
A janela Create Design Review oferece suporte às seguintes opções e campos que definem as configurações principais da nova instância de Design Review:
-
Review Context bloco – Define a versão do design à qual esta revisão será aplicada. A configuração assume por padrão os dados de design mais recentes do projeto de design (o projeto WIP atual), mas pode ser definida para uma Release específica do projeto ou um Commit (anterior) no menu suspenso.
-
Reviewers – Os membros indicados do Workspace que serão solicitados a revisar o projeto de design. Escolha um revisor na lista suspensa do controle ou digitando seu endereço de e-mail. As tarefas de Design Review serão criadas automaticamente para esses usuários.
-
Description – Insira informações relevantes sobre a revisão, como seu objetivo ou requisitos.
-
Checklist Template – Use o menu suspenso para escolher uma lista pré-configurada de itens de verificação em texto que os revisores podem concluir e comentar. As Checklists do review são gerenciadas por um administrador do Workspace por meio da página Admin–Settings–Checklists.
Os usuários adicionados como Reviewers devem ser membros do Workspace registrados e ter acesso Share ao design em revisão.
A configuração enviada da Design Review é aberta como uma nova instância de revisão atribuída aos Revisores especificados. Caso contrário, as Design Reviews são abertas a partir de suas entradas em bloco na página Design Reviews do projeto.
Insira o e-mail/nome de um membro ou escolha na lista suspensa. Um e-mail inserido será rejeitado se o usuário não for um membro do Workspace. Os revisores também devem ter acesso ao design em revisão – caso contrário, isso poderá ser corrigido na janela Share exibida em seguida. 
Uma nova instância de Design Review também pode ser iniciada a partir de:
-
o menu
na visualização Design do projeto no Workspace. 
-
o menu
na visualização Releases do projeto no Workspace. 
-
da caixa de diálogo do projeto no Altium Designer Share quando Design Review estiver selecionado e o projeto não tiver revisões ativas (
In Progress). Caso contrário, a caixa de diálogo apresentará uma lista em blocos das Design Reviews ativas do projeto.Consulte Suporte para Design Reviews para informações relacionadas ao Altium Designer.
Um Iniciador ou Revisor de Design Review pode cancelar uma instância de revisão a qualquer momento:
-
no menu
do bloco da revisão. 
-
no menu superior
de uma Design Review aberta. 
-
no menu do painel da visualização Tasks view Activites (
). Quando canceladas, todas as tarefas da Design Review são movidas para um status concluído ( Resolved) e a própria revisão é fechada em estado somente leitura.
Trabalhando com Checklists
Embora opcionais, as Checklists da Design Review oferecem um acréscimo valioso para a criação de revisões estruturadas e auditáveis de designs de projeto. As Checklists são essencialmente uma lista numerada de itens de verificação textuais que os Revisores podem reconhecer ou não aceitar ao concluir suas tarefas de revisão. Cada item de verificação pode ser aceito/rejeitado por todos os Revisores especificados, que também podem adicionar Comments (e Tasks associadas) a cada entrada por meio da Design Snapshot view.
Checklists de exemplo para esquemático e PCB estão disponíveis por padrão, e novas Checklists podem ser criadas ou modificadas. As Checklists são gerenciadas por administradores do Workspace na visualização Admin–Settings–Checklists; no entanto, os usuários podem adicionar, remover e modificar Checklists ao criar uma instância de Design Review.
Os itens do modelo selecionado são numerados automaticamente quando adicionados ao Checklist geral. As entradas dos itens podem ser excluídas (
), arrastadas para cima e para baixo para reordenar a lista, e arrastadas para a esquerda e para a direita para definir o recuo da linha (também Tab/Shift+Tab).
A entrada de item de Checklist adicionada manualmente agora está disponível para os revisores. Você pode criar seu próprio modelo a partir das entradas atuais, como aquelas que adicionou manualmente, usando a opção Save Items as Template do Checklist. Como todos os itens de checklist adicionados, a entrada pode ser marcada como Sim (
), Não (
) e Não Aplicável (
).
Consulte a página Checklists do Admin para obter informações sobre como criar e gerenciar Checklists de Revisão de Projeto.
Comparar com Dados Anteriores
As Revisões de Projeto também incluem a capacidade direta de abrir uma comparação dos documentos de Esquemático, PCB e BOM do snapshot com os de um evento anterior de Commit ou Release do projeto. Isso permite que tanto o criador da revisão quanto os Revisores visualizem diretamente as diferenças entre os dados de projeto em revisão e os dados selecionados de um evento anterior.
Consulte a página Comparações de Dados de Projeto para obter informações sobre como realizar comparações de documentos de projeto.
Revisar Snapshot do Projeto
A visualização Design Snapshot corresponde ao estado do projeto quando a instância da Revisão de Projeto foi criada e oferece os recursos disponíveis na visualização normal de projeto WIP, incluindo navegação completa pelos documentos, destaque de nets, cross-probing e comentários.
Além da capacidade de inspecionar o projeto em seu estado de revisão, a visualização do snapshot também fornece um painel dedicado Design Review (
) que resume o status atual da revisão, fornece acesso às comparações (veja acima) e permite executar os itens Checklist da revisão.
O painel Design Review do Snapshot do Projeto inclui informações sobre o status da revisão e fornece acesso aos itens do Checklist.
Na visualização Design Snapshot, os Comentários inseridos e sua atribuição a Tarefas de usuário estão diretamente associados à Revisão de Projeto. A revisão incluirá apenas esses Comentários e Tarefas, e não mostrará Comentários/Tarefas existentes do projeto WIP de origem. Por outro lado, a visualização atual de projeto WIP incluirá Comentários e Tarefas criados em uma Revisão de Projeto.
Um Comentário/tarefa inserido em Revisão de Projeto incluirá uma entrada From: <design review> que vincula à revisão associada. A Revisão de Projeto também permite adicionar Comentários a partir de, e associá-los a, um item de Checklist selecionado no painel Design Review.
Observe que a área Comments and Tasks da Overview da Revisão de Projeto inclui uma lista de Comentários e Tarefas associadas que se aplicam à revisão atual. Quando um Comentário tiver sido adicionado a um item de Checklist, a entrada da coluna ID mostrará o número do Checklist e o número do Comentário. Quando um Comentário tiver uma Tarefa associada, a entrada de ID mostrará essa referência de Tarefa. Todas as entradas da coluna ID são links ativos para o Comentário ou a Tarefa.
Tarefas de Revisão de Projeto
A visualização Tasks da Revisão de Projeto inclui solicitações gerais de tarefas criadas a partir de Comentários inseridos na visualização Design Snapshot e tarefas de Iniciador/Revisor geradas pelo processo de Revisão de Projeto. As Tarefas de Revisão de Projeto também estão disponíveis nas visualizações Tasks do Projeto e Tasks do Workspace.
As Tarefas de Comentário, que estão associadas a um documento específico do projeto (snapshot), podem ser gerenciadas e ter seu progresso acompanhado por todos os membros do Workspace que tenham acesso ao projeto. Selecione um bloco de Tarefa para abrir o painel Info e acessar seus detalhes (Status, Assignee, Priority etc.), adicionar outro comentário ou fazer cross-probe para o comentário na visualização Design Snapshot (Open Review).
Consulte Trabalhando com Tarefas para mais informações.
Uma instância de Revisão de Projeto cria automaticamente Tarefas de processo associadas para Revisores e para o Iniciador. Elas são atualizadas e avançam até a conclusão com o processo de Revisão de Projeto, mas também podem ser gerenciadas e avançadas diretamente pela visualização Tasks por seu Responsável (o Iniciador ou Revisor atribuído à tarefa). Selecione um bloco de Tarefa para abrir o painel Info e acessar seus detalhes junto com o modo de visualização Activity.
Consulte Concluindo Revisões na Página de Tarefas abaixo para informações relacionadas.
A visualização Activity do painel fornece detalhes da Revisão de Projeto relacionada à Tarefa atual, incluindo seu progresso, usuários associados, projeto associado e histórico de alterações. Você pode usar a opção Terminate da visualização para encerrar a Revisão de Projeto atual – observe que todas as tarefas passarão então para o estado concluído (Resolved). 
Concluindo Revisões
Os membros do Workspace que foram designados como Reviewers devem avaliar o projeto dentro do escopo de revisão definido, concluir os itens do Checklist e, por fim, aceitar ou rejeitar os resultados por meio do botão 
. A decisão de conclusão da Tarefa (feedback) do revisor pode ser finalizada nas visualizações Overview, Design Snapshot ou Tasks da Revisão de Projeto. Observe que as visualizações Visão Geral e Snapshot fornecem acesso completo aos recursos da Revisão de Projeto, como Checklists, Comparações e Comentários agrupados.
A contribuição de um Revisor para a Revisão de Projeto é concluída quando sua avaliação é registrada como Approve ou Reject e sua Tarefa de revisão é encerrada (Resolved). A entrada com o nome do Revisor é então associada a um ícone de marca de verificação verde (
), destacada em verde, ou ambos.
Concluir Checklists não é obrigatório para enviar a revisão com sucesso. Clique na opção Sim/Não/NA de uma entrada de Checklist (
) para concluir esse item – clique novamente para remover uma seleção registrada.
As seleções das entradas do Checklist permanecem ativas para todos os usuários (Revisores e o Iniciador) e são cumulativas. Um Revisor, por exemplo, verá as seleções de itens do Checklist feitas por outros revisores – passe o cursor sobre uma seleção marcada para ver o nome do usuário. 
O Revisor então usa o botão 
para finalizar seu processo de revisão e feedback, enviando os resultados.
Na conclusão do processo, o estado da revisão associado à entrada de nome do Revisor mudará de Pending 
para Approved ou Rejected 
(dependendo da avaliação do Revisor). Isso fica visível para todas as partes interessadas na Design Review, incluindo outros Revisores e o Iniciador da revisão (criador).
Como alternativa, o mesmo processo de revisão pode ser concluído por meio da exibição Design Snapshot, que oferece a vantagem de acesso direto aos documentos relacionados de Schematic, PCB e BOM, além de permitir adicionar Comments às entradas da Checklist. Neste caso, os elementos e controles da revisão são acessados por meio do painel Design Review.
O envio da revisão conclui a tarefa atribuída e marca a entrada de nome do revisor de acordo. Observe que o painel agora inclui um botão 
, que pode ser usado para reverter o envio e retornar a tarefa de revisão a um estado ativo (Pending).
Observe que tarefas individuais de Design Review também podem ser processadas até a conclusão na exibição Tasks. Essa abordagem é realizada por meio do painel Tasks pane, mas não oferece os recursos adicionais das exibições Overview e Design Snapshot, como acesso a Checklists, Comparisons e Comments.
Finalizando revisões
Uma Design Review é finalizada e movida para um estado fechado e somente leitura pelo Initiator da revisão, que escolhe um estado Completed ou Rejected nas opções suspensas de Review decision e confirma isso com o botão 
. Somente o Iniciador da revisão ou um Administrador do Workspace pode finalizar uma Design Review. Isso não depende de os Revisores atribuídos terem concluído seu processo de revisão e, portanto, pode ocorrer a qualquer momento.
O curso esperado dos eventos seria que os Revisores de projeto tivessem concluído a Checklist da revisão, tratado quaisquer Comments/Tasks da revisão e enviado sua avaliação da revisão como Approve ou Reject (veja acima). O Iniciador da Design Review então move a revisão para um estado finalizado e fechado.
O Iniciador da Design Review conclui o processo de revisão especificando o estado fechado da revisão como Completed ou Rejected nas opções suspensas, ou cancelado no menu superior .
A Design Review finalizada é marcada com o estado selecionado (como Completed) e então fechada como uma instância de revisão somente leitura quando confirmada ().
Observe que um documento PDF de resumo da Design Review pode ser baixado a qualquer momento na opção Download Report do menu . 
O relatório contém todas as informações relacionadas ao estado atual da Design Review e inclui links ativos para os documentos e comentários da revisão. Exemplo: 
Depois que o Iniciador da revisão concluir a Design Review enviando seu resumo, a instância da revisão passará de um estado InProgress para um estado fechado determinado pela decisão de revisão do Iniciador. A Task de revisão do Iniciador passará de um estado In Progress para um estado Resolved, independentemente da escolha da decisão da revisão.
Juntamente com a Activities page do projeto, a History page do projeto conterá informações relacionadas à Design Review. Commits ou Releases do projeto que sejam, ou tenham sido, objeto de uma Design Review incluirão uma referência correspondente no bloco de histórico relacionado. Cada entrada é um link ativo para essa instância de Design Review e mostra o estado atual da revisão ao passar o cursor sobre o nome. Exemplo: 
Criando uma Design Review personalizada
Related page: Definindo um fluxo de trabalho de processo
Embora o recurso Design Review seja codificado para fornecer um conjunto específico de capacidades e opções, seu fluxo procedimental e opções adicionais são determinados por seu Process Workflow. O processo relacionado – Design Review – está disponível para administradores do Workspace por meio da Admin – Processes page, onde pode ser modificado e salvo como um processo alternativo de design review. 
Você também pode criar um novo processo personalizado do zero aplicando os elementos dedicados de design review usados por esse fluxo de trabalho (conforme disponível no tema Project Activities).
Exemplo de revisão personalizada
O exemplo de design review personalizado mostrado aqui fornece ao Iniciador da revisão uma escolha entre dois caminhos de tipo de revisão – Schematic e PCB – que são cada um atribuídos a usuários em seus respectivos Workspace Groups. Os resultados de cada tipo de revisão são recebidos e resumidos pelo Iniciador da revisão, que fecha a design review com um status Completed ou Unacceptable.
Um exemplo de definição de fluxo de trabalho personalizado que se torna disponível como um processo alternativo para o recurso Design Review.
Para criar um novo fluxo de trabalho de processo personalizado para o recurso Design Review, escolha a guia de tema Project Activities na página Admin - Processes do Workspace e selecione o botão 
para abrir o Process Workflow Editor – alternativamente, você pode criar um novo processo editando o existente. Um processo é criado organizando-se diagramaticamente os elementos Start, Task e Branching necessários, além de adicionar lógica de decisão de ramificação e controles baseados em variáveis a Forms de usuário. Uma atividade de processo de Design Review é definida usando o elemento Start do tipo Start Review.
Veja as imagens abaixo para uma visão geral dos principais Forms usados no exemplo de processo de design review acima – as imagens refletem a visualização ao editar ou criar um fluxo de trabalho (página Admin - Processes).
A primeira Set Review Type Task interativa no processo – tratada pelo usuário que iniciou a design review (o Initiator) – inclui um Form que exige a seleção do tipo de revisão. Isso é designado como a variável Domain, com opções para selecionar Schematic, PCB ou Both (fluxos de revisão). A lógica de Branch seguinte direciona o fluxo para uma das Tasks de revisão, ou para ambas. 
Cada um dos fluxos de revisão (Schematic e PCB) usa a Task específica Design Review, que inclui variáveis de Form para que o(s) revisor(es) forneça(m) feedback relacionado ao domínio da revisão – no caso acima, conclusões Layout validity e Manufacturability para o domínio PCB. A tarefa de revisão de Schematic é atribuída ao Grupo de usuários SCH Eng e a tarefa de PCB ao Grupo PCB Eng. 
Quando concluído e habilitado na página Admin - Processes, o processo personalizado estará disponível para seleção ao iniciar uma nova instância de Design Review. Tanto para os Revisores quanto para o Iniciador, a interface da revisão adotará as opções de comando e a estrutura de fluxo definidas pelo processo personalizado, como mostrado abaixo para o processo de exemplo:
-
Criando/configurando a revisão (Initiator).
-
Concluindo tarefas de revisão (Reviewers).
A revisão
In ProgressDRplus ativa agora está disponível para os revisores, com o Workflow mantido na etapa de tarefas ramificadas.
Esta visualização de exemplo mostra o usuário atribuído à instância de PCB.
Quando todas as tarefas dos revisores estiverem concluídas, elas passam para um estado
Resolved, e o Workflow avança para o evento Summarize, que fica disponível para o iniciador para finalização.
-
Finalizando a revisão (Initiator).
Observe que, com este Workflow, há uma etapa de Summary da revisão associada a cada ramificação da revisão, conforme indicado pelos ícones de próximo/anterior Summarize. Clique em
para prosseguir.
Observe que, neste exemplo simples, o Workflow inclui um evento Related Tasks Completed que impedirá a finalização da revisão até que ambas as ramificações de tarefas (Schematic e PCB) tenham sido concluídas.
Se apenas uma ramificação de domínio for selecionada inicialmente pelo Instigator, então o workflow da revisão será interrompido na etapa final de relatório Summary.
Localizado por IA