Templates
Mit Text Templates kannst du in Xentral Connect Ausgabeformate für Daten definieren, die in Workflows verwendet werden.
1. Überblick
Text Templates gehören zu den flexibelsten Komponenten in Xentral Connect. Mit Text Templates kannst du in Xentral Connect Ausgabeformate für Daten definieren, die in Workflows verwendet werden. Sie ermöglichen es dir, Daten aus einem Workflow in ein bestimmtes Format zu bringen – z. B. CSV, XML, EDI, HTML oder eigene Textdateien.
Ein Text Template ist dabei eine Komponente, die du direkt im Workflow Designer verwenden kannst. Du übergibst Daten aus deinem Workflow an das Template, und der erzeugte Text-Output kann anschließend z. B. als Datei gespeichert oder an ein anderes System übertragen werden.
2. Grundlagen
2.1 Was ist ein Text Template?
Ein Text Template ist ein Twig-Template, das Daten aus einer Datenstruktur in ein gewünschtes Textformat bringt.
Typische Anwendungsfälle:
Export von Produktdaten als CSV-Datei
Erzeugung von XML- oder EDI-Dateien für Datenaustausch
Erstellung von HTML-Ausgaben (z. B. Berichte oder E-Mails)
Dynamische Lückentexte, bei denen Variablen ersetzt werden
Der Output eines Text Templates ist nicht die Datei selbst, sondern der Inhalt.
Wenn du eine Datei erzeugen möchtest (z. B. .csv), nutzt du anschließend z. B. die FTP-Komponente, um diesen Inhalt als physikalische Datei abzulegen.
2.2 Wofür benötigt man Text Templates?
Ein Text Template wird immer dann eingesetzt, wenn du Daten aus Workflows in ein definiertes Ausgabeformat transformieren möchtest.
Typische Anwendungsfälle:
Export von Produktdaten als CSV für Google Shopping
Erzeugung von XML-Dateien für Marktplätze
Ausgabe von EDI-Nachrichten
Generieren von HTML-Texten (Berichte, HTML-E-Mails)
Formatierte Textdateien mit dynamischen Variablen
Der Ablauf ist einfach:
Workflow verarbeitet Daten
Daten werden an die Text Template Komponente übergeben
Das Template formatiert sie als Text-Ausgabe
Diese Textausgabe kannst du z. B. mit der FTP-Komponente als Datei ablegen
Wichtig: 👉 Der Output eines Text Templates ist immer der Dateiinhalt, nicht die Datei selbst. Das tatsächliche Schreiben erfolgt über z. B. FTP, S3, HTTP Upload usw.
2.3 Welche Ausgabeformate sind möglich?
Text Templates sind extrem flexibel: Alles, was Text ist, kann generiert werden.
Mögliche Formate:
CSV
XML
JSON
HTML
EDI-Nachrichten
BMECat
DATANORM
Freiform-Text (Lückentext, Dokumentfragmente, Beschreibungen)
Twig unterstützt u. a.:
Schleifen
Bedingungen
Formatierungsfunktionen
Datumsoperationen
Filters (z. B.
upper,lower,replace)
Damit kannst du auch hochkomplexe Ausgabestrukturen definieren.
3. Anwendungsbeispiele
Neben CSV-Dateien kannst du Text Templates auch für viele andere Ausgabeformate verwenden:
XML
Strukturierte Datenformate, z. B. für EDI oder BMEcat
HTML
Ausgabe als Webansicht oder Bericht
JSON
Export für API-Integrationen
Custom Text
Individuelle Formate, z. B. Lückentexte oder einfache Textdateien
Dank der Twig-Funktionalitäten bist du sehr flexibel und kannst auch komplexe Strukturen mit Bedingungen, Schleifen und Formatierungen erstellen.
Basis-Konfiguration
Unter Konfiguration bearbeiten (⚙️) findest du die wichtigsten Einstellungen:
Name: Bezeichnung des Templates
Typ: legt das Ausgabeformat fest (z. B. CSV, XML, HTML)
Basis-Datenstruktur: bestimmt die Datenquelle
Die Auswahl der Datenstruktur ist bindend – nachträglich kann sie nicht mehr geändert werden.
Integration in Workflows
Text Templates werden genauso genutzt wie andere Komponenten:
Text Template Komponente in den Workflow ziehen
Template auswählen
Datenstruktur als Input übergeben
Output in einer Datei-Komponente speichern oder weiterverarbeiten
Der resultierende Text kann z. B. über folgende Komponenten weiterverarbeitet werden:
FTP/SFTP-Komponente: Datei-Upload oder -Ablage
E-Mail-Komponente: Versand als E-Mail-Anhang
File Writer: Speicherung als Datei im System
Best Practices
Verwende aussagekräftige Namen für deine Templates (z. B.
product_export_csv).Baue Templates modular – wiederverwendbare Teile (z. B. Kopfzeilen) können dupliziert werden.
Teste die Ausgabe regelmäßig mit Beispiel-Daten.
Nutze Twig-Hilfsfunktionen, um Strings, Zahlen oder Datumsangaben zu formatieren.
Beispiel-Use-Case
Ein typisches Anwendungsszenario:
Du möchtest Produktdaten exportieren, um sie in Google Shopping zu importieren.
Dazu erstellst du ein Text Template im CSV-Format, das die Felder Product ID, Title und Price enthält.
Der Workflow exportiert anschließend die CSV-Datei per FTP auf deinen Webserver.
5. Beispiel: Erstellen eines CSV-Exports
5.1 Header anlegen
5.2 Variablen einfügen
Durch Anklicken der Felder werden die Variablen eingefügt:
5.3 Speichern und verwenden
Im Default-Projekt: Speichern möglich
Im Standard-Projekt: Schreibrechte gesperrt
Das Template kann danach in jedem Workflow über die Text Template Komponente genutzt werden.
9. Zusammenfassung
Text Templates erzeugen flexible, dynamische Text-Ausgaben auf Basis einer Datenstruktur.
Sie verwenden Twig zur Formatierung.
Sie ermöglichen praktisch jedes Ausgabeformat (CSV, XML, EDI, HTML, Freitext, …).
Der Output ist der Dateiinhalt, nicht die Datei selbst.
Dateien werden anschließend über andere Workflow-Komponenten gespeichert oder versendet.
Das Tool ist sehr flexibel und ermöglicht schnelle Erstellung von Exportformaten für Integrationen.
Zuletzt aktualisiert
War das hilfreich?