Gatilhos de metaobjetos

Copiar página

DisparShopify Flow quando uma entrada do metaobjeto é alterada, conforme configurado na definição do metaobjeto.

Os metaobjetos são registros estruturados de forma personalizada: guias de tamanhos, localizadores de lojas, listas de ingredientes, instruções de cuidados e qualquer outra coisa que o senhor mesmo definir. O gatilho de atualização da entrada do metaobjeto é acionado quando uma dessas entradas é alterada.

Como configurar um

O exemplo nesta página monitora um metaobjeto chamado “Guia de tamanhos”, que contém uma entrada: linen-shirts.

1. Gatilhos de metaobjetos abertos

Abra “Gatilhos de metaobjetos” na navegação do aplicativo. Até que você adicione um tipo, a página permanecerá vazia.

A página “Gatilhos de metaobjetos” é exibida antes de qualquer definição ser monitorada, com um botão “Adicionar gatilho” — A página “Gatilhos de Metaobjeto” é exibida antes que qualquer conteúdo seja assistido.

2. Escolha o tipo de metaobjeto

Clique em “Adicionar Gatilho”, selecione o tipo de metaobjeto que deseja monitorar e clique em “Adicionar Gatilho” na caixa de diálogo. Você monitora um tipo inteiro, e não entradas individuais: todas as entradas desse tipo acionam o gatilho, inclusive as que forem criadas posteriormente.

Um tipo que o(a) senhor(a) criou há pouco pode não aparecer na caixa de diálogo, pois a lista permanece armazenada por algum tempo. Clique em “Atualizar metaobjetos” e abra a caixa de diálogo novamente.

A caixa de diálogo “Selecionar tipo de metaobjeto” com o guia de tipo “Tamanho” selecionado — Escolha o tipo a ser monitorado. Cada registro desse tipo será acionado, inclusive os registros criados posteriormente.

3. O tipo agora está sendo monitorado

O tipo aparece na lista como “Ativo”. Ao excluí-lo, o acompanhamento será interrompido.

A lista de gatilhos de metaobjetos com o guia de tipo “Tamanho” exibido como “Ativo” — O tipo monitorado: Ativo. Ao excluir, o monitoramento é encerrado.

O que um evento representa

A edição de qualquer entrada desse tipo aciona o evento “Metaobjeto entry updated” em Shopify Flow. O Shopify Flow recebe metaobjectHandle para as condições e a própria entrada como metaobject: seu tipo, nome de exibição e campos, tal como estão no momento. Não há valor anterior para os campos do metaobjeto. No Histórico de Eventos do aplicativo, o mesmo evento é listado com o ID, o tipo e o identificador da entrada.

Utilize o identificador em uma condição em que apenas uma entrada seja relevante (metaobjectHandle igual a linen-shirts). Passo a passo: Gatilho de metaobjeto, passo a passo.

Um evento no Histórico de Eventos: entrada do metaobjeto atualizada para a entrada “camisas de linho” do tipo “guia de tamanhos” — O evento no Histórico de Eventos após uma edição na entrada “camisas de linho”.

Autorização

Os gatilhos de metaobjetos requerem o Acesso a Dados de Metaobjetos (read_metaobjects), o que inclui acesso tanto às definições quanto às entradas. Conceda essa permissão na página “Permissões”.

Usos típicos

Notifique a equipe de conteúdo sempre que houver alterações no guia de tamanhos ou nas instruções de cuidados.
Sincronize um registro alterado do localizador de lojas com um sistema externo.
Execute novamente um fluxo de trabalho de validação quando um registro de conteúdo estruturado for editado.