Ajutor
Conectați-vă

Previzualizarea datelor API utilizate în Shopify Flow

Majoritatea fluxurilor de lucru accesează date din magazinul dvs., astfel încât să le puteți utiliza în condiții și acțiuni. Shopify Flow accesează datele magazinului prin apelarea GraphQL Admin API, oferindu-vă acces la aproape toate câmpurile din API.

Pe măsură ce construiți un flux de lucru, veți întâlni adesea nume de câmpuri și descrieri bazate pe API, dar este posibil să trebuiască să cunoașteți valorile acelor date. De exemplu, s-ar putea să doriți să știți numele aplicației pentru o comandă creată dintr-o comandă provizorie. În plus, s-ar putea să doriți să vă asigurați că fluxul de lucru redă datele pe care le așteptați sau în formatul pe care îl așteptați.

Pentru a examina valorile datelor, aveți la dispoziție mai multe opțiuni în Shopify Flow.

Pe această pagină

Găsirea unui câmp în panoul de administrare Shopify

În majoritatea cazurilor, puteți găsi datele căutând în panoul de administrare Shopify. De exemplu, product.title este listat pe pagina Produs.

Obținerea datelor eșantion

Atunci când construiți un flux de lucru, puteți obține date eșantion direct în editorul Flow. Deoarece datele Flow provin din evenimente, pentru a obține date eșantion exacte, trebuie să începeți prin a alege un eveniment relevant:

  1. În editorul Flow, deschideți o acțiune în care doriți să utilizați datele și faceți clic pe Adăugare variabilă. Alternativ, într-o condiție, faceți clic pe Adăugare criterii.
  2. Faceți clic pe Configurare date eșantion.
  3. Flow afișează evenimentele anterioare în funcție de declanșatorul fluxului de lucru. Faceți clic pe Reîncărcare evenimente pentru a prelua evenimente din execuțiile recente sau faceți clic pe Pornire ascultare evenimente live și apoi declanșați manual evenimentul în panoul de administrare sau în aplicația relevantă (pentru declanșatoarele bazate pe aplicații).
  4. După ce evenimentul are loc, Flow va afișa detalii despre eveniment. Alegeți evenimentul pe care doriți să-l utilizați pentru a obține date eșantion. Faceți clic pe Utilizare acest eveniment declanșator.
  5. Acum, pe măsură ce navigați prin evenimente, ar trebui să se afișeze date eșantion pentru fiecare variabilă.

Limitări:

  • Din cauza constrângerilor de spațiu, pentru datele dintr-o listă, Flow va afișa doar datele de la primul articol din listă.
  • Flow va stoca până la 5 evenimente la un moment dat, per flux de lucru.
  • Flow nu poate prelua evenimente din execuțiile recente pentru unele declanșatoare, cum ar fi Oră programată, Intrare metaobiect creată, Clientul a intrat în segment sau Clientul a părăsit segmentul.

Utilizarea câmpului într-un flux de lucru live

Puteți utiliza în siguranță câmpurile într-un flux de lucru, folosind acțiunea Jurnal de ieșire. Atunci când rulați un flux de lucru, acțiunea Jurnal de ieșire va tipări rezultatul oricăror variabile și text pe pagina Istoric execuții. Puteți utiliza, de asemenea, acțiuni de notificare, cum ar fi Trimitere e-mail intern.

Pași pentru a utiliza Jurnal de ieșire:

  1. Alegeți un declanșator care poate fi declanșat manual.
  2. Adăugați o acțiune Jurnal de ieșire la fluxul de lucru și conectați-o la declanșator.
  3. În configurația Jurnal de ieșire, faceți clic pe Adăugare variabilă pentru a adăuga variabilele pe care doriți să le inspectați la secțiunea Ieșire.
  4. După ce ați terminat, faceți clic pe Activare flux de lucru.
  5. Declanșați fluxul de lucru, fie rulându-l manual, fie făcând ca declanșatorul să se activeze. De exemplu, dacă utilizați declanșatorul Comandă creată, creați o comandă test.
  6. După ce rulează fluxul de lucru, verificați jurnalul de activitate pentru variabile.

Consultarea paginii JSON a resursei

Majoritatea paginilor de resurse din panoul de administrare Shopify, cum ar fi paginile Comandă, Produs sau Client, vă permit să vizualizați datele care deservesc pagina. Aceste date nu au exact aceeași denumire și același format pe care le utilizează Shopify Flow, dar valorile se potrivesc cu cele din GraphQL Admin API. Pentru a examina datele, adăugați .json la URL.

De exemplu, navigați la o comandă mergând în panoul de administrare Shopify la pagina Comenzi și făcând clic pe o comandă. În adresa paginii din bara de adrese a browserului dvs., schimbați adresa de la:

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

La următoarea:

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

Utilizarea GraphiQL sau a unui instrument API extern

Puteți interoga direct API-ul utilizând un instrument API extern, cum ar fi Postman, sau instrumentul gratuit furnizat de Shopify, GraphiQL. Această opțiune oferă cele mai exacte rezultate, dar necesită o oarecare familiaritate cu crearea de interogări GraphQL.

Pentru GraphiQL, Shopify oferă atât un explorator GraphiQL bazat pe web cu date generice, cât și aplicația GraphiQL. Cu GraphiQL, puteți construi o interogare GraphQL care se potrivește exact cu numele câmpurilor din Shopify Flow. De asemenea, valorile se potrivesc exact cu magazinul dvs. dacă utilizați aplicația.

Prin utilizarea acestui instrument, puteți determina exact ce date utilizează Shopify Flow, cu datele reale ale magazinului dvs. De exemplu, creați următoarea interogare:

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

În următoarele rezultate, variabila order / app / name afișează numele aplicației pentru comandă. În acest caz, comanda a fost creată din aplicația Comenzi provizorii, astfel că valoarea este Comenzi provizorii. Informațiile despre canal sunt disponibile numai pentru aplicația Punct de vânzare.

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