Valores antigos e novos: como um fluxo de trabalho pode aproveitá-los

Valores antigos e novos: como um fluxo de trabalho pode aproveitá-los

Copiar página

Shopify Flow

Os gatilhos atualizados do Flow passam ao fluxo de trabalho o registro tal como ele está no momento. As páginas de ajuda do Shopify explicam isso para cada um deles: apenas os valores atuais estão disponíveis; os valores anteriores à alteração não estão. Para um alerta informando que algo mudou, isso é suficiente.

Muitos fluxos de trabalho exigem mais do que isso. “O preço caiu mais de 10%” requer o preço anterior. “O identificador foi alterado; redirecione a URL antiga” requer o identificador anterior. “O cliente cancelou a assinatura” precisa saber que ele estava inscrito anteriormente. Cada gatilho de alteração deste aplicativo contém ambos os valores; assim, esses fluxos de trabalho consistem em uma condição e uma ação, sem código e sem que nada seja armazenado manualmente.

De onde vem o valor anterior

O aplicativo armazena o último valor conhecido dos campos que monitora, por registro. Quando o Shopify reporta uma atualização, ele compara os valores e, caso um campo monitorado apresente diferença, aciona o gatilho com ambos os valores. Na prática, dois detalhes são importantes:

  • Na primeira vez que o aplicativo detecta um registro, ele apenas o memoriza. Nada é acionado, pois não há nada com que comparar. Quando o senhor ativa um gatilho, o aplicativo lê os registros existentes uma vez em segundo plano, de modo que a primeira alteração real já acione o gatilho. Para pedidos, ele lê os últimos 60 dias por padrão, e o senhor pode ampliar esse intervalo no aplicativo.
  • Os valores correspondem ao momento da alteração. Um fluxo de trabalho acionado por um gatilho Flow lê o registro quando o fluxo de trabalho é executado. Se o registro for alterado novamente um segundo depois, ou for excluído, esse fluxo de trabalho visualizará o estado mais recente ou não conseguirá carregar o registro. Um evento deste aplicativo mantém os valores com os quais foi criado. É possível consultá-los posteriormente no Histórico de Eventos do aplicativo.
Foi criado um evento no Histórico de Eventos, marcado como “Sucesso”, com o preço antigo e o novo
Um evento, exibido no Histórico de Eventos do aplicativo: o preço antes e depois da alteração.

O que só é possível construir com o valor anterior

Fluxo de trabalho Gatilho A condição que requer o valor anterior Pronto para uso
Redirecionar a URL antiga quando um produto ou coleção for renomeado Alteração do identificador do produto, alteração do identificador da coleção nenhum: o redirecionamento ocorre de oldHandle para newHandle Redirecionar URLs antigas de produtos quando o identificador de um produto for alterado, Redirecionar URLs antigas de coleções quando o identificador de uma coleção for alterado
Marque os produtos cujo preço caiu 10% ou mais Alteração no preço da variante do produto priceChange.percentChange menor ou igual a -10 Marque os produtos quando o preço de uma variante cair 10% ou mais
Marque um produto como em promoção e retire a marcação novamente Alteração no preço da variante do produto priceChange.oldCompareAtPrice.amount está vazio e priceChange.newCompareAtPrice.amount não está, ou vice-versa Marque os produtos como em promoção quando for adicionado um preço de comparação, Remova a tag de promoção quando o preço de comparação for removido
Liberar um pedido quando um pagamento pendente for recebido Alteração na situação financeira do pedido oldFinancialStatus igual a pending e newFinancialStatus igual a paid Marcar pedidos quando for recebido um pagamento pendente
Avisem o almoxarifado quando o endereço for alterado após o checkout Alteração do endereço de entrega do pedido nenhuma: a mensagem exibe oldShippingAddress e shippingAddress Marque os pedidos quando o endereço de entrega for alterado após a checkout
Marque os clientes que cancelarem a assinatura e remova a tag quando eles voltarem Alteração no consentimento para o marketing por e-mail dos clientes consentState é igual a unsubscribed; oldConsentState indica qual era o valor anterior Marque os clientes quando eles cancelarem a assinatura do e-mail de marketing
Mantenha o SKU anterior para o seu ERP ou feed Alteração do SKU da variante do produto nenhum: skuChange.oldSku é gravado em um metacampo Salvar o SKU anterior quando o SKU de uma variante for alterado
Reavalie a margem quando um custo aumentar Alteração no custo da variante do produto variantCostChange.percentChange maior que 5 Marque os produtos para uma revisão de margem quando o custo de uma variante aumentar
Tag um produto como “estoque baixo” uma única vez, quando ele atingir o limite Alteração no nível de estoque no local inventoryLevel.oldAvailable é maior ou igual a 5 e inventoryLevel.newAvailable é menor que 5 Marque os produtos como “estoque baixo” quando o estoque ficar abaixo de cinco unidades

