Para cada item (iterar)

A ação Para cada item (iteração) executa etapas em todos os itens de uma lista quando está conectada à opção Repetir para cada item. Essa ação funciona apenas em listas, como itens de linha em um pedido ou listas retornadas por ações do tipo Obter dados, como Obter dados da coleção, Obter dados do cliente ou Obter dados do produto.

Depois de adicionar a ação Para cada item (iteração), é preciso configurar etapas adicionais para a iteração do loop em cada item da lista fornecida. Diferentemente da ramificação Verdadeiro/Falso das condições, a ação Para cada item (iteração) tem uma ordem de operações definida para suas ramificações:

1. A ramificação Repetir para cada item ocorre primeiro e repete as etapas a serem executadas em cada entrada da lista. As ações nessa ramificação ocorrem tantas vezes quanto o número de itens na lista fornecida.
2. A ramificação Após o último item ocorre por último e permite definir etapas para continuar o workflow. Essa etapa é realizada depois que todas as ações executadas por Repetir para cada item para cada item da lista são concluídas.

Por exemplo, você cria um workflow executado toda segunda-feira. O workflow usa a ação Obter dados do pedido para recuperar os pedidos feitos durante a semana. Em seguida, a ação Para cada item (iteração) aplica uma tag Novo pedido a cada pedido retornado pela lista getOrderData. Depois que todos os pedidos da lista recebem a tag, um e-mail interno é enviado para indicar que a marcação com tags foi concluída.

Considerações sobre o uso da ação Para cada item (iteração)

Analise as considerações a seguir antes de usar a ação Para cada item (iteração):

• A lista usada na ação Para cada item (iteração) não pode ter mais de 1.000 itens. Se a lista selecionada tiver mais de 1.000 itens, o workflow falhará, e nenhuma ação após a ação Para cada item (iteração) será executada.
• As ações a seguir não podem vir depois de Repetir para cada item:
  • A ação Aguardar.
  • Qualquer ação Obter dados, como Obter dados do pedido.
  • A ação Executar código.
• É possível aninhar apenas uma ação Para cada item (iteração) dentro de outra ação Para cada item (iteração).

Campos

A ação Para cada item (iteração) contém os seguintes campos.

Acionadores

A ação Para cada item (iteração) pode ser usada em qualquer workflow.

Monitoramento de workflows

Depois que um workflow é executado, você pode analisar o desempenho dele na página Atividade do Shopify Flow. O seguinte se aplica a workflows que contêm a ação Para cada item (iterar):

• As seções Status e Ação se aplicam a todas as ações executadas pela ação Para cada item (iterar).
• A pré-visualização do workflow destaca quantos itens no loop seguiram um caminho específico.
• A seção Detalhes da execução, incluindo a pré-visualização do workflow, exibe os resultados de cada iteração do loop. Use o menu Item nos detalhes da etapa da execução para filtrar os resultados por ações realizadas e erros a fim de solucionar problemas em loops rapidamente.

Modelos

Adicionar itens de linha a linhas do Planilhas Google quando um novo pedido é feito

Quando um novo pedido é criado, uma etapa Para cada item (iterar) em um workflow percorre cada item de linha para adicionar os dados do produto a uma linha do Planilhas Google. Ver modelo.

Adicionar produtos com uma tag a uma coleção no futuro

Em um momento futuro, busque todos os produtos com uma determinada tag e, em seguida, adicione-os a uma coleção. Ver modelo.

Permitir pedidos para empresas criadas por solicitações de conta da empresa

Atribui uma permissão de pedido quando uma empresa é criada por uma solicitação de conta da empresa. Ver modelo.

Cancelar pedidos se o cliente fez mais de 5 pedidos hoje

Cancela pedidos se um cliente faz mais de cinco pedidos em um único dia. Ele verifica o número de pedidos feitos por um cliente nas últimas 24 horas e cancela os que excedem esse limite, marcando o cliente com uma tag por possível fraude. Ver modelo.

Converter um metacampo de cliente em tags para todos os clientes

