Priekšskatīt API datus, kas tiek izmantoti lietotnē Shopify Flow

Vairums darbplūsmu piekļūst tava veikala datiem, lai tos varētu izmantot nosacījumos un darbībās. Shopify Flow piekļūst veikala datiem, izsaucot GraphQL Admin API, un nodrošina tev piekļuvi gandrīz visiem API laukiem.

Veidojot darbplūsmu, tu bieži saskarsies ar lauku nosaukumiem un aprakstiem, kuru pamatā ir API, taču tev var būt nepieciešams zināt šo datu vērtības. Piemēram, tu varētu vēlēties uzzināt lietotnes nosaukumu pasūtījumam, kas izveidots no pasūtījuma melnraksta. Turklāt tu, iespējams, gribēsi pārliecināties, ka tava darbplūsma izvada gaidītos datus vai izmanto gaidīto formātu.

Lai pārskatītu datu vērtības, rīkā Shopify Flow tev ir pieejamas vairākas iespējas.

Lauka atrašana Shopify administrēšanas panelī

Lielākoties datus var atrast, meklējot tos Shopify administrēšanas panelī. Piemēram, product.title ir norādīts Produkta lapā.

Paraugdatu iegūšana

Veidojot darbplūsmu, vari iegūt paraugdatus tieši rīka Shopify Flow redaktorā. Tā kā Shopify Flow dati tiek iegūti no notikumiem, lai iegūtu precīzus paraugdatus, vispirms ir jāizvēlas atbilstošs notikums:

1. Rīka Shopify Flow redaktorā atver darbību, kurā vēlies izmantot datus, un noklikšķini uz Pievienot mainīgo. Vai arī nosacījumā noklikšķini uz Pievienot kritēriju.
2. Noklikšķini uz Konfigurēt paraugdatus.
3. Rīkā Shopify Flow tiek parādīti iepriekšējie notikumi, pamatojoties uz darbplūsmas trigeri. Noklikšķini uz Atsvaidzināt notikumus, lai iegūtu notikumus no pēdējām izpildēm, vai noklikšķini uz Sākt reāllaika notikumu uztveršanu un pēc tam manuāli aktivizē notikumu administrēšanas panelī vai atbilstošajā lietotnē (uz lietotnēm balstītiem trigeriem).
4. Pēc notikuma iestāšanās rīkā Shopify Flow tiks parādīta informācija par šo notikumu. Izvēlies notikumu, kuru vēlies izmantot paraugdatu iegūšanai. Noklikšķini uz Izmantot šo trigera notikumu.
5. Tagad, pārlūkojot notikumus, pie katra mainīgā tiks parādīti paraugdati.

Ierobežojumi:

• Vietas ierobežojumu dēļ sarakstā esošiem datiem rīkā Shopify Flow tiks parādīti dati tikai no saraksta pirmā vienuma.
• Rīks Shopify Flow katrai darbplūsmai vienlaikus saglabās līdz 5 notikumiem.
• Rīks Shopify Flow nevar iegūt notikumus no nesenām izpildēm noteiktiem trigeriem, piemēram, Ieplānotais laiks, Izveidots metaobjekta ieraksts, Klients pievienojies segmentam vai Klients izstājies no segmenta.

Lauka izmantošana aktīvā darbplūsmā

Laukus darbplūsmā var droši izmantot, liekot lietā darbību Reģistrēt izvadi. Kad izpildi darbplūsmu, darbība Reģistrēt izvadi izdrukās jebkuru mainīgo lielumu un teksta izvadi lapā Izpilžu vēsture. Vari izmantot arī paziņojumu darbības, piemēram, Nosūtīt iekšēju e-pastu.

Darbības „Reģistrēt izvadi” izmantošanas soļi:

1. Izvēlies trigeri, kuru var aktivizēt manuāli.
2. Darbplūsmai pievieno darbību Reģistrēt izvadi un savieno to ar trigeri.
3. Konfigurācijā Reģistrēt izvadi noklikšķini uz Pievienot mainīgo, lai sadaļai Izvade pievienotu mainīgos, kurus vēlies pārbaudīt.
4. Kad tas ir paveikts, noklikšķini uz Ieslēgt darbplūsmu.
5. Aktivizē darbplūsmu, vai nu izpildot to manuāli, vai izraisot trigera aktivizēšanos. Piemēram, ja izmanto trigeri Izveidots pasūtījums, izveido testa pasūtījumu.
6. Pēc darbplūsmas izpildes pārbaudi mainīgos aktivitāšu žurnālā.

Resursa JSON lapas apskatīšana

Lielākā daļa Shopify administrēšanas paneļa resursu lapu, piemēram, lapas Pasūtījums, Produkts vai Klients, ļauj skatīt datus, kas apkalpo šo lapu. Šiem datiem nav tieši tādi paši nosaukumi un formāts, kādu izmanto rīks Shopify Flow, taču vērtības atbilst GraphQL Admin API esošajām. Lai pārskatītu datus, pievieno URL beigās .json.

Piemēram, pārej uz pasūtījumu, Shopify administrēšanas panelī atverot lapu Pasūtījumi un noklikšķinot uz pasūtījuma. Pārlūkprogrammas adreses joslā maini lapas adresi no:

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

uz šādu:

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

Piezīme

Formātā .json tiek izmantots REST API. Mainīgo nosaukumu reģistrā REST API tiek izmantotas zemsvītras, piemēram, line_items. Sistēmā GraphQL un rīkā Shopify Flow tiek izmantots camelCase (kamieļreģistrs), piemēram, lineItems. Turklāt reizēm atšķiras lauku nosaukumi, piemēram, tiek izmantots properties, nevis customAttributes. Pārbaudi informāciju, ko atrodi, izmantojot šo pieeju.

GraphiQL vai trešās puses API rīka izmantošana

API var vaicāt tieši, izmantojot trešās puses API rīku, piemēram, Postman, vai Shopify nodrošināto bezmaksas rīku GraphiQL. Šī opcija sniedz visprecīzākos rezultātus, taču tās izmantošanai ir nepieciešamas iemaņas GraphQL vaicājumu veidošanā.

Rīkam GraphiQL Shopify piedāvā gan tīmekļa GraphiQL pārlūku ar vispārīgiem datiem, gan lietotni GraphiQL. Ar rīku GraphiQL vari izveidot GraphQL vaicājumu, kas precīzi atbilst lauku nosaukumiem rīkā Shopify Flow. Izmantojot lietotni, arī vērtības precīzi atbildīs tava veikala datiem.

Izmantojot šo rīku, tu vari precīzi noteikt, kādus datus izmanto rīks Shopify Flow ar taviem reālajiem veikala datiem. Piemēram, tu izveido šādu vaicājumu:

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

Tālāk norādītajos rezultātos mainīgais order / app / name parāda pasūtījuma lietotnes nosaukumu. Šajā gadījumā pasūtījums tika izveidots no pasūtījumu melnrakstu lietotnes, tāpēc vērtība ir Draft Orders. Informācija par kanālu ir pieejama tikai lietotnei 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"
            }
          }
        }
      ]
    }
  }