Performing Design Reviews

Uma parte essencial de qualquer processo de conceção é a revisão do seu progresso e validade em fases-chave do desenvolvimento, quer isso assuma a forma de discussões colaborativas entre pares ou de mecanismos rígidos de aprovação formal. Inerente a esse processo, seja a que nível for, está a disponibilização de acesso a todos os dados relevantes do projeto, ficheiros, comentários, representações visuais e ferramentas de feedback necessárias para o(s) revisor(es) visado(s).

O Altium Designer disponibiliza esta capacidade de uma forma altamente flexível através da aplicação de processos de revisão Process Workflows que são alojados por um Workspace ligado e acedidos a partir do Altium Designer.

► Para mais informações sobre processos e os seus fluxos de trabalho, consulte Creating & Managing Processes (Altium 365 Workpace, Enterprise Server Workspace).

Os fluxos de trabalho dos processos incorporam formulários interativos que são apresentados ao utilizador à medida que este progride pelas etapas do fluxo do processo e proporcionam a oportunidade de comentar, anexar ficheiros, visualizar documentos de conceção e muito mais. Os processos de revisão podem ser iniciados por qualquer utilizador do Altium Designer que tenha acesso ao projeto, e são atribuídos a outros utilizadores (membros da equipa) ou grupos de utilizadores (funções da equipa).

Do lado do Workspace, um administrador trabalha com processos como fluxos baseados em diagramas, em que os formulários de utilizador e as etapas incorporadas nos fluxos são totalmente personalizáveis. Isto permite que sejam construídos (e aplicados), se necessário, processos muito específicos, por exemplo, que visem requisitos de revisão estabelecidos pela empresa. Pode ser criado qualquer número de processos de fluxo de trabalho.

► Para mais informações, consulte Defining a Process Workflow (Altium 365 Workspace, Enterprise Server Workspace).

Processos de Revisão

O Workspace oferece três processos de revisão predefinidos que podem ser acedidos tal como fornecidos ou usados como base para processos personalizados mais avançados:

• Ad Hoc Review – Um processo de revisão informal sem uma conclusão registada.
• Handoff Review – Um processo de revisão mais formal em que o iniciador da revisão (submissor) regista uma conclusão de aprovação/reprovação (Concluído/Rejeitado) ao encerrar a revisão. Um estado concluído indica que a conceção está pronta para avançar para a fase seguinte de desenvolvimento.
• Milestone Review – Um processo de revisão de ciclo fechado mais elaborado em que o submissor usa o feedback da revisão para decidir se o estado é Concluído, Rejeitado ou se a conceção deve ser corrigida (Retrabalhada). Neste último caso, a conceção retrabalhada é depois verificada e a decisão Concluído/Rejeitado/Retrabalho é repetida. A revisão será encerrada quando o objetivo ou marco do projeto for alcançado com sucesso.

Em todos os casos acima, tanto o submissor/aprovador da revisão (Iniciador) como os revisores (Responsáveis) são guiados através do fluxo do processo por uma sequência de formulários da interface do utilizador. Os requisitos e opções em cada uma das etapas do fluxo do processo são determinados pela entrada de Processo correspondente no Workspace, que por sua vez é gerida pelo Administrador do servidor – que também pode iniciar e cancelar um processo de revisão.

Efetuar uma Revisão

Uma revisão assume normalmente a forma de três fases sequenciais:

1. O utilizador que inicia a revisão (o submissor) define o que será revisto e por quem, e adiciona quaisquer dados ou informações que venham a ser necessários.
2. Os revisores acedem aos dados do projeto e fornecem feedback adequado e, se necessário, adicionam dados ou informações relevantes.
3. O aprovador da revisão (normalmente o iniciador) avalia e resume o feedback dos revisores e encerra o processo.

Todas as fases de uma revisão são representadas por uma Task correspondente (Altium 365 Workspace, Enterprise Server Workspace) no painel Tasklist do software, que informa cada utilizador de que é necessária uma ação e fornece informações sobre tarefas concluídas. Selecionar uma Task pendente ativará essa fase da revisão.

Iniciar e Definir a Revisão

Um processo de revisão é iniciado a partir do menu Project » Project Activities no Altium Designer. A revisão aplicar-se-á inicialmente ao projeto atualmente ativo.

