Review & Approval

UI: Review & Approval / Revisão e aprovação
Público-alvo: Initiators, reviewers e approvers do projeto

Para que serve

Criar e executar reviews de documentos com workflow (passos, reviewers, approve/reject), alinhados aos Approval Flows.

Relevância

Governança: nada avança sem o passo certo. Pode partir de arquivos, de um Transmittal ou de um Topic. Sem reviews claros, o CDE não distingue “em revisão” de “aprovado para uso”.

Exemplo de uso

O gerente cria um review a partir de 3 plantas, escolhe o workflow Technical review → Final approval, inicia o fluxo. No passo Revisão, o revisor reivindica o passo (modo Single) e submete a decisão do participante. Quando o fluxo chega à Aprovação final, o aprovador decide arquivo por arquivo. Se algum arquivo for REJECT, a aprovação final é fechada como rejeitada; se todos forem APPROVE, o passo é concluído e as ações de conclusão (atributos / pasta de destino) são aplicadas conforme o template.

Quem pode usar

Initiators, reviewers e approvers com papel no fluxo (e permissões CDE / projeto correspondentes).

Anatomia da tela

• Listas Active reviews / Archived reviews.
• Ribbon Manage / Reports / View.
• Wizard Create (Scope → … → Summary).
• Detalhe (sheet): abas Informações · Arquivos · Etapas · Decisões · Histórico.

Opções e campos

Ribbon

Grupo	Ações
Manage	Create Review · Start · Close · Send Back · Send to Initiator · Skip Step · Archive · Delete
Reports	Export CSV · Export Report PDF
View	Filters · Columns · Compare Versions

Colunas / filtros da lista

Status · ID · Round · Review name · Priority · Initiated by · Next action due · Created on · Files · Progress · Total steps · Current step · Workflow · Next action by · Finished on · Approved · Rejected · Actions.

Filtros: Search · Status · Priority · Initiated by · Created on · Next action due · Finished on · Total steps · Current step · Workflow.

Statuses: Draft · Active · Processing · Sent back · Returned · Closed · Archived · Cancelled.
Priorities: Low · Medium · High · Critical.

Create wizard

Passos: Scope · Files · Workflow · Reviewers · Details · Summary.

Campo	Função
Scope	Documents/files · Transmittal · Topic
Approval workflow	Fluxo do projeto (template)
Review name / Title · Description · Priority · Due date	Identidade do review
Reviewer(s) & Approver(s)	Quem decide em cada passo
Step name · Type (Sequential / Parallel / Consolidation)	Estrutura
Reviewer mode (Single / Group)	Um revisor por vez vs grupo
Rule (All must decide / Any one / Majority)	Quórum em passos de grupo
Action upon completion · Copy approved files to · Update attributes when approved	Pós-aprovação
Linked references · Completion target folder	Referências e destino
Save as draft · Create & start	Publicar

Detalhe / abas

Aba	Conteúdo
Informações	Review ID · Created by · Created · Due · Started · Closed · Progress · Round · Completion target folder · Watchers
Arquivos	Lista de arquivos; decisões APPROVE/REJECT somente na aprovação final; Transmit… · Abrir · Download
Etapas	Passos do workflow, participantes, estado do passo, Submeter decisão (passos de revisão)
Decisões	Decisões de participante + decisões por arquivo (ver seção abaixo)
Histórico	Timeline de ações (start, claim, decisões, skip, close…)

Badges de passo: Not Started · Waiting · In Review · Completed · Skipped · Rejected.
Badges de arquivo: APPROVE · REJECT (e códigos de estado do projeto, se mapeados).

Ações frequentes no header do detalhe: Start · Close · Claim step / Reivindicar passo · Download PDF · Create transmittal · menu (Skip step · Recall · Cancel…).

Transmit… no detalhe de arquivo pode mostrar “Transmittal is not available yet.” em alguns estados — somente após o review estar elegível (tipicamente fechado/aprovado conforme regras).

Como funciona o fluxo de execução

Esta seção descreve o comportamento esperado no aplicativo — útil para usuários e para QA.

Dois tipos de passo

Tipo de passo	O que o revisor faz	Onde na UI
Revisão (intermediário)	Decide no passo como participante (aprovar / rejeitar o passo)	Aba Etapas (e resumo em Decisões)
Aprovação final (Final approval)	Decide arquivo por arquivo (APPROVE / REJECT)	Aba Arquivos

O mesmo review pode ter vários passos de revisão e um passo de aprovação final no fim do template.

Claim step (Reivindicar passo)

• Só aparece quando o passo ativo está em modo Single (um revisor por vez).
• Serve para reservar o passo para você.
• Não “libera modelos/arquivos” em qualquer etapa: nas etapas de Revisão, o claim não ativa APPROVE/REJECT na aba Arquivos.
• Na Aprovação final (Single), o claim é normalmente necessário antes de você poder decidir os arquivos.

Etapa de Revisão ativa

1. Abre o review → aba Etapas.
2. Se o modo for Single → Claim step.
3. Submeter decisão do participante nesse passo.
4. Na aba Arquivos é normal ver a mensagem de que você não tem permissão para decidir sobre estes arquivos — as decisões por arquivo só existem na aprovação final.

Etapa de Aprovação final ativa

1. O passo deve estar Em revisão (não “Não iniciado”).
2. Se Single → Claim step.
3. Na aba Arquivos, decida cada arquivo (APPROVE / REJECT), um a um ou em massa quando a UI permitir.
4. Cada decisão de arquivo grava imediatamente — não há rascunho + botão “submeter o pacote no final”.
5. Enquanto o passo final ainda está ativo, você pode alterar a decisão de um arquivo (voltar a decidir o mesmo arquivo).
6. Quando o último arquivo recebe decisão, o sistema consolida automaticamente:
   • Todos APPROVE → passo final Concluído (e o fluxo segue / fecha conforme o template).
   • Qualquer REJECT → passo final Rejeitado e o review passa para o estado de retorno/fechamento correspondente (Sent back / concluído rejeitado na UI). Não há tela extra “confirmar resultado do pacote”.

Depois do fechamento

• Já não é possível mudar decisões de arquivo.
• A mensagem de sem permissão na aba Arquivos é esperada.
• O botão Change na aba Decisões pode ainda aparecer e apenas navega para Arquivos — aí o sistema bloqueia. Isso não significa que a regra de negócio esteja errada.

Como ler a aba Decisões

Há dois tipos de decisão na mesma aba:

1. Decisões de participante — cards por pessoa/passo (etapas tipo Revisão), com badge Aprovado/Rejeitado.
2. Decisões por arquivo — listadas por arquivo, com o nome de quem decidiu (aprovação final).

Importante:

• Na Aprovação final, o aprovador não cria um card de “participante Aprovado/Rejeitado” no mesmo estilo da etapa de revisão — apenas decide nos arquivos. Por isso pode parecer que “falta” a decisão do usuário final nos contadores de participante.
• Os contadores do topo (X aprovado(s) / Y rejeitado(s)) contam somente decisões de participante, não os APPROVE/REJECT dos arquivos. Você pode ver 1 aprovado / 0 rejeitado no topo e mesmo assim ter um arquivo REJECT na lista — comportamento atual da UI, não prova que o REJECT foi ignorado.

Checklist rápido (esperado)

Situação	Resultado esperado
Aba Arquivos na etapa Revisão	Mensagem de sem permissão para decidir arquivos
Claim na etapa Revisão	Reserva o passo; não libera APPROVE/REJECT de arquivos
Entrar em Aprovação final + claim (Single)	Passa a poder decidir arquivos
Alterar decisão de um arquivo antes de todos estarem decididos	Permitido
Último arquivo com 1 REJECT (mesmo com outros APPROVE)	Passo final Rejeitado; fluxo fecha sem confirmação manual extra
Todos os arquivos APPROVE	Passo final concluído / avança
Depois de fechado, tentar mudar arquivo	Bloqueado
Aba Decisões: aprovador final	Aparece nas decisões por arquivo, não como segundo card de participante da etapa 1

Como usar

Abrir

1. CDE → Review & Approval.
2. Abra um item em Active reviews (ou Archived reviews).

Criar e iniciar

1. Create Review.
2. Percorra o wizard (Scope → Files → Workflow → Reviewers → Details → Summary).
3. Create & start (ou Save as draft e depois Start).

Executar como revisor (passo de Revisão)

1. Abra o detalhe do review ativo.
2. Aba Etapas → se Single, Claim step.
3. Submeter decisão do participante.
4. Não espere decidir arquivos neste passo.

Executar como aprovador final

1. Confirme que o passo atual é Aprovação final / Final approval e está Em revisão.
2. Se Single → Claim step.
3. Aba Arquivos → APPROVE / REJECT por arquivo.
4. Ao completar o último arquivo, o resultado é consolidado automaticamente (ver seção acima).

Fechar / arquivar / transmitir

1. Quando o fluxo terminar, use Close / Archive conforme o estado e suas permissões.
2. Create transmittal pode ficar disponível em reviews fechados elegíveis.
3. Notificações: Project Notifications.

Ligações

• Approval Flows · Document statuses · CDE Configuration · Transmittals · Topics

Dicas / erros comuns

• “Não posso decidir arquivos” na etapa Revisão — esperado. Somente na Aprovação final.
• Claim não desbloqueou os arquivos — confirme se o passo ativo é realmente a aprovação final (não um passo de revisão intermediário).
• Aprovei 2 e rejeitei 1 e o fluxo ficou rejeitado — esperado: qualquer REJECT na aprovação final rejeita o passo. Não há confirmação manual do “pacote”.
• Queria mudar a decisão depois de fechar — só é possível enquanto a aprovação final ainda está ativa; depois do fechamento, não.
• Na aba Decisões só vejo o usuário da etapa 1 — o aprovador final conta nas decisões por arquivo; os contadores Aprovado/Rejeitado do topo ignoram arquivos.
• Sem workflow/template no projeto, Create fica limitado — configure Approval Flows.
• Diferente de Design RFA — RFA.
• Skip Step / Send Back / Recall alteram o trilho — use com critério (Skip marca o passo como ignorado e avança).