Bruk av API-felt med argumenter i Shopify Flow til å opprette variabler

Noen variabler krever ytterligere parametere for å fungere riktig i en Shopify Flow-arbeidsflyt. Disse parameterne er argumenter som du må oppgi verdier for før variabelen anses som fullstendig og kan brukes av arbeidsflyten.

For eksempel avgjør feltet product.inCollection om et produkt er i en spesifikk samling og returnerer et boolsk resultat, true eller false. Samlingens id-argument må imidlertid inkluderes for dette feltet, for ellers vil ikke variabelen vite hvilken spesifikke samling den skal se etter. For å bruke feltet riktig, må du inkludere argumentet som en del av feltet. Du kan for eksempel gjøre en spørring på product.inCollection(id: "gid://shopify/Collection/123456") slik at Flow kan avgjøre om produktet er i samlingen med ID-en 123456, og deretter returnere true eller false som forventet. Når du oppretter variabler i Shopify Flow, trenger du ikke å søke etter verdier som produkt- eller samlings-ID-er. Flow har en ressursvelger for å velge verdien du ønsker, og ID-en fylles inn automatisk.

For å gjøre det enklere å gjøre spørringer på felt med argumenter, kan du tilordne et nytt variabelnavn til variabelen du oppretter fra feltet og argumentet i Shopify Flow. Hvis for eksempel navnet på samlingen med ID-en 123456 er Summer Bestsellers, kan du gi variabelen inCollection(id: "gid://shopify/Collection/123456") et enklere navn, som inSummerBestsellers. Deretter kan du ganske enkelt bruke variabelen product.inSummerBestsellers i alle påfølgende trinn i arbeidsflyten.

Fordi argumenter varierer avhengig av hvilke verdier som tilordnes til dem, kan du opprette flere nye variabler fra ett enkelt felt som krever argumenter. Du kan for eksempel opprette tre unike variabler bare fra feltet product.inCollection:

• product.inCollection(id: "gid://shopify/Collection/123456") kan bli product.inSummerBestsellers.
• product.inCollection(id: "gid://shopify/Collection/654321") kan bli product.inSwimwear.
• product.inCollection(id: "gid://shopify/Collection/112233") kan bli product.inBeachAccessories.

Støttede GraphQL Admin API-felt i Shopify Flow

Shopify Flow støtter følgende felt i GraphQL Admin API med påkrevde argumenter:

• 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 felt av typen translations, som collection.translations og product.translations

Ikke-støttede GraphQL Admin API-felt i Shopify Flow

Shopify Flow støtter ikke følgende felt:

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

For å bruke data fra disse ikke-støttede feltene i arbeidsflyten, må du bruke en Send HTTP-forespørsel-handling.

Opprette en variabel fra et felt med et argument

Du kan opprette en variabel i Shopify Flow for alle støttede felt som krever et argument. Du trenger bare å opprette variabelen én gang i en enkelt arbeidsflyt, ettersom variabelen forblir tilgjengelig som et alternativ i alle etterfølgende trinn i arbeidsflyten.

Variabelen du oppretter, deles ikke med andre arbeidsflyter. For å bruke den i en annen arbeidsflyt, må du legge den til på nytt der.

Trinn:

1. I en Shopify Flow-arbeidsflyt klikker du på Legg til en variabel i en handling eller betingelse.
2. Velg et felt som krever et argument. Disse feltene viser en +-knapp. Klikk deretter på + Opprett variabel.
3. I Opprett variabel -dialogboksen gjør du følgende:
   1. Basert på feltet du valgte, angir du en verdi for det obligatoriske argumentet.
   2. Valgfritt: I feltet Nytt variabelnavn kan du tilpasse hva du vil at den nye variabelen skal hete. Dette navnet gjelder bare for den gjeldende arbeidsflyten.
   3. Klikk på Legg til for å oppdatere panelet for variabelvalg.

Etter at du har lagt til den nye variabelen i en arbeidsflyt, forblir variabelen tilgjengelig som et feltalternativ, og du kan raskt referere til den i senere trinn. Når du velger Legg til en variabel, vises den nestet under det opprinnelige feltalternativet i listen over felt.

Opprette en variabel fra et metafelt i Shopify Flow

Metafelt er en type variabel med felt som krever argumenter. Å hente metafeltdata i en Shopify Flow-arbeidsflyt er litt annerledes enn å hente standard feltdata i andre variabler, fordi du oppretter og definerer metafeltets feltverdier for namespace og key, slik at de alltid er unike for butikken.

For eksempel krever feltet product.inCollection alltid id-argumentet, uavhengig av hvilken butikk du jobber i. Fordi du angir navnefelt og nøkkel for hvert metafelt du oppretter i butikken, er imidlertid de obligatoriske argumentene tilpasset. En variabel for et produktmetafelt som registrerer vaskeanvisninger for et sommerplagg, kan for eksempel være product.careGuideSummer.value, mens en variabel for et produktmetafelt som registrerer ID-en til aldersgruppen produktet er for, kan være product.ageGroup.value_item.taxonomyReference.id. Feltnavnene og argumentene bestemmes i sin helhet av deg.

Finn ut mer om metafelt i Shopify Flow.