Utilizarea câmpurilor API cu argumente în Shopify Flow pentru a crea variabile

Anumite variabile necesită parametri suplimentari pentru a funcționa corect într-un flux de lucru Shopify Flow. Acești parametri sunt argumente cărora trebuie să le declarați valorile înainte ca variabila să fie considerată completă și utilizabilă de către fluxul de lucru.

De exemplu, câmpul product.inCollection determină dacă un produs se află sau nu într-o colecție specificată și returnează un rezultat boolean true sau false. Totuși, argumentul id al colecției trebuie inclus pentru acest câmp, deoarece altfel variabila nu va ști ce colecție specifică să verifice. Pentru a utiliza corect câmpul, trebuie să includeți argumentul ca parte a câmpului. De exemplu, interogarea product.inCollection(id: "gid://shopify/Collection/123456") astfel încât Flow să poată determina dacă produsul se află sau nu în colecția cu ID-ul 123456 și apoi să returneze true sau false conform așteptărilor. Când creați variabile în Shopify Flow, nu este necesar să căutați valori precum ID-urile produselor sau ale colecțiilor. Flow oferă un selector de resurse pentru a selecta valoarea dorită, iar ID-ul este completat automat.

Pentru a simplifica experiența interogării câmpurilor cu argumente, puteți atribui un nou nume variabilei pe care o creați din câmpul și argumentul din Shopify Flow. De exemplu, dacă numele colecției cu ID-ul 123456 este Summer Bestsellers, atunci ați putea atribui variabilei inCollection(id: "gid://shopify/Collection/123456") un nume mai simplu, inSummerBestsellers. Apoi, în toți pașii ulteriori ai fluxului de lucru, puteți utiliza pur și simplu variabila product.inSummerBestsellers.

Deoarece argumentele diferă în funcție de valorile care le sunt atribuite, puteți crea mai multe variabile noi dintr-un singur câmp care necesită argumente. De exemplu, ați putea crea 3 variabile unice doar din câmpul product.inCollection:

• product.inCollection(id: "gid://shopify/Collection/123456") ar putea fi product.inSummerBestsellers.
• product.inCollection(id: "gid://shopify/Collection/654321") ar putea fi product.inSwimwear.
• product.inCollection(id: "gid://shopify/Collection/112233") ar putea fi product.inBeachAccessories.

Câmpuri GraphQL Admin API acceptate în Shopify Flow

Shopify Flow acceptă următoarele câmpuri în GraphQL Admin API cu argumente obligatorii:

• 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 de câmpuri de tip translations, cum ar fi collection.translations și product.translations

Câmpuri GraphQL Admin API neacceptate în Shopify Flow

Shopify Flow nu acceptă următoarele câmpuri:

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

Pentru a utiliza datele din aceste câmpuri neacceptate în fluxul dumneavoastră de lucru, trebuie să folosiți o acțiune de tip Trimitere solicitare HTTP.

Crearea unei variabile dintr-un câmp cu un argument

Puteți crea o variabilă în Shopify Flow pentru orice câmp acceptat care necesită un argument. Trebuie să creați variabila o singură dată într-un singur flux de lucru, deoarece aceasta rămâne disponibilă ca opțiune în toți pașii ulteriori ai fluxului de lucru.

Variabila pe care o creați nu este partajată cu niciun alt flux de lucru, așa că pentru a o folosi într-un alt flux de lucru, trebuie să o adăugați din nou în acel flux de lucru.

Pași:

1. Într-un flux de lucru Shopify Flow, faceți clic pe Adaugă o variabilă într-o acțiune sau condiție.
2. Selectați un câmp care necesită un argument. Aceste câmpuri afișează un buton +. Apoi, faceți clic pe + Creare variabilă.
3. În caseta de dialog Creare variabilă , urmați acești pași:
   1. Pe baza câmpului pe care l-ați selectat, setați o valoare pentru argumentul necesar.
   2. Opțional: În câmpul Nume variabilă nouă, personalizați modul în care doriți să se numească noua variabilă. Acest nume se aplică numai fluxului de lucru curent.
   3. Faceți clic pe Adaugă pentru a reîmprospăta panoul de selecție a variabilei.

După adăugarea noii variabile la un flux de lucru, aceasta rămâne disponibilă ca opțiune de câmp și o puteți referenția rapid în pașii ulteriori. Când alegeți Adaugă o variabilă, aceasta se afișează imbricată sub opțiunea de câmp originală în lista de câmpuri.

Crearea unei variabile dintr-un metacâmp în Shopify Flow

Metacâmpurile sunt un tip de variabilă cu câmpuri care necesită argumente. Preluarea datelor metacâmpului într-un flux de lucru Shopify Flow diferă ușor de preluarea datelor standard de câmp în alte variabile, deoarece dumneavoastră creați și definiți valorile câmpurilor namespace și key ale metacâmpului, astfel încât acestea sunt întotdeauna unice pentru magazinul dumneavoastră.

De exemplu, câmpul product.inCollection necesită întotdeauna argumentul id, indiferent de magazinul în care lucrați. Cu toate acestea, deoarece setați spațiul de nume și cheia pentru fiecare metacâmp pe care îl creați în magazinul dumneavoastră, argumentele necesare sunt personalizate. Astfel, o variabilă pentru un metacâmp de produs care captează instrucțiunile de îngrijire pentru un articol de îmbrăcăminte de vară ar putea fi product.careGuideSummer.value, sau o variabilă pentru un metacâmp de produs care înregistrează ID-ul grupului de vârstă căruia îi este destinat produsul ar putea fi product.ageGroup.value_item.taxonomyReference.id. Numele câmpurilor și argumentele sunt determinate în întregime de dumneavoastră.

Află mai multe despre metacâmpurile din Shopify Flow.