Histórico de versões
Em um modelo versionado, cada salvamento grava uma nova versão numerada que nunca é alterada depois. Você pode listar as versões de um registro, comparar uma com a anterior e restaurar uma versão anterior.
Quais modelos mantêm histórico
Um modelo mantém histórico quando versionamento, publicação ou variantes estão ativados para ele. Os três vêm desativados por padrão e são definidos por modelo. Em um modelo sem nenhum deles, uma atualização substitui os dados no lugar.
O que o console mostra
A aba Histórico de um registro lista suas versões com o nome do autor e a descrição da alteração. Dali você pode comparar uma versão com a anterior ou restaurá-la. A descrição é opcional pela API e pela CLI, e o console preenche "Conteúdo salvo" quando um editor a deixa em branco.
Restaurar adiciona uma versão
Uma restauração traz o conteúdo da versão antiga de volta como uma nova versão, validada como qualquer outro salvamento. O histórico só avança, e a versão da qual você restaurou permanece inalterada. Se o modelo mudou desde que aquela versão foi gravada, a restauração descarta campos que o modelo não declara mais e recusa valores em um formato que ele não aceita mais.
Verificando uma restauração antes
foir records revert aceita --dry-run como flag. Ela informa o que seria convertido, descartado ou recusado, não grava nada e sai com código diferente de zero se a reversão fosse recusada. A mutation de reversão no GraphQL tem um argumento dryRun equivalente.
Por quanto tempo o histórico é mantido
O histórico é mantido por uma janela que depende do seu plano, e uma varredura diária recolhe as versões mais antigas que isso. Algumas versões são mantidas qualquer que seja a idade: a que está sendo editada, a publicada, uma na fila para uma publicação agendada, uma que a reversão de um rollout restauraria, e a versão mais recente de cada registro.
Leia os detalhes
O guia de registros explica como as versões são gravadas, por quanto tempo são mantidas e o que uma restauração faz quando o modelo mudou.