Testar um fluxo de trabalho no Shopify Flow

É possível testar um fluxo de trabalho antes de ativá-lo. Isso permite verificar a lógica e confirmar se as variáveis e os parâmetros estão corretos antes da ativação do fluxo de trabalho para operação autônoma. O teste não realiza ações como enviar notificações, atualizar pedidos ou produtos, nem faz alterações nos dados da loja ativa. Vale destacar que o teste de um fluxo de trabalho pode ser feito a qualquer momento no Shopify Flow.

Cada teste começa com os dados do evento do acionador. Há três maneiras de obter esses dados no Shopify Flow, dependendo de você querer usar dados reais ou simulados da loja:

• Gravação de eventos: essa opção ativa um modo de teste que monitora eventos em tempo real que ocorrem naturalmente na loja e que causariam o disparo do fluxo de trabalho. Nesse modo, também é possível abrir uma nova aba do navegador para realizar manualmente uma ação real que geraria um evento de teste com dados reais, como criar um pedido de verdade para testar o acionador Pedido criado.
• Criação de eventos: essa opção permite criar manualmente eventos simulados com dados reais da loja que causariam o disparo do fluxo de trabalho sem, de fato, fazer alterações. Por exemplo, é possível selecionar um pedido existente no admin da Shopify e usar os dados reais dele como o evento de teste para um acionador Pedido criado, mesmo que ele já tenha sido criado.
• Geração de eventos: semelhante à criação manual de um evento de teste, essa opção faz com que o Sidekick gere eventos de teste simulados para você. Por exemplo, o Sidekick pode gerar dois eventos de teste (uma condição atendida e uma não atendida) para testar um fluxo de trabalho Pedido criado usando os dados de pedidos existentes na loja. Depois, é possível usar, editar ou remover esses eventos de teste com base nas suas preferências.

Considerações sobre o teste de um workflow no Shopify Flow

Antes de testar um workflow, analise as seguintes considerações:

• Os workflows no modo de teste usam os dados reais da loja para retornar variáveis do Liquid e determinar a lógica do workflow, mas não executam ações nem fazem modificações na loja. Uma execução de teste é interrompida na primeira ação que tenta fazer uma alteração na lógica do workflow para evitar alterações indesejadas.
• É possível testar o fluxo de trabalho em qualquer estágio da criação. O fluxo não precisa estar concluído para o teste da versão atual, mas todas as etapas precisam ser válidas. Não é possível usar em um teste as etapas incompletas ou mal configuradas.
• A lista Execuções recentes do fluxo de trabalho não inclui as execuções de teste.
• As ações em um workflow que se conectam a serviços externos, como Enviar solicitação HTTP, exibem pré-visualizações da configuração durante um teste, mas mostram a mensagem Não é possível simular esta ação como o valor de dados retornado, em vez de dados reais.

Usar eventos reais gravados para testar um fluxo de trabalho no Shopify Flow

Ao gravar eventos, o fluxo de trabalho usa dados reais da loja baseados no acionador definido por você para produzir uma lista de eventos de teste. Dependendo do evento do acionador, talvez seja necessário realizar a ação manualmente para gerar um evento de teste. Por exemplo, se você estiver testando o evento Coleção criada, será preciso criar manualmente uma coleção no admin da Shopify para que o fluxo de trabalho grave o evento para teste.

Etapas:

1. No admin da Shopify, acesse Apps > Flow.

2. Na seção Workflows, clique no workflow que você quer testar.

3. Clique em Editar para abrir o editor de workflow.

4. No acionador do fluxo de trabalho, clique em Testar o fluxo de trabalho.

5. Na caixa de diálogo Testar o fluxo de trabalho, clique em + Adicionar evento > Gravar eventos para ativar o modo de teste do fluxo de trabalho.

6. Opcional: se nenhum evento de teste estiver sendo gerado naturalmente, abra uma nova aba do navegador e crie manualmente um evento que faça com que o acionador inicie o workflow de teste.

7. Na caixa de diálogo do evento de teste, todos os eventos de teste acionados aparecem na lista Gravação de eventos. Selecione o evento de teste que você quer executar para testar o fluxo de trabalho.

