Unser Variablen-Editor ermöglicht dir die Erstellung benutzerdefinierter Variablen. Dabei stehen dir zahlreiche Optionen zur Verfügung, die Raum für kreative Anpassungen lassen. Wir zeigen dir, für welche Anwendungsfälle du sie einsetzen kannst.

Wie Du individuelle Variablen erstellen kannst

Klicke auf “Vorlagen” unter dem Konfigurationsbereich. Wähle dann den “Variablen Editor” aus. 

Du kannst eine neue Variable erstellen, indem du auf “Variable erstellen” und dann auf “Neu” klickst. Öffne daraufhin auf der rechten Seite den Code-Editor.

Im Code Editor erstellst du deine individuellen Handlebars für deine Vorlagen.

Eine Handlebar baut sich grundsätzlich folgendermaßen auf:

{{#Bedingungsblock-Helper (Bedingung)}} Bedingte Anzeige {{/Bedingungsblock-Helper}}

Bedeutung der Handlebar-Syntax

{{ }}-Klammern

Diese doppelten geschweiften Klammern {{ }} dienen in Handlebars als Platzhalter oder Marker für Vorlagen-Variablen. Alles, was sich zwischen diesen Klammern befindet, wird als Handlebars-Ausdruck interpretiert und später durch den tatsächlichen Wert ersetzt.

#Bedingungsblock-Helper

Der #Bedingungsblock-Helper ist ein spezielles Konstrukt in Handlebars, das verwendet wird, um bedingte Anweisungen in Handlebars-Vorlagen zu erstellen. Er ermöglicht es, Teile der Vorlage basierend auf einer Bedingung anzuzeigen oder auszublenden. Mögliche Bedingungsblock-Helper sind:

Bedingung

Dies ist der Teil deines Handlebars-Ausdrucks, in dem du eine Bedingung oder einen Vergleich angibst. Es kann ein Vergleich sein, der wahr oder falsch ist.

Die Bedingung baut sich folgendermaßen auf: (Vergleichsoperator Attribut "Wert")

Bedingte Anzeige

Dies ist der Inhalt, der angezeigt wird, wenn die zuvor definierte Bedingung erfüllt ist. Hier kannst du HTML, Text oder andere Handlebars-Platzhalter einfügen. Wenn die Bedingung wahr ist, wird dieser Inhalt gerendert, ansonsten bleibt er ausgeblendet.

Du kannst dir z.B. einen bestimmten Text anzeigen lassen, einen Link oder auch ein Bild. In dieser Hinsicht bieten sich zahlreiche Möglichkeiten. Wir werden sie anhand konkreter Anwendungsfälle erläutern und dir beispielsweise zeigen, was du tun kannst.

{{/Bedingungsblock-Helper}

{{/Bedingungsblock-Helper}}ist das Abschluss-Tag eines Bedingungsblock-Helpers in Handlebars. Dieser Tag markiert das Ende des bedingten Abschnitts innerhalb einer Handlebars-Vorlage.

Mehrere Bedingungen verknüpfen

Wenn du mehrere Bedingungen in Handlebars prüfen möchtest, kannst du sie auf folgende Weisen verknüpfen:

UND-Verknüpfung: Wenn du sicherstellen möchtest, dass beide Bedingungen erfüllt sind, dann schreibst du sie einfach hintereinander.

{{#if(Bedingung1)}} {{#if(Bedingung2)}} Bedingte Anzeige wenn beide Bedingungen wahr sind {{/if}}{{/if}}

ODER-Verknüpfung: Wenn du möchtest, dass entweder die eine oder die andere Bedingung erfüllt wird, dann verwendest du den #else-Block.

{{#if (Bedingung1)}} Hier wird der Inhalt angezeigt, wenn Bedingung1 wahr ist {{else}} {{#if (Bedingung2)}} Hier wird der Inhalt angezeigt, wenn Bedingung2 wahr ist {{/if}} {{/if}}

Erstellen einer Anzeigebedingung

Das war nun der ganz allgemeine Aufbau einer Handlebar, darunter kannst du dir vielleicht noch nicht so viel vorstellen, deshalb möchten wir dir nun erkähren, wie genau du vorgehst, um dir deine Variable zu erstellen:

1. Stelle zunächst deine Bedingung auf:
2. Nun musst du diese in die Handlebar-Snytax übersetzen:

{{#Bedingungsblock-Helper (Bedingung)}} Bedingte Anzeige {{/Bedingungsblock-Helper}}

Anwendungsfall 1: Anzeigen eines bestimmten Texts

Kommen wir nun zu konkreten Anwendungsfällen. Wir werden diese kontinuierlich ergänzen. Sollte die Anzeigebedingung, die du erstellen willst nicht dabei sein, dann melde dich gerne bei uns und wir schauen gemeinsam, wie wir diese umsetzen können.

Bedingung: ”Wenn die Postleitzahl der Lieferadresse “50670” ist, zeige “max.mustermann@epilot.cloud” an.

Übersetzung:

Füge die einzelnen Elemente zusammen:

{{#if (eq opportunity.delivery_address.Primary.postal_code "50670")}} max.mustermann@epilot.cloud {{/if}}

Anwendungsfall 2: Anzeigen von Bildern

Damit du in deiner Anzeigebedingung ein Bild verwenden kannst, musst du dieses zunächst in epilot unter Dateien hochladen. Anschließend stellst du diese dann auf „öffentliche Datei“ und kopierst dort folgenden Link. Diesen musst du in deiner Anzeigebedingung verwenden:

Bild ohne Bedingungen anzeigen lassen

Wenn du einfach nur ein Bild als Variable verwenden möchtest, kannst du folgenden Code in deine individuelle Variable im Code Editor einfügen:

{{<img src="https://epilot-prod-user-content.s3.eu-central-1.amazonaws.com/" height=30 width=100>}}

Den Link tauschst du mit dem öffentlichen Link deiner Datei aus. Die Größe des Bildes kannst du ebenfalls beliebig verändern. Wenn du die Variable kopierst, ist es wichtig, dass du ~~ in die Variable einfügst. Deine Variable sieht dann folgendermaßen aus: {{~~Variable_Test}}.

Bild mit Bedingungen anzeigen lassen

Bedingung: “Wenn der Bearbeiter der Opportunity Max Mustermann heißt, dann soll ein Bild seiner Unterschrift angezeigt werden.”

{{#if (eq opportunity.assignee "Max Mustermann")}} <img src="https://epilot-prod-user-content.s3.eu-central-1.amazonaws.com/" height=30 width=100> {{/if}}

Die Werte für Größe und Style des Bild kannst du beliebig anpassen.

Diese Bedingung lässt sich dann natürlich auch noch erweitern, damit die Namen weiterer Mitarbeiter abgefragt werden. Dafür fügst du einfach mehrere Bedingungen hintereinander ein, dann werden diese nacheinander geprüft:

{{#if (eq opportunity.assignee.0.display_name "Max Mustermann")}} <img src="https://epilot-prod-user-content.s3.eu-central-1.amazonaws.com/Bild1" height=30 width=100> {{/if}}

{{#if (eq opportunity.assignee.0.display_name "Maria Musterfrau")}} <img src="https://epilot-prod-user-content.s3.eu-central-1.amazonaws.com/Bild2" height=30 width=100> {{/if}}

Excel-Formeln

Du kannst in deinen Templates Excel-ähnliche Formeln mit dem calc -Helfer verwenden.

Beispiele:

Preis: {{price}}
Menge: {{qty}}

Gesamt (gerundet auf 2): {{ calc "ROUND(price * qty, 2)" }}
Rabattiert: {{ calc "ROUND((price * qty) * (1 - discount), 2)" }}

Begrenzung mit IF:
{{ calc "IF(qty > 10, 10, qty)" }}

Verwendung benannter Argumente:
{{ calc "ROUND(a + b, 0)" a=fee b=shipping }}

Min/Max:
{{ calc "MAX(price1, price2, price3)" }}

Arithmetische Operatoren

• + - Addition
• - - Subtraktion
• * - Multiplikation
• / - Division
• ^ - Exponentiation
• % - Modulus (Rest der Division)
• () - Klammern zur Gruppierung von Ausdrücken
• -number - Negation (unäres Minus)

Formelfunktionen

• ABS(number) - Gibt den absoluten Wert einer Zahl zurück.
• AND(condition1, condition2, ...) - Gibt true zurück, wenn alle Bedingungen wahr sind.
• AVERAGE(number1, number2, ...) - Gibt den Durchschnitt einer Zahlenmenge zurück.
• CEIL(number) - Rundet eine Zahl auf die nächste ganze Zahl nach oben.
• FLOOR(number) - Rundet eine Zahl auf die nächste ganze Zahl nach unten.
• IF(condition, value_if_true, value_if_false) - Gibt einen Wert zurück, wenn die Bedingung wahr ist, und einen anderen, wenn sie falsch ist.
• MAX(number1, number2, ...) - Gibt die größte Zahl in einer Zahlenmenge zurück.
• MIN(number1, number2, ...) - Gibt die kleinste Zahl in einer Zahlenmenge zurück.
• NOT(condition) - Kehrt den Wahrheitswert des Arguments um. Gibt true zurück, wenn das Argument falsch ist, und false, wenn es wahr ist.
• OR(condition1, condition2, ...) - Gibt true zurück, wenn eine der Bedingungen wahr ist.
• ROUND(number, [places]) - Rundet eine Zahl auf die angegebene Anzahl von Dezimalstellen. Wenn keine Angabe erfolgt, wird auf 0 Dezimalstellen gerundet.
• SUM(number1, number2, ...) - Gibt die Summe einer Zahlenmenge zurück.
• RAND() - Gibt eine Zufallszahl zwischen 0 (einschließlich) und 1 (exklusiv) zurück.

Datumsfunktionen

Alle Datumsfunktionen arbeiten mit ISO 8601-Datumsstrings (z. B. "2025-09-26" oder "2025-09-26T12:00:00Z") und verwenden standardmäßig UTC mit optionaler Zeitzonenunterstützung.

Aktuelles Datum und Uhrzeit

• NOW([timezone]) - Gibt das aktuelle Datum und die aktuelle Uhrzeit zurück.
• TODAY([timezone]) - Gibt nur das aktuelle Datum zurück (ohne Uhrzeit).

Datumsberechnungen

• DATEADD(date, value, unit, [timezone]) - Addiert/Subtrahiert Zeit zu/von einem Datum
      Einheiten: "years", "quarters", "months", "weeks", "days", "hours", "minutes", "seconds"
• DATEDIFF(start_date, end_date, unit, [timezone]) - Berechnet die Differenz zwischen zwei Daten
      Gibt den abgerundeten Wert der Differenz zurück (z. B. 1,9 Monate = 1)

Date components

• YEAR(date, [timezone]) - Gibt das Jahr zurück (z. B. 2025)
• MONTH(date, [timezone]) - Gibt den Monat zurück (1–12)
• DAY(date, [timezone]) - Gibt den Tag des Monats zurück (1–31)
• HOUR(date, [timezone]) - Gibt die Stunde zurück (0–23)
• MINUTE(date, [timezone]) - Gibt die Minute zurück (0–59)
• SECOND(date, [timezone]) - Gibt die Sekunde zurück (0–59)
• WEEKDAY(date, [type], [timezone]) - Gibt den Wochentag zurück
  • type=1: Sonntag=1, Samstag=7 (Excel-Standard)
  • type=2 oder ausgelassen: Montag=1, Sonntag=7 (ISO-Standard)
  • type=3: Montag=0, Sonntag=6

Wochenberechnungen

• WEEKNUM(date, [type], [timezone]) - Gibt die ISO-Kalenderwochennummer des Jahres zurück

Beispiele

<!-- 14 Tage zum Bestelldatum hinzufügen -->
Lieferdatum: {{ calc "DATEADD(order.date, 14, \"days\")" }}

<!-- Alter berechnen -->
Alter: {{ calc "DATEDIFF(birthDate, TODAY(), \"years\")" }} Jahre alt

<!-- Komponenten extrahieren -->
Jahr: {{ calc "YEAR(invoice.date)" }}
Monat: {{ calc "MONTH(invoice.date)" }}

<!-- Geschäftslogik -->
Fälligkeitsdatum: {{ calc "DATEADD(invoice.date, payment.terms, \"days\")" }}
Überfällig: {{ calc "DATEDIFF(invoice.dueDate, TODAY(), \"days\") < 0" }}

<!-- Zeitzonenbehandlung -->
Lokales Datum: {{ calc "TODAY(\"Europe/Helsinki\")" }}