Mais três que os lojistas constroem por conta própria:

  • Informe o endereço antigo quando o e-mail de um cliente for alterado. A notificação “E-mail do cliente alterado” contém oldEmail e email. Envie a notificação para oldEmail por meio de uma ação de e-mail que receba uma variável como destinatário, por exemplo, o Workflow Transactional Email. Sem o endereço antigo, não há mais ninguém a quem avisar.
  • Reaja a uma etapa em um status personalizado. Um metacampo loyalty.tier passa de silver para gold: a atualização do metacampo do cliente contém metafield.previousValue e metafield.value, de modo que o fluxo de trabalho possa parabenizar pelo upgrade e não enviar nenhuma notificação em caso de downgrade.
  • Aja em relação a uma tag removida. Após a remoção de uma tag, um registro passa a se parecer com um que nunca a teve. As tags “Ordem”, “Cliente”, “Produto” e “Pedido provisório” indicam as tags removidas. Consulte Executar um fluxo de trabalho quando uma tag específica for adicionada ou removida.

Todos os valores anteriores e posteriores, por gatilho

Pedidos

Gatilho Antes e depois
Etiquetas de pedido adicionadas, etiquetas de pedido removidas addedTags, removedTags, previousTags, currentTags
Nota do pedido alterada oldNote, newNote
Alteração na situação financeira do pedido oldFinancialStatus, newFinancialStatus
Alteração no processamento do pedido oldFulfillmentStatus, newFulfillmentStatus e, por linha ou remessa, em changes.items: processado, não processado, rastreamento atualizado com número, URL e empresa
O status de exibição do pedido foi alterado oldDisplayFulfillmentStatus, newDisplayFulfillmentStatus
Atributos do pedido alterados changes.items, com changeType, key, oldValue e newValue
Itens de linha do pedido alterados changes.items, com changeType (adicionado, removido, alteração na quantidade, no preço ou na variante) e a quantidade, o preço e a variante antigos e novos
Alteração do endereço de entrega do pedido shippingAddress e oldShippingAddress, cada um deles também como campos separados
Atualização de metacampo de pedido metafield.value, metafield.previousValue
Atualização do pedido changes.fields e changes.items com field, oldValue e newValue para status financeiro, status de processamento, tags, notas, itens de linha e atributos personalizados

Clientes

Gatilho Antes e depois
Tags de clientes adicionadas, tags de clientes removidas addedTags, removedTags, previousTags, currentTags
Nota do cliente alterada oldNote, newNote
Alteração no status do cliente oldState, newState
Nome do cliente alterado firstName, lastName, oldFirstName, oldLastName
E-mail do cliente alterado email, oldEmail
Alteração do número de telefone do cliente phone, oldPhone
Alteração do endereço do cliente address e oldAddress, cada um deles também como campos separados
Alteração do consentimento para marketing por e-mail dos clientes; Alteração do consentimento para marketing por SMS dos clientes consentState, optInLevel, oldConsentState, oldOptInLevel
Atualização do metacampo do cliente metafield.value, metafield.previousValue
Atualização para o cliente changes.fields e changes.items para tags, notas e estado

Produtos e variantes

