Gatilhos de metacampo

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. O senhor escolhe quais metacampos monitorar, uma definição por vez; assim, uma loja com centenas de metacampos só acionará os gatilhos para aqueles que são relevantes para um fluxo de trabalho.

Tipos de proprietários de suporte

Produto, Variante do produto, Coleção, Cliente, Pedido, Empresa, Unidade da empresa, Blog, Postagem no blog e Página.

Como configurar um

O exemplo nesta página monitora um metacampo de produto chamado “Avaliação” (custom.rating), o tipo de valor que um aplicativo de avaliações grava.

1. Selecione o metacampo

1. Abra “Gatilhos de metacampo” na navegação do aplicativo.
2. Clique em “Adicionar gatilho”.
3. Escolha o tipo de recurso ao qual o metacampo pertence, por exemplo, Produto.
4. 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 listados (Shopify admin, Configurações, Dados personalizados). A lista é mantida por uma hora; portanto, uma definição que o(a) senhor(a) criou há pouco pode não constar: clique em “Atualizar metacampos” ao lado de “Adicionar gatilho” e abra a caixa de diálogo novamente.

2. O metacampo está agora sob observação

O metacampo aparece na lista como “Ativo”. Não há mais nada a ser ativado: adicioná-lo aqui já significa ativá-lo. Ao excluí-lo, o monitoramento é interrompido.

O aplicativo primeiro registra o valor atual desse metacampo nos seus registros existentes, de modo que a primeira edição já seja executada com o valor antigo correto.

3. O que um evento representa

A partir de então, toda alteração nesse metacampo aciona o evento “Metacampo Update” no Shopify Flow. O evento contém o namespace e a chave, o registro ao qual pertence, o novo valor e previousValue - o valor anterior do metacampo. previousValue fica vazio quando o metacampo é definido pela primeira vez.

No exemplo, a avaliação passou de 4,5 para 2,5. Uma condição do fluxo de trabalho “o valor é menor que 3 e o valor anterior é 3 ou mais” é acionada uma única vez, no momento em que a avaliação cai abaixo de 3, em vez de ser acionada a cada edição posterior. Passo a passo: Gatilhos de metacampo, passo a passo.

O gatilho genérico e os gatilhos tipados

Existem duas maneiras de incorporar as alterações nos metacampos:

Gatilho	Capas	Oferece
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, além da ordem como uma referência nativa do Shopify Flow
Atualização do metacampo do produto	Apenas produtos	O mesmo, além do produto como referência nativa
Atualização do metacampo do cliente	Somente para clientes	O mesmo, além do cliente como referência nativa
Atualização do metacampo de variantes do produto	Apenas variantes do produto	O mesmo, além do produto pai como referência nativa

Utilize um gatilho tipado quando seu fluxo de trabalho precisar atuar diretamente sobre o próprio recurso, por exemplo, para tagar o pedido ou ler seus itens de linha. A referência nativa significa que o Flow pode utilizar diretamente suas próprias ações do tipo Shopify nesse recurso, sem a necessidade de uma etapa de consulta.

Utilize o gatilho genérico quando precisar apenas saber se um valor foi alterado ou quando estiver monitorando um tipo de proprietário que não possua uma variante tipada.

Cada um dos gatilhos definidos possui seu próprio botão na página “Gatilhos” (ativar um fluxo de trabalho do Shopify Flow que utilize um desses gatilhos significa ativá-lo) e são acionados além do gatilho genérico. Eles compartilham um único evento; portanto, ativar ambos não resulta em contagem dupla em sua cota.

Guias

• Acionar o evento Shopify Flow ao atualizar os metacampos do pedido
• Acionar o Shopify Flow quando houver alterações nos metacampos do produto
• Acionar o Shopify Flow ao atualizar os metacampos do cliente
• Gatilhos de metacampo, passo a passo - um exemplo prático para cada um dos cinco gatilhos de metacampo.