Versionamento - Amazon Quick Suite

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Versionamento

As versões ajudam você a gerenciar seus Amazon Quick Flows à medida que você os cria, testa e compartilha com outras pessoas. Pense em versões como salvar cópias diferentes do seu trabalho. Você pode ter uma cópia de trabalho e, ao mesmo tempo, manter uma versão limpa e publicada para que outras pessoas usem. O Amazon Quick Flows simplifica as coisas com no máximo três versões para qualquer fluxo.

Como funciona o versionamento

A configuração da sua organização determina quais tipos de versão você verá:

Se sua organização usa a revisão de aprovação

Você trabalhará com três tipos de versões. Para obter informações detalhadas sobre como as análises de aprovação funcionam, consulte a documentação Amazon Quick Flows - Revisões de aprovação.

🔧 Rascunho

O que é: sua cópia de trabalho onde você cria e testa seu fluxo. Você pode continuar executando rascunhos como fluxos privados sem nunca compartilhá-los.

O que você pode fazer:

  • Edite e modifique seu fluxo livremente

  • Adicione cartões como cartões Amazon Quick Sight, cartões de upload de arquivos e cartões de saída

  • Teste suas alterações antes de compartilhar

  • Salve seu trabalho automaticamente à medida que avança

  • Crie vários rascunhos para experimentar abordagens diferentes

⏳ Aprovação pendente

O que é: essa versão do fluxo está aguardando que um usuário qualificado a revise e aprove para compartilhamento.

O que você pode fazer:

  • Visualize seu fluxo enviado (mas não consigo editá-lo)

  • Verifique o status de aprovação

  • Responder ao feedback do revisor

  • Aguarde a aprovação ou resolva as alterações solicitadas antes de reenviá-las para análise

✅ Publicado

O que é: Seu fluxo aprovado que outras pessoas agora podem usar

O que você pode fazer:

  • Veja seu fluxo publicado ao vivo

  • Use-o como ponto de partida para novos rascunhos

Se sua organização não usa a revisão de aprovação

Você trabalhará com dois tipos de versões:

🔧 Rascunho

O que é: Seu espaço de trabalho privado para criar fluxos

O que você pode fazer:

  • Edite e teste seu fluxo

  • Salve as alterações automaticamente

  • Mantenha seu trabalho privado até que esteja pronto para compartilhar

✅ Publicado

O que é: Seu fluxo publicado que outras pessoas podem usar imediatamente

O que você pode fazer:

  • Publique diretamente quando seu fluxo estiver pronto

  • Disponibilize-o para os usuários imediatamente

  • Use-o como base para futuras mudanças

Principais conceitos de controle de versão

A compreensão desses conceitos básicos ajudará você a trabalhar de forma eficaz com o controle de versão do Amazon Quick Flows:

Multiversão para criadores: como criador de fluxo, você pode ver e trabalhar com várias versões do seu fluxo (rascunho, aprovação pendente, compartilhada). Isso permite que você continue desenvolvendo enquanto os usuários acessam a versão estável publicada.

Versão única para usuários: os usuários finais sempre veem somente uma versão do seu fluxo: a versão publicada atualmente. Isso evita confusões e garante que todos tenham a mesma experiência.

Fluxo de trabalho de publicação de alterações: ao fazer alterações em um fluxo compartilhado existente, você deve “publicar alterações” para disponibilizar essas atualizações aos usuários. Isso cria uma nova versão e pode acionar a revisão da aprovação.

Substituição de versão: sempre que você publica alterações, a nova versão substitui a versão publicada anteriormente para todos os usuários. As versões históricas são mantidas para os criadores, mas os usuários sempre veem a versão mais recente aprovada.

Controle de versão da definição do aplicativo: alterações nos elementos principais do fluxo, como título, descrição e estrutura, são consideradas alterações na definição do aplicativo e exigem passar por todo o processo de publicação.

Criação e edição de fluxos

Todos os novos fluxos começam como rascunhos em seu espaço de trabalho privado. Você pode criar e testar seu fluxo, adicionando cartões, definindo configurações e iterando conforme necessário. Seu trabalho é salvo automaticamente, mas você pode salvar manualmente marcos importantes. Quando estiver pronto para compartilhar seu fluxo com outras pessoas, você precisará “publicar alterações” para disponibilizá-lo ao público-alvo.

Publicando seu fluxo

Com a revisão de aprovação: quando seu rascunho estiver pronto, você “publica as alterações” para enviá-lo para análise. Seu fluxo passa para o status “Aprovação pendente”, onde os revisores podem avaliá-lo. Se forem solicitadas alterações, você precisará criar um novo rascunho com atualizações e reenviá-lo. Depois de aprovado, seu fluxo se torna “Publicado” e fica disponível para os usuários. Qualquer alteração futura em um fluxo compartilhado exige a republicação e a aprovação novamente.

Sem revisão de aprovação: quando seu rascunho estiver pronto, você “publica as alterações” para compartilhá-lo imediatamente. Seu fluxo se torna “Publicado” e fica disponível para os usuários imediatamente. Você pode continuar fazendo alterações no modo de rascunho e publicar atualizações conforme necessário.

Fazendo alterações nos fluxos compartilhados

Depois de compartilhar um fluxo, todas as alterações feitas exigem passar pelo processo de “publicação de alterações” para disponibilizá-las aos usuários. Isso garante que os usuários sempre tenham acesso a uma versão estável e testada enquanto você continua desenvolvendo melhorias.

O fluxo de trabalho de publicação de alterações

Ao modificar um fluxo compartilhado, você está trabalhando em uma nova versão de rascunho. Os usuários continuarão vendo e usando a versão publicada atual até que você conclua o processo de publicação das alterações. Essa abordagem impede que os usuários vejam alterações incompletas ou não testadas.

Alterações no título e na descrição: as atualizações no título ou na descrição do seu fluxo são consideradas alterações na definição do aplicativo. Eles exigem a publicação de alterações e, se a revisão de aprovação estiver ativada, passar pelo processo de aprovação novamente.

Alterações de conteúdo: modificações em cartões, solicitações ou lógica de fluxo também exigem alterações na publicação. Cada atualização publicada cria uma nova versão que substitui a versão anterior para todos os usuários.

Alterações nas permissões de compartilhamento: adicionar novos usuários ou alterar permissões (como converter espectadores em coproprietários) pode exigir aprovação, dependendo das configurações da sua organização.

Fluxos de cancelamento de publicação

Você pode cancelar a publicação de um fluxo compartilhado para removê-lo da disponibilidade geral e, ao mesmo tempo, mantê-lo acessível aos coproprietários. Quando você cancela a publicação de um fluxo:

  • Os espectadores perdem o acesso: os usuários com permissões de visualizador não podem mais ver ou usar o fluxo

  • Os coproprietários mantêm o acesso: os coproprietários ainda podem acessar e trabalhar com o fluxo não publicado

  • Estado de rascunho: o fluxo retorna ao estado de rascunho para posterior desenvolvimento

  • Nenhuma aprovação é necessária: o cancelamento da publicação não exige a análise de aprovação

Esse recurso é útil quando você precisa fazer alterações significativas em um fluxo amplamente compartilhado ou remover temporariamente o acesso ao resolver problemas.

Dicas para o sucesso

Siga essas melhores práticas para garantir que seus fluxos funcionem de forma confiável e forneçam uma ótima experiência para seus usuários.

Antes de enviar ou publicar

  • ✅ Teste seu fluxo minuciosamente com diferentes cenários e entradas

  • ✅ Verifique se todas as etapas funcionam conforme o esperado

  • ✅ Verifique se as permissões de dados estão configuradas corretamente para os usuários pretendidos

  • ✅ Adicione descrições claras e texto de ajuda para os usuários

  • ✅ Analise qualquer tratamento de erros ou casos extremos

Gerenciando várias versões

  • Acompanhe as alterações que você fez em cada versão

  • Use nomes ou notas descritivas para identificar versões diferentes

  • Não exclua rascunhos importantes até ter certeza de que não precisará deles

Trabalhando com sua equipe

  • Comunique-se com colegas de equipe sobre quem está trabalhando em quê

  • Coordene o tempo para publicar fluxos compartilhados

  • Informe aos usuários quando fluxos importantes estão sendo atualizados

  • Certifique-se de que as permissões de acesso adequadas estejam em vigor antes de compartilhar

Referência da versão

Use essa tabela como uma referência rápida para entender o que você pode fazer com cada tipo de versão e quais são as próximas etapas em seu fluxo de trabalho.

# Tipo de versão Pode editar? Visível para os usuários? Próxima etapa
1 Rascunho ✅ Sim ❌ Não Enviar/publicar
2 Aprovação pendente ❌ Não ❌ Não Aguarde a aprovação
3 Compartilhado ❌ Não ✅ Sim Crie um novo rascunho para alterações