Disparadores de metaobjetos

Os metaobjetos são registos com estrutura personalizada: guias de tamanhos, localizadores de lojas, listas de ingredientes, instruções de cuidados e qualquer outra coisa que o próprio utilizador definir. O gatilho de atualização da entrada do metaobjeto é acionado quando uma dessas entradas é alterada.

Configurar um

O exemplo nesta página monitoriza um metaobjeto chamado «Size guide» com uma entrada: linen-shirts.

1. Abertura de gatilhos de metaobjetos

Abra «Metaobject Triggers» na navegação da aplicação. Até adicionar um tipo, a página fica vazia.

A página «Metaobject Triggers» é apresentada antes de qualquer definição ser monitorizada, com um botão «Adicionar gatilho»
A página «Metaobject Triggers» é apresentada antes de se assistir a qualquer conteúdo.

2. Escolha o tipo de metaobjeto

Clique em «Adicionar Gatilho», selecione o tipo de metaobjeto que pretende monitorizar e clique em «Adicionar Gatilho» na caixa de diálogo. A monitorização é feita sobre um tipo completo, e não sobre entradas individuais: todas as entradas desse tipo ativam o gatilho, incluindo as que criar posteriormente.

É possível que um tipo que criou há pouco não conste na caixa de diálogo, uma vez que a lista fica memorizada durante algum tempo. Clique em «Atualizar metaobjetos» e abra novamente a caixa de diálogo.

A caixa de diálogo «Selecionar tipo de metaobjeto» com o guia de tipo «Tamanho» selecionado
Escolha o tipo que pretende monitorizar. Todas as entradas desse tipo são processadas, incluindo as criadas posteriormente.

3. O tipo está agora sob vigilância

O tipo aparece na lista como «Ativo». Ao eliminá-lo, deixa de o acompanhar.

A lista de «Metaobject Triggers» com o tipo «Size guide» apresentada como «Ativa»
O tipo monitorizado: Ativo. Ao eliminar, deixa de ser monitorizado.

O que um evento representa

A edição de qualquer entrada desse tipo aciona a entrada «Metaobject entry updated» em Shopify Flow. O fluxo recebe metaobjectHandle para as condições e a própria entrada como metaobject: o seu tipo, nome de exibição e campos, tal como se encontram atualmente. Não existe nenhum valor anterior para os campos do metaobjeto. No Histórico de Eventos da aplicação, o mesmo evento é listado com o ID, o tipo e o identificador da entrada.

Utilize o identificador numa situação em que apenas uma entrada seja relevante (metaobjectHandle igual a linen-shirts). Passo a passo: Acionador 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 aos Dados de Metaobjetos (read_metaobjects), que inclui o acesso tanto às definições como às entradas. Conceda essa permissão na página «Permissões».

Utilizações típicas

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