Pregled API podataka korišćenih u aplikaciji Shopify Flow

Većina tokova posla pristupa podacima iz vaše prodavnice, kako biste mogli da ih koristite u uslovima i radnjama. Shopify Flow pristupa podacima prodavnice tako što poziva GraphQL Admin API, čime dobijate pristup skoro svim poljima u API-ju.

Dok pravite tok posla, često ćete nailaziti na imena polja i opise zasnovane na API-ju, ali ćete možda morati da znate vrednosti tih podataka. Na primer, možda ćete želeti da saznate ime aplikacije za porudžbinu koja je kreirana iz radne verzije porudžbine. Pored toga, možda ćete želeti da se uverite da vaš tok posla daje izlazne podatke koje očekujete ili u obliku koji očekujete.

Da biste pregledali vrednosti podataka, na raspolaganju vam je nekoliko opcija u aplikaciji Shopify Flow.

Na ovoj stranici

Pronađite polje u Shopify adminu

U većini slučajeva podatke možete pronaći u Shopify adminu. Na primer, product.title se nalazi na stranici Proizvod.

Preuzmite probne podatke

Kad pravite tok posla, probne podatke možete da dobijete direktno u uređivaču za Flow. Pošto podaci za Flow potiču od događaja, da biste dobili tačne probne podatke, morate da počnete tako što ćete izabrati relevantan događaj:

U uređivaču za Flow otvorite radnju u kojoj želite da koristite podatke i kliknite na Dodaj promenljivu. Alternativno, u uslovu kliknite na Dodaj kriterijum.
Kliknite na Konfiguriši probne podatke.
Flow prikazuje prethodne događaje na osnovu okidača toka posla. Kliknite na Osveži događaje da biste preuzeli događaje iz nedavnih izvršavanja ili kliknite na Započni slušanje aktivnih događaja i zatim ručno pokrenite događaj u Shopify adminu ili relevantnoj aplikaciji (za okidače zasnovane na aplikaciji).
Nakon što se događaj dogodi, Flow će prikazati detalje o njemu. Izaberite događaj koji želite da koristite za dobijanje probnih podataka. Kliknite na Koristi ovaj događaj okidača.
Sada, dok pregledate događaje, za svaku promenljivu bi trebalo da se prikazuju probni podaci.

Ograničenja:

Zbog ograničenja prostora, za podatke na listi Flow će prikazati samo podatke iz prve stavke na listi.
Flow će čuvati najviše 5 događaja istovremeno po toku posla.
Flow ne može da preuzima događaje iz nedavnih izvršavanja za neke okidače, kao što su Planirano vreme, Unos metaobjekta je kreiran, Kupac je dodat u segment ili Kupac je napustio segment.

Koristite polje u aktivnom toku posla

Možete bezbedno da koristite polja u toku posla koristeći radnju Evidentiraj izlaz. Kad pokrenete tok posla, radnja Evidentiraj izlaz će ispisati izlazne podatke svih promenljivih i teksta na stranici Istorija izvršavanja. Možete i da koristite radnje za obaveštenja, kao što je Pošalji interni imejl.

Koraci za korišćenje evidentiranja izlaza:

Izaberite okidač koji može ručno da se pokrene.
Dodajte radnju Evidentiraj izlaz u tok posla i povežite je sa okidačem.
U konfiguraciji za Evidentiraj izlaz kliknite na Dodaj promenljivu da biste dodali promenljive koje želite da proverite u odeljku Izlaz.
Kada završite, kliknite na Uključi tok posla.
Pokrenite tok posla, bilo tako što ćete da ga pokrenete ručno ili tako što ćete aktivirati okidač. Na primer, ako koristite okidač Porudžbina je kreirana, kreirajte probnu porudžbinu.
Nakon što se tok posla izvrši, proverite dnevnik aktivnosti za te promenljive.

Pogledajte JSON stranicu resursa

Većina stranica resursa u Shopify adminu, kao što su stranice Porudžbina, Proizvod ili Kupac, omogućavaju vam da vidite podatke koji opslužuju tu stranicu. Ovi podaci nemaju potpuno ista imena i format kao oni koje koristi Shopify Flow, ali se vrednosti podudaraju sa onima u GraphQL Admin API-ju. Da biste pregledali podatke, dodajte .json u URL.

Na primer, idite do porudžbine tako što ćete u Shopify adminu preći na stranicu Porudžbine i kliknuti na nju. U adresnoj traci pregledača promenite adresu iz:

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

U sledeće:

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

Koristite GraphiQL ili API alat treće strane

Možete da direktno pošaljete upit API-ju koristeći API alat treće strane, kao što je Postman ili besplatan alat GraphiQL koji obezbeđuje Shopify. Ova opcija pruža najtačnije rezultate, ali zahteva određeno poznavanje kreiranja GraphQL upita.

Za GraphiQL, Shopify nudi i veb-istraživač GraphiQL sa generičkim podacima i aplikaciju GraphiQL. Pomoću GraphiQL-a možete da kreirate GraphQL upit koji se tačno podudara sa imenima polja u aplikaciji Shopify Flow. Vrednosti se takođe tačno podudaraju sa vašom prodavnicom ako koristite aplikaciju.

Korišćenjem ovog alata, pomoću stvarnih podataka o prodavnici možete tačno da utvrdite koje podatke koristi Shopify Flow. Na primer, kreirate sledeći upit:

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

U sledećim rezultatima promenljiva order / app / name prikazuje ime aplikacije za porudžbinu. U ovom slučaju je porudžbina kreirana iz aplikacije za radne verzije porudžbina, tako da je vrednost Draft Orders. Informacije o kanalu dostupne su samo za aplikaciju 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"
            }
          }
        }
      ]
    }
  }