Best Practices
Möglichkeiten und Vorteile von TextTemplates:
- Daten aus dem DataStore mithilfe eines Workflows laden und mit einem TextTemplate in ein CSV Dokument umwandeln
- automatisierte EDIFACT Nachrichten schreiben, die aus Bestelldaten generiert werden
- Parameter erstellen und im Rahmen eines Workflows einbinden
Beim Typ 'DataStructure' wird nur ein Datensatz verarbeitet, z. B. eine Bestellung, die in eine EDIFACT Nachricht umgewandelt wird. Mit dem Typ 'DataStructure Liste' werden mehrere Datensätze verarbeitet, z. B. zum Generieren einer CSV Datei.
Die Twig Funktionen können ganz einfach per Klick auf das Element in die Zwischenablage kopiert und im Editor eingefügt werden. Neben den in yedi verfügbaren Funktionen können auch eigene Twig-Funktionen manuell in den Editor eingegeben werden. Eine Dokumentation der Twig Funktonien ist hier zu finden: https://twig.symfony.com/doc/3.x/
- gewünschtes Feld aus der Datenstruktur auf der linken Seite kopieren und in den TextTemplate Editor einfügen
- Twig Funktion "Nummer formatieren" auf der rechten Seite kopieren und direkt hinter den Feldnamen (vor die geschweiften Klammern) einfügen
- das erste Argument definiert die Anzahl an Nachkommastellen
- das zweite Argument definiert die Dezimalstelle
- das dritte Argument definiert das Tausendertrennzeichen
- Beispiel: {{ orders_entry.invoiceAmount | number_format(2, ',', '.') }}
- Weitere Informationen sind hier zu finden: https://twig.symfony.com/doc/3.x/filters/number_format.html
Mit Klick auf eine Collection aus der Datenstruktur auf der linken Seite wird eine for-Schleife in die Zwischenablage kopiert. Diese Schleife iteriert durch alle Elemente aus der Collection. Innerhalb der for-Schleife stehen die Elemente dann einzeln zur Verfügung.
Mit folgendem Twig-Code werden beispielsweise die Preise der Artikel einer Bestellung durchiteriert und zu einer Liste ("prices") hinzugefügt, sodass anschließend das erste Element (der erste Preis) aus der Liste ausgewählt werden kann.
- gewünschtes Feld aus der Datenstruktur auf der linken Seite kopieren und in den TextTemplate Editor einfügen
- Gewünschten Text-Operator auf der rechten Seite kopieren und direkt hinter den Feldnamen (vor die geschweiften Klammern) einfügen
- Beispiele für Textoperatoren:
- Text ersetzen (|replace)
- Text zu Groß- bzw. Kleinschreibung umwandeln (|upper bzw. |lower)
- Führende und/ oder nachfolgende Zeichen entfernen (|trim)
Im Folgenden Twig-Code werden Leerzeichen am Anfang und am Ende der Zeichenfolge entfernt sowie die Abkürzung 'EUR' mit 'Euro' ersetzt.