Tomando o processo Ad Hoc Review como exemplo, no seu formato predefinido e não modificado, a caixa de diálogo do formulário de abertura permite ao submissor (Barry no exemplo abaixo) especificar o projeto que será revisto e quais os utilizadores atribuídos para concluir a fase de feedback da revisão.

Os campos de entrada e menus na caixa de diálogo Ad Hoc Review são:

• Request title – o modo predefinido AUTO adota o nome do processo como base do nome do processo ativo (o título da Activity). Pode ser introduzido um nome personalizado em sua substituição.
• Project – o nome do projeto que será revisto. Este é o projeto ativo quando o processo é iniciado, mas qualquer projeto disponível pode ser selecionado a partir das opções do menu pendente sensível à digitação.
• Description – texto para fornecer informações adicionais aos revisores.
• Reviewers – membros da equipa ou grupos de funções especificados aos quais será atribuída a tarefa de submeter feedback da revisão. Comece a escrever para ver as entradas disponíveis.

Clique no botão para iniciar o fluxo de trabalho do processo e avançar para o formulário de definição de dados.

A caixa de diálogo do formulário Prepare review data seguinte permite-lhe especificar recursos de dados de conceção específicos e adicionar anexos. Note que qualquer texto do formulário destacado a azul é uma ligação ativa para esses dados de origem. A caixa de diálogo também inclui um diagrama descritivo do fluxo do processo no separador Diagram, que também indica a sua posição atual nas etapas do fluxo.

As opções de destaque na caixa de diálogo do formulário são:

• Data – use o menu pendente para selecionar um conjunto de dados de libertação específico do projeto (por data), ou use a opção associada para procurar e selecionar um conjunto específico de dados de libertação. No estado predefinido, em que não estão selecionados dados, o(s) revisor(es) terá(ão) acesso apenas aos dados de origem do projeto.
• Attachments – procure () ou arraste e largue ficheiros que pretenda adicionar como dados de revisão ou fontes de informação.

Quando todos os dados da revisão tiverem sido especificados ou adicionados ao formulário, clique no botão para mover o processo para a fase de Revisão.

Neste momento, a Task ativa Prepare review data é fechada no painel Tasklist, uma vez que a fase de submissão da revisão está concluída – note que, neste ponto, o utilizador do Altium Designer é o submissor do processo de revisão (Iniciador). O processo de revisão em curso é mostrado na listagem Activities do painel com um estado ativo. Clique no botão para garantir que vê o estado mais recente das Activities.

Para ver o estado de progresso do processo de revisão ativo, selecione a respetiva entrada na lista Activities para apresentar os dados atuais e o diagrama de fluxo anotado (separador Diagram).

Fornecer Feedback da Revisão

Com o processo de revisão configurado e submetido pelo Iniciador, a atividade irá gerar automaticamente Tasks a serem concluídas por aqueles especificados como Revisores. Quando um Revisor (por exemplo, Norm Smith neste exemplo) inicia sessão no Altium Designer, a área Tasks mostrará uma tarefa Provide review feedback atribuída.Selecting this Task will activate the Review stage of the process flow for the Reviewer. The following Provide review feedback form dialog offers the relevant project data (as specified by the review submitter), the opportunity to include comments and file attachments or open the project in the Web Viewer () and the requirement to submit a feedback Vote.

As opções de destaque na caixa de diálogo Provide Review feedback são:

• Open Project – selecione para abrir a conceção do projeto no Workspace Web Viewer. Isto disponibiliza uma grande quantidade de dados do projeto e vistas interativas totalmente renderizadas dos documentos de origem da conceção, o que permite adicionar comentários destacados e, opcionalmente, atribuí-los a um utilizador específico (membro do Workspace).
  ► Para mais informações, consulte a página Web Viewer (Altium 365 Workspace, Enterprise Server Workspace).
• Comment – as notas de comentário aqui incluídas serão atribuídas ao nome do revisor quando o processo de revisão for finalizado.
• Vote – selecione um resumo apropriado da conclusão da revisão.
• Reviewers attachments – procure () ou arraste e largue ficheiros, tais como notas mais detalhadas ou documentos de referência, que serão incluídos com o feedback da revisão.