Este workflow completa as tags de todos os clientes com base no valor de um metacampo. Ele é executado a cada hora e busca até 100 clientes que não têm a tag processed. Para cada cliente, ele analisa o valor de um metacampo custom.test e o adiciona como uma tag. O workflow também adiciona uma tag processed para que o cliente não seja retornado na próxima execução agendada. Para usar o workflow, é preciso alterar o namespace e a chave do metacampo para corresponder a um metacampo da loja. Ver modelo.

Excluir clientes inativos

Exclui perfis de clientes com mais de cinco anos de idade que nunca fizeram um pedido. Ver modelo.

Excluir produtos inativos

Exclui produtos sem estoque que não são atualizados há um ano. Ver modelo.

Processar itens digitais de um pedido

Processa todos os itens que não exigem entrega física, como itens digitais, ou que correspondem a uma lista de SKUs. É executado uma vez para cada local de processamento (o "pedido em processamento") de um novo pedido. Ver modelo.

Suspender o processamento de pedidos se um cliente fizer vários pedidos em 24 horas

Verifica se um cliente fez vários pedidos em um período de 24 horas. Em caso afirmativo, suspende os processamentos de pedidos e consolida o frete. Ver modelo.

Suspender pedidos se o cliente fez mais de um pedido nas últimas 24 horas

Quando um pedido é criado, verifica se o cliente fez outros pedidos nas últimas 24 horas. Em caso afirmativo, coloca todos os pedidos em suspensão. Ver modelo.

Publicar produtos com uma determinada tag no futuro

Em uma data futura, busca produtos com uma determinada tag e os publica. Este workflow usa o acionador Horário agendado e a ação Obter dados do produto. Ver modelo.

Liberar suspensão de processamento de pedido em itens de troca quando a devolução é encerrada

Quando uma devolução é encerrada, o sistema verifica se há um saldo devedor no pedido. Se não houver saldo no pedido, ele libera os itens de troca. Ver modelo

Remover tag de produto novo 90 dias após a criação do produto

Todos os dias, o workflow busca até 100 produtos que foram criados há mais de 90 dias e que ainda têm a tag new. Em seguida, ele remove essas tags de cada produto. Ver modelo.

Agendar a remoção de produtos da Loja virtual na data e hora especificadas

Em uma única data no futuro, remove produtos da loja virtual por tag, ID ou SKU. Usa o acionador Horário agendado e a ação Obter dados do produto. Ver modelo.

Enviar fatura de pedido B2B para vários endereços de e-mail

Envia faturas de pedidos B2B para vários endereços de e-mail. Para isso, são usados os endereços de e-mail salvos como metacampos em um local da empresa, quando existentes, ou, caso não existam, primeiro são criados três metacampos: extra_invoice_recipient.email1, .email2 e .email3. Ver modelo.

Enviar pedido e itens de linha para o Planilhas Google

Exporta cada item de linha do pedido para uma linha no Planilhas Google. Ver modelo.

Marcar com tag e enviar um resumo diário de processamentos de pedidos atrasados

Todos os dias, marca com tag e envia um resumo diário por e-mail que contabiliza o número total e o valor em dólar de todos os pedidos que não cumprem a garantia de frete de dois dias. Ver modelo.

Marcar com tag clientes que têm um estorno

A cada hora, este workflow busca pedidos com estornos e adiciona uma tag ao cliente do pedido. Usa o acionador Horário agendado e a ação Obter dados do pedido. Ver modelo.

Marcar pedidos com a tag da campanha UTM associada

Adiciona tags a pedidos que contêm os nomes de campanhas UTM associadas. Ver modelo.

Marcar com tag pedidos não processados com mais de 2 dias

Todos os dias, o workflow busca todos os pedidos não processados com mais de dois dias e adiciona uma tag ao pedido. Ver modelo.

Rastrear variantes de produto em promoção usando um metacampo de produto

Define um metacampo em um produto se pelo menos uma das variantes dele estiver em promoção. Isso pode ser útil para rastrear quais produtos estão em promoção no momento. Ver modelo.