Liquid-variabler er pladsholdere defineret i Liquid, som erstattes af værdier fra GraphQL Admin API, når et workflow køres. Variabler kan beskrive de attributter for kunder, ordrer og produkter, der indgår i dine workflows, f.eks. ordrenummer, ordrepris eller kundenavn. Variabler kan bruges i betingelser til at styre logikken i dit workflow eller til at levere data fra en handling.
Tilføjelse af variabler i workflows ved hjælp af Liquid
Du kan tilføje variabler ved hjælp af Liquid i ethvert tekstfelt, der indeholder linket Tilføj en variabel. Klik på linket Tilføj en variabel under det relevante felt, og vælg derefter en variabel på listen.
Variablerne på listen Tilføj en variabel er filtreret, så du kun bruger de variabler, der returneres af trin før det nuværende trin, f.eks. udløsere. Udløseren Ordre oprettet indeholder f.eks. ordre- og butiksressourcer fra Admin API, der kan indsættes som variabler. Når du har valgt en variabel på listen, føjes den til tekstfeltet som korrekt formateret Liquid.
Du kan også skrive Liquid direkte i tekstfeltet. Du kan f.eks. bruge variablen {{ order.name }} til at vise ordrestrengen fra Shopify-administratoren, f.eks. ordre-123.
Da Flow bruger Admin API til at hente de data, der bruges til Liquid, anvender variabelsyntaksen camel case. I camel case-variabler starter det første ord med et lille bogstav, og efterfølgende ord starter med et stort bogstav, f.eks. firstName eller canMarkAsPaid. Hvis du f.eks. vil have adgang til den dato, hvor et produkt blev oprettet, skal du angive {{ product.createdAt }}. Hvis du bruger Liquid-syntaksen i et Shopify-tema, som ikke bruger camel case, skal du i stedet angive {{ product.created_at }}.
Betingede og gentagende Liquid-tags
Liquid-tags kan bruges sammen med variabler til at udføre følgende funktioner:
Skrive betingede erklæringer, f.eks. afgøre om en ordres samlede beløb er større end 100 USD.
Gentage en liste over objekter, f.eks. vise data for hver varelinje i en ordre.
Du kan bruge Liquid-tags til at skrive disse erklæringer og gentage objekter.
Følgende Liquid viser f.eks. ordrenummeret, hvis ordrens samlede beløb er større end 100 USD:
{% if order.totalPriceSet.shopMoney.amount > 100 %}
Order number: {{ order.name }}
{% endif %}
Du kan også bruge en for-løkke til at gentage en liste over objekter, f.eks. varelinjer for en ordre. Følgende Liquid viser f.eks. navnet på hver varelinje i en ordre:
{% for li in order.lineItems %}
{{ li.title }}
{% endfor %}
Flow understøtter følgende betingede (eller kontrolflow) Liquid-tags:
Du kan transformere variabeldata i Liquid ved hjælp af filtre. Flow understøtter alle open source-Liquid-filtre.
Følgende Liquid fjerner f.eks. et præfiks fra et ordrenavn og viser det, der er tilbage: {{ order.name | remove: "Ordre-" }}
Overvejelser i forbindelse med brug af Liquid-variabler i filtre
Gennemgå følgende overvejelser, før du transformerer variabler ved hjælp af filtre:
Flow understøtter ikke punktnotation, som er tilgængelig for nogle filtre. Flow understøtter f.eks. {{ order.lineItems | size }}, men ikke {{ order.lineItems.size }}.
Flow understøtter ikke punktnotation for metafelter. Du kan f.eks. ikke bruge {{ order.metafields.custom.hold_note }}. I stedet skal du gennemløbe metafelterne som beskrevet i eksemplerne.
Flow understøtter ikke brug af indekser til at få adgang til varer på en liste. Du kan f.eks. ikke bruge {{ order.lineItems[0].title }}. I stedet skal du gennemløbe varelinjerne som beskrevet i eksemplerne.
Datofiltre
Ud over standard Liquid-filtrene indeholder Flow datofiltre til at hente en dato i forhold til en anden dato for at understøtte funktionerne Planlagt tidspunkt-udløser og Hent data. Disse filtre er: date_minus og date_plus. For eksempel:
Sådan returneres en dato én dag ude i fremtiden: {{ "now" | date_plus: "1 day" }}
Sådan returneres en dato én dag tilbage i tiden: {{ "now" | date_minus: "1 day" }}
Disse filtre accepterer second, minute, day, week, month og year som varighedsenhed, både i ental (f.eks. second) og flertal (f.eks. seconds). Du kan også angive følgende typer af enheder, der kan tilpasses:
Et heltal, der repræsenterer antallet af sekunder: {{ "now" | date_minus: 3600 }}, hvor 3600 svarer til 1 time.
En ISO8601-varighedsstreng: {{ "now" | date_minus: "P1Y2D" }}, hvor P1Y2D betyder 1 år og 2 dage.
Kryptografiske filtre
Flow indeholder kryptografiske filtre til hashing og oprettelse af hash-baserede meddelelsesgodkendelseskoder (HMAC'er). Disse filtre er nyttige til at oprette unikke identifikatorer, kontrolsummer eller til integration med tredjepartssystemer, der kræver specifikke hashformater.
Hashingfiltre
Shopify Flow understøtter følgende typer hashingfiltre:
blake3 – Opretter en BLAKE3-hash (anbefales til generel brug).
Til generelle hashingformål og nye implementeringer bør du bruge blake3, da den giver overlegen ydeevne og sikkerhed sammenlignet med ældre algoritmer. sha256, sha1 og md5 er dog tilgængelige af hensyn til kompatibilitet med tredjepartssystemer.
Eksempel på brug:
{{ "hello world" | blake3 }} returnerer BLAKE3-hashen for “hello world”.
HMAC-filtre
Hvis du vil oprette en HMAC med en hemmelig nøgle, skal du bruge et af følgende understøttede filtre:
Du vil gerne vise webadresserne for den kunde, ordre og det produkt, der er involveret i et workflow.
# 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>
Konverter en liste over tags til et metafelt
Du vil gerne konvertere et sæt tags til et metafelt, der er en liste over tekstfelter med en enkelt linje. Du opretter et workflow ved hjælp af udløseren Produkt føjet til butik og bruger handlingen Opdater produktmetafelt. I afsnittet Værdi under handlingen Opdater produktmetafelt tilføjer du følgende Liquid-kode. I dette eksempel antages det, at du kun behøver at angive værdierne én gang, når produktet oprettes, og at produktet har to relevante tags: color:red og color:orange.
Eksempel på Liquid til at angive listen over et tekstfelt med en enkelt linje.
Du vil oprette et workflow, der sender en mail til en medarbejder, når en kunde bruger mere end 500 USD på en ordre. Du opretter et workflow ved hjælp af udløseren Ordre oprettet, angiver en betingelse, der er sand, hvis ordretotalen er over 500 USD, og bruger handlingen Send intern mail. I afsnittet Besked under handlingen Send intern mail bruger du følgende variabler.
Eksempel på brug af variabler til at angive kundeoplysninger.
Input
Output
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 }}.
Send venligst en personlig tak til Jeanne Dupont (jeanne@example.com) for at have afgivet en ordre på 763,42 USD.
Skriv en dynamisk mail for et produkt med lav lagerbeholdning
Du beslutter dig for, at du vil informere en medarbejder, når lagerbeholdningen for et produkt er ved at være lav, og der skal bestilles flere varer. Du opretter et workflow, der starter med udløseren Lagerantal ændret, og angiver en betingelse, der er sand, hvis det tidligere lagerantal er mindre end eller lig med 10. I afsnittet Besked under handlingen Send intern mail bruger du følgende variabler.
Eksempel på brug af variabler til at angive vareoplysninger.
Input
Output
Please reorder {{ product.title }}. Email owner@store.com to verify that they've received the purchase order.
Genbestil venligst High Waist Leggings – Sort. Mail til owner@example.com for at bekræfte, at de har modtaget købsordren.
Skriv en dynamisk mail for at give en medarbejder besked om en svigagtig ordre
Du vil gerne annullere ordrer, der har et højt risikoniveau, men foretrækker, at dine medarbejdere annullerer ordren manuelt. Du opretter et workflow, der starter med udløseren Ordre oprettet, og angiver en betingelse, der er sand, hvis ordrens risikoniveau er lig med højt. I afsnittet Besked under handlingen Send intern mail bruger du følgende variabler.
Eksempel på brug af variabler til at give oplysninger om en svigagtig ordre.
Input
Output
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!
Vores Shopify-butik har modtaget en ordre med høj risiko for svindel. Vi vil gerne annullere denne ordre med det samme, før den sendes til produktion:
#1001
Dupont, Jeanne
jeanne@example.com
Bekræft den nye ordrestatus. På forhånd tak!
Output varelinjerne for en ordre ved hjælp af en for-løkke
Når der modtages en ordre, kan det være nyttigt at sende en besked, der indeholder de bestilte produkter. Du kan gøre dette ved hjælp af en for-løkke, som gentagne gange udfører en kodeblok. Tekstfelter, der understøtter variabler, understøtter også for-løkker og forloop-objektet.
Du vil f.eks. oprette et workflow, der returnerer en liste over alle SKU'er og antal i en ordre. I sektionen Besked i handlingen Send intern mail bruger du følgende variabler.
Eksempel på brug af for-løkke til at angive ordreoplysninger.
Input
Output
Order summary:
{% for a in order.lineItems %}
{{a.sku}} ( {{a.quantity}} )
{% endfor %}
Vis varelinjer for en ordre ved hjælp af en for-løkke med yderligere oplysninger
Du beslutter dig for at føje flere oplysninger til mailen, herunder produktnavn, SKU'er, pris pr. vare og kundens forsendelsesoplysninger. I sektionen Besked i handlingen Send intern mail bruger du følgende variabler.
Eksempel på brug af for-løkke til at angive mere omfattende ordreoplysninger.
Input
Output
Order summary:
{% for a in order.lineItems %}
Product: {{a.title}}
SKU: {{a.sku}}
Price (per unit): ${{a.originalUnitPriceSet.shopMoney.amount}}
Quantity: {{a.quantity}}
{% endfor %}
Ordreoversigt:
Produkt: High Waist Leggings - Black
SKU: 8987097979
Pris (pr. enhed): 8,49 USD
Antal: 5
Produkt: Athletic Socks - Blue
SKU: 888998898B
Pris (pr. enhed): 5,61 USD
Antal: 2
Vis nogle varelinjer ved at kombinere en for-løkke med en if-sætning
Du skal spore solgte varer, der leveres af en bestemt forhandler. I sektionen Besked i handlingen Send intern mail bruger du følgende variabler og inkluderer en if-sætning i din for-løkke.
Eksempel på brug af for-løkke og if-sætning til at angive ordreoplysninger for bestemte forhandlere.
Input
Output
Acme product sold:
{% for x in order.lineItems %}
{% if x.vendor == 'acme-vendor' %}
Product name: {{x.title}}
SKU: {{x.sku}}
{% endif %}
{% endfor %}
Solgt Acme-produkt:
Produktnavn: High Waist Leggings - Black
SKU: 8987097979
Komplekse dataobjekter i Shopify Flow
Flow giver dig adgang til næsten alle data i GraphQL Admin API. Dette omfatter komplekse dataobjekter, f.eks. lister og objekter. Der er dog nogle begrænsninger for, hvad du kan gøre med disse objekter. I dette afsnit beskrives disse begrænsninger, og der gives eksempler på, hvordan du kan arbejde med dem.
I stedet for at kalde lister og objekter direkte, bør du gennemløbe listen og kun medtage de felter, du vil have.
I stedet for at kalde {{ order.lineItems }} direkte kan du f.eks. bruge følgende format til at kalde bestemte felter. Disse eksempler indeholder alle de felter, der ville blive inkluderet, hvis du kaldte listen eller objektet direkte. Kopiér og indsæt de felter, du har brug for.
Tekst
{% for li in order.lineItems %}
{% comment %}li.contract - omitted{% endcomment %}
