Valores antigos e novos: o que um fluxo de trabalho pode fazer com eles

Valores antigos e novos: o que um fluxo de trabalho pode fazer com eles

Copiar página

Shopify Flow

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

Muitos fluxos de trabalho requerem mais do que isso. «O preço baixou mais de 10 por cento» requer o preço anterior. «O identificador mudou, redirecione o URL anterior» requer o identificador anterior. «O cliente cancelou a subscrição» precisa de saber que estava subscrito anteriormente. Cada gatilho de alteração desta aplicação inclui ambos os valores, pelo que estes fluxos de trabalho constituem uma condição e uma ação, sem código e sem que seja necessário armazenar nada manualmente.

De onde provém o valor anterior

A aplicação memoriza o último valor conhecido dos campos que monitoriza, por registo. Quando o Shopify comunica uma atualização, a aplicação compara os valores e, caso um campo monitorizado apresente uma diferença, aciona o gatilho com ambos os valores. Na prática, há dois pormenores importantes:

  • A primeira vez que a aplicação deteta um registo, limita-se a memorizá-lo. Não é acionado nenhum evento, porque não há nada com que comparar. Quando ativa um gatilho, a aplicação lê os seus registos existentes uma vez em segundo plano, de modo a que a primeira alteração efetiva já acione o evento. No caso dos pedidos, por predefinição, a aplicação analisa os últimos 60 dias, podendo alargar esse intervalo na própria aplicação.
  • Os valores referem-se ao momento da alteração. Um fluxo de trabalho associado a um gatilho «Atualização do Flow» lê o registo quando o fluxo de trabalho é executado. Se o registo for alterado novamente um segundo depois, ou for eliminado, esse fluxo de trabalho visualiza o estado mais recente ou não consegue carregar o registo. Um evento desta aplicação mantém os valores com que foi criado. Pode consultá-los posteriormente no Histórico de Eventos da aplicação.
Foi criado um evento no Histórico de Eventos, marcado como «Sucesso», com o preço antigo e o novo
Um evento, apresentado no Histórico de Eventos da aplicação: o preço antes e depois da alteração.

O que só pode ser construído com o valor anterior

Fluxo de trabalho Gatilho A condição que requer o valor anterior Pronto a utilizar
Redirigir o URL antigo quando um produto ou uma coleção for renomeado(a) Alteração do identificador do produto, alteração do identificador da coleção nenhum: o redirecionamento é feito de oldHandle para newHandle Redirigir os URLs antigos dos produtos quando o identificador de um produto for alterado, Redirigir os URLs antigos das coleções quando o identificador de uma coleção for alterado
Marque os produtos cujo preço baixou 10 por cento ou mais Alteração do preço de uma variante do produto priceChange.percentChange inferior ou igual a -10 Marque os produtos quando o preço de uma variante baixar 10 por cento ou mais
Marque um produto como estando em promoção e retire essa marcação Alteração do preço de uma variante do produto priceChange.oldCompareAtPrice.amount está vazio e priceChange.newCompareAtPrice.amount não está, ou o contrário Marque os produtos como estando em promoção quando for adicionado um preço de comparação, Retire a tag de promoção quando o preço de comparação for removido
Liberar um pedido quando for recebido um pagamento pendente Alteração do estado financeiro do pedido oldFinancialStatus igual a pending e newFinancialStatus igual a paid Assinalar os pedidos quando for recebido um pagamento pendente
Avisar o armazém quando a morada for alterada após o checkout Alteração da morada de entrega do pedido nenhuma: a mensagem apresenta oldShippingAddress e shippingAddress Assinalar os pedidos quando a morada de entrega for alterada após o checkout
Marque os clientes que cancelarem a subscrição e retire a marcação quando regressarem Alteração do consentimento do cliente para o marketing por e-mail consentState é igual a unsubscribed; oldConsentState indica qual era o valor anterior Assigne uma etiqueta aos clientes quando estes cancelarem a subscrição do e-mail de marketing
Mantenha o SKU anterior para o seu ERP ou feed Alteração do SKU da variante do produto nenhum: o skuChange.oldSku é gravado num metacampo Guardar o SKU anterior quando um SKU de variante for alterado
Reavaliar a margem quando um custo aumentar Alteração do custo da variante do produto variantCostChange.percentChange superior a 5 Marque os produtos para uma revisão da margem sempre que o custo de uma variante aumentar
Tag um produto como «stock baixo» uma única vez, quando este atingir o limite Alteração do 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 descer para menos de cinco unidades

Mais três que os lojistas constroem eles próprios:

  • Indique 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 através de uma ação de e-mail que aceite 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 enviar o aviso.
  • Reaja a uma etapa num estado personalizado. Um metacampo loyalty.tier passa de silver para gold: a atualização do metacampo do cliente inclui metafield.previousValue e metafield.value, pelo que o fluxo de trabalho pode felicitar o cliente pela subida de nível e não emitir qualquer mensagem em caso de descida de nível.
  • Aja em relação a uma etiqueta removida. Após a remoção de uma etiqueta, um registo fica com o aspeto de um registo que nunca a teve. As etiquetas «Pedido», «Cliente», «Produto» e «Pedido provisório» removidas designam as etiquetas 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