Gatilho Antes e depois
Tags de produto adicionadas, Tags de produto removidas addedTags, removedTags, previousTags, currentTags
Título do produto, identificador, descrição, status, fornecedor e tipo foram alterados o valor antigo e o novo, por exemplo, oldTitle e newTitle
Produto publicado no canal, produto retirado do canal channels.added, channels.removed, channels.current
Alteração no preço da variante do produto priceChange.oldPrice, newPrice, oldCompareAtPrice, newCompareAtPrice, delta, percentChange, direction
Alteração no preço unitário da variante do produto unitPriceChange.oldUnitPrice, newUnitPrice, delta, percentChange, direction
Alteração no custo da variante do produto variantCostChange.oldCost, newCost, delta, percentChange, direction
Alteração do SKU da variante do produto skuChange.oldSku, newSku
O código de barras da variante do produto foi alterado barcodeChange.oldBarcode, newBarcode, as listas de códigos de barras antigos e novos, added, removed
Atualização do metacampo do produto, atualização do metacampo da variante do produto metafield.value, metafield.previousValue
Atualização do produto changes.fields e changes.items para título, identificador, descrição, status, fornecedor, tipo de produto e tags; e, por variante, para preço, preço de comparação, SKU, código de barras, política de estoque, tributável, título, opções e imagem

Estoque, coleções, locais e muito mais

Gatilho Antes e depois
Alteração no nível de estoque, falta de estoque e reposição de estoque no local inventoryLevel.oldAvailable``newAvailable``delta``percentChange``direction, juntamente com o local
Título, identificador e descrição da coleção foram alterados o valor antigo e o novo
Atualização de local, Atualização da empresa, Atualização da localização da empresa, Atualização de desconto, Atualização do blog, Atualização de postagem no blog, Atualização da página changes.fields e changes.items no registro, sempre
Atualização da coleção, atualização do pedido provisório, atualização do mercado a mesma lista changes, quando a opção Enviar valores antigos e novos estiver ativada
Os dez fatores que desencadeiam os pedidos provisórios o mesmo padrão dos pedidos: tags, notas, atributos, itens de linha, status, e-mail e endereços
Atualização de metacampos para 15 tipos de registros metafield.value, metafield.previousValue

Referência completa sobre gatilhos lista todos os gatilhos com todos os seus campos.

Os números já vêm com os cálculos feitos

As condições do Shopify Flow comparam valores, não realizam cálculos, e os valores monetários chegam ao Shopify Flow na forma de texto. Portanto, a expressão “caiu mais de 10%” não pode ser calculada dentro de um fluxo de trabalho a partir de dois preços. Os gatilhos de preço, preço unitário, custo e estoque, portanto, enviam o resultado na forma de números:

Campo Significado Exemplo
delta novo valor menos valor anterior -5
percentChange a variação, expressa em porcentagem do valor anterior -12.5 significa uma queda de 12,5 por cento
direction increase, decrease ou unchanged decrease
Seletor de variáveis do Shopify Flow para “Alteração de preço de variante do produto”, com os parâmetros oldPrice, newPrice, delta, percentChange e direction
As variáveis “Preço da variante do produto alterado” no seletor do Shopify Flow.
Uma condição do Shopify Flow: priceChange.percentChange é menor que -10
Uma condição relativa à porcentagem calculada pelo aplicativo. Não é necessária nenhuma etapa de programação.
O Shopify Flow fornece o valor anterior de um campo?

Não com seus próprios gatilhos atualizados. As páginas de ajuda do Shopify para os gatilhos “Produto atualizado”, “Pedido atualizado”, “Cliente atualizado” e outros gatilhos de atualização indicam que apenas os valores atuais estão disponíveis no fluxo de trabalho. Os gatilhos deste aplicativo enviam o valor anterior e o posterior.

Posso calcular o valor anterior no Shopify Flow?

Somente se o senhor mesmo tiver armazenado essa informação antes da alteração, por exemplo, copiando um valor para um metacampo por meio de outro fluxo de trabalho e recuperando-o posteriormente. Essa cópia precisa existir antes da primeira alteração e ser mantida em sincronia para cada registro. O aplicativo realiza esse controle para os campos que monitora.

O valor anterior está disponível para os metacampos?

Sim. Cada gatilho de metacampo deste aplicativo inclui metafield.previousValue junto com metafield.value, para 15 tipos de registros. Consulte Alterações nos metacampos no Shopify Flow: os gatilhos atualizados e os gatilhos de metacampos.

Por que não ocorreu nenhuma ação na primeira troca de disco?

O aplicativo precisa de um ponto de partida. Quando um gatilho é ativado, ele lê seus registros existentes uma vez em segundo plano. Uma alteração feita antes que essa leitura chegasse ao registro é apenas registrada. A próxima alteração é acionada. Histórico de eventos e solução de problemas mostra o estado dessa sincronização.

Próximos passos