DotLiquid für JTL-Anwender

Platzhalter in DotLiquid

Es gibt zwei Typen von Platzhaltern in DotLiquid, den Output- und den Tag-Platzhalter.

Output-Platzhalter sind umgeben von zwei geschweiften Klammern und geben einen Text aus.

{{ Variable }}

Tag-Platzhalter sind umgeben von zwei Prozentzeichen und jeweils einer geschweiften Klammer. Sie enthalten zum Beispiel Abfragen, Verzweigungen oder Schleifen und geben keinen Text aus.

{% Abfrage Wenn, Dann, Sonst %}

Beispiel: Einfache Ausgabe

Ein einfaches Beispiel für eine Ausgabe:

Hallo {{ name }}. => Hallo Name.
Hallo {{ user.name }}. => Hallo Kunden.Name.
Hallo {{ 'Tobi' }}. => Hallo Tobi.

Beispiel: Ausgabe mit Filter

DotLiquid bringt einige Filter bereits von Haus aus mit, JTL hat diese um zusätzliche Filter ergänzt. Der erste Parameter des Output-Platzhalters ist stets die Variable für die Ausgabe, im Anschluss folgen durch einen Balken (Pipe) getrennt und immer linksseitig die zu verwendenden Filter. Das Ergebnis des ersten Filters ist gleichzeitig die Ausgabe für einen darauf folgenden Filter. Mehrere Filter können entsprechend verschachtelt werden und von links nach rechts abgearbeitet. Nach dem letzten Filter resultiert das Ergebnis in eine Textausgabe (String).

Einige Beispiele für erweiterte Ausgaben:

Hallo, {{ 'tobi' | Upcase }}. => Hallo, TOBI.
Hallo, Tobi hat {{ 'tobi' | Size }} Buchstaben! => Hallo, Tobi hat 4 Buchstaben!
Hallo, wir haben heute den {{ Datum.Jetzt | Datum: "dd.MM.yyyy" }}. => Hallo, wir haben heute den 08.11.2013.

Besonderheiten in JTL-Wawi

• Alle Variablen die Ihnen aus List&Label bekannt sind, stehen Ihnen auch in DotLiquid zur Verfügung.
• Zusätzlich gibt es einige Sondervariablen
• Firma.* => Alle Details zur Firma wie in List&Label, zum Beispiel Firma.Name, Firma.PLZ ..
• Vorgang.* => Alle Details zum aktuellen Vorgang, zum Beispiel Vorgang.Lieferschein.Auftrag.Vorname ..
• Datum.Jetzt => Aktueller Zeitstempel mit Datum und Uhrzeit
• Datum.Gestartet => Zeitpunkt, zu dem der Ausgabevorgang gestartet wurden
• Verzeichnisse.Desktop => Der Speicherpfad zu Ihrem Desktop
• Verzeichnisse.EigeneDateien => Der Speicherpfad zu Ihren Eigenen Dateien
• Tabulator => Fügt ein Tabulator-Zeichen ein
• Alle Filter müssen im sogenannten CamelCase geschrieben werden, zum Beispiel Date statt date oder DividedBy statt divided_by
• Datum-Strings werden im C#-Format angegeben, nicht im Ruby-Format

Video

In diesem Video zeigen wir Ihnen, wie Sie Dotliquid-Code einrücken können und somit eine bessere Übersicht erhalten.