Shopify Flow és GraphQL Admin API

A Flow a Shopify GraphQL Admin API-t használja olyan automatizálások és integrációk létrehozására, amelyek kibővítik és fejlesztik a Shopify adminisztrációs felületét. A Flow az API 2026-01-es verzióját használja a munkafolyamatokban lévő feltételek és változók kiértékelésére, valamint műveletek végrehajtására a Shopify-üzletében. Mivel a Flow az API meghívásával fér hozzá az üzlet adataihoz, a Flow-ból szinte az összes, az API-ban elérhető mezőhöz hozzáférhet.

Mivel a Shopify 3 havonta új API-verziókat ad ki, szükség lehet egyes munkafolyamatok frissítésére, amikor a mezők megváltoznak vagy elavulttá válnak.

A GraphQL Admin API használata a munkafolyamatokban

A Flow-ban a legtöbb művelet a GraphQL Admin API-t használja a Shopify-üzlet módosításához. Például a Rendelési címkék hozzáadása művelet a tagsAdd mutációt használja. Az Admin API-kérelem küldése művelet a legtöbb mutációt használhatja, beleértve azokat is, amelyek még nem érhetők el műveletként a Flow-ban.

A munkafolyamatok létrehozása során gyakran fog találkozni a GraphQL Admin API szintaxisán alapuló mezőnevekkel és leírásokkal. Például egy változat teljes értékesíthető mennyiségének meghatározásához egy munkafolyamatban a variants_item.inventoryQuantity változót kell használnia. Annak a helyszínnek a meghatározásához pedig, ahol egy vásárló feliratkozott az Ön e-mailes hírlevelére, az emailSubscriptionMethod változót kell használnia.

Nem kell jártasnak lennie az API-ban ahhoz, hogy munkafolyamatokat hozzon létre a Flow alkalmazással, de a változónevek és definícióik megértése segíthet Önnek abban, hogy pontosan a kívánt munkafolyamat-logikát építse fel. Például, ha ismeri a különbséget egy vásárló displayName és firstName tulajdonsága között, az segíthet, hogy a munkafolyamata a megfelelő adatokhoz férjen hozzá, attól függően, hogy mire szeretné használni azokat. A munkafolyamat felépítése során minden változóhoz tartozik definíció, és az ikonra kattintva többet is megtudhat bármelyik változóról vagy definícióról.

Üzletadatok és a GraphQL Admin API

A munkafolyamatok az üzletéből származó adatokat használják a feltételekben és a műveletekben. A Flow a GraphQL Admin API segítségével fér hozzá az üzlet adataihoz, ami azt jelenti, hogy Ön hozzáfér az API szinte összes mezőjéhez. Ha egy művelet nem rendelkezik a kiváltó vagy egy Adatok lekérése művelet által biztosított szükséges adatokkal, akkor a munkafolyamat nem fut le, és egy hibaüzenet jelenik meg.

Például egy munkafolyamat egy Vásárló létrehozva kiváltóval indul, és vásárlói adatokat importál a munkafolyamatba. Ha ezt a kiváltót egy Rendelési címkék hozzáadása művelet követi, amely rendelési adatokat igényel, nem pedig vásárlói adatokat, akkor a munkafolyamat hiányzó adatok miatti hibát fog eredményezni.

Előfordulhat, hogy meg kell tekintenie az adatok előnézetét vagy át kell tekintenie az API-dokumentációt, hogy megértse, mit ad ki az API és mit használ a Flow, és hogy megbizonyosodjon arról, hogy a munkafolyamata az Ön által elvárt adatokat adja ki.

Mezőargumentumok és GraphQL Admin API

Bizonyos GraphQL Admin API-mezők argumentumokat – olyan további paramétereket – igényelnek, amelyek szűkítik a visszaadott adatokat. Például a product.inCollection mezőhöz meg kell adni egy kollekció-id (azonosító) argumentumot, hogy tudja, melyik kollekciót kell vizsgálnia. Enélkül a mező nem tud eredményt visszaadni.

A Flow-ban a szükséges argumentumérték megadásával e mezőkből változókat hozhat létre, amelyeket aztán a munkafolyamatban is felhasználhat. A változóhoz egyéni nevet is hozzárendelhet, hogy a későbbi lépésekben könnyebb legyen hivatkozni rá. Például a product.inCollection(id: "gid://shopify/Collection/123456") nevet product.inSummerBestsellers-re módosíthatja.

További információ az argumentummal rendelkező mezőkből történő változólétrehozásról.

A metamezőkből történő változólétrehozás további információkat igényel a Flow-ban, mivel az egyes metamezők névterét és kulcsát Ön határozza meg, így az argumentumok mindig egyediek az adott üzletre nézve. További információ a Flow metamezőiről.

API-verziókezelés

A Shopify 3 havonta új API-verziókat ad ki, és a Flow a lehető leghamarabb átveszi az új verziókat, de előfordulhat, hogy lemarad a legújabb verzióhoz képest. Amikor lehetséges, a verziók közötti változások automatikusan megoldódnak, de egyes változások nem feltétlenül egyértelműek, beleértve a következő helyzeteket is:

• Amikor a mezőket eltávolítják, de nem biztosítanak helyettesítőt, ami befolyásolhatja a feltételek vagy a Liquid kiértékelését.
• Amikor a mezők null értékűvé válnak, ami befolyásolhatja a feltételek vagy a Liquid kiértékelését.
• Amikor az enum értékek megváltoznak, vagy új union vagy interface típusok kerülnek hozzáadásra, ami befolyásolhatja a Liquid-et vagy a kódot.
• Amikor a mutációs argumentumok megváltoznak, ami befolyásolhatja az Admin API-kérelem küldése műveletek konfigurációját.

Előfordulhat, hogy egyes munkafolyamatokat manuálisan kell frissíteni. Ilyen esetekben a munkafolyamatok Frissítés szükséges vagy Nem támogatott API hibaüzenetet jeleníthetnek meg, és elvezetik Önt a releváns API-dokumentációhoz, hogy elvégezze a szükséges módosításokat a munkafolyamat-szerkesztőben. Amikor ezek a frissítések befejeződtek és mentésre kerültek, a munkafolyamat automatikusan frissül a Flow-ban elérhető legújabb API-verzió használatára.

Dönthet úgy, hogy ideiglenesen figyelmen kívül hagyja a problémákat, hogy sürgős módosításokat hajtson végre egy olyan munkafolyamaton, amely API-verziókompatibilitási hibákat tartalmaz. Ha ezeket a problémákat nem oldja meg, a munkafolyamat leállhat, vagy hibákat okozhat, amikor a régebbi API-verziót a Shopify már nem támogatja.