Shopify Flow'ssa käytettävän API-datan esikatselu

Useimmat työnkulut käyttävät kauppasi dataa, jotta voit hyödyntää sitä ehdoissa ja toiminnoissa. Shopify Flow käyttää kaupan dataa kutsumalla GraphQL Admin API -rajapintaa, mikä antaa sinulle pääsyn lähes kaikkiin API-rajapinnan kenttiin.

Työnkulkua luodessasi törmäät usein API-pohjaisiin kenttien nimiin ja kuvauksiin, mutta sinun on ehkä tiedettävä kyseisen datan arvot. Voit esimerkiksi haluta tietää sen sovelluksen nimen, jota käytettiin tilausluonnoksesta luodun tilauksen tekemiseen. Lisäksi saatat haluta varmistaa, että työnkulkusi tuottaa odottamasi datan odotetussa muodossa.

Shopify Flow'ssa on useita vaihtoehtoja datan arvojen tarkastelemiseen.

Tällä sivulla

Kentän etsiminen Shopifyn ohjausnäkymästä

Useimmissa tapauksissa löydät datan Shopifyn ohjausnäkymästä. Esimerkiksi product.title on lueteltu tuotesivulla.

Hae esimerkkidataa

Kun luot työnkulkua, voit hakea näytedataa suoraan Flow-editorista. Koska Flow'n data tulee tapahtumista, sinun on aloitettava valitsemalla asiaankuuluva tapahtuma, jotta saat tarkkaa näytedataa:

Avaa Flow'n editorissa toiminto, jossa haluat käyttää dataa, ja klikkaa Lisää muuttuja. Vaihtoehtoisesti voit klikata ehdossa Lisää kriteerit.
Klikkaa Määritä näytedata.
Flow näyttää aiemmat tapahtumat työnkulun käynnistimen perusteella. Hae viimeisimpien suoritusten tapahtumat klikkaamalla Päivitä tapahtumat tai aloita live-tapahtumien kuuntelu klikkaamalla Aloita live-tapahtumien kuuntelu ja käynnistä sitten tapahtuma manuaalisesti ohjausnäkymässä tai asianomaisessa sovelluksessa (sovelluspohjaisille käynnistimille).
Kun tapahtuma on suoritettu, Flow näyttää tapahtuman tiedot. Valitse tapahtuma, jota haluat käyttää näytedatan hakemiseen. Klikkaa Käytä tätä käynnistintapahtumaa.
Nyt kun selaat tapahtumia, kunkin muuttujan näytedatan pitäisi tulla näkyviin.

Rajoitukset:

Tilarajoitusten vuoksi Flow näyttää luettelon datasta vain ensimmäisen tuotteen tiedot.
Flow tallentaa enintään 5 tapahtumaa kerrallaan työnkulkua kohti.
Flow ei voi hakea viimeisimpien suoritusten tapahtumia joillekin käynnistimille, kuten Ajastettu aika, Metaobjektimerkintä luotu, Asiakas liittyi segmenttiin tai Asiakas poistui segmentistä.

Kentän käyttäminen live-työnkulussa

Voit käyttää kenttiä turvallisesti työnkulussa käyttämällä Kirjaa tuloste -toimintoa. Kun suoritat työnkulun, Kirjaa tuloste -toiminto tulostaa muuttujien ja tekstien tulosteet Suoritushistoria-sivulle. Voit myös käyttää ilmoitustoimintoja, kuten Lähetä sisäinen sähköposti.

Kirjaa tuloste -toiminnon käyttövaiheet:

Valitse käynnistin, jonka voi käynnistää manuaalisesti.
Lisää Kirjaa tuloste -toiminto työnkulkuun ja yhdistä se käynnistimeen.
Klikkaa Kirjaa tuloste -toiminnon määrityksissä Lisää muuttuja lisätäksesi tarkasteltavat muuttujat Tuloste-osioon.
Kun olet valmis, klikkaa Ota työnkulku käyttöön.
Käynnistä työnkulku joko suorittamalla se manuaalisesti tai aiheuttamalla käynnistimen laukeaminen. Jos esimerkiksi käytät Tilaus luotu -käynnistintä, luo testitilaus.
Kun työnkulku on suoritettu, tarkista muuttujat toimintalokista.

Resurssin JSON-sivun käyttäminen

Useimmilla Shopifyn ohjausnäkymän resurssisivuilla, kuten Tilaus-, Tuote- tai Asiakas-sivuilla, voit tarkastella sivua palvelevaa dataa. Tämän datan nimeämiskäytäntö ja muoto eivät ole täysin samat kuin Shopify Flow'ssa, mutta arvot vastaavat GraphQL Admin APIn arvoja. Voit tarkastella dataa lisäämällä URL-osoitteeseen .json.

Siirry esimerkiksi tilaukseen menemällä Shopifyn ohjausnäkymässä Tilaukset-sivulle ja klikkaamalla tilausta. Muuta selaimen osoiterivillä oleva osoite muodosta:

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

muotoon:

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

GraphiQL:n tai kolmannen osapuolen API-työkalun käyttäminen

Voit tehdä kyselyitä suoraan APIin käyttämällä kolmannen osapuolen API-työkalua, kuten Postmania, tai Shopifyn tarjoamaa ilmaista työkalua, GraphiQL:ää. Tämä vaihtoehto antaa tarkimmat tulokset, mutta se edellyttää jonkin verran perehtyneisyyttä GraphQL-kyselyiden luomiseen.

Shopify tarjoaa GraphiQL:ää varten sekä yleistä dataa sisältävän verkkopohjaisen GraphiQL explorerin että GraphiQL-sovelluksen. GraphiQL:n avulla voit luoda GraphQL-kyselyn, joka vastaa täsmälleen Shopify Flow'n kenttien nimiä. Arvot vastaavat myös täsmälleen kauppasi arvoja, jos käytät sovellusta.

Tämän työkalun avulla voit selvittää tarkalleen, mitä dataa Shopify Flow käyttää, oman kauppasi todellisella datalla. Voit esimerkiksi luoda seuraavan kyselyn:

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

Seuraavissa tuloksissa muuttuja order / app / name näyttää tilauksen sovelluksen nimen. Tässä tapauksessa tilaus luotiin tilausluonnossovelluksella, joten arvo on Draft Orders. Kanavatiedot ovat saatavilla vain Point of Sale -sovellukselle.

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