Beispiel 1 - Der erste Flow

Ausgangssituation

Sie haben sich erstmalig in Synesty Studio eingeloggt und möchten die ersten Schritte kennenlernen.

In diesem Beispiel erstellen wir gemeinsam einen einfachen Flow, der eine CSV-Datei von einer URL herunterlädt, einige Spalten anpasst (z.B. Preise berechnet) und die fertige Datei auf einen FTP-Server hochlädt. Dabei lernen Sie das elementare Konzept kennen, wie Sie die Inputs und Outputs der Steps miteinander „verdrahten”.

Der fertige Flow sieht am Ende so aus:

Ziel

Nach diesem Tutorial wissen Sie:

wie man einen Flow anlegt und Steps hinzufügt,
wie man Steps konfiguriert und miteinander verbindet (verdrahtet),
wie man mit dem Mapper Daten transformiert,
wie man einen Flow ausführt und automatisiert.

Schritt 1: Einen neuen leeren Flow erstellen

Loggen Sie sich ein. Klicken Sie auf dem Dashboard unter Schnellstart auf Flow erstellen.

Wählen Sie im nächsten Dialog Leeren Flow erstellen.

Damit ist Ihr erster Flow erstellt und Sie befinden sich in der Flow-Ansicht.

Schritt 2: Steps hinzufügen

Fügen Sie folgende Steps über den „+ Step hinzufügen” Button zum Flow hinzu.

Step 1: UrlDownload

Suchen Sie nach dem Begriff „URL” und wählen Sie den Step UrlDownload aus.

Step 2: SpreadsheetCSVReader

Fügen Sie einen weiteren Step hinzu. Suchen Sie diesmal nach „SpreadsheetCSVReader” und wählen Sie diesen aus.

Sie haben jetzt 2 Steps im Flow:

Schritt 3: Step 1 konfigurieren (UrlDownload)

Klicken Sie in der Flow-Übersicht auf den UrlDownload-Step, um seine Konfiguration zu öffnen.

Tragen Sie im Feld host folgende URL zur Beispiel-CSV-Datei ein:

http://demodata.synesty.com/example-articledata.csv

Klicken Sie anschließend auf Speichern. Der Flow sieht danach so aus:

Steps „verdrahten”

Das graue Icon zeigt an, dass Step 2 den Output von Step 1 als Input verwendet. Diese Verdrahtung von Step-Outputs und Step-Inputs ist ein elementares Konzept in Synesty Studio.

Jeder Step kann die Ausgabe vorheriger Steps verarbeiten. In der Step-Konfiguration können Sie mit dem -Button aus den Outputs der vorherigen Steps wählen.

Schritt 4: Step 2 konfigurieren (SpreadsheetCSVReader)

Den zweiten Step (SpreadsheetCSVReader) müssen Sie in diesem Beispiel nicht weiter konfigurieren – er erkennt automatisch das Format der heruntergeladenen CSV-Datei. Bei anderen Dateien haben Sie jedoch die Möglichkeit, Spaltentrenner und Encoding (z.B. UTF-8 oder ISO-8859-1) anzupassen.

Step-Vorschau nutzen

Jeder Step besitzt eine Vorschau-Funktion. Klicken Sie beim zweiten Step auf das Augen-Symbol, um sich die Ausgabe anzusehen. Dadurch werden alle Steps bis einschließlich diesem ausgeführt und das Ergebnis angezeigt.

Sie sehen eine Vorschau der CSV-Datei, die von der konfigurierten URL heruntergeladen und in eine Tabelle umgewandelt wurde.

Schritt 5: Daten transformieren (Mapper)

Bisher haben wir die Datei nur heruntergeladen und in eine lesbare Tabellenform gebracht. In den meisten Fällen möchte man die Daten jedoch auch verändern oder anpassen.

Fügen Sie nun den Mapper Step (vollständiger Name: SpreadsheetMapper) dem Flow hinzu:

Der Mapper ist der wichtigste Step in Synesty Studio – Sie werden ihn in nahezu jedem Flow benötigen. Immer wenn es darum geht, Daten oder Spalten zu transformieren, Werte zu berechnen oder Felder umzubenennen, kommt dieser Step zum Einsatz.

Der Flow besteht nun aus 3 Steps:

Step 3 konfigurieren (Mapper)

Klicken Sie auf das Zahnrad-Symbol des Mapper-Steps und dann auf den erscheinenden Configure-Button.

Der Mapping Editor

Sie sehen nun den Transformy Mapping Editor – das leistungsstärkste Werkzeug zur Datenmanipulation in Synesty Studio. Sie können es sich vorstellen wie die Formel-Funktionen in Excel oder Google Sheets, nur vollständig automatisiert.

Da noch keine Vorschaudaten geladen sind, klicken Sie auf den Button „Daten aus vorherigen Steps holen”. Dadurch werden alle vorherigen Steps ausgeführt, und die Daten stehen für die Konfiguration bereit.

Beispiel: Preis in Abhängigkeit des Lagerbestands berechnen

Nehmen wir an, wir möchten den Preis in Abhängigkeit des Lagerbestands in der Spalte stock verändern: Bei einem Bestand von mehr als 100 Stück soll ein Rabatt von 50 % gewährt werden, ansonsten bleibt der Preis unverändert.

Zur Veranschaulichung benennen wir die Spalte description in priceBefore um und wählen price als Quelle. Schieben Sie die Spalten über die Pfeilsymbole so, dass priceBefore, price und stock nebeneinander erscheinen.

Öffnen Sie die Funktionen der Spalte price durch Klick auf das WENN-DANN Generator Symbol.

Wählen Sie das Tab Bedingung generieren und füllen Sie das Formular wie im folgenden Screenshot aus:

Hinweis: Kopieren Sie folgenden Ausdruck in das Feld DANN und wählen Sie dabei Wert aus Spalte:

price?number * 0.50

Durch Klick auf Bedingung erstellen wird folgender Ausdruck in das Wert-Feld der Spalte price eingetragen:

<#if (stock?number > 100)>${price?number * 0.50}<#else>${price}</#if>

Dies bedeutet: Wenn stock größer als 100 ist, dann multipliziere den Preis mit 0,50 (50 % Rabatt), andernfalls behalte den ursprünglichen Preis.

Drücken Sie nun den Button Vorschau anzeigen:

Hier sehen Sie das eingetragene WENN-DANN-Skript in Freemarker-Syntax.
Mit diesem Button aktualisieren Sie die Vorschau.
Im Ergebnis sehen Sie, dass die Preise in den markierten Spalten halbiert sind, weil der Lagerbestand > 100 ist.

Rundung auf 2 Dezimalstellen

Wie Sie vielleicht bemerkt haben, haben die berechneten Werte nun 3 Nachkommastellen. Um auf 2 Stellen zu runden, nutzen Sie die Runden-Funktion:

Beispiel-CSV-Datei herunterladen

Bei großen Dateien ist es praktisch, eine Beispieldatei herunterzuladen, um diese z.B. mit Excel zu prüfen:

Speichern Sie alle Einstellungen mit dem Speichern-Button , um zur Flow-Ansicht zurückzukehren.

Schritt 6: CSV-Datei erstellen (CSVWriter)

Der Output des Mappers ist ein Spreadsheet (eine interne Tabellenstruktur). Um daraus eine echte, physische CSV-Datei zu erzeugen, fügen Sie den Step CSVWriter dem Flow hinzu:

Konfigurieren Sie den Step: Geben Sie unter filename einen Dateinamen ein, z.B. meineCSVDatei.csv, und klicken Sie auf Speichern.

Schritt 7: Datei hochladen (FTPUpload)

Im letzten Schritt laden wir die erstellte CSV-Datei auf einen FTP-Server hoch. Fügen Sie den Step FTPUpload dem Flow hinzu:

Konfigurieren Sie den FTP-Upload mit den Zugangsdaten Ihres FTP-Servers (Host, Benutzername, Passwort, Zielverzeichnis).

Der fertige Flow

Der vollständige Flow sollte am Ende wie folgt aussehen:

Führen Sie den Flow jetzt aus, indem Sie auf den Button klicken. Der Flow wird sofort im Hintergrund komplett ausgeführt.

Nach erfolgreicher Ausführung sollte die neue CSV-Datei auf Ihrem FTP-Server liegen.

Flow automatisieren (Scheduling)

Wenn dieser Flow automatisch zu bestimmten Zeiten laufen soll (z.B. einmal täglich), klicken Sie in der Flow-Ansicht auf den Planen-Button . Dort legen Sie Startzeit und Interval fest. Durch Setzen des Status auf aktiv und anschließenden Klick auf Update wird der Flow aktiviert.

Damit haben Sie Ihren ersten Flow erstellt und automatisiert – herzlichen Glückwunsch!

Ausführungsstatus prüfen

Den Status vergangener und laufender Flow-Ausführungen können Sie jederzeit im Event Log einsehen:

Zusammenfassung

In diesem Tutorial haben Sie die grundlegenden Konzepte bei der Arbeit mit Synesty Studio kennengelernt:

Flow anlegen – aus dem Dashboard heraus einen leeren Flow erstellen
Steps hinzufügen – UrlDownload, CSVReader, Mapper, CSVWriter, FTPUpload
Steps verdrahten – Outputs vorheriger Steps als Input nutzen
Mapper konfigurieren – Daten mit WENN-DANN-Logik transformieren
Flow ausführen und automatisieren – manueller Start und Scheduling

Sie können diesen Flow nun als Ausgangspunkt für Ihre eigenen Integrationen verwenden. Statt des FTP-Uploads können Sie z.B. auch einen E-Mail-Versand oder einen Upload zu einem Cloud-Speicher verwenden. Die Möglichkeiten sind sehr vielfältig.

Die wichtigsten Kern-Steps für Ihre nächsten Flows finden Sie unter Basis-Steps.