Brug af API-felter med argumenter i Shopify Flow til at oprette variabler

Nogle variabler kræver yderligere parametre for at fungere korrekt i et Shopify Flow-workflow. Disse parametre er argumenter, som du skal deklarere værdier for, før variablen anses for at være fuldstændig og kan bruges af workflowet.

For eksempel bestemmer feltet product.inCollection, om et produkt er i en bestemt kollektion, og returnerer et boolesk true- eller false-resultat. Argumentet for kollektionens id skal dog inkluderes for dette felt, da variablen ellers ikke ved, hvilken specifik kollektion der skal kontrolleres. For at bruge feltet korrekt skal du inkludere argumentet som en del af feltet. Hvis du for eksempel forespørger product.inCollection(id: "gid://shopify/Collection/123456"), kan Flow bestemme, om produktet er i kollektionen med id'et 123456, og derefter returnere true eller false som forventet. Når du opretter variabler i Shopify Flow, behøver du ikke at søge efter værdier som f.eks. produkt- eller kollektions-id'er. Flow har en ressourcevælger, hvor du kan vælge den ønskede værdi, hvorefter id'et udfyldes automatisk.

For at gøre det enklere at forespørge felter med argumenter kan du tildele et nyt variabelnavn til den variabel, du opretter ud fra feltet og argumentet i Shopify Flow. Hvis navnet på kollektionen med id'et 123456 for eksempel er Summer Bestsellers, kan du tildele variablen inCollection(id: "gid://shopify/Collection/123456") det mere enkle navn inSummerBestsellers. I alle efterfølgende trin af dit workflow kan du derefter bare bruge variablen product.inSummerBestsellers.

Da argumenter varierer afhængigt af, hvilke værdier der er tildelt dem, kan du oprette flere nye variabler fra et enkelt felt, der kræver argumenter. Du kan for eksempel oprette 3 unikke variabler bare ud fra feltet product.inCollection:

• product.inCollection(id: "gid://shopify/Collection/123456") kunne være product.inSummerBestsellers.
• product.inCollection(id: "gid://shopify/Collection/654321") kunne være product.inSwimwear.
• product.inCollection(id: "gid://shopify/Collection/112233") kunne være product.inBeachAccessories.

Understøttede GraphQL Admin API-felter i Shopify Flow

Shopify Flow understøtter følgende felter med påkrævede argumenter i GraphQL Admin API'et:

• 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 felter af typen translations, såsom collection.translations og product.translations

Ikke-understøttede GraphQL Admin API-felter i Shopify Flow

Shopify Flow understøtter ikke følgende felter:

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

For at bruge data fra disse ikke-understøttede felter i dit workflow skal du bruge en Send HTTP-anmodning-handling.

Oprettelse af en variabel fra et felt med et argument

Du kan oprette en variabel i Shopify Flow for ethvert understøttet felt, der kræver et argument. Du behøver kun at oprette variablen én gang i et workflow, da den derefter er tilgængelig som en valgmulighed i alle efterfølgende trin af workflowet.

Den variabel, du opretter, deles ikke med andre workflows. Hvis du vil bruge den i et andet workflow, skal du derfor tilføje den igen i dette workflow.

Fremgangsmåde:

1. Klik på Tilføj en variabel i en handling eller en betingelse i et Shopify Flow-workflow.
2. Vælg et felt, der kræver et argument. Disse felter har en +-knap. Klik derefter på + Opret variabel.
3. I dialogboksen Opret variabel skal du følge denne fremgangsmåde:
   1. Angiv en værdi for det påkrævede argument med udgangspunkt i det felt, du har valgt.
   2. Valgfrit: I feltet Navn på ny variabel kan du tilpasse navnet på den nye variabel. Dette navn gælder kun for det aktuelle workflow.
   3. Klik på Tilføj for at opdatere panelet til valg af variabler.

Når du har tilføjet den nye variabel i et workflow, er den fortsat tilgængelig som en feltmulighed, og du kan hurtigt henvise til den i efterfølgende trin. Når du vælger Tilføj en variabel, vises den indlejret under den oprindelige feltmulighed på listen over felter.

Oprettelse af en variabel ud fra et metafelt i Shopify Flow

Metafelter er en type variabel med felter, der kræver argumenter. Indhentning af data for metafelter i et Shopify Flow-workflow adskiller sig lidt fra indhentning af standardfeltdata for andre variabler. Det skyldes, at du opretter og definerer metafeltets feltværdier for namespace og key, så de altid er unikke for din butik.

Feltet product.inCollection kræver f.eks. altid argumentet id, uanset hvilken butik du arbejder i. Da du angiver navneområde og nøgle for alle metafelter, du opretter i din butik, er de påkrævede argumenter dog tilpassede. En variabel for et produktmetafelt, der indeholder vaskeanvisninger for et stykke sommertøj, kan f.eks. være product.careGuideSummer.value. En variabel for et produktmetafelt, der registrerer id'et for den aldersgruppe, produktet er beregnet til, kan f.eks. være product.ageGroup.value_item.taxonomyReference.id. Feltnavnene og argumenterne bestemmes udelukkende af dig.

Få mere at vide om metafelter i Shopify Flow.