Upotreba polja API-ja s argumentima u aplikaciji Shopify Flow za izradu varijabli

Određene varijable zahtijevaju dodatne parametre kako bi pravilno funkcionirale u tijeku rada za Shopify Flow. Ti su parametri argumenti kojima morate navesti vrijednosti kako bi se varijabla smatrala potpunom i upotrebljivom za tijek rada.

Na primjer, polje product.inCollection određuje nalazi li se proizvod u navedenoj kolekciji ili ne te vraća booleovski rezultat true (istina) ili false (laž). Međutim, mora se uključiti argument kolekcije id za to polje jer u protivnom varijabla neće znati koju točno kolekciju treba provjeriti. Da biste pravilno upotrijebili to polje, morate uključiti argument kao dio polja. Na primjer, postavljanjem upita product.inCollection(id: "gid://shopify/Collection/123456") aplikacija Flow može utvrditi je li proizvod u kolekciji s ID-jem 123456 i zatim vratiti rezultat true ili false, kako se i očekuje. Prilikom izrade varijabli u aplikaciji Shopify Flow ne morate tražiti vrijednosti kao što su ID-jevi proizvoda ili kolekcije. Flow nudi kontrolu za odabir resursa pomoću koje birate željenu vrijednost, a ID se popunjava automatski.

Da biste pojednostavnili postavljanje upita za polja s argumentima, možete dodijeliti novo ime varijabli koju izradite iz polja i argumenta u aplikaciji Shopify Flow. Na primjer, ako je naziv kolekcije s ID-jem 123456 Summer Bestsellers (Ljetni bestseleri), tada varijabli inCollection(id: "gid://shopify/Collection/123456") možete dodijeliti jednostavnije ime inSummerBestsellers. Zatim, u svim sljedećim koracima tijeka rada možete jednostavno upotrijebiti varijablu product.inSummerBestsellers.

Budući da se argumenti razlikuju ovisno o vrijednostima koje su im dodijeljene, od jednog polja koje zahtijeva argumente možete izraditi više novih varijabli. Na primjer, možete izraditi tri jedinstvene varijable samo na temelju polja product.inCollection:

• product.inCollection(id: "gid://shopify/Collection/123456") mogla bi biti product.inSummerBestsellers.
• product.inCollection(id: "gid://shopify/Collection/654321") mogla bi biti product.inSwimwear.
• product.inCollection(id: "gid://shopify/Collection/112233") mogla bi biti product.inBeachAccessories.

Podržana polja za GraphQL Admin API u aplikaciji Shopify Flow

Aplikacija Shopify Flow podržava sljedeća polja u sučelju GraphQL Admin API uz obavezne argumente:

• channel.hasCollection
• collection.hasProduct
• collection.publishedOnChannel
• collection.publishedOnPublication
• companyLocation.inCatalog
• inventoryItem.inventoryLevel
• location.inventoryLevel
• metaobject.field
• market.assignedCustomization
• marketLocalizableResource.marketLocalizations
• product.inCollection
• product.publishedOnChannel
• product.publishedOnPublication
• product.restrictedForResource
• publication.hasCollection
• publishable.publishedOnChannel
• publishable.publishedOnPublication
• sellingPlanGroup.appliesToProduct
• sellingPlanGroup.appliesToProductVariant
• sellingPlanGroup.appliesToProductVariants
• 20 polja vrste translations, kao što su collection.translations i product.translations

Nepodržana polja za GraphQL Admin API u aplikaciji Shopify Flow

Aplikacija Shopify Flow ne podržava sljedeća polja:

• deliveryCarrierService.availableServicesForCountries
• inventoryLevel.quantities
• return.suggestedFinancialOutcome
• return.suggestedRefund
• shop.search

Da biste u svom tijeku rada mogli upotrijebiti podatke iz ovih nepodržanih polja, morate upotrijebiti radnju Slanje HTTP zahtjeva.

Izrada varijable iz polja s argumentom

U aplikaciji Shopify Flow možete izraditi varijablu za bilo koje podržano polje koje zahtijeva argument. Trebate izraditi varijablu samo jedanput u jednom tijeku rada jer će ona ostati dostupna kao opcija u svim sljedećim koracima u tijeku rada.

Varijabla koju izradite ne dijeli se s drugim tijekovima rada pa je za upotrebu u drugom tijeku rada morate ponovno dodati.

Koraci:

1. U tijeku rada za Shopify Flow kliknite Dodaj varijablu u radnji ili uvjetu.
2. Odaberite polje za koje je potreban argument. Ta polja prikazuju gumb +. Zatim kliknite + Izradi varijablu.
3. U dijaloškom okviru Izradi varijablu poduzmite sljedeće korake:
   1. Na temelju odabranog polja postavite vrijednost za traženi argument.
   2. Neobavezno: u polju Naziv nove varijable prilagodite željeni naziv nove varijable. Taj se naziv primjenjuje samo na trenutačni tijek rada.
   3. Kliknite Dodaj za osvježavanje ploče za odabir varijable.

Nakon dodavanja nove varijable u tijek rada, ona ostaje dostupna kao opcija polja te se u sljedećim koracima možete brzo referirati na nju. Pri odabiru opcije Dodaj varijablu, prikazuje se ugniježđena ispod izvorne opcije polja na popisu polja.

Izrada varijable iz metapolja u aplikaciji Shopify Flow

Metapolja su vrsta varijable s poljima za koja su potrebni argumenti. Dohvaćanje podataka metapolja u tijeku rada za Shopify Flow malo se razlikuje od dohvaćanja standardnih podataka polja u drugim varijablama jer sami izrađujete i definirate vrijednosti za namespace i key metapolja, pa su one uvijek jedinstvene za vašu trgovinu.

Primjerice, polje product.inCollection uvijek zahtijeva argument id, bez obzira na to u kojoj trgovini radite. Međutim, budući da za svako metapolje koje izradite u svojoj trgovini postavljate prostor za ime i ključ, traženi su argumenti prilagođeni. Stoga varijabla metapolja proizvoda koja bilježi upute za održavanje ljetne odjeće može biti product.careGuideSummer.value, dok varijabla metapolja proizvoda koja bilježi ID dobne skupine za koju je proizvod namijenjen može biti product.ageGroup.value_item.taxonomyReference.id. Nazive polja i argumente određujete isključivo vi.

Saznajte više o metapoljima u aplikaciji Shopify Flow.