Bruke egendefinerte skript i varslingsmaler

Hva er templatskripting?

Varslingsmaler støtter et skriptspråk kalt Liquid (drevet av Scriban). Dette lar deg inkludere forsendelsesdata som ikke er tilgjengelig som en standard flettetagg — som egendefinerte referansefelt — og legge til enkel logikk som "vis kun denne seksjonen hvis en verdi finnes."

Du trenger ikke å være utvikler for å bruke denne funksjonen, men det krever at du skriver kode direkte i malredigereren.

Når bør jeg bruke skripting?

Bruk skripting når:

• Du trenger et referansefelt som ikke har en standard flettetagg (for eksempel en egendefinert ordreferanse lagret under en spesifikk referansetype)
• Du ønsker å vise eller skjule en seksjon avhengig av om en verdi er til stede
• Du må bygge en egendefinert URL ved hjelp av forsendelsesdata

For standardfelter som mottakernavn, ordrenummer eller sporingslenke — bruk de vanlige flettetaggene. Skripting er for spesialtilfeller.
 

Hvor du legger til skript i redigereren

Skript må legges til inne i en eksisterende innholdsblokk — ikke som en egen frittstående blokk. Hvis du legger til en skriptblokk alene, vil det opprette en tom åpning i e-posten din.

Det er to steder du vanligvis vil legge til skript:

1. Inne i en tekstblokk — for å vise en verdi som en del av e-postteksten din
2. Inne i en knappes lenkefelt — for å bygge en dynamisk URL

Eksempel 1: Vis et referansefelt i e-posttekst

Dette eksempelet viser hvordan du viser en egendefinert referanseverdi (referansetype 7 — mottakerreferanse) i e-posten din.

1. Åpne malen din. Gå til Portal > Settings > Notifications > Templates og åpne malen du vil redigere.
    
2. Klikk inn i tekstblokken der du vil at verdien skal vises. Skriptet må ligge i samme blokk som teksten rundt — ikke i en separat blokk.
    

3. Skriv skriptet i starten av blokken. Lim inn følgende helt i begynnelsen av tekstblokken, før annet innhold:

   {%- for rf in references -%}{%- if rf.type_id == 7 -%}{%- assign ref_val = rf.value -%}{%- endif -%}{%- endfor -%}

   
   Deretter, på neste linje, legg til etiketten din og vis verdien:

   Mottakerreferanse: {{ ref_val }}

    

4. Forhåndsvis malen. Bruk Preview-knappen og skriv inn en strekkode fra en forsendelse som har en mottakerreferanse. Bekreft at verdien vises korrekt.
    

   

    

Hva hvis referansen er tom for noen forsendelser?

Legg til en reservevisning slik at ingenting ser ødelagt ut. Dette skjuler hele linjen hvis ingen verdi blir funnet:

{%- for rf in references -%}{%- if rf.type_id == 7 -%}{%- assign ref_val = rf.value -%}{%- endif -%}{%- endfor -%}
{% if ref_val %}Mottakerreferanse: {{ ref_val }}{% endif %}

Eksempel 2: Vis en seksjon betinget

Bruk dette for å vise en tekstblokk kun når en bestemt betingelse er oppfylt — for eksempel bare vise hentingsinstruksjoner når en hentekode finnes.

{% if pickup_code %}
Din hentekode er: {{ pickup_code }}
Vennligst vis denne koden når du henter pakken.
{% endif %}

Eksempel 3: Dynamisk knapp-URL

I stedet for å lenke til en fast URL, kan du inkludere forsendelsesdata i lenken.

1. Legg til en knapp-blokk i malen din.
    

2. Åpne knappens lenkeinnstillinger og skriv inn URL-en din. For enkle felt, skriv URL-en direkte i lenkefeltet:

   https://anywebsite.no/?s={{any_number}}

   
   
   For en referanseverdi i URL-en:

   {%- for rf in references -%}{%- if rf.type_id == 7 -%}{%- assign ref_val = rf.value -%}{%- endif -%}{%- endfor -%}https://yourwebsite.com/search?ref={{ ref_val }}

   Note: Hold alt på én linje uten mellomrom mellom skriptet og URL-en.

Vanlige referanse type-ID-er

Referanser identifiseres ved et type_id-nummer. Bytt ut 7 i eksemplene over med type-ID-en for feltet du trenger.

Hvis du ikke er sikker på hvilken type-ID feltet ditt bruker, sjekk forsendelsen i Shipment Data API eller kontakt nShift support.