Variabler er plassholdere som erstattes med verdier når en arbeidsflyt kjører. Disse variablene beskriver egenskapene til kunder, bestillinger og produkter som er involvert i arbeidsflytene dine. Det finnes for eksempel variabler for bestillingsnummer, bestillingspris, kundenavn og så videre. Variabler kan brukes i betingelser til å kontrollere logikken i arbeidsflyten, eller for å sende data i en handling.
Liquid er et malspråk som brukes for å hente variabler i handlinger, og for å skrive kode i Flow. Flow bruker en variant av Liquid som ligger nærmest biblioteket med åpen kildekode. Shopify-temaer bruker en annen variant av Liquid, men denne varianten av Liquid er spesifikk for temaer, og inneholder mange flere filtre og tagger enn Flow støtter, samt en annen syntaks for å bruke variabler.
Liquid-variabler
Du kan legge til Liquid-variabler for alle tekstfelter som inneholder koblingen Legg til en variabel. Klikk på koblingen Legg til en variabel under det relevante feltet, og velg deretter en variabel fra listen.
Variablene i listen Legg til en variabel er filtrert, slik at du bare kan se variablene som returneres av trinn før det gjeldende trinnet, som utløsere. Utløseren Bestilling opprettet leverer for eksempel bestillings- og butikkressurser, som deretter lar deg bruke alle variabler knyttet til bestillingen eller butikkinnstillingene, som er tilgjengelig i GraphQL Admin API. Når du har valgt en variabel fra listen, formateres den og legges til i tekstboksen for deg.
Du kan også skrive liquid direkte i tekstblokken. Du kan for eksempel bruke variabelen {{ order.name }} for å vise bestillingsstrengen som vises i Shopify-administrator, som order-123.
Fordi Flow bruker GraphQL Admin API til å hente data du bruker i Liquid, bruker variabelsyntaksen «camel case». For å hente datoen et produkt ble opprettet, angir du for eksempel {{ product.createdAt }}. Hvis du bruker Liquid-syntaksen i et Shopify-tema, angir du {{ product.created_at }}.
Betingelsesbaserte og iterasjonsbaserte Liquid-tagger
Av og til kan det være lurt å bruke Liquid-tagger til å gjøre følgende:
Skrive betingelsesbaserte erklæringer, som å se om totalsummen for en bestilling er større enn 100 USD
Gå gjennom en liste med objekter, som å returnere data for hver varelinje i en bestilling
Du kan bruke Liquid-tagger til å skrive disse erklæringene og gå gjennom objekter.
Følgende Liquid viser for eksempel bestillingsnummeret hvis totalsummen for bestillingen er større enn 100 USD:
Du kan også bruke en for-løkke til å gå gjennom en liste med objekter, som varelinjer i en bestilling. Følgende Liquid-kode viser for eksempel navnet på hver varelinje i en bestilling:
Flow støtter også følgende betingede Liquid- (eller kontrollflyt)-merker:
Med filtre kan du endre data i Liquid. Flow støtter alle Liquid-filtre med åpen kildekode.
Følgende Liquid-kode fjerner for eksempel et prefiks fra bestillingsnavnet og returnerer det som gjenstår: {{ order.name | remove: "Order-" }}
I tillegg til standardfiltre for Liquid, gir Flow datofiltre for å hente en dato som er relativ til en annen dato for å støtte utløseren Planlagt tid og funksjonen Hent data. Disse filtrene er: date_minus og date_plus.
Slik returnerer du en dato én dag i fremtiden:{{ "now" | date_plus: "1 day" }}
Slik returnerer du en dato én dag i fortiden:{{ "now" | date_minus: "1 day" }}
Disse filtrene godtar second, minute, day, week, month og year som varighetsenhet, både i entall (som second) og flertall (som seconds). I tillegg til dette formatet kan du også oppgi et heltall (antall sekunder). For eksempel:{{ "now" | date_minus: 3600 }}
Du kan også oppgi en ISO8601-varighetsstreng, der P1Y2D betyr 1 år og 2 dager:{{ "now" | date_minus: "P1Y2D" }}
Hensyn ved bruk av Liquid-variabler i filtre
Flow støtter ikke punktnotasjon, som er tilgjengelig for noen filtre. Flow støtter for eksempel {{ order.lineItems | size }}, men ikke {{ order.lineItems.size }}.
Flow støtter ikke punktnotasjon for metafelter. Du kan for eksempel ikke bruke {{ order.metafields.custom.hold_note }}. I stedet må du kjøre en løkke over metafeltene, som vist i eksemplene.
Flow støtter ikke bruk av indekser for å hente elementer i en liste. Du kan for eksempel ikke bruke {{ order.lineItems[0].title }}. Du må i stedet kjøre en løkke over varelinjene, som vist i eksemplene.
Eksempler
For å få et bedre inntrykk av hvordan du kan bruke Liquid-variabler kan du se følgende eksempler.
URL-adresser for resultater for ressurser
Du ønsker å returnere URL-adresser for kunde, bestilling og produkt som er involvert i en arbeidsflyt.
Konverter en liste med tagger til et metafelt
Du vil konvertere et sett med tagger til et metafelt som er en liste med énlinjes tekstfelter. Du oppretter en arbeidsflyt ved hjelp av utløseren Produkt lagt til i butikk, og bruker handlingen Oppdater produktmetafelt. Legg til følgende Liquid-kode i seksjonen Verdi for handlingen Oppdater produktmetafelt. Dette eksempelet forutsetter at du bare trenger å angi verdiene én gang når produktet opprettes, og at produktet har to relevante tagger: color:red og color:orange.
Liquid-eksempel for å angi listen for et énlinjes tekstfelt.
Du ønsker å opprette en arbeidsflyt for å sende en e-postmelding til en ansatt når en kunde bruker mer enn 500 USD på en bestilling. Du oppretter en arbeidsflyt ved hjelp av utløseren Bestilling opprettet, angir en betingelse som er sann hvis totalsummen for bestillingen er over 500 USD, og bruker handlingen Send intern e-postmelding. Bruk følgende variabler i seksjonen Melding for handlingen Send intern e-postmelding.
Eksempel på bruk av variabler for å oppgi kundeopplysninger
Overtre
Utdata
Send en personlig takkemelding til {{ order.customer.firstName }} {{ order.customer.lastName }}({{ order.customer.email }}) for å ha lagt inn en bestilling på {{ order.totalPriceSet.shopMoney.amount }} USD .
Send en personlig takkemelding til Jeanne Dupong (jeanne@example.com) for å ha lagt inn en bestilling på 763,42 USD.
Skriv en dynamisk e-postmelding for et produkt med lav lagerbeholdning
Du bestemmer deg for å at du må informere et personalmedlem når lagerantallet blir lavt og det må legges inn en bestilling for nye lagervarer. Du oppretter en arbeidsflyt som starter med utløseren Lagerantall endret, og angir betingelsen som sann hvis lagerantallet før er mindre enn eller lik 10. I delen Melding for handlingen Send intern e-post bruker du følgende variabler.
Eksempler på bruk av variabler for å oppgi vareopplysninger.
Overtre
Utdata
Bestill mer av {{ product.title }}. Send en e-post til owner@store.com for å bekrefte at de har mottatt innkjøpsordren.
Bestill mer av Leggings med høyt liv – Sort. Send en e-post til owner@store.com for å bekrefte at de har mottatt innkjøpsordren.
Skriv en dynamisk e-postmelding for å varsle personalet om en falsk bestilling
Du vil kansellere bestillinger med et høyt risikonivå, men foretrekker at personalet manuelt kansellerer bestillingen. Du oppretter en arbeidsflyt som starter med utløseren Bestilling opprettet, og angir en betingelse som er sann hvis risikonivået for bestillingen tilsvarer høyt. I delen Melding for handlingen Send intern e-post bruker du følgende variabler.
Eksempler på bruk av variabler for oppgi informasjon om en falsk bestilling.
Overtre
Utdata
Shopify-butikken vår har mottatt en bestilling med høy svindelrisiko. Vi vil gjerne kansellere denne bestillingen umiddelbart, før den sendes i produksjon:
Shopify-butikken vår har mottatt en bestilling med høy svindelrisiko. Vi vil gjerne kansellere denne bestillingen umiddelbart, før den sendes i prdouksjon:
#1001 Dupont, Jeanne jeanne@example.com
Bekreft den nye bestillingsstatusen. Takk!
Returner varelinjer for en bestilling ved hjelp av en for-løkke
Når en bestilling er mottatt, kan det være nyttig å sende en melding som inneholder produktene som er bestilt. Dette kan du gjøre ved å bruke for loop, som kjører en blokk med kode gjentatte ganger. Tekstfelter som støtter variabler støtter også for-lokker og forloop-objektet.
Du vil for eksempel opprette en arbeidsflyt som returnerer en liste over alle SKU-er og antall i en bestilling. I delen Melding for handlingen Send intern e-post bruker du følgende variabler.
Eksempel på bruk av en for-loop for å oppgi bestillingsinformasjon.
Overtre
Utdata
Bestillingssammendrag: {% for a in order.lineItems %} SKU: {{a.sku}} ( {{a.quantity}} ), {% endfor %}
Returner varelinjer for en bestilling ved hjelp av en for-løkke med tilleggsinformasjon
Du bestemmer deg for å legge til mer informasjon i e-posten, inkludert produktnavn, SKU-er, pris per vare og kundens leveringsinformasjon. I delen Melding for handlingen Send intern e-post bruker du følgende variabler.
Eksempel på bruk av en for-loop for å gi mer omfattende bestillingsinformasjon.
Overtre
Utdata
Bestillingssammendrag: {% for a in order.lineItems %} Produkt: {{a.title}} SKU: {{a.sku}} Pris (per vare): {{a.originalUnitPriceSet.shopMoney.amount}} USD Antall: {{a.quantity}} {% endfor %}
Returner noen varelinjer ved å kombinere en for-løkke med en if-erklæring
Du har behov for å spore solgte varer som leveres av en bestemt leverandør. I delen Melding for handlingen Send intern e-post bruker du følgende variabler og legger ved en if-kommando i for loop.
Eksempel på bruk av en for-loop og en if-kommando for å oppgi bestillingsinformasjon for bestemte leverandører.
Overtre
Utdata
Acme-produkt solgt: {% for x in order.lineItems %} {% if x.vendor == 'acme-vendor' %} Produktnavn: {{x.title}} SKU: {{x.sku}} {% endif %} {% endfor %}
Acme-produkt solgt: Produktnavn: Leggings med høyt liv – Sort SKU: 8987097979
Kompliserte dataobjekter i Shopify Flow
Flow gir deg tilgang til nesten alle data i GraphQL Admin API. Dette inkluderer komplekse dataobjekter, som lister og objekter. Det er imidlertid noen begrensninger i hva du kan gjøre med disse objektene. Seksjonen oppsummerer disse begrensningene og inneholder eksempler på hvordan de fungerer.
I stedet for å anrope lister og objekter direkte, bør du kjøre en løkke gjennom listen og bare inkludere de feltene du ønsker.
I stedet for å kalle {{ order.lineItems }} direkte, kan du for eksempel bruke følgende format til å anrope bestemt felter. Disse eksemplene inkluderer alle felter som ville vært inkludert ved å anrope listen eller objektet direkte. Kopier og lim inn feltene du trenger.
Textjson
Finner du ikke svarene du leter etter? Vi er her for å hjelpe deg.