Revisões

Uma revisão é um conjunto de artefatos que você cria para ser revisado por membros específicos da equipe. A revisão segue um ciclo de vida que muda à medida que os participantes completam a revisão.

Você pode criar uma revisão para artefatos individuais que seleciona ou pode criar uma revisão de uma coleção.

Crie uma revisão de artefatos individuais clicando no ícone Criar revisão na seção Revisão da barra lateral. Após fornecer um nome para a revisão, você então inclui artefatos e participantes à revisão clicando nos botões apropriados no Editor de Revisão e depois clicando no botão Iniciar Revisão. Notificações de e-mail são enviadas automaticamente aos participantes quando uma revisão é iniciada e toda vez que determinados eventos ocorrem na revisão. Os participantes ingressam na revisão clicando no nome da revisão que aparece no painel de cada participante.

Existem dois tipos de revisões: uma revisão Formal e uma revisão Informal.

Ao incluir um participante em uma revisão, você designa uma função ao participante que determina as ações que são necessárias para concluir a revisão. A tabela a seguir descreve essas funções e ações.

Tabela 1. Revisando Função e Ação Requerida
Função Participante Ação Necessária
Aprovador Este participante deve aprovar ( ícone), desaprovar (ícone), ou se abster(ícone) para cada artefato na revisão antes que a revisão possa avançar para o estado Revisado ou Finalizado. Note que o ícone que corresponde à escolha do participante aparece na coluna de status nas janelas do editor de revisão.
Revisor Este participante deve revisar um artefato (ícone revisado) ou se abster(ícone) de revisar o artefato antes que a revisão possa avançar para o estado Revisado ou Finalizado.
Opcional Esse participante pode opcionalmente revisar ou abster-se de revisar um artefato; no entanto, a revisão pode mudar para o estado revisado ou finalizado independente do que esse participante fizer.

Estados de Revisão de Ciclo de Vida

O estado da revisão muda com base em seu nível de conclusão. Esta é a ordem principal que uma revisão segue no seu ciclo de vida:

Rascunho > Em Andamento > Revisado > Finalizado

A seguinte tabela descreve os estados do ciclo de vida de uma revisão:
Tabela 2. Estados de Revisão de Ciclo de Vida
Estados de Revisão Descrição
Rascunho O estado inicial de uma revisão em que o criador de uma revisão designa uma data de vencimento, inclui instruções de revisão, inclui participantes, designa funções aos participantes e inclui artefatos na revisão. Os participantes não são notificados quando a revisão está no estado de rascunho.
Em Andamento Quando o criador da revisão clica no botão Iniciar revisão, a revisão muda para o estado Em Andamento. Os participantes ingressam na revisão clicando no título da revisão que aparece em seus painéis. Quando todos os participantes terminarem de revisar os artefatos, a revisão muda para o estado Revisado.
Pausado Um estado intermediário no qual a revisão foi pausada. Este estado possibilita ao criador da revisão alterar os participantes, suas funções, ou os artefatos que compõem a revisão. Em uma revisão Formal, o criador também pode escolher obter a versão mais recente dos artefatos, quando então todos os artefatos que foram capturados inicialmente na revisão são substituídos pelas versões mais recentes dos artefatos. Observe que os participantes não podem incluir comentários de revisão ou marcar artefatos como revisados quando a revisão estiver pausada. O criador da revisão deve clicar no botão Continuar para continuar a revisão.
Revisado Os revisores incluíram comentários nos artefatos e clicaram no botão Pronto na sua revisão. O criador da revisão (ou um administrador) ainda pode fazer mudanças na revisão neste ponto pausando a revisão e fazendo alterações.
Finalizado Todos os revisores necessários concluíram a revisão e o criador clicou no botão Finalizar revisão. A revisão está salva e não pode mais ser modificada. No caso de uma revisão Formal, as versões específicas dos artefatos que foram aprovadas também são salvas. Agora você pode criar uma coleção que contenha os artefatos revisados para continuar a trabalhar com esses artefatos fora da revisão.

Seções do Editor de Revisão

Quando um participante abre uma revisão, o editor de revisão aparece com duas seções minimizáveis: a Revisão do Participante e a Revisão Geral. Os participantes podem comutar entre as duas seções clicando na seta de revisão do participante (seta do participante) ou na seta da revisão geral (seta de revisão geral) (ou clicando nos cabeçalhos da seção)

Na Revisão do Participante, o participante vê a função do participante e os artefatos que compõem a revisão. O participante visualiza um artefato dando um clique duplo nele, o que exibe o artefato em modo somente de leitura. Em seguida, dependendo da função designada ao participante, o participante aprova, marca como revisado, desaprova ou se abstém.

Na Revisão Geral, o participante vê os artefatos e os participantes que compõem a revisão, mas somente o criador da revisão (ou um administrador) pode fazer alterações à revisão. O criador da revisão pode alterar a revisão clicando em pausar e fazendo as alterações. O criador pode alterar os participantes, suas funções, ou os artefatos que compõem a revisão. O criador pode até substituir a versão atual dos artefatos na revisão pela versão mais recente dos artefatos no projeto.

Notificação de E-mail

É possível incluir comentários manualmente em uma revisão na barra lateral do Editor de Revisão; no entanto, a maioria dos eventos gera automaticamente notificação de e-mail aos participantes da revisão.
Nota: Se o e-mail não foi configurado quando o produto foi instalado inicialmente, é necessário primeiro definir as configurações de e-mail no servidor para habilitar notificações de e-mail automáticas.
A tabela a seguir fornece uma descrição dos eventos que causam o envio de notificações de e-mail:
Tabela 3. Eventos de Notificação de E-mail
Destinatário da Notificação Eventos que causam o envio de notificações de e-mail
Todos os Participantes Quando a revisão estiver iniciada ou quando houver inclusões ou alterações em determinadas propriedades, como data de vencimento, status e instruções de revisão.
Todos os Participantes Artefatos são incluídos ou removidos da revisão
Participantes específicos Participantes são incluídos ou removidos da revisão.
Participantes específicos Alterar para seus status ou para o status de um artefato que os afeta. Este evento ocorre quando o criador da revisão reconfigura o status do participante.
Participante Específico Alterações da função do revisor.

Revisando uma coleção.

Além de criar uma revisão de artefatos individuais, também é possível criar uma revisão de uma coleção. Crie uma revisão de uma coleção a partir do editor de coleção ou do menu de contexto da coleção. Ao criar uma revisão de uma coleção, deve ser observado o seguinte:

Feedback