Previsualizar os datos da API utilizados en Shopify Flow

A maioría dos fluxos de traballo acceden aos datos da túa tenda, para que os poidas usar nas condicións e nas accións. Shopify Flow accede aos datos da tenda mediante unha chamada á GraphQL Admin API, o cal che fornece acceso a practicamente todos os campos da API.

Ao crear un fluxo de traballo, a miúdo atoparás nomes de campos e descricións baseados na API, pero é posible que necesites coñecer os valores deses datos. Por exemplo, quizais queiras coñecer o nome da aplicación dun pedido creado a partir dun pedido preliminar. Ademais, podes querer asegurarte de que o teu fluxo de traballo xera os datos que esperas, ou no formato que esperas.

Para revisar os valores dos datos, tes varias opcións en Shopify Flow.

Atopar un campo no administrador de Shopify

Na maioría dos casos, podes atopar datos se buscas no administrador de Shopify. Por exemplo, product.title aparece na páxina Produto.

Obter datos de mostra

Ao crear un fluxo de traballo, podes obter datos de mostra directamente no editor de Flow. Como os datos de Flow proveñen de eventos, para obter datos de mostra precisos debes comezar escollendo un evento relevante:

1. No editor de Flow, abre unha acción na que queiras usar os datos e fai clic en Engadir unha variable. Como alternativa, nunha condición, fai clic en Engadir criterios.
2. Fai clic en Configurar datos de mostra.
3. Flow mostra os eventos anteriores en función do activador do fluxo de traballo. Fai clic en Actualizar eventos para obter os eventos das execucións recentes ou en Comezar a escoitar eventos en directo e, a continuación, inicia manualmente o evento no administrador ou na aplicación relevante (para os activadores baseados en aplicacións).
4. Despois de que ocorra o evento, Flow mostrará os detalles sobre el. Escolle o evento que queiras usar para obter os datos de mostra. Fai clic en Usar este evento activador.
5. Agora, ao explorar os eventos, deberían mostrarse datos de mostra para cada variable.

Limitacións:

• Debido ás restricións de espazo, para os datos dunha lista, Flow só mostrará os datos do primeiro artigo da lista.
• Flow almacenará un máximo de 5 eventos á vez por cada fluxo de traballo.
• Flow non pode obter os eventos das execucións recentes para algúns activadores, como Tempo programado, Entrada de metaobxecto creada, O cliente uniuse ao segmento ou O cliente abandonou o segmento.

Usar o campo nun fluxo de traballo activo

Podes usar os campos con seguridade nun fluxo de traballo facendo uso da acción Rexistrar saída. Ao executar un fluxo de traballo, a acción Rexistrar saída imprimirá a saída de calquera variable ou texto na páxina Historial de execucións. Tamén podes usar accións de notificación como Enviar correo electrónico interno.

Pasos para usar Rexistrar saída:

1. Escolle un activador que se poida iniciar manualmente.
2. Engade unha acción Rexistrar saída ao fluxo de traballo e conéctaa co activador.
3. Na configuración de Rexistrar saída, fai clic en Engadir unha variable para engadir as variables que queres inspeccionar á sección Saída.
4. Cando remates, fai clic en Activar o fluxo de traballo.
5. Inicia o fluxo de traballo, xa sexa executándoo manualmente ou provocando o inicio do activador. Por exemplo, se usas o activador Pedido creado, crea un pedido de proba.
6. Despois de que o fluxo de traballo se execute, consulta as variables no rexistro de actividade.

Consultar a páxina JSON do recurso

A maioría das páxinas de recursos no administrador de Shopify, como as páxinas Pedido, Produto ou Cliente, permiten ver os datos que abastecen á páxina. Estes datos non teñen exactamente os mesmos nomes e formato que usa Shopify Flow, pero os valores coinciden cos da GraphQL Admin API. Para revisar os datos, engade .json ao URL.

Por exemplo, para navegar a un pedido, vai á páxina Pedidos no administrador de Shopify e fai clic nun pedido. Na barra de enderezos do teu navegador, cambia o enderezo da páxina de:

https://https://admin.shopify.com/store/<shopname>/orders/3804849891234

Ao seguinte:

https://https://admin.shopify.com/store/<shopname>/orders/3804849891234.json

Nota

O formato .json segue a REST API. O uso de maiúsculas nos nomes das variables da REST API usa guións baixos, como line_items. GraphQL e Shopify Flow usan o formato camelCase (maiúscula intercalada), como lineItems. Ademais, ás veces os nomes dos campos son diferentes, como properties en vez de customAttributes. Verifica a información que atopes usando este enfoque.

Usar GraphiQL ou unha ferramenta de API de terceiros

Podes consultar a API directamente usando unha ferramenta de API de terceiros, como Postman, ou a ferramenta gratuíta que ofrece Shopify, GraphiQL. Esta opción ofrece os resultados máis precisos, pero require certa familiaridade coa creación de consultas de GraphQL.

Para GraphiQL, Shopify ofrece tanto un explorador de GraphiQL baseado na web con datos xenéricos como a aplicación GraphiQL. Con GraphiQL, podes crear unha consulta de GraphQL que coincida exactamente cos nomes dos campos en Shopify Flow. Os valores tamén coincidirán exactamente cos da túa tenda se usas a aplicación.

Ao usar esta ferramenta, podes determinar exactamente os datos que usa Shopify Flow, cos datos reais da túa tenda. Por exemplo, creas a seguinte consulta:

{
  orders(first:5, reverse:true) {
    nodes {
      createdAt
      app {
        name
      }
      channelInformation {
        app {
          title
        }
      }
    }
  }
}

Nos seguintes resultados, a variable order / app / name mostra o nome da aplicación para o pedido. Neste caso, o pedido creouse dende a aplicación de borradores de pedidos, polo que o valor é Draft Orders. A información da canle só está dispoñible para a aplicación Point of Sale.

{
  "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"
            }
          }
        }
      ]
    }
  }