Note que qualquer texto destacado a azul é uma ligação ativa para esses dados de origem. Selecione o botão para concluir o processo de revisão – isto é indicado no painel Tasklist, que fechará (removerá) essa tarefa ativa.

Resumir e Encerrar a Revisão

Quando todos os Revisores especificados tiverem concluído as tarefas de feedback da revisão que lhes foram atribuídas, o processo de Revisão ativo avança para a sua fase de resumo/encerramento. É gerada uma tarefa Summarize review para o utilizador atribuído a avaliar a atividade de revisão – neste caso, Barry, o mesmo utilizador que submeteu (iniciou) a revisão. Note que, para este utilizador, o processo de revisão é mostrado num estado ativo no painel Tasklist em Activities. Para os revisores, a atividade está agora encerrada porque as suas tarefas de contribuição foram concluídas.

Selecionar a tarefa Summarize review no painel Tasklist moverá o fluxo da revisão para a sua fase final, tal como apresentado na caixa de diálogo do formulário Summarize review.

As inclusões dignas de nota neste formulário são:

• Information provided by reviewers
  • Comment – uma lista dos comentários fornecidos pelos revisores no final das respetivas tarefas de revisão.
  • Vote – a classificação de conclusão da revisão selecionada por cada revisor.
  • Review attachments – quaisquer ficheiros relacionados adicionados à tarefa pelos revisores.
• Summary
  • Summary note – notas finais adicionadas pelo avaliador do processo de revisão (neste caso, o submetente/iniciador) que serão registadas quando a revisão for encerrada.

Ao clicar no botão da caixa de diálogo, o processo ativo de Design Review será encerrado. Tenha em atenção que, nos processos de Design Review mais avançados que estão disponíveis, estão incluídas etapas adicionais na fase de avaliação, como especificar uma conclusão de concluído/rejeitado ou iniciar uma tarefa de retrabalho do design.

Para examinar o Design Review concluído, atualize as entradas de Atividades no painel Tasklist (), assinale a opção Show Closed no menu e selecione a tarefa encerrada na lista. A seguinte caixa de diálogo inclui um resumo das informações da revisão (no separador Data) e o diagrama do fluxo do processo (separador Diagram) com o estado de progresso destacado — que é Completed, como seria de esperar.

Processos de Revisão Personalizados

Os processos de Design Review, tal como são apresentados ao utilizador no Altium Designer, são desenvolvidos e editados no Workspace ligado por um Administrador designado. A versatilidade dos elementos de etapas do fluxo e dos formulários da IU que, em conjunto, formam um fluxo de trabalho de processo de Design Review permite criar revisões que satisfazem uma vasta gama de necessidades específicas.

Algumas das opções adicionais que podem ser aplicadas às etapas e aos formulários são:

• atribuir qualquer etapa do fluxo a um utilizador ou função específica, para além dos designados como revisores ou avaliador.
• negar a um utilizador ou função o acesso a uma etapa específica do fluxo de trabalho (um Exception), para que essa etapa seja ignorada no fluxo para esse utilizador ou função.
• tornar obrigatório o preenchimento de um campo do formulário antes de a caixa de diálogo do formulário poder ser submetida.
• adicionar etapas intermédias ao fluxo de trabalho que imponham tarefas adicionais e formulários de utilizador.
• criar um ciclo de decisão no fluxo de trabalho em que apenas uma ação específica o fechará.
• mostrar ou ocultar determinados dados ou mensagens de evento/erro num formulário da IU de uma etapa do fluxo de trabalho.
• utilizar a funcionalidade Web Viewer do Workspace para permitir a inspeção e comentário de documentos de design por revisores que não tenham acesso direto aos documentos de origem do design.

Como indicado anteriormente, pode ser criado qualquer número de processos de revisão e disponibilizado ao Altium Designer, e estes podem ser desenvolvidos para níveis de revisão que vão desde a recolha informal de feedback de colegas até processos formais de revisão ratificados pela empresa e integrados com outros sistemas da empresa (como PLM).

► Para informações detalhadas sobre a criação de processos personalizados, consulte Defining a Process Workflow (Altium 365 Workspace, Enterprise Server Workspace).