Agendamentos, coleta de dados e loop
Para criar um fluxo de trabalho, na maioria das vezes é possível vincular várias condições e ações a um acionador que é executado quando um evento acontece. Em alguns casos de uso, você pode descobrir que não existe nenhum acionador para o que precisa fazer ou que ele precisa ser executado em um determinado horário ou que talvez seja necessário trabalhar com uma lista de dados.
Por exemplo, vamos supor que você queira receber um resumo diário de pedidos não processados. Com esse grupo de recursos, é possível executar um fluxo de trabalho todos os dias em um determinado horário para coletar os pedidos e, em seguida, enviar um resumo deles a você.
Neste documento, você aprenderá sobre o acionador "Scheduled time" ("Horário agendado") e as ações "Get data ("Coletar dados") e "For each" ("Para cada"). Caso você não saiba qual é a melhor maneira de usar esses recursos, consulte outros exemplos e modelos que usam esses acionadores e ações ou veja este vídeo explicativo.
Nesta página
Acionador "Scheduled time" ("Horário agendado")
Em vez de usar um evento como ponto de partida, o acionador Scheduled time ("Horário agendado"), inicia um fluxo de trabalho no horário e na data especificados por você. Outra possibilidade é agendar que o fluxo de trabalho se repita de hora em hora, diariamente, semanalmente ou mensalmente.Como resultado da execução de um agendamento, é preciso usar uma ação para coletar os dados que serão usados, como clientes, pedidos ou produtos. Para fazer isso, use ações Get data ("Coletar dados").
Ações "Get data" ("Coletar dados")
A maioria das ações altera algo na loja (por exemplo, adiciona tags a um cliente) ou envia um comando a um app (como dá instruções a um app para enviar uma notificação push a um cliente).
As ações "Get data" ("Coletar dados") buscam informações da loja para usar no Flow. Essas ações chamam uma consulta com um conjunto de filtros, por exemplo, para só coletar algo atualizado no último dia. A ação retorna uma lista de itens que correspondem a esses dados. Por exemplo, a ação Get order data ("Coletar dados de pedido") chama a consulta de pedido na API Admin e retorna uma lista de pedidos que correspondem à consulta.
As ações abaixo recuperam informações da loja para que você use esses dados no fluxo de trabalho. Consulte cada ação para saber como filtrar os dados e quais informações são retornadas:
- Coletar dados de coleção
- Coletar dados de cliente
- Coletar dados de rascunho de pedido
- Coletar dados de processamento de pedidos
- Coletar dados de pedido
- Coletar dados de produto
- Coletar dados da variante de produto
- Get subscription contract data ("Coletar dados do contrato de assinatura")
Tags do Liquid
Quando você usa uma ação Get data ("Coletar dados"), é possível empregar as tags date_minus e date_plus do Liquid para alterar datas na consulta. Por exemplo, para calcular uma data de cinco dias antes do horário de execução agendado para um fluxo de trabalho, use este código Liquid:
{{ scheduledAt | date_minus: "5 days" }}Para saber mais sobre como usar as tags, consulte a documentação sobre variáveis do Liquid.
Loops
Quando você usa uma ação Get data ("Coletar dados"), você recebe uma lista das informações que correspondem à consulta. Use a ação For each ("Para cada") para colocar essa lista em loop. Nessa situação, é possível usar condições e ações que serão aplicadas apenas ao item específico.
Por exemplo, você pode criar um fluxo de trabalho que inclua a ação Get order data ("Coletar dados de pedido"). Em seguida, use a ação For each ("Para cada") para adicionar uma tag a cada pedido.
Ações "Aggregation" ("Agregação")
Durante o trabalho com listas, talvez você queira contar o número de itens a usar em condições e ações posteriores. Por exemplo, pode ser interessante verificar se há mais de 0 resultados antes de enviar um e-mail. O Flow disponibiliza essas ações para executar cálculos nos dados da lista em um fluxo de trabalho:
- Count ("Contar"): extrai o número de entradas em uma lista
- Sum ("Somar"): soma os valores das entradas em uma lista
Limitações conhecidas
- As ações "Get data" ("Coletar dados") e "For each" ("Para cada") só podem ser executadas em listas com até 100 itens.
- O acionador Hora agendada pode ser executado com frequência a cada 10 minutos.
- Para cada loop, só é possível haver uma ação por iteração de loop.