Gatilhos de metaobjetos

Metaobjetos são registros com estrutura personalizada: guias de tamanhos, localizadores de lojas, listas de ingredientes, instruções de cuidados e qualquer outra coisa que você mesmo modelar. 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 “Metaobject Triggers” na navegação do aplicativo. Até você adicionar um tipo, a página ficará vazia.

A página “Gatilhos de metaobjetos” é exibida antes que qualquer definição seja monitorada, com um botão “Adicionar gatilho” — A página “Metaobject Triggers” é 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, incluindo aquelas que você criar posteriormente.

Um tipo que você criou há pouco pode não estar aparecendo 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 entrada desse tipo será acionada, inclusive as entradas criadas posteriormente.

3. O tipo agora está sendo monitorado

O tipo aparece na lista como “Ativo”. Ao excluí-lo, ele deixa de ser monitorado.

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 “Metaobject entry updated” em Shopify Flow. O fluxo recebe metaobjectHandle para as condições e a própria entrada como metaobject: seu tipo, nome de exibição e campos, conforme 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.

Use o identificador quando apenas uma entrada for 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 “size_guide” — O evento no Histórico de Eventos após uma edição na entrada “camisas de linho”.

Permissão

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

Usos típicos

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