Benutzerdefinierte Scripts in Benachrichtigungsvorlagen verwenden

Was ist Template-Scripting?

Benachrichtigungsvorlagen unterstützen eine Skriptsprache namens Liquid (powered by Scriban). Damit können Sie Versanddaten einbinden, die nicht als Standard-Platzhalter verfügbar sind — z. B. benutzerdefinierte Referenzfelder — und einfache Logik hinzufügen wie „Diesen Abschnitt nur anzeigen, wenn ein Wert vorhanden ist."

Sie müssen kein Entwickler sein, um diese Funktion zu nutzen, aber sie erfordert, dass Sie Code direkt in den Vorlagen-Editor eingeben.

Wann sollte ich Scripting verwenden?

Verwenden Sie Scripting, wenn:

• Sie ein Referenzfeld benötigen, das keinen Standard-Platzhalter hat (z. B. eine benutzerdefinierte Auftragsreferenz, die unter einem bestimmten Referenztyp gespeichert ist)
• Sie einen Abschnitt ein- oder ausblenden möchten, je nachdem, ob ein Wert vorhanden ist
• Sie eine benutzerdefinierte URL mit Versanddaten aufbauen müssen

Für Standardfelder wie Empfängername, Auftragsnummer oder Tracking-Link — verwenden Sie die regulären Platzhalter. Scripting ist für Sonderfälle gedacht.

Wo Scripts im Editor hinzugefügt werden

Scripts müssen innerhalb eines bestehenden Inhaltsblocks hinzugefügt werden — nicht als separater eigenständiger Block. Wenn Sie einen Script-Block allein hinzufügen, entsteht eine leere Lücke in Ihrer E-Mail.

Es gibt zwei Stellen, an denen Sie Scripts typischerweise hinzufügen:

1. Innerhalb eines Textblocks — um einen Wert als Teil Ihres E-Mail-Textes auszugeben
2. Innerhalb des Linkfelds einer Schaltfläche — um eine dynamische URL zu erstellen

Beispiel 1: Ein Referenzfeld im E-Mail-Text anzeigen

Dieses Beispiel zeigt, wie Sie einen benutzerdefinierten Referenzwert (Referenztyp 7 — Empfängerreferenz) in Ihrer E-Mail anzeigen.

1. Öffnen Sie Ihre Vorlage. Gehen Sie zu Portal > Settings > Notifications > Templates und öffnen Sie die Vorlage, die Sie bearbeiten möchten.
2. Klicken Sie in den Textblock, in dem der Wert erscheinen soll. Das Script muss sich im selben Block befinden wie der umgebende Text — nicht in einem separaten Block.

3. Geben Sie das Script am Anfang des Blocks ein. Fügen Sie Folgendes ganz am Beginn des Textblocks ein, vor allen anderen Inhalten:

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

   Fügen Sie dann in der nächsten Zeile Ihre Bezeichnung hinzu und geben Sie den Wert aus:

   Receiver reference: {{ ref_val }}

4. Zeigen Sie eine Vorschau der Vorlage an. Verwenden Sie die Schaltfläche Preview und geben Sie einen Barcode einer Sendung ein, die eine Empfängerreferenz hat. Vergewissern Sie sich, dass der Wert korrekt angezeigt wird.

   

Was ist, wenn die Referenz bei einigen Sendungen leer ist?

Fügen Sie einen Fallback hinzu, damit nichts fehlerhaft aussieht. Dadurch wird die Zeile vollständig ausgeblendet, wenn kein Wert gefunden wird:

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

Beispiel 2: Einen Abschnitt bedingt anzeigen

Verwenden Sie dies, um einen Textblock nur dann anzuzeigen, wenn eine bestimmte Bedingung erfüllt ist — z. B. Abholhinweise nur anzeigen, wenn ein Abholcode vorhanden ist.

{% if pickup_code %}
Your pickup code is: {{ pickup_code }}
Please show this code when collecting your parcel.
{% endif %}

Beispiel 3: Dynamische Schaltflächen-URL

Anstatt auf eine feste URL zu verlinken, können Sie Versanddaten in den Link einbinden.

1. Fügen Sie Ihrer Vorlage einen Schaltflächenblock hinzu.

2. Öffnen Sie die Linkeinstellungen der Schaltfläche und geben Sie Ihre URL ein. Für einfache Felder geben Sie die URL direkt in das Linkfeld ein:

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

   

   Für einen Referenzwert in der URL:

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

   Note: Keep everything on one line with no space between the script and the URL.

Häufige Referenztyp-IDs

Referenzen werden durch eine type_id-Nummer identifiziert. Ersetzen Sie 7 in den obigen Beispielen durch die Typ-ID für das Feld, das Sie benötigen.

Wenn Sie nicht sicher sind, welche Typ-ID Ihr Feld verwendet, überprüfen Sie die Sendung in der Shipment Data API oder wenden Sie sich an den nShift-Support.