Använda API-fält med argument i Shopify Flow för att skapa variabler

Vissa variabler kräver ytterligare parametrar för att fungera korrekt i ett Shopify Flow-arbetsflöde. Dessa parametrar är argument som du måste ange värden för innan variabeln anses vara komplett och kan användas i arbetsflödet.

Fältet product.inCollection avgör till exempel om en produkt finns i en angiven produktserie eller inte och returnerar ett booleskt true- eller false-resultat. Du måste dock inkludera id-argumentet för produktserien för det här fältet, eftersom variabeln annars inte vet vilken specifik produktserie som ska kontrolleras. För att använda fältet korrekt måste du inkludera argumentet som en del av fältet. Genom att till exempel göra en förfrågan till product.inCollection(id: "gid://shopify/Collection/123456") kan Flow avgöra om produkten finns i produktserien med ID 123456 eller inte, och sedan returnera true eller false som förväntat. När du skapar variabler i Shopify Flow behöver du inte söka efter värden som produkt- eller produktserie-ID:n. Flow tillhandahåller en resursväljare för att välja det värde du vill ha, och ID:t fylls i automatiskt.

För att förenkla hanteringen av fält med argument kan du tilldela ett nytt variabelnamn till den variabel som du skapar från fältet och argumentet i Shopify Flow. Om namnet på produktserien med ID 123456 till exempel är Summer Bestsellers kan du ge variabeln inCollection(id: "gid://shopify/Collection/123456") det enklare namnet inSummerBestsellers. Därefter kan du i alla efterföljande steg i arbetsflödet helt enkelt använda variabeln product.inSummerBestsellers.

Eftersom argument skiljer sig åt beroende på vilka värden som tilldelas dem, kan du skapa flera nya variabler från ett enda fält som kräver argument. Du kan till exempel skapa tre unika variabler från enbart fältet 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.

GraphQL Admin API-fält som stöds i Shopify Flow

Shopify Flow stöder följande fält i GraphQL Admin API med obligatoriska argument:

• 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 fält av typen translations, till exempel collection.translations och product.translations

GraphQL Admin API-fält som inte stöds i Shopify Flow

Shopify Flow stöder inte följande fält:

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

För att använda data från dessa fält som inte stöds i ditt arbetsflöde måste du använda åtgärden Skicka HTTP-förfrågan.

Skapa en variabel från ett fält med ett argument

Du kan skapa en variabel i Shopify Flow för alla fält som stöds och kräver ett argument. Du behöver bara skapa variabeln en gång i ett enskilt arbetsflöde, eftersom variabeln förblir tillgänglig som ett alternativ i alla efterföljande steg i arbetsflödet.

Variabeln som du skapar delas inte med några andra arbetsflöden. För att använda den i ett annat arbetsflöde måste du därför lägga till den på nytt i det aktuella arbetsflödet.

Steg:

1. Klicka på Lägg till en variabel i en åtgärd eller ett villkor i ett Shopify Flow-arbetsflöde.
2. Välj ett fält som kräver ett argument. Dessa fält visar en +-knapp. Klicka sedan på + Skapa variabel.
3. I dialogrutan ” Skapa variabel ” gör du följande:
   1. Ange ett värde för det obligatoriska argumentet baserat på fältet som du har valt.
   2. Valfritt: I fältet Nytt variabelnamn kan du anpassa vad du vill att den nya variabeln ska heta. Detta namn gäller endast för det aktuella arbetsflödet.
   3. Klicka på Lägg till för att uppdatera variabelvalspanelen.

När du har lagt till den nya variabeln i ett arbetsflöde förblir variabeln tillgänglig som ett fältalternativ, och du kan snabbt referera till den i efterföljande steg. När du väljer Lägg till en variabel visas den nästlad under det ursprungliga fältalternativet i listan över fält.

Skapa en variabel från ett metafält i Shopify Flow

Metafält är en typ av variabel med fält som kräver argument. Att hämta data från metafält i ett Shopify Flow-arbetsflöde skiljer sig något från att hämta standardfältdata i andra variabler, eftersom du skapar och definierar metafältets fältvärden för namespace (namnrymd) och key (nyckel), så de är alltid unika för din butik.

Till exempel kräver fältet product.inCollection alltid argumentet id, oavsett vilken butik du arbetar i. Men eftersom du anger namnrymd och nyckel för varje metafält som du skapar i din butik, är de obligatoriska argumenten anpassade. En variabel för ett produktmetafält som innehåller skötselråd för ett sommarklädesplagg kan alltså vara product.careGuideSummer.value, medan en variabel för ett produktmetafält som registrerar ID för den åldersgrupp produkten är avsedd för kan vara product.ageGroup.value_item.taxonomyReference.id. Fältnamnen och argumenten bestäms helt och hållet av dig.

Mer information om metafält i Shopify Flow.