Liquid-variabelen zijn tijdelijke aanduidingen in Liquid die worden vervangen door waarden uit de GraphQL Admin API wanneer een workflow wordt uitgevoerd. Variabelen kunnen de attributen beschrijven van de klanten, bestellingen en producten die bij je workflows betrokken zijn, zoals het bestelnummer, de bestelprijs of de klantnaam. Variabelen kunnen in voorwaarden worden gebruikt om de logica in je workflow te sturen, of om gegevens uit een actie uit te voeren.
Je kunt met Liquid variabelen toevoegen aan elk tekstvak met de link Een variabele toevoegen. Klik op de link Een variabele toevoegen onder het betreffende veld en kies vervolgens een variabele uit de lijst.
De variabelen in de lijst Een variabele toevoegen zijn gefilterd, zodat je alleen de variabelen gebruikt die worden geretourneerd door stappen die vóór de huidige stap komen, zoals triggers. De trigger Bestelling aangemaakt levert bijvoorbeeld bestel- en winkelresources uit de Admin API die als variabelen kunnen worden ingevoegd. Nadat je een variabele uit de lijst hebt gekozen, wordt deze als correct opgemaakte Liquid aan het tekstvak toegevoegd.
Je kunt Liquid ook rechtstreeks in het tekstvak schrijven. Je kunt bijvoorbeeld de variabele {{ order.name }} gebruiken om de besteltekenreeks uit het Shopify-beheercentrum weer te geven, zoals bestelling-123.
Omdat Flow de Admin API gebruikt om de gegevens voor Liquid op te halen, wordt voor de variabele syntaxis camel case gebruikt. Bij camel case-variabelen begint het eerste woord met een kleine letter en beginnen de volgende woorden met een hoofdletter, zoals firstName of canMarkAsPaid. Voer bijvoorbeeld {{ product.createdAt }} in om de aanmaakdatum van een product te openen. Als je de Liquid-syntaxis in een Shopify-thema gebruikt (waarbij geen camel case wordt gebruikt), voer je {{ product.created_at }} in.
Conditionele en iteratie-Liquid-tags
Liquid-tags kunnen met variabelen worden gebruikt om de volgende functies uit te voeren:
Conditionele verklaringen schrijven, zoals bepalen of een besteltotaal hoger is dan $ 100.
Door een lijst met objecten itereren, zoals gegevens weergeven voor elke orderregel in een bestelling.
Je kunt Liquid-tags gebruiken om deze verklaringen te schrijven en door objecten te itereren.
De volgende Liquid geeft bijvoorbeeld het bestelnummer weer als het besteltotaal hoger is dan $ 100:
{% if order.totalPriceSet.shopMoney.amount > 100 %}
Order number: {{ order.name }}
{% endif %}
Je kunt ook een for-lus gebruiken om door een lijst met objecten te itereren, zoals de orderregels voor een bestelling. De volgende Liquid geeft bijvoorbeeld de naam van elke orderregel in een bestelling weer:
{% for li in order.lineItems %}
{{ li.title }}
{% endfor %}
Flow ondersteunt de volgende conditionele (of control flow) Liquid-tags:
Je kunt variabele gegevens in Liquid transformeren met filters. Flow ondersteunt alle open source-Liquid-filters.
De volgende Liquid verwijdert bijvoorbeeld een voorvoegsel van een bestelnaam en geeft het resterende deel weer: {{ order.name | remove: "Order-" }}
Aandachtspunten voor het gebruik van Liquid-variabelen in filters
Lees de volgende aandachtspunten door voordat je variabelen met filters transformeert:
Flow ondersteunt geen puntnotatie die voor sommige filters beschikbaar is. Flow ondersteunt bijvoorbeeld wel {{ order.lineItems | size }}, maar niet {{ order.lineItems.size }}.
Flow ondersteunt geen puntnotatie voor metavelden. Je kunt bijvoorbeeld niet {{ order.metafields.custom.hold_note }} gebruiken. In plaats daarvan moet je over de metavelden loopen, zoals beschreven in de voorbeelden.
Flow ondersteunt het gebruik van indexen niet om toegang te krijgen tot artikelen in een lijst. Je kunt bijvoorbeeld niet {{ order.lineItems[0].title }} gebruiken. In plaats daarvan moet je over de orderregels loopen, zoals beschreven in de voorbeelden.
Datumfilters
Naast de standaard Liquid-filters biedt Flow datumfilters om een datum ten opzichte van een andere datum te krijgen. Dit ter ondersteuning van de trigger Geplande tijd en de functie Gegevens ophalen. Deze filters zijn: date_minus en date_plus. Bijvoorbeeld:
Een datum één dag in de toekomst retourneren: {{ "now" | date_plus: "1 day" }}
Een datum één dag in het verleden retourneren: {{ "now" | date_minus: "1 day" }}
Deze filters accepteren second, minute, day, week, month en year als duur-eenheid, zowel in het enkelvoud (zoals second) als in het meervoud (zoals seconds). Je kunt ook de volgende soorten aanpasbare eenheden opgeven:
Een geheel getal dat het aantal seconden aangeeft: {{ "now" | date_minus: 3600 }}, waarbij 3600 gelijk is aan 1 uur.
Een ISO8601-duurtekenreeks: {{ "now" | date_minus: "P1Y2D" }}, waarbij P1Y2D 1 jaar en 2 dagen betekent.
Cryptografische filters
Flow biedt cryptografische filters voor hashen en het aanmaken van HMAC's (Hash-based Message Authentication Codes). Deze filters zijn handig voor het aanmaken van unieke ID's, checksums of voor integratie met systemen van externe partijen die specifieke hash-indelingen vereisen.
Hashingfilters
Shopify Flow ondersteunt de volgende soorten hashingfilters:
blake3 - Maakt een BLAKE3-hash aan (aanbevolen voor algemeen gebruik).
Voor algemene hashingdoeleinden en nieuwe implementaties kun je het beste blake3 gebruiken, omdat dit betere prestaties en beveiliging biedt in vergelijking met oudere algoritmen. sha256, sha1 en md5 zijn echter beschikbaar voor compatibiliteit met systemen van externe partijen.
Voorbeeld van gebruik:
{{ "hello world" | blake3 }} geeft de BLAKE3-hash van 'hello world' terug.
HMAC-filters
Gebruik een van de volgende ondersteunde filters om een HMAC met een geheime sleutel aan te maken:
Je wilt de URL's uitvoeren voor de klant, bestelling en het product die bij een workflow betrokken zijn.
# Output the base Admin URL for your store
https://admin.shopify.com/store/{{ shop.myShopifyDomain | replace: ".myshopify.com", "" }}
# Assign the base Admin url to a variable named base_url:
{%- capture base_url -%}https://admin.shopify.com/store/{{ shop.myShopifyDomain | replace: ".myshopify.com", "" }}{%- endcapture -%}
# Customer from a Customer trigger:
{{ base_url }}/customers/{{ customer.legacyResourceId }}
# Customer without the base_url:
https://admin.shopify.com/store/{{ shop.myShopifyDomain | replace: ".myshopify.com", "" }}/customers/{{ customer.legacyResourceId }}
# Customer from an Order trigger:
{{ base_url }}/customers/{{ order.customer.legacyResourceId }}
# Order:
{{ base_url }}/orders/{{ order.legacyResourceId }}
# Product:
{{ base_url }}/products/{{ product.legacyResourceId }}
# Product Variant:
{{ base_url }}/products/{{ product.legacyResourceId }}/variants/{{ productVariant.legacyResourceId }}
# Example showing a clickable link in HTML, making use of the URL:
<a href="{{ base_url }}/products/{{ product.legacyResourceId }}">{{ product.title }}</a>
Een lijst met tags naar een metaveld omzetten
Je wilt een set tags omzetten naar een metaveld dat een lijst met tekstvelden van één regel is. Je maakt een workflow aan met de trigger Product toegevoegd aan winkel en gebruikt de actie Productmetaveld bijwerken. In de sectie Waarde van de actie Productmetaveld bijwerken voeg je de volgende Liquid-code toe. In dit voorbeeld wordt ervan uitgegaan dat je de waarden maar één keer hoeft in te stellen wanneer het product wordt aangemaakt en dat het product twee relevante tags heeft: color:red en color:orange.
Voorbeeld van Liquid om de lijst van een tekstveld van één regel in te stellen.
Een dynamisch e-mailbericht voor een bestelling schrijven
Je wilt een workflow aanmaken om een e-mail naar een medewerker te sturen wanneer een klant meer dan $ 500 aan een bestelling besteedt. Je maakt een workflow aan met de trigger Bestelling aangemaakt, stelt een voorwaarde in die waar is als het totaalbedrag van de bestelling hoger is dan $ 500 en gebruikt de actie Interne e-mail verzenden. In de sectie Bericht van de actie Interne e-mail verzenden gebruik je de volgende variabelen.
Voorbeeld van het gebruik van variabelen om klantgegevens te verstrekken.
Invoer
Uitvoer
Please send a personal thank you note to {{ order.customer.firstName }} {{ order.customer.lastName }}({{ order.customer.email }}) for placing an order for $ {{ order.totalPriceSet.shopMoney.amount }}.
Stuur een persoonlijk bedankje naar Jeanne Dupont (jeanne@example.com) voor het plaatsen van een bestelling van $ 763,42.
Een dynamisch e-mailbericht schrijven voor een product met een lage voorraad
Je besluit dat je een medewerker moet informeren wanneer de productvoorraad laag wordt en er meer voorraad moet worden besteld. Je maakt een workflow aan die begint met de trigger Voorraadaantal gewijzigd en stelt een voorwaarde in die waar is als het vorige voorraadaantal kleiner is dan of gelijk is aan 10. In de sectie Bericht van de actie Interne e-mail verzenden gebruik je de volgende variabelen.
Voorbeeld van het gebruik van variabelen om artikelgegevens te verstrekken.
Invoer
Uitvoer
Please reorder {{ product.title }}. Email owner@store.com to verify that they've received the purchase order.
Bestel Legging met hoge taille - Zwart opnieuw. E-mail owner@example.com om te verifiëren dat ze de inkooporder hebben ontvangen.
Een dynamisch e-mailbericht schrijven om medewerkers op de hoogte te stellen van een frauduleuze bestelling
Je wilt bestellingen met een hoog risiconiveau annuleren, maar geeft er de voorkeur aan dat je medewerkers de bestelling handmatig annuleren. Je maakt een workflow aan die begint met de trigger Bestelling aangemaakt en stelt een voorwaarde in die waar is als het risiconiveau van de bestelling gelijk is aan 'hoog'. In de sectie Bericht van de actie Interne e-mail verzenden gebruik je de volgende variabelen.
Voorbeeld van het gebruik van variabelen om informatie over een frauduleuze bestelling te verstrekken.
Invoer
Uitvoer
Our Shopify store has received an order with a high risk of fraud. We would like to cancel this order right away, before it is sent to production:
{{ order.name }}
{{ order.billingAddress.lastName }}, {{ order.billingAddress.firstName }}
{{ order.email }}
Please confirm the new order status. Thanks!
Onze Shopify-winkel heeft een bestelling ontvangen met een hoog risico op fraude. We willen deze bestelling direct annuleren, voordat deze naar productie wordt gestuurd:
#1001
Dupont, Jeanne
jeanne@example.com
Bevestig de nieuwe bestelstatus. Bedankt!
De orderregels voor een bestelling uitvoeren met een for-loop
Wanneer een bestelling wordt ontvangen, kan het handig zijn een bericht te sturen met de bestelde producten. Dit kun je doen met een for-loop, die herhaaldelijk een codeblok uitvoert. Tekstvelden die variabelen ondersteunen, ondersteunen ook for-loops en het forloop-object.
Stel, je wilt een workflow aanmaken die een lijst genereert met alle SKU's en hoeveelheden in een bestelling. In de sectie Bericht van de actie Interne e-mail verzenden gebruik je de volgende variabelen.
Voorbeeld van het gebruik van een for-loop om bestelgegevens weer te geven.
Invoer
Uitvoer
Order summary:
{% for a in order.lineItems %}
{{a.sku}} ( {{a.quantity}} )
{% endfor %}
Orderregels voor een bestelling weergeven met een for-loop en extra informatie
Je besluit meer informatie aan de e-mail toe te voegen, zoals de productnaam, SKU's, de prijs per artikel en de verzendgegevens van de klant. In de sectie Bericht van de actie Interne e-mail verzenden gebruik je de volgende variabelen.
Voorbeeld van het gebruik van een for-loop om uitgebreidere bestelgegevens weer te geven.
Invoer
Uitvoer
Order summary:
{% for a in order.lineItems %}
Product: {{a.title}}
SKU: {{a.sku}}
Price (per unit): ${{a.originalUnitPriceSet.shopMoney.amount}}
Quantity: {{a.quantity}}
{% endfor %}
Besteloverzicht:
Product: High Waist Leggings - Black
SKU: 8987097979
Prijs (per stuk): $ 8,49
Aantal: 5
Product: Athletic Socks - Blue
SKU: 888998898B
Prijs (per stuk): $ 5,61
Aantal: 2
Bepaalde orderregels weergeven door een for-loop met een if-statement te combineren
Je wilt verkochte artikelen volgen die door een specifieke verkoper worden geleverd. In de sectie Bericht van de actie Interne e-mail verzenden gebruik je de volgende variabelen en voeg je een if-statement toe aan je for-loop.
Voorbeeld van het gebruik van een for-loop en if-statement om bestelgegevens voor specifieke verkopers weer te geven.
Invoer
Uitvoer
Acme product sold:
{% for x in order.lineItems %}
{% if x.vendor == 'acme-vendor' %}
Product name: {{x.title}}
SKU: {{x.sku}}
{% endif %}
{% endfor %}
Acme-product verkocht:
Productnaam: High Waist Leggings - Black
SKU: 8987097979
Complexe dataobjecten in Shopify Flow
Met Flow heb je toegang tot bijna alle gegevens in de GraphQL Admin API. Dit omvat complexe dataobjecten, zoals lijsten en objecten. Er zijn echter enkele beperkingen aan wat je met deze objecten kunt doen. In deze sectie worden deze beperkingen beschreven en vind je voorbeelden van hoe je ermee kunt werken.
In plaats van lijsten en objecten rechtstreeks aan te roepen, moet je de lijst doorlopen en alleen de gewenste velden opnemen.
In plaats van {{ order.lineItems }} rechtstreeks aan te roepen, gebruik je bijvoorbeeld de volgende indeling om specifieke velden aan te roepen. Deze voorbeelden bevatten alle velden die zouden worden opgenomen door de lijst of het object rechtstreeks aan te roepen. Kopieer en plak de velden die je nodig hebt.
Tekst
{% for li in order.lineItems %}
{% comment %}li.contract - omitted{% endcomment %}