Tags de pedido adicionadas, Tags de pedido removidas addedTags, removedTags, previousTags, currentTags
Nota do pedido alterada oldNote, newNote
Alteração do estado financeiro do pedido oldFinancialStatus, newFinancialStatus
Alteração no processamento de pedidos oldFulfillmentStatus, newFulfillmentStatus e, por linha ou envio, em changes.items: processado, não processado, rastreio atualizado com número, URL e empresa
Alteração do estado de visualização do pedido oldDisplayFulfillmentStatus, newDisplayFulfillmentStatus
Atributos do pedido alterados changes.items, com changeType, key, oldValue e newValue
Alterações nos itens de linha do pedido 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 da morada de entrega do pedido shippingAddress e oldShippingAddress, cada um deles também como campos separados
Atualização do metacampo do pedido metafield.value, metafield.previousValue
Atualização do pedido changes.fields e changes.items com field, oldValue e newValue para o estado financeiro, o estado de processamento, as tags, a nota, os itens de linha e os atributos personalizados

Clientes

Gatilho Antes e depois
Tags de cliente adicionadas, tags de cliente removidas addedTags, removedTags, previousTags, currentTags
Nota do cliente alterada oldNote, newNote
Alteração do estado do cliente oldState, newState
Alteração do nome do cliente firstName, lastName, oldFirstName, oldLastName
O endereço de e-mail do cliente foi alterado email, oldEmail
Alteração do número de telefone do cliente phone, oldPhone
Alteração da morada do cliente address e oldAddress, cada um deles também como campos separados
Alteração do consentimento para o marketing por e-mail dos clientes, alteração do consentimento para o marketing por SMS dos clientes consentState, optInLevel, oldConsentState, oldOptInLevel
Atualização do metacampo do cliente metafield.value, metafield.previousValue
Atualização para os clientes 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
O título do produto, o identificador, a descrição, o estado, o fornecedor e o 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 do preço de uma variante do produto priceChange.oldPrice, newPrice, oldCompareAtPrice, newCompareAtPrice, delta, percentChange, direction
Alteração do preço unitário de uma variante do produto unitPriceChange.oldUnitPrice, newUnitPrice, delta, percentChange, direction
Alteração do 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, estado, 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, sujeito a imposto, título, opções e imagem

Existências, coleções, locais e muito mais

Gatilho Antes e depois
Alteração do nível de estoque, esgotamento e reposição de estoque na localização inventoryLevel.oldAvailable``newAvailable``delta``percentChange``direction, juntamente com a localização
Título, identificador e descrição da coleção alterados o valor antigo e o novo
Atualização da localização, Atualização da empresa, Atualização da localização da empresa, Atualização do desconto, Atualização do blogue, Atualização de uma publicação no blogue, Atualização da página changes.fields e changes.items no registo, 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 que os pedidos: tags, notas, atributos, itens de linha, estado, e-mail e endereços
Atualização de metacampos para 15 tipos de registos metafield.value, metafield.previousValue

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

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

As condições do Flow são comparadas, não calculadas, e os montantes monetários chegam ao Flow sob a forma de texto. Por isso, a expressão «diminuiu mais de 10 por cento» não pode ser calculada no âmbito de um fluxo de trabalho a partir de dois preços. Os gatilhos de preço, preço unitário, custo e stock enviam, portanto, o resultado sob a forma de números:

Campo Significado Exemplo
delta novo valor menos valor anterior -5
percentChange a variação, expressa em percentagem 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 a alteração do preço da variante do produto, com os parâmetros «preço antigo», «novo preço», «diferença», «variação percentual» e «direção»
As variáveis «Preço da variante do produto alterado» no seletor do Shopify Flow.
Uma condição do Shopify Flow: priceChange.percentChange é inferior a -10
Uma condição relativa à percentagem calculada pela aplicação. Não é necessário qualquer passo de programação.
O Shopify Flow fornece o valor anterior de um campo?

Não com os seus próprios gatilhos atualizados. As páginas de ajuda da Shopify relativas aos gatilhos «Produto atualizado», «Pedido atualizado», «Cliente atualizado» e aos outros gatilhos de atualização indicam que apenas os valores atuais estão disponíveis no fluxo de trabalho. Os gatilhos desta aplicação enviam o valor anterior e o valor posterior.

Posso calcular o valor anterior no Shopify Flow?

Apenas se o tiver guardado você mesmo antes da alteração, por exemplo, copiando um valor para um metacampo através de outro fluxo de trabalho e recuperando-o posteriormente. Essa cópia tem de existir antes da primeira alteração e ser mantida em sincronia para cada registo. A aplicação trata deste registo para os campos que monitoriza.

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

Sim. Cada gatilho de metacampo desta aplicação inclui metafield.previousValue juntamente com metafield.value, para 15 tipos de registos. Consulte Alterações nos metacampos no Shopify Flow: os gatilhos atualizados e os gatilhos dos metacampos.

Por que razão não se disparou nada na primeira mudança de disco?

A aplicação necessita de um ponto de partida. Quando um gatilho é ativado, a aplicação lê os seus registos existentes uma vez em segundo plano. Uma alteração efetuada antes de essa leitura ter chegado ao registo é apenas registada. A alteração seguinte é acionada. Histórico de eventos e resolução de problemas mostra o estado dessa sincronização.

Próximos passos