Gatilhos de metacampos
Acione o Shopify Flow quando um metacampo específico for alterado em produtos, variantes, pedidos, clientes e mais 6 tipos de titulares.
Os gatilhos de metacampo são acionados quando uma definição específica de metacampo é alterada, em qualquer um dos 10 tipos de proprietário. Pode escolher quais os metacampos a monitorizar, uma definição de cada vez, pelo que uma loja com centenas de metacampos só aciona os gatilhos relativos aos que são relevantes para um fluxo de trabalho.
Tipos de proprietário com suporte
Produto, Variante de produto, Coleção, Cliente, Pedido, Empresa, Localização da empresa, Blogue, Publicação no blogue e Página.
Como configurar um
O exemplo nesta página monitoriza um metacampo de produto denominado «Rating» (custom.rating), o tipo de valor que uma aplicação de avaliações introduz.
1. Selecione o metacampo
- Abra «Gatilhos de metacampo» na navegação da aplicação.
- Clique em «Adicionar gatilho».
- Escolha o tipo de recurso ao qual o metacampo pertence, por exemplo, Produto.
- Selecione a definição do metacampo na lista - pesquise pelo nome, caso haja muitas opções - e clique em «Adicionar gatilho».
Apenas os metacampos com uma definição são apresentados (Shopify admin, Configurações, Dados personalizados). A lista é guardada durante uma hora, pelo que uma definição que tenha criado há pouco possa não constar: clique em «Atualizar metacampos» junto a «Adicionar gatilho» e abra novamente a caixa de diálogo.
2. O metacampo está agora sob vigilância
O metacampo aparece na lista como «Ativo». Não há mais nada a ativar: ao adicioná-lo aqui, está a ativá-lo. Ao eliminá-lo, deixa de o monitorizar.
A aplicação regista primeiro o valor atual desse metacampo nos seus registos existentes, pelo que a primeira edição já é efetuada com o valor antigo correto.
3. O que um evento implica
A partir daí, cada alteração nesse metacampo aciona o evento «Metacampo Update» no Shopify Flow. O evento inclui o namespace e a chave, o registo a que pertence, o novo valor e previousValue - o valor anterior do metacampo. previousValue está vazio quando o metacampo foi definido pela primeira vez.
No exemplo, a classificação passou de 4,5 para 2,5. Uma condição do fluxo de trabalho «o valor é inferior a 3 e o valor anterior é igual ou superior a 3» é acionada uma única vez, no momento em que a classificação desce abaixo de 3, em vez de ser acionada em cada edição posterior. Passo a passo: Gatilhos de metacampo, passo a passo.
O gatilho genérico e os gatilhos tipados
Existem duas formas de aplicar as alterações nos metacampos:
| Gatilho | Capas | Fornece |
|---|---|---|
| Atualização do Metacampo | Todos os 10 tipos de proprietários | Espaço de nomes, chave, ID do proprietário, valor antigo e novo |
| Atualização do metacampo de pedido | Apenas pedidos | O mesmo, acrescido da ordem como referência nativa do Shopify Flow |
| Atualização do metacampo do produto | Apenas produtos | O mesmo, acrescido do produto como referência nativa |
| Atualização do metacampo do cliente | Apenas para clientes | O mesmo, acrescentando o cliente como referência nativa |
| Atualização do metacampo da variante do produto | Apenas variantes do produto | O mesmo, acrescido do produto principal como referência nativa |
Utilize um gatilho tipado quando o seu fluxo de trabalho precisar de atuar sobre o próprio recurso, por exemplo, para taggar o pedido ou ler os seus itens de linha. A referência nativa significa que o Flow pode utilizar diretamente as suas próprias ações Shopify nesse recurso, sem necessidade de uma etapa de pesquisa.
Utilize o gatilho genérico quando apenas precisar de saber que um valor foi alterado, ou quando estiver a monitorizar um tipo de proprietário que não possua nenhuma variante tipada.
Cada um dos gatilhos definidos possui o seu próprio botão na página «Gatilhos» (ativar um fluxo de trabalho do Shopify Flow que utilize um desses gatilhos equivale a ativá-lo) e são acionados para além do gatilho genérico. Partilham um único evento, pelo que ativar ambos não implica uma dupla contagem na sua cota.
Guias
- Acionar o Shopify Flow quando forem atualizados os metacampos da encomenda
- Acionar o Shopify Flow quando houver alterações nos metacampos do produto
- Acionar o Shopify Flow quando forem atualizados os metacampos do cliente
- Gatilhos de metacampo, passo a passo - um exemplo prático para cada um dos cinco gatilhos de metacampo.