Abi
Logi sisse

Rakenduses Shopify Flow kasutatavate API-andmete eelvaade

Enamik töövooge kasutab sinu poe andmeid, et saaksid neid tingimustes ja toimingutes kasutada. Shopify Flow pääseb poe andmetele juurde, kutsudes välja lahenduse GraphQL Admin API, mis annab sulle juurdepääsu peaaegu kõigile API väljadele.

Töövoo loomisel puutud sageli kokku API-l põhinevate väljanimede ja kirjeldustega, kuid sul võib olla vaja teada nende andmete väärtusi. Näiteks võid soovida teada rakenduse nime tellimuse puhul, mis loodi tellimuse mustandist. Lisaks võid soovida veenduda, et sinu töövoog väljastab andmeid, mida ootad, või oodatud vormingus.

Andmete väärtuste ülevaatamiseks on sul rakenduses Shopify Flow mitu võimalust.

Sellel lehel

Leia väli Shopify administraatoris

Enamikul juhtudel leiad andmeid, kui otsid neid Shopify administraatorist. Näiteks product.title on loetletud tootelehel.

Hangi näidisandmed

Töövoo loomisel saad näidisandmeid otse rakenduse Flow redaktorist. Kuna rakenduse Flow andmed pärinevad sündmustest, pead täpsete näidisandmete saamiseks alustama asjakohase sündmuse valimisest:

  1. Ava rakenduse Flow redaktoris toiming, kus soovid andmeid kasutada, ja klõpsa valikut Lisa muutuja. Teise võimalusena klõpsa tingimuses valikut Lisa kriteerium.
  2. Klõpsa valikut Seadista näidisandmed.
  3. Flow kuvab varasemad sündmused töövoo käivitaja põhjal. Viimaste käivituste sündmuste toomiseks klõpsa valikut Värskenda sündmusi või klõpsa valikut Alusta reaalajas sündmuste kuulamist ja käivita sündmus käsitsi administraatoris või asjakohases rakenduses (rakendusepõhiste käivitajate puhul).
  4. Pärast sündmuse toimumist kuvab Flow selle üksikasjad. Vali sündmus, mida soovid näidisandmete saamiseks kasutada. Klõpsa valikut Kasuta seda käivitaja sündmust.
  5. Nüüd peaks sündmusi sirvides iga muutuja kohta ilmuma näidisandmed.

Piirangud:

  • Ruumipiirangute tõttu kuvab Flow loendis olevate andmete puhul ainult loendi esimese üksuse andmeid.
  • Flow salvestab korraga kuni 5 sündmust iga töövoo kohta.
  • Flow ei suuda osade käivitajate (nt ajastatud aeg, loodud metaobjekti kirje, kliendi lisandumine segmenti või kliendi lahkumine segmendist) puhul eelmiste käivituste sündmusi tuua.

Kasuta välja aktiivses töövoos

Saad välju töövoos turvaliselt kasutada, kasutades toimingut Logi väljund. Töövoo käivitamisel kirjutab toiming Logi väljund muutujate ja teksti väljundi lehele Käivituste ajalugu. Lisaks võid kasutada teavituste toiminguid, nagu Saada sisemine e-kiri.

Toimingu „Logi väljund“ kasutamise sammud:

  1. Vali käivitaja, mida saab käivitada käsitsi.
  2. Lisa töövoogu toiming Logi väljund ja ühenda see käivitajaga.
  3. Toimingu Logi väljund seadistuses klõpsa valikut Lisa muutuja, et lisada jaotisse Väljund muutujad, mida soovid kontrollida.
  4. Kui oled lõpetanud, klõpsa valikut Lülita töövoog sisse.
  5. Aktiveeri töövoog, kas käivitades selle käsitsi või pannes käivitaja tööle. Näiteks kui kasutad käivitajat Tellimus on loodud, siis loo testtellimus.
  6. Pärast töövoo käivitamist kontrolli tegevuste logist muutujate olemasolu.

Vaata ressursi JSON-lehte

Enamik ressursilehti Shopify administraatoris, näiteks lehed Tellimus, Toode või Klient, võimaldavad sul vaadata lehte teenindavaid andmeid. Nende andmete nimed ja vorming ei kattu täpselt sellega, mida kasutab Shopify Flow, kuid väärtused vastavad liideses GraphQL Admin API olevatele väärtustele. Andmete ülevaatamiseks lisa URL-ile .json.

Näiteks mine tellimuse juurde, avades Shopify administraatoris lehe Tellimused ja klõpsates tellimust. Muuda oma brauseri aadressiribal lehe aadress järgmisest:

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

järgmiseks:

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

Kasuta GraphiQL-i või kolmanda osapoole API tööriista

Saad teha päringuid otse API-le, kasutades kolmanda osapoole API tööriista, näiteks Postman, või Shopify pakutavat tasuta tööriista GraphiQL. See valik annab kõige täpsemaid tulemusi, kuid see nõuab veidi teadmisi GraphQL-i päringute loomise kohta.

GraphiQL-i jaoks pakub Shopify nii veebipõhist GraphiQL-i uurijat üldiste andmetega kui ka GraphiQL-i rakendust. GraphiQL-i abil saad koostada GraphQL-i päringu, mis sobitub täpselt rakenduse Shopify Flow väljanimedega. Rakendust kasutades klapivad ka väärtused täpselt sinu poe andmetega.

Seda tööriista kasutades saad oma poe reaalsete andmete põhjal täpselt kindlaks teha, milliseid andmeid Shopify Flow kasutab. Näiteks lood järgmise päringu:

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

Järgmistes tulemustes kuvab muutuja order / app / name tellimuse jaoks kasutatud rakenduse nime. Sel juhul loodi tellimus tellimuste mustandite rakendusest, seega on väärtuseks Draft Orders. Kanali teave on saadaval ainult rakenduse Point of Sale puhul.

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