Aurreikusi Shopify Flow-en erabiltzen diren API datuak

Lan-fluxu gehienak zure dendako datuetara sartzen dira, datu horiek baldintza eta ekintzetan erabil ditzazun. Shopify Flow aplikazioak dendako datuak eskuratzen ditu GraphQL Admin API-ari dei eginez, horrela APIko ia eremu guztietara sartzeko aukera izan dezazun.

Lan-fluxu bat sortzen ari zarela, sarritan APIan oinarritutako eremu-izenak eta deskribapenak aurkituko dituzu, baina agian datu horien balioak ezagutu beharko dituzu. Adibidez, eskaera-zirriborro batetik sortutako eskaera baten aplikazioaren izena jakin nahiko duzu beharbada. Horrez gain, baliteke ziurtatu nahi izatea lan-fluxuak espero dituzun datuak ematen dituela, edo espero duzun formatuan ematen dituela.

Datuen balioak berrikusteko, hainbat aukera dituzu Shopify Flow-n.

Bilatu eremu bat Shopify-ko administratzailean

Kasu gehienetan, datuak Shopify-ko administratzailean begiratuta aurki ditzakezu. Adibidez, product.title Produktu orrian ageri da.

Lortu lagin-datuak

Lan-fluxu bat eraikitzean, lagin-datuak zuzenean eskura ditzakezu Flow editorean. Flow-ren datuak gertaeretatik datozenez, lagin-datu zehatzak lortzeko, gertaera garrantzitsu bat aukeratuz hasi behar duzu:

1. Flow-ren editorean, ireki datuak erabili nahi dituzun ekintza bat eta sakatu Gehitu aldagaia. Bestela, baldintza batean, sakatu Gehitu irizpidea.
2. Sakatu Konfiguratu lagin-datuak.
3. Flow-k aurreko gertaerak erakusten ditu lan-fluxuaren abiarazlean oinarrituta. Sakatu Freskatu gertaerak azken exekuzioetako gertaerak eskuratzeko, edo sakatu Hasi zuzeneko gertaerak entzuten eta, ondoren, abiarazi gertaera eskuz Administratzailean edo dagokion aplikazioan (aplikazioetan oinarritutako abiarazleen kasuan).
4. Gertaera jazo ondoren, Flow-k gertaerari buruzko xehetasunak erakutsiko ditu. Aukeratu lagin-datuak lortzeko erabili nahi duzun gertaera. Sakatu Erabili abiarazlearen gertaera hau.
5. Orain, gertaeretan arakatzen duzun heinean, lagin-datuak agertuko dira aldagai bakoitzeko.

Mugak:

• Espazio-mugak direla eta, zerrenda bateko datuen kasuan, Flow-k zerrendako lehen elementuaren datuak soilik erakutsiko ditu.
• Flow-k gehienez 5 gertaera gordeko ditu aldi berean lan-fluxuko.
• Flow-k ezin du azken exekuzioetako gertaerarik eskuratu abiarazle batzuetarako; adibidez, Programatutako ordua, Metaobjektu-sarrera sortu da, Bezeroa segmentura batu da edo Bezeroak segmentua utzi du abiarazleetarako.

Erabili eremua zuzeneko lan-fluxu batean

Eremuak segurtasunez erabil ditzakezu lan-fluxu batean, Erregistratu irteera ekintza erabiliz. Lan-fluxu bat exekutatzean, Erregistratu irteera ekintzak edozein aldagairen eta testuren irteera inprimatuko du Exekuzioen historia orrian. Jakinarazpen-ekintzak ere erabil ditzakezu, esaterako, Bidali barneko mezu elektronikoa.

Erregistratu irteera ekintza erabiltzeko urratsak:

1. Aukeratu eskuz abiaraz daitekeen abiarazle bat.
2. Gehitu Erregistratu irteera ekintza bat lan-fluxuari eta konektatu abiarazlearekin.
3. Erregistratu irteera konfigurazioan, sakatu Gehitu aldagaia aztertu nahi dituzun aldagaiak Irteera atalean gehitzeko.
4. Amaitutakoan, sakatu Aktibatu lan-fluxua.
5. Abiarazi lan-fluxua, izan eskuz exekutatuz edo abiarazlea abiaraziz. Adibidez, Eskaera sortu da abiarazlea erabiltzen ari bazara, sortu probako eskaera bat.
6. Lan-fluxua exekutatu ondoren, egiaztatu aldagaien jarduera-erregistroa.

Kontsultatu baliabidearen JSON orria

Shopify-ko administratzaileko baliabide-orri gehienek, adibidez Eskaera, Produktua edo Bezeroa orriek, orria hornitzen duten datuak ikusteko aukera ematen dizute. Datu horiek ez dute Shopify Flow-k erabiltzen duen izendapen eta formatu bera, baina balioak bat datoz GraphQL Admin APIn dagoenarekin. Datuak berrikusteko, gehitu .json URLari.

Adibidez, eskaera batera joateko, joan Shopify-ko administratzaileko Eskaerak orrira eta sakatu eskaera batean. Nabigatzailearen helbide-barran, aldatu orriaren helbidea hemendik:

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

Hona:

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

Oharra

.json formatuak REST APIa jarraitzen du. REST APIn aldagaien izenetan azpimarrak erabiltzen dira, esaterako line_items. GraphQLek eta Shopify Flow-k, aldiz, CamelCase erabiltzen dute, adibidez, lineItems. Gainera, batzuetan eremu-izenak desberdinak dira, esaterako, properties, customAttributes izan beharrean. Egiaztatu ikuspegi honen bidez aurkitzen duzun informazioa.

Erabili GraphiQL edo hirugarrenen API tresna bat

Zuzenean egin diezaiokezu kontsulta APIari hirugarrenen API tresna bat erabiliz, adibidez Postman, edo Shopifyk eskaintzen duen GraphiQL doako tresna erabiliz. Aukera horrek emaitza zehatzenak ematen ditu, baina GraphQL kontsultak sortzen jakitea eskatzen du.

GraphiQLerako, Shopifyk datu generikoak dituen webean oinarritutako GraphiQL esploratzailea eta GraphiQL aplikazioa eskaintzen ditu. GraphiQL bidez, GraphQL kontsulta bat eraiki dezakezu Shopify Flow-ko eremu-izenekin guztiz bat datorrena. Aplikazioa erabiltzen baduzu, balioak ere bat etorriko dira zure dendakoekin.

Tresna hori erabiliz, zehazki jakin dezakezu Shopify Flow-k zer datu erabiltzen dituen zure dendako benetako datuekin. Adibidez, honako kontsulta hau sortzen baduzu:

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

Honako emaitza hauetan, order / app / name aldagaiak eskaeraren aplikazioaren izena erakusten du. Kasu honetan, eskaera eskaera-zirriborroen aplikaziotik sortu zen, beraz, balioa Draft Orders da. Kanalari buruzko informazioa Point of Sale aplikaziorako soilik dago erabilgarri.

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