Visualização de dados da API usados no Shopify Flow
A maioria dos fluxos de trabalho acessa dados da loja para que você possa usá-los em condições e ações. O Shopify Flow acessa os dados da loja chamando a GraphQL Admin API, o que dá acesso a quase todos os campos da API.
Ao criar um fluxo de trabalho, você costuma encontrar nomes e descrições de campos com base na API, mas talvez precise saber os valores desses dados. Por exemplo, pode ser necessário saber o nome do app de um pedido que foi criado a partir de um rascunho de pedido. Além disso, você pode querer confirmar se o fluxo de trabalho exibe os dados que espera ou no formato esperado.
Para analisar os valores dos dados, há várias opções no Shopify Flow.
Nesta página
Encontrar um campo no admin da Shopify
Na maioria dos casos, é possível encontrar dados no admin da Shopify. Por exemplo, product.title está na página Produto.
Obter dados de amostra
Ao criar um fluxo de trabalho, você pode obter dados de amostra diretamente no editor do Flow. Como os dados do Flow vêm de eventos, para obter dados de amostra precisos, comece escolhendo um evento relevante:
- No editor do Flow, abra uma ação em que você queira usar os dados e clique em Adicionar variável. Se preferir, em uma condição, clique em Adicionar critérios.
- Clique em Configurar dados de amostra.
- O Flow exibe eventos anteriores com base no acionador do fluxo de trabalho. Clique em Atualizar eventos para buscar eventos de execuções recentes ou em Começar a ouvir eventos ao vivo e acione o evento manualmente no admin ou no app relevante (para acionadores baseados em apps).
- Depois que o evento ocorre, o Flow exibe informações sobre ele. Escolha o evento que você quer usar para obter os dados de amostra. Clique em Usar este evento de acionador.
- Agora, ao navegar pelos eventos, os dados de amostra devem ser exibidos para cada variável.
Limitações:
- Devido a limitações de espaço, para dados em uma lista, o Flow exibe apenas os dados do primeiro item da lista.
- O Flow armazena até cinco eventos por vez, por fluxo de trabalho.
- O Flow não consegue buscar eventos de execuções recentes para alguns acionadores, como Horário agendado, Entrada de metaobjeto criada, Cliente entrou no segmento ou Cliente saiu do segmento.
Usar o campo em um fluxo de trabalho ativo
É possível usar os campos com segurança em um fluxo de trabalho com a ação Registrar saída. Ao executar um fluxo de trabalho, essa ação imprime a saída de todas as variáveis e textos na página Histórico de execuções. Também é possível usar ações de notificação, como Enviar e-mail interno.
Etapas para usar a ação Registrar saída:
- Escolha um acionador que possa ser acionado manualmente.
- Adicione uma ação Registrar saída ao fluxo de trabalho e conecte-a ao acionador.
- Na configuração de Registrar saída, clique em Adicionar variável para adicionar as variáveis que você quer analisar à seção Saída.
- Quando terminar, clique em Ativar fluxo de trabalho.
- Acione o fluxo de trabalho, seja executando-o manualmente ou fazendo o acionador disparar. Por exemplo, se você estiver usando o acionador Pedido criado, crie um pedido de teste.
- Depois que o fluxo de trabalho for executado, verifique o registro de atividade para consultar as variáveis.
Consultar a página JSON do recurso
A maioria das páginas de recursos no admin da Shopify, como as de Pedido, Produto ou Cliente, permite que você veja os dados que compõem a página. Esses dados não têm exatamente o mesmo nome e formato usados no Shopify Flow, mas os valores correspondem aos da GraphQL Admin API. Para analisar os dados, adicione .json ao URL.
Por exemplo, acesse um pedido no admin da Shopify, na página Pedidos, e clique nele. Na barra de endereços do navegador, altere o endereço da página de:
https://https://admin.shopify.com/store/<shopname>/orders/3804849891234
Para o seguinte:
https://https://admin.shopify.com/store/<shopname>/orders/3804849891234.json
Usar o GraphiQL ou uma ferramenta de API de terceiros
Consulte a API diretamente usando uma ferramenta de API de terceiros, como o Postman, ou a ferramenta gratuita da Shopify, o GraphiQL. Essa opção oferece os resultados mais precisos, mas exige certa familiaridade com a criação de consultas GraphQL.
Para o GraphiQL, a Shopify oferece um explorador GraphiQL baseado na web com dados genéricos e o app GraphiQL. Com o GraphiQL, é possível criar uma consulta GraphQL que corresponda exatamente aos nomes dos campos no Shopify Flow. Se você usar o app, os valores também corresponderão exatamente aos da sua loja.
Com essa ferramenta, você pode determinar exatamente quais dados o Shopify Flow usa, com os dados reais da sua loja. Por exemplo, crie a seguinte consulta:
{
orders(first:5, reverse:true) {
nodes {
createdAt
app {
name
}
channelInformation {
app {
title
}
}
}
}
}Nos resultados a seguir, a variável order / app / name exibe o nome do app do pedido. Neste caso, o pedido foi criado a partir do app de rascunhos de pedido, portanto o valor é Pedidos em rascunho. As informações do canal de vendas estão disponíveis apenas para o app Ponto de venda.
{
"data": {
"orders": {
"nodes": [
{
"createdAt": "2023-04-10T12:32:41Z",
"app": {
"name": "Draft Orders"
},
"channelInformation": null
},
{
"createdAt": "2023-04-10T12:29:12Z",
"app": {
"name": "Draft Orders"
},
"channelInformation": null
},
{
"createdAt": "2023-03-17T20:23:10Z",
"app": {
"name": "Draft Orders"
},
"channelInformation": null
},
{
"createdAt": "2023-03-17T20:20:53Z",
"app": {
"name": "Draft Orders"
},
"channelInformation": null
},
{
"createdAt": "2023-03-17T15:45:15Z",
"app": {
"name": "Point of Sale"
},
"channelInformation": {
"app": {
"title": "Point of Sale"
}
}
}
]
}
}