8. O fluxo de trabalho destaca condições e ações específicas para exibir visualmente o caminho lógico usado, com base no evento do acionador selecionado. É possível realizar qualquer uma destas ações:

   • Para pré-visualizar a saída aplicável com base nos dados do evento de teste, clique em uma etapa de condição ou ação no fluxo de trabalho e, depois, na aba Pré-visualização. Isso pode ser útil para confirmar se as variáveis mostram os dados corretos.
   • Para escolher um evento de teste diferente, selecione um novo evento na lista Gravação de eventos.
   • Para atualizar os resultados do teste do fluxo de trabalho, clique em Reiniciar teste no acionador do fluxo de trabalho.
   • Para salvar o evento de teste, clique em e depois em Salvar. Após o salvamento, é possível modificar os dados do teste conforme necessário.

9. Opcional: clique em Parar gravação para sair do modo de detecção. Para voltar a detectar eventos de teste em tempo real, clique em Iniciar gravação.

Criar eventos simulados para testar um fluxo de trabalho no Shopify Flow

Ao criar eventos simulados manualmente ou com o Sidekick, você fornece dados de evento baseados no acionador definido para gerar uma lista de eventos de teste. Esses eventos simulados usam dados reais da loja, como informações de produtos e coleções existentes, mas não fazem alterações de fato. Assim, é possível usar o evento simulado para executar o teste do fluxo de trabalho.

Os dados selecionados durante a criação de eventos dependem do tipo de acionador que inicia o fluxo de trabalho. Por exemplo, em um fluxo de trabalho que começa com o acionador Pedido criado, basta selecionar um pedido existente para uso como evento de teste. No entanto, o acionador Permissão atribuída a contato da empresa exige a seleção de um local da empresa, de um contato dessa empresa e de um nível de permissão para a criação do evento de teste.

Se você não quiser selecionar os dados para a criação de um evento de teste por conta própria, o Sidekick poderá gerar um conjunto desses eventos.

Etapas:

Editar eventos de teste salvos no Shopify Flow

A qualquer momento, é possível editar o conteúdo dos eventos de teste salvos para o fluxo de trabalho. Também é possível remover totalmente qualquer evento salvo.

Etapas:

1. No admin da Shopify, acesse Apps > Flow.

2. Na seção Workflows, clique no workflow que você quer testar.

3. Clique em Editar para abrir o editor de workflow.

4. No acionador do fluxo de trabalho, clique em Testar o fluxo de trabalho.

5. Na lista Evento salvo, passe o cursor do mouse sobre o evento de teste que quer editar e clique em … > Editar.

6. Atualize o conteúdo dos campos no evento de teste. Talvez seja necessário clicar no X para remover os dados antes da seleção de novos.

7. Clique em Salvar.

8. Opcional: para excluir o evento de teste salvo, passe o cursor do mouse sobre ele e clique em … > Remover.

Analisar o teste do workflow

Ao testar um workflow no Shopify Flow, analise as seguintes informações para garantir que ele se comporte conforme o esperado com base no evento do acionador de teste:

• A lógica geral do workflow está funcionando como esperado? Por exemplo, se a condição de um evento de teste for verdadeira, o workflow segue o caminho lógico para a condição que foi atendida?
• O workflow está usando as variáveis corretas em todas as condições e ações? Por exemplo, talvez você tenha solicitado que o workflow verificasse a variável fulfillments_item.totalQuantity, que retorna a soma de todas as quantidades de itens de linha de um processamento de pedido, em vez da variável order.fulfillmentsCount.count, que retorna a contagem de processamentos de pedido no pedido.
• O workflow está usando os operadores corretos em todas as condições e variáveis?
  • Confirme a lógica AND/OR. Por exemplo, para uma condição com vários elementos, a condição está verificando se ambos os elementos são verdadeiros (A AND B), ou apenas um (A OR B)?
  • Confirme a lógica Nenhum de/Pelo menos um de/Todos de, quando aplicável.
  • Confirme se os operadores da variável estão corretos, como a lógica Igual a, Diferente de, Não existe, Existe, Maior que, Menor que e É pelo menos um de, quando aplicável.
• As condições e ações do workflow estão acontecendo na sequência correta? Por exemplo, o workflow pode estar configurado para verificar várias condições diferentes ao mesmo tempo, em vez de verificar uma condição antes de passar para a próxima com base no resultado.

Se um workflow de teste se comportar de forma inesperada, analise as informações sobre solução de erros em workflows do Shopify Flow.