Previsualització de les dades de l'API utilitzades a Shopify Flow

La majoria de fluxos de treball accedeixen a les dades de la teva botiga, per la qual cosa pots utilitzar-les en condicions i accions. Shopify Flow accedeix a les dades de la botiga fent una crida a la GraphQL Admin API, cosa que et permet accedir a gairebé tots els camps de l'API.

Mentre crees un flux de treball, sovint trobaràs noms i descripcions de camps basats en l'API, però potser et caldrà saber els valors d'aquestes dades. Per exemple, potser vols saber el nom de l'aplicació per a una comanda que s'ha creat a partir d'un esborrany de comanda. A més, és possible que vulguis assegurar-te que el teu flux de treball genera les dades que esperes o en el format que esperes.

Per revisar els valors de les dades, tens diverses opcions a Shopify Flow.

Trobar un camp al panell d'administració de Shopify

En la majoria dels casos, pots trobar dades si mires el panell d'administració de Shopify. Per exemple, product.title es mostra a la pàgina Producte.

Obtenir dades de mostra

Quan crees un flux de treball, pots obtenir dades de mostra directament a l'editor de Flow. Com que les dades de Flow provenen d'esdeveniments, per obtenir dades de mostra precises, has de començar per triar un esdeveniment rellevant:

1. A l'editor de Flow, obre una acció on vulguis utilitzar les dades i fes clic a Afegeix una variable. Alternativament, en una condició, fes clic a Afegeix criteris.
2. Fes clic a Configura les dades de mostra.
3. Flow mostra esdeveniments anteriors basats en l'esdeveniment desencadenant del flux de treball. Fes clic a Actualitza els esdeveniments per recuperar esdeveniments d'execucions recents, o fes clic a Comença a escoltar esdeveniments en directe i, a continuació, activa manualment l'esdeveniment al panell d'administració o a l'aplicació rellevant (per a esdeveniments desencadenants basats en aplicacions).
4. Un cop es produeixi l'esdeveniment, Flow mostrarà els detalls de l'esdeveniment. Tria l'esdeveniment que vulguis utilitzar per obtenir dades de mostra. Fes clic a Utilitza aquest esdeveniment desencadenant.
5. Ara, a mesura que naveguis pels esdeveniments, s'haurien de mostrar dades de mostra per a cada variable.

Limitacions:

• A causa de les limitacions d'espai, per a les dades d'una llista, Flow només mostrarà les dades del primer element de la llista.
• Flow emmagatzemarà fins a 5 esdeveniments alhora per flux de treball.
• Flow no pot obtenir esdeveniments d'execucions recents per a alguns esdeveniments desencadenants, com ara Hora programada, Entrada de metaobjecte creada, Client afegit al segment o Client eliminat del segment.

Utilitzar el camp en un flux de treball actiu

Pots utilitzar els camps de manera segura en un flux de treball fent servir l'acció Registra la sortida. Quan executes un flux de treball, l'acció Registra la sortida imprimirà la sortida de qualsevol variable i text a la pàgina Historial d'execucions. També pots utilitzar accions de notificació com ara Envia un correu electrònic intern.

Passos per utilitzar Registra la sortida:

1. Tria un esdeveniment desencadenant que es pugui activar manualment.
2. Afegeix una acció Registra la sortida al flux de treball i connecta-la a l'esdeveniment desencadenant.
3. A la configuració de Registra la sortida, fes clic a Afegeix una variable per afegir les variables que vulguis inspeccionar a la secció Sortida.
4. Quan hagis acabat, fes clic a Activa el flux de treball.
5. Activa el flux de treball, ja sigui executant-lo manualment o provocant que s'activi l'esdeveniment desencadenant. Per exemple, si utilitzes l'esdeveniment desencadenant Comanda creada, crea una comanda de prova.
6. Un cop s'executi el flux de treball, comprova el registre d'activitat per veure les variables.

Consultar la pàgina JSON del recurs

La majoria de les pàgines de recursos del panell d'administració de Shopify, com ara les pàgines Comanda, Producte o Client, permeten veure les dades que proporcionen informació a la pàgina. Aquestes dades no tenen exactament la mateixa nomenclatura i format que utilitza Shopify Flow, però els valors coincideixen amb el que hi ha a la GraphQL Admin API. Per revisar les dades, afegeix .json a l'URL.

Per exemple, navega a una comanda anant al panell d'administració de Shopify fins a la pàgina Comandes i fent clic en una comanda. A l'adreça de la pàgina de la barra d'adreces del teu navegador, canvia l'adreça de:

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

A la següent:

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

Nota

El format .json segueix la REST API. L'ús de majúscules i minúscules dels noms de les variables a la REST API fa servir guions baixos, com ara line_items. GraphQL i Shopify Flow utilitzen camelCase, com ara lineItems. A més, de vegades els noms dels camps difereixen, com ara properties en lloc de customAttributes. Verifica la informació que trobis amb aquest mètode.

Utilitzar GraphiQL o una eina d'API de tercers

Pots fer consultes directament a l'API amb una eina d'API de tercers com ara Postman o amb l'eina gratuïta proporcionada per Shopify, GraphiQL. Aquesta opció ofereix els resultats més precisos, però requereix certa familiaritat amb la creació de consultes de GraphQL.

Per a GraphiQL, Shopify ofereix tant un explorador GraphiQL basat en web amb dades genèriques com l'aplicació GraphiQL. Amb GraphiQL, pots crear una consulta de GraphQL que coincideixi exactament amb els noms dels camps a Shopify Flow. Els valors també coincidiran exactament amb els de la teva botiga si fas servir l'aplicació.

En utilitzar aquesta eina, pots determinar exactament quines dades fa servir Shopify Flow, amb les dades reals de la teva botiga. Per exemple, crees la consulta següent:

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

En els resultats següents, la variable order / app / name mostra el nom de l'aplicació per a la comanda. En aquest cas, la comanda es va crear des de l'aplicació d'esborranys de comanda, per la qual cosa el valor és Draft Orders. La informació del canal només està disponible per a l'aplicació 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"
            }
          }
        }
      ]
    }
  }