Gatilhos de metacampo
Acione fluxos do Shopify Flow quando um metacampo específico muda em 10 tipos de proprietário, como produtos, pedidos e clientes. Veja como configurar.
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ários com suporte
Produto, Variante do 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 grava.
1. Selecione o metacampo
- Abra «Gatilhos de Metacampos» 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 (Admin Shopify, Definiçõ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: adicioná-lo aqui equivale a ativá-lo. Ao eliminá-lo, deixa de ser monitorizado.
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 ao qual pertence, o novo valor e previousValue - o valor anterior do metacampo. previousValue está vazio quando o metacampo é definido pela primeira vez. Isto inclui um metacampo que já se encontra preenchido aquando da criação do registo, por exemplo, um cliente criado através de um formulário cujas respostas estão armazenadas em metacampos: o evento é acionado uma única vez, com um previousValue vazio.
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 dos pedidos 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 intervir diretamente no próprio recurso, por exemplo, para atribuir uma etiqueta ao pedido ou ler os seus itens de linha. A referência nativa significa que o Shopify Flow pode utilizar diretamente as suas próprias ações do 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 uma 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. Uma vez que partilham o mesmo evento, 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.