Verwendung von API-Feldern mit Argumenten in Shopify Flow zur Erstellung von Variablen

Einige Variablen erfordern zusätzliche Parameter, um in einem Shopify Flow-Workflow ordnungsgemäß zu funktionieren. Bei diesen Parametern handelt es sich um Argumente, für die du Werte deklarieren musst, bevor die Variable als vollständig und für den Workflow nutzbar gilt.

Das Feld product.inCollection bestimmt beispielsweise, ob sich ein Produkt in einer bestimmten Kollektion befindet oder nicht, und gibt das boolesche Ergebnis true oder false zurück. Das id-Argument der Kollektion muss jedoch für dieses Feld angegeben werden, da die Variable sonst nicht weiß, welche spezifische Kollektion überprüft werden soll. Um das Feld richtig zu verwenden, musst du das Argument als Teil des Felds einschließen. Wenn du beispielsweise product.inCollection(id: "gid://shopify/Collection/123456") abfragst, kann Flow ermitteln, ob sich das Produkt in der Kollektion mit der ID 123456 befindet, und dann erwartungsgemäß true oder false zurückgeben. Bei der Erstellung von Variablen in Shopify Flow musst du nicht nach Werten wie Produkt- oder Kollektions-IDs suchen. Flow bietet eine Ressourcenauswahl, mit der du den gewünschten Wert auswählen kannst. Die ID wird dann automatisch ausgefüllt.

Um die Abfrage von Feldern mit Argumenten zu vereinfachen, kannst du der Variablen, die du aus dem Feld und Argument in Shopify Flow erstellst, einen neuen Variablennamen zuweisen. Wenn der Name der Kollektion mit der ID 123456 beispielsweise Summer Bestsellers lautet, könntest du der Variablen inCollection(id: "gid://shopify/Collection/123456") den einfacheren Namen inSummerBestsellers zuweisen. In allen weiteren Schritten des Workflows kannst du dann einfach die Variable product.inSummerBestsellers verwenden.

Da sich Argumente je nach zugewiesenen Werten unterscheiden, kannst du aus einem einzigen Feld, das Argumente erfordert, mehrere neue Variablen erstellen. Du könntest beispielsweise nur aus dem Feld product.inCollection drei einzigartige Variablen erstellen:

• product.inCollection(id: "gid://shopify/Collection/123456") könnte product.inSummerBestsellers sein.
• product.inCollection(id: "gid://shopify/Collection/654321") könnte product.inSwimwear sein.
• product.inCollection(id: "gid://shopify/Collection/112233") könnte product.inBeachAccessories sein.

Unterstützte Felder der GraphQL Admin API in Shopify Flow

Shopify Flow unterstützt die folgenden Felder in der GraphQL Admin API mit erforderlichen Argumenten:

• 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 Felder vom Typ translations, zum Beispiel collection.translations und product.translations

Nicht unterstützte Felder der GraphQL Admin API in Shopify Flow

Shopify Flow unterstützt die folgenden Felder nicht:

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

Um Daten aus diesen nicht unterstützten Feldern in deinem Workflow zu verwenden, musst du eine Aktion vom Typ HTTP-Anfrage senden verwenden.

Erstellung einer Variablen aus einem Feld mit einem Argument

Du kannst in Shopify Flow eine Variable für jedes unterstützte Feld erstellen, das ein Argument erfordert. Du musst die Variable nur einmal in einem einzelnen Workflow erstellen, da die Variable in allen darauffolgenden Schritten des Workflows als Option verfügbar bleibt.

Die von dir erstellte Variable wird nicht mit anderen Workflows geteilt. Um sie in einem anderen Workflow verwenden zu können, musst du sie dort erneut hinzufügen.

Schritte:

1. Klicke in einem Shopify Flow-Workflow in einer Aktion oder Bedingung auf Variable hinzufügen.
2. Wähle ein Feld aus, das ein Argument erfordert. Diese Felder zeigen eine +-Schaltfläche an. Klicke dann auf + Variable erstellen.
3. Im Dialog „ Variable erstellen “ führst du die folgenden Schritte aus:
   1. Lege basierend auf dem von dir ausgewählten Feld einen Wert für das erforderliche Argument fest.
   2. Optional: Passe im Feld Neuer Variablenname an, wie die neue Variable heißen soll. Dieser Name gilt nur für den aktuellen Workflow.
   3. Klicke auf Hinzufügen, um den Bereich zur Variablenauswahl zu aktualisieren.

Nach dem Hinzufügen der neuen Variable zu einem Workflow bleibt die Variable als Feldoption verfügbar und du kannst in nachfolgenden Schritten schnell darauf verweisen. Wenn du Variable hinzufügen wählst, wird sie in der Feldliste unterhalb der ursprünglichen Feldoption verschachtelt angezeigt.

Variable aus einem Metafeld in Shopify Flow erstellen

Metafelder sind eine Art von Variable mit Feldern, die Argumente erfordern. Der Abruf von Metafeld-Daten in einem Shopify Flow-Workflow unterscheidet sich geringfügig vom Abruf von Standardfelddaten in anderen Variablen, da du die Feldwerte namespace und key des Metafelds erstellst und definierst, sodass sie für deinen Shop immer eindeutig sind.

Beispielsweise erfordert das Feld product.inCollection immer das Argument id, unabhängig davon, in welchem Shop du arbeitest. Da du jedoch den Namensraum und den Schlüssel für jedes Metafeld, das du in deinem Shop erstellst, selbst festlegst, sind die erforderlichen Argumente benutzerdefiniert. So könnte eine Variable für ein Produkt-Metafeld, das die Pflegehinweise für ein Sommerkleidungsstück erfasst, product.careGuideSummer.value lauten. Eine Variable für ein Produkt-Metafeld, das die ID der Altersgruppe speichert, für die das Produkt gedacht ist, könnte product.ageGroup.value_item.taxonomyReference.id lauten. Die Feldnamen und Argumente werden komplett von dir bestimmt.

Mehr Informationen zu Metafeldern in Shopify Flow.