🚀 Gerenciamento de Alterações com Plugin Breeze

Este guia orienta o usuário sobre como criar, editar e aprovar alterações em páginas que utilizam o fluxo de trabalho do Plugin Breeze.

O Plugin Breeze é uma ferramenta de fluxo de trabalho integrada ao Confluence Cloud que permite gerenciar o ciclo de vida do conteúdo. Ele possibilita a criação de rascunhos, revisões e aprovações de forma isolada da versão publicada, garantindo a integridade do site de Ajuda. O Breeze permite trabalhar em uma Cópia de Trabalho (Working Copy). Isso garante que você possa editar e revisar o conteúdo em modo de rascunho sem afetar a versão publicada no site até que a aprovação final ocorra.

1. O que Requer Bastante Atenção?

• "Create Work Copy" deve ser usado APENAS para editar uma dica que já existe.
  

  Atenção! Caso use "Work Copy" para criar um tema novo baseado em um antigo, ao fazer o Merge, o conteúdo da dica original será apagado.

   

• "Duplicar" (Duplicate) deve ser usado quando você quer criar uma nova dica aproveitando a estrutura de uma antiga.
  
  

2. Diferença Crucial Antes de Começar

• Para EDITAR uma dica existente: Use o botão Create Work Copy.
  Isso cria uma versão de rascunho sem alterar o que o cliente vê.
  
  
  
  O status da página ficará como Draft (working copy) como no exemplo abaixo.
  Agora você já pode editar a cópia da página.
  
  
  
  

• Para CRIAR uma nova dica baseada em uma antiga: Use a função Duplicar (Duplicate).
  
  
  
  

• RISCO: Nunca utilize "Work Copy" para criar um tema novo sobrepondo um antigo. Ao realizar o Merge, o conteúdo original da página será apagado e substituído pelo novo.
  

3. Criar uma Cópia de Trabalho (Edição)

Para alterar uma página já publicada:

1. Acesse a página que precisa atualizar.

2. No menu superior, localize o status (geralmente Up to date = Atualizado).

3. No menu superior, clique em Create Work copy.
   
   
   

4. Com o status Draft Working Copy ativo, clique em Editar.

5. Realize as alterações e clique em Atualizar.
   
   

   • O status permanece como Draft (Working Copy) até que você solicite uma aprovação.
     

4. Criar uma Nova Dica (Do Zero)

Para conteúdos inéditos, o fluxo é simplificado:

• Crie a página normalmente no espaço de sua área (Shop, Fiscal, DP ou Pack/Prosoft).

• Se precisar interromper o trabalho, apenas feche o editor.
  A página ficará como Rascunho (Draft) nativo até que você decida publicar ou iniciar um fluxo de aprovação.

5. Solicitar Aprovação (Com Revisor Externo)

Utilize este fluxo para validar o conteúdo com supervisores ou revisores.

1. Clique no status Draft Working Copy.

2. Clique em Request approval.

3. Definindo o Aprovador: Clique no ícone da Canetinha (Pencil) para buscar o nome do responsável.
   
   

   • Nota: Estamos definindo se a aprovação será via usuário específico ou via comentário de supervisão.
     
     

4. Escolha o tipo (Standard ou Multi-step) e clique em Confirm approvers.
   
   

   Aprovação padrão (Aprovador Único):

    Aprovação padrão (Aprovador Único):

   1. Clique no status Draft Working Copy.
      
      

      • O sistema exibe a mensagem: "Esta página é um rascunho. Solicite aprovação quando o conteúdo desta página estiver pronto para publicação".
        
        

   2. Clique em Request approval (Solicitar aprovação).

   3. Selecione o tipo de aprovação Standard approval: Aprovação padrão.

   4. Em Approvers, clique no editor para informar o aprovador.
      
      Em Type (Tipo):
      
      

      • Everyone must approve: Todos devem aprovar.

      • First response decides: A primeira resposta define o resultado.

      • Majority must approve: A maioria deve aprovar.
        
        
        
        

   5. Clique em Confirm approvers (Confirmar aprovadores).
      
      
      
      
   6. (Opcional) Informe a Data. Clique em Request approval para finalizar.
      
      

   
   Resultado: O status muda para In approval (working copy). O aprovador recebe uma notificação por e-mail e via Confluence.

   Aprovação em Várias Etapas (Múltiplos Aprovadores):

   Aprovação em Várias Etapas (Múltiplos Aprovadores):
   
   

   1. Clique no status Draft Working Copy.
      
      

      • O sistema exibe a mensagem: "Esta página é um rascunho. Solicite aprovação quando o conteúdo desta página estiver pronto para publicação".
        
        

   2. Clique em Request approval (Solicitar aprovação).

   3. Selecione o tipo de aprovação: Multi-step approval: Aprovação em várias etapas.
   4. Em Approvers, clique no editor para informar o primeiro aprovador.
      
      Para adicionar mais aprovadores, clique em + Add step / clique no editor para informar o próximo aprovador / Clique em Confirm approvers (Confirmar aprovadores).
      Em Type (Tipo):
      
      

      • Everyone must approve: Todos devem aprovar.

      • First response decides: A primeira resposta define o resultado.

      • Majority must approve: A maioria deve aprovar.
        
        

   5. (Opcional) Informe a Data.Clique em Request approval para finalizar.
      
      

   
   Resultado: O status muda para In approval (working copy). O aprovador recebe uma notificação por e-mail e via Confluence.

   
   

6. Finalização e Publicação (O momento crítico)

Após a aprovação, o conteúdo precisa ser mesclado para ir ao ar.

1. Clique no status Up to date (working copy) da página com a revisão aprovada / ... / Merge working copy.

2. O que acontece agora? O sistema pegará todas as suas alterações e substituirá a versão antiga da página.

3. Publicação imediata: No Confluence Cloud, o Merge envia a alteração instantaneamente para o site de ajuda (Scroll Sites).
   
   

💡 Dica Pro: Antes de fazer o Merge, você pode obter o Link Fixo da página através do menu do Scroll Sites. Isso permite enviar o link para o DSN ou ações de Marketing antes mesmo da dica estar pública. O que for informado em URL path, fará a composição do link da página. Conforme o cenário abaixo: https://ajuda.alterdata.com.br/reforma-tibutaria

7. Boas Práticas e Segurança

• Comentários de Contexto: Em áreas compartilhadas (como instrução e suporte), sempre deixe um comentário interno na página explicando o objetivo daquela documentação.
  Isso evita que colegas excluam seu trabalho por acharem que é um teste.

• Publicação Individual: Lembre-se que o Breeze publica página por página.
  Diferente do antigo Ajuda (Server), no Ajuda em ambiente Cloud, você tem controle total sobre qual dica vai ao ar e quando.
  
  

8. Glossário de Comandos

Consulte os termos para saber sua finalidade: