Súgó
Bejelentkezés

A Shopify Flow-ban használt API-adatok előnézete

A legtöbb munkafolyamat hozzáfér az üzlete adataihoz, hogy Ön felhasználhassa azokat a feltételekben és műveletekben. A Shopify Flow az üzlet adatait a GraphQL Admin API meghívásával éri el, így hozzáférést biztosít az API szinte összes mezőjéhez.

Egy munkafolyamat létrehozása során gyakran találkozhat API-alapú mezőnevekkel és leírásokkal, de szükség lehet az adatok értékeinek ismeretére is. Előfordulhat például, hogy tudni szeretné egy olyan rendelés alkalmazásnevét, amely egy rendelési vázlatból jött létre. Emellett érdemes meggyőződnie arról, hogy a munkafolyamat a várt adatokat, illetve a várt formában adja ki.

Az adatok értékeinek áttekintésére több lehetősége is van a Shopify Flow-ban.

Ezen az oldalon

Mező keresése a Shopify adminisztrációs felületén

A legtöbb esetben az adatokat a Shopify adminisztrációs felületén találja meg. Például a product.title a Termék oldalon található.

Mintaadatok lekérése

Egy munkafolyamat létrehozásakor közvetlenül a Flow-szerkesztőben kérhet le mintaadatokat. Mivel a Flow adatai eseményekből származnak, a pontos mintaadatok lekéréséhez először ki kell választania egy releváns eseményt:

  1. A Flow-szerkesztőben nyisson meg egy műveletet, ahol használni szeretné az adatokat, és kattintson a Változó hozzáadása gombra. Alternatív megoldásként egy feltételben kattintson a Kritériumok hozzáadása gombra.
  2. Kattintson a Mintaadatok konfigurálása gombra.
  3. A Flow megjeleníti a korábbi eseményeket a munkafolyamat kiváltója alapján. Kattintson az Események frissítése gombra a legutóbbi futtatások eseményeinek lekéréséhez, vagy kattintson az Élő események figyelésének indítása gombra, majd manuálisan váltsa ki az eseményt az adminisztrációs felületen vagy a megfelelő alkalmazásban (alkalmazásalapú kiváltók esetén).
  4. Az esemény bekövetkezése után a Flow megjeleníti az esemény részleteit. Válassza ki azt az eseményt, amelyet mintaadatok lekéréséhez szeretne használni. Kattintson a Kiváltó esemény használata gombra.
  5. Mostantól az események böngészése közben minden változóhoz meg kell jelennie a mintaadatoknak.

Korlátozások:

  • Helyszűke miatt a listában szereplő adatok esetében a Flow csak a lista első tételének adatait jeleníti meg.
  • A Flow munkafolyamatonként egyszerre legfeljebb 5 eseményt tárol.
  • A Flow bizonyos kiváltók, például az Időzített időpont, a Metaobjektum-bejegyzés létrehozva, a Vásárló szegmenshez csatlakozott vagy a Vásárló elhagyta a szegmenst esetében nem tudja lekérni a legutóbbi futtatások eseményeit.

A mező használata éles munkafolyamatban

Biztonságosan használhatja a mezőket egy munkafolyamatban a Naplókimenet művelet segítségével. Amikor egy munkafolyamatot futtat, a Naplókimenet művelet a változók és szövegek kimenetét a Futtatási előzmények oldalra írja. Használhat értesítési műveleteket is, például a Belső e-mail küldése műveletet.

A Naplókimenet használatának lépései:

  1. Válasszon egy olyan kiváltót, amely manuálisan is elindítható.
  2. Adjon hozzá egy Naplókimenet műveletet a munkafolyamathoz, és kapcsolja össze a kiváltóval.
  3. A Naplókimenet konfigurációjában kattintson a Változó hozzáadása gombra, hogy a vizsgálni kívánt változókat hozzáadja a Kimenet szakaszhoz.
  4. Ha végzett, kattintson a Munkafolyamat bekapcsolása gombra.
  5. Indítsa el a munkafolyamatot, akár manuális futtatással, akár a kiváltó aktiválásával. Ha például a Rendelés létrehozva kiváltót használja, hozzon létre egy próbarentelést.
  6. A munkafolyamat lefutása után ellenőrizze a változókat a tevékenységnaplóban.

Hivatkozás az erőforrás JSON-oldalára

A Shopify adminisztrációs felületének legtöbb erőforrásoldala, például a Rendelés, a Termék vagy a Vásárló oldal lehetővé teszi az oldalt kiszolgáló adatok megtekintését. Ezeknek az adatoknak az elnevezése és formátuma nem pontosan egyezik meg a Shopify Flow által használtakkal, de az értékek megegyeznek a GraphQL Admin API-ban találhatókkal. Az adatok áttekintéséhez adjon hozzá egy .json végződést az URL-hez.

Például navigáljon egy rendeléshez úgy, hogy a Shopify adminisztrációs felületén a Rendelések oldalra lép, és rákattint egy rendelésre. A böngésző címsorában módosítsa az oldal címét a következőről:

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

A következőre:

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

A GraphiQL vagy egy harmadik féltől származó API-eszköz használata

Közvetlenül lekérdezheti az API-t egy harmadik féltől származó API-eszközzel, például a Postmannel vagy az ingyenes, Shopify által biztosított GraphiQL eszközzel. Ez a lehetőség adja a legpontosabb eredményeket, de ehhez némi jártasság szükséges a GraphQL-lekérdezések létrehozásában.

A GraphiQL-hez a Shopify egy általános adatokkal rendelkező webalapú GraphiQL explorert és a GraphiQL alkalmazást is kínálja. A GraphiQL segítségével olyan GraphQL-lekérdezést hozhat létre, amely pontosan megfelel a Shopify Flow mezőneveinek. Az értékek is pontosan megegyeznek az üzletében lévőkkel, ha az alkalmazást használja.

Ennek az eszköznek a használatával, az üzlete valós adataival pontosan meghatározhatja, hogy a Shopify Flow milyen adatokat használ. Például létrehozhatja a következő lekérdezést:

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

A következő eredményekben az order / app / name változó a rendeléshez tartozó alkalmazás nevét jeleníti meg. Ebben az esetben a rendelés a „Draft Orders” alkalmazásból jött létre, így az érték Draft Orders. A csatornaadatok csak a „Point of Sale” alkalmazás esetében érhetők el.

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