Mecanismo de Versioning do App Builder
Visão Geral
O App Builder inclui agora um mecanismo de versioning robusto. Você pode capturar e restaurar com segurança estados anteriores sem perda de dados ou inconsistências, independentemente de as alterações terem sido feitas manualmente.
Este mecanismo o ajuda a:
- Salvar pontos de verificação nomeados durante sessões complexas de design.
- Recuperar-se de alterações não intencionais.
- Preservar pontos de restauração antes de operações de alto impacto.
Note
Desfazer/Refazer tem escopo de sessão. Se você fechar a aba do navegador, o histórico de desfazer será perdido. O Histórico de Versões fornece pontos de restauração persistentes entre sessões.
Pré-requisitos
Antes de começar:
- Abra um aplicativo no App Builder.
- Certifique-se de que você tem permissões de edição para o workspace do aplicativo.
- Salve pelo menos uma alteração para habilitar entradas de versão relevantes à sua sessão atual.
O Que Você Pode Fazer
O recurso de versioning inclui duas capacidades principais:
- Sistema de Versioning de Estado: Captura automática e manual de estados de aplicativos e visualizações.
- Navegação e Gerenciamento de Versões: Listar, filtrar, renomear, duplicar, restaurar, abrir e deletar versões salvas.
Os snapshots capturam o estado do modelo do App Builder, incluindo:
- Estrutura do aplicativo
- Visualizações
- Fontes de dados
- Tema
O App Builder armazena snapshots de forma eficiente usando uma estratégia de Diff/Delta.
Acessar o Histórico de Versões
Você pode abrir o Histórico de Versões a partir do menu de aplicativo no dropdown do nome do aplicativo (Mostrar Histórico de Versões).
O painel abre no lado esquerdo e exibe uma linha do tempo das versões.
Salvar uma Versão Manual
Use versões manuais para criar pontos de restauração intencionais antes de alterações arriscadas.
- Abra o botão de salvamento dividido ou o menu de contexto do aplicativo/visualização.
- Selecione Salvar Versão.
- (Opcional) Digite um rótulo personalizado. : O formato padrão é Salvamento manual - [timestamp].
- Selecione Salvar.
No final:
- O App Builder cria uma versão com um ID único atribuído automaticamente.
- Um toast de sucesso aparece (por exemplo, Versão salva).
Snapshots Automáticos
Salvamos automaticamente apenas ao restaurar uma versão manualmente salva.
Navegar e Gerenciar Versões
O painel de Histórico de Versões suporta navegação por linha do tempo e gerenciamento de versões.
Filtragem e agrupamento
Use filtros para estreitar os resultados:
- Todas as Versões
- Minhas Versões
- Versões Nomeadas
Os grupos de linha do tempo podem incluir:
- Mais Cedo Hoje
- Mais Cedo Esta Semana
- Mês Passado
As versões mais novas são exibidas primeiro por padrão.
Ações por versão
As ações por linha podem incluir:
- Restaurar
- Renomear
- Duplicar
- Deletar
Fluxo de Trabalho de Restauração
- Abra Histórico de Versões.
- Selecione a versão de destino.
- Escolha Restaurar.
- Confirme a restauração.
Resultado esperado:
- Um toast de sucesso confirma a restauração.
- Se você restaurar uma versão manualmente salva, o App Builder cria um snapshot automático antes da restauração.
Atualizações do Menu de Aplicativo e UX de Salvamento
O nome do aplicativo agora abre um dropdown com:
- Renomear
- Duplicar
- Copiar para Workspace
- Mostrar Histórico de Versões
Atualizações de comportamento relacionadas:
- Renomear é acessado a partir do dropdown e da renomeação por clique.
- Duplicar não força navegação para longe do aplicativo atual.
- Toasts de sucesso confirmam ações, incluindo duplicação e salvamento de versão.
Retenção e Limpeza
A retenção de versão segue estas regras:
- As versões são retidas por pelo menos 90 dias. Após isso, deletamos apenas as versões auto-salvas
- As versões manuais e auto-salvas não são deletadas automaticamente, elas podem ser deletadas manualmente pelo usuário.
Limitações e Notas
- O histórico de versões não substitui estratégias de branching de controle de código-fonte.
- Desfazer/Refazer e Histórico de Versões são sistemas de recuperação diferentes.
- A disponibilidade exata do gatilho pode variar por configuração de locatário e lançamento de implantação.
Resultados Esperados
Após usar o versioning, você pode:
- Criar pontos de restauração confiáveis antes de edições arriscadas.
- Recuperar-se rapidamente de alterações não intencionais que devem ser revertidas.
- Rastrear a evolução de aplicativos e visualizações com metadados claros e filtros de linha do tempo.
