Versionamento de fluxos

Introdução

O versionamento de fluxos é algo essencial para que todo o time envolvido com o Workspace Floui possa contribuir para a melhoria dos processos realizados pelo fluxo, além de possibilitar o retorno para versões anteriores em situações necessárias.

Neste artigo será detalhado a geração e controle de versionamentos básicos e snapshots de fluxos, como restaurar versões anteriores e boas práticas para o versionamento de seu fluxo.

Crie versionamentos básicos do seu fluxo

Versionamentos básicos são versões geradas a partir do momento que o usuário salva o fluxo, intencionados para alterações menores.

Para gerar versionamento básicos de um fluxo, acesse a tela de edição de seu fluxo e clique em Salvar. Ao haver sucesso na edição ou criação do fluxo, será criada uma versão para este fluxo.

Cada versão criada possui um número incremental para identificação. Este valor sempre será incrementado mesmo que alguma versão seja removida, melhorando a identificação caso alguma versão tenha sido removida por algum dos usuários da conta.

O versionamento básico possui limite de 100 versões geradas. Ao gerar novas versões básicas em um fluxo com 100 versões básicas, as versões mais antigas serão removidas e a versão nova será gerada.

Crie snapshots do seu fluxo e obtenha mais controle sobre as versões

Snapshots são versionamentos nomeados, intencionados para que sejam usados em modificações significativas do fluxo.

Para criar um Snapshot, acesse a edição de um fluxo e clique no botão Snapshot, ao lado do botão Salvar. Na janela exibida, insira um nome para o Snapshot e clique em Criar. Ao haver sucesso no salvamento do fluxo, o Snapshot será gerado com sucesso.

Assim como os versionamentos básicos, os Snapshots terão um número incremental gerado.

A criação de snapshots para um determinado fluxo é ilimitada, diferente do versionamento básico.

O que é salvo no versionamento

Ao gerar uma nova Versão básica ou Snapshot serão salvadas as seguintes informações do fluxo:

• Nome do fluxo;

• Status (inativo/ativo);

• Conectores, seus vínculos e parametrizações;

• Abas do fluxo;

• Grupo atual;

• Notas;

• Variáveis locais do fluxo;

• Limite de execuções simultâneas do fluxo;

• Thumbnail (Imagem em miniatura usado na listagem de fluxos);

• Data de modificação;

Visualize o histórico de versões

Em um fluxo com snapshots ou versões básicas criadas é possível visualizar todas as versões criadas até o momento. Para acessar o histórico de versões clique na seção inferior do editor de fluxo.

Será exibido uma listagem com todas as versões e snapshots criadas para aquele fluxo, em ordenação mais recente para mais antiga, o identificador incremental da versão, seu nome (em caso de snapshot), data de criação e opções. Também será exibido um indicador de qual versão está ativa naquele momento.

Para identificar o usuário que gerou ou modificou aquela versão, mova o cursor do mouse acima da data de atualização da versão. Assim irá exibir o nome e e-mail do usuário autor daquela versão, visando o rastreamento de ações realizadas.

Iconografia:

: Ícone usado para Snapshots do fluxo;

: Ícone usado para versionamentos básicos do fluxo;

Pela tela de histórico de versões é possível realizar modificações em Snapshots, como:

• Modificar o nome do snapshot;

• Remover o snapshot;

Restaure para versões antigas de seu fluxo

A restauração de fluxos possibilita que usuários possam retornar para versões anteriores do seu fluxo, visando a necessidade de retornar para versões mais estáveis do processo executado pelo fluxo ou para reverter cenários inesperados.

Para realizar a restauração de um fluxo, acesse o Histórico de versões. Em seguida, escolha entre Snapshots ou versões básicas e clique em Opções, após isso clique em Restaurar. Visualize o alerta e confirme a restauração para iniciar o processo de restauração do fluxo.

Antes de iniciar a restauração é relevante analisar os dados gerais do fluxo e conectores. Caso algum recurso não esteja mais disponível, por ter sido removido do Workspace Floui, por exemplo, este recurso não será retornado junto à restauração.

Exemplo: Retornar para uma versão onde um recurso atribuído em um conector (Database, Forms, Conta de Serviço, etc.) não exista mais. Neste caso o conector será sinalizado em vermelho, informando que o recurso, previamente atribuído em uma versão antiga, não existe mais.

Ao confirmar a restauração o fluxo selecionado será restaurado e alterado como fluxo principal.

Casos onde o fluxo não poderá ser restaurado

Visando a segurança do usuário e saúde das operações realizadas pelo Workspace, durante o processo de restauração, em determinados casos, a restauração pode não estar disponível. Estes casos são:

• Restaurar para versões onde há conectores depreciados;

• Restaurar para versões onde a contagem de conectores exceda o limite da conta;

Adicionalmente, o fluxo não poderá ser restaurado para versões anteriores à implementação da funcionalidade de versionamento de fluxos.

Execução de fluxo durante a restauração

A restauração de versões de fluxos pode ser realizada a qualquer momento, porém, é importante que todos os processos agendados e em andamento sejam abortados antes de iniciar a restauração. Assim evitando casos inesperados.

Em fluxos que possuam trigger do tipo CRON é importante notar que, após o agendamento ser realizado para a versão atual, ao restaurar o fluxo para uma versão anterior, o processo agendado de CRON ainda irá executar o fluxo com base no fluxo no momento em que foi agendado, ou seja, irá executar o fluxo em seu estado antes da restauração. Logo é relevante analisar possíveis agendamentos ao iniciar a restauração.

Boas práticas para o gerenciamento de versões do seu fluxo

Para manter um ambiente de trabalho saudável e de fácil entendimento para outros usuários do Workspace Floui, é recomendado que sejam seguidas boas práticas na geração e controle de versionamento.

Boas práticas gerais a serem seguidas:

• Nomeie suas snapshots para que fique claro o seu estado atual;

• Crie snapshots ao realizar modificações significantes de seu fluxo;

• Verifique possíveis impactos que serão gerados ao restaurar para versões antigas do fluxo;

• Encerre processos em andamento antes de iniciar a restauração;

A organização também poderá criar boas práticas que se adequem ao seu fluxo de trabalho e a necessidade.