Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


 

 

Info
titleErste Schritte

Als Ergänzung zu dieser Seite empfehlen wir die Seite Erste Schritte. Diese Seite erklärt am Beispiel, wie man Flows erstellt und die folgenden wichtigsten Kern-Steps:

 



Table of Contents
outlinetrue

...

  • Es gibt Steps für unterschiedlichste Systeme und Funktionen wie z.B. Daten holen, Daten bearbeiten und Daten wieder ausgeben oder hoch laden.
  • Ein Flow kann manuell und automatisiert ausgeführt werden.
  • Alle Steps in einem Flow werden nacheinander ausgeführt. 
  • Jeder Step kann die Ausgabe vorheriger Steps weiter bearbeiten (stellen Sie sich mehrere Trichter hintereinander vor).
  • Jede Ausführung eines Flows wird als Run bezeichnet. 
  • Jeder Run erzeugt einen Eintrag im Event Log mit Informationen über Erfolg/Fehler und diverse Meldungen über den Fortschritt.
  • Die Anzahl der monatlich möglichen Runs ist begrenzt und hängt davon ab welches Paket oder Upgrade Sie gebucht haben.

 


Steps

Ein Step bezeichnet einen einzelnen Baustein eines Flows.

...

Info

Wenn die Auswahlbox leer ist, muss erst ein Account angelegt werden. Klicken Sie dazu auf den Link "Meine Verbindungen anzeigen" unter der Auswahlbox.

 


Step Vorschläge

Beim Erstellen werden häufig hinzugefügte Steps kontextsensitiv vorgeschlagen. Wenn Sie mit der Zeit einige Flows erstellt haben, und genau wissen was sie brauchen, können die Step-Vorschläge sehr viel Zeit sparen.
Klicken Sie dazu auf den Button Step hinzufügen. Danach werden Ihnen rechts unten passende Steps vorgeschlagen.

...

  • Der erste Output des vorherigen Steps ist vom Typ: SPREADSHEET, SPREADSHEETLIST, FILE oder FILELIST
  • Der neu hinzugefügte Step erwartet einen passenden Input vom Typ: SPREADSHEET, SPREADSHEETLIST, FILE oder FILELIST

 


Info
titleSteps "verdrahten"

Das graue Icon  bedeutet, dass der 2. Step einen Output des 1. Steps als Input benutzt. Diese "Verdrahtung" von Step-Outputs- und Step-Inputs ist ein elementares Konzept bei der Erstellung von Flows.
Jeder Step kann Outputs von vorherigen Steps verarbeiten.


Ein Step kann auch manuell mit dem  
-Button neu verknüpft werden. Bei Klick auf diesen Button kann ein vorheriger Step-Output für die Verknüpfung gewählt werden.


 

 



Info
titleWann ist eine manuelle Verknüpfüng notwendig?

Es gibt verschiedene Fälle, wo eine manuelle Verknüpfung notwendig ist:

  • die automatische Verknüpfung beim Hinzufügen eines Steps, verknüpft ihn immer dem vorherigen Step. Wenn dies nicht gewünscht ist, dann kann manuell neu verknüpft werden
  • die automatische Verknüpfung konnte nicht angewendet werden.
  • sie wollen einfach einen anderen Step-Output verwenden, als sie dies ursprünglich getan hatten.

 


Verknüpfung durch Verschieben

Wenn man einen Step innerhalb eines Flows verschiebt, dann hat man unmittelbar danach die Möglichkeit den Input neu mit dem Output des vorhergehenden Steps zu verknüpfen. Bisher gab es diese automatische Verknüpfung von Inputs und Outputs beim hinzufügen neuer Steps. Das spart vor allem Zeit beim Erstellen von Flows, wo man in der Regel sehr oft Steps hinzufügt und verschiebt. 

 


Laufzeit Eigenschaften

Laufzeit Eigenschaften sind spezielle Variablen, die dynamische Informationen enthalten, die nur zur Laufzeit des Flows gültig sind. 

 

 



Laufzeit VariableBeschreibung
prop_lastruntimeDer Startzeitpunkt der letzten automatischen Ausführung (Wann startete der letzte Run?)
prop_actualruntimeDie geplante Ausführungszeit des Flows (entspricht der eingestellten Nächsten Ausführung)
current_timestampDer jeweils aktuelle Zeitpunkt beim Start des Flows
prop_intervalminutesDas eingestellte Intervall des Flows
jobnameDer Name des Flows
job_idDie ID des Flows
job_uniquenameEine systemweit eindeutige ID des Flows, die selbst vergeben werden kann und der Short-URL beim URLTrigger (siehe weiter unten) entspricht.
customer_idDie ID ihres Kundenaccounts
customer_nameDer Name ihres Kundenaccounts
flow_run_idDie ID (UUID) des aktuellen Runs, die bei jeder Ausführung dynamisch erzeugt wird und eindeutig ist.

...

Warning

Achtung: Die Vorschau führt alle vorherigen Steps bis zum aktuellen Step aus, damit auch immer die notwendigen Inputs vorhanden sind. Vor allem wenn vorherige Steps sehr lange dauern oder schreibende Prozesse beinhalten, sollte man beim Testen aufpassen und eventuell den zu testenden Step etwas weiter nach vorn schieben.

 


Steps innerhalb des Flows verschieben

Die Reihenfolge der Steps kann durch verschieben mit der Maus verändert werden.
 

 


Steps duplizieren

Man kann Steps mit seinen Einstellungen duplizieren. Das ist praktisch, wenn man den gleichen Step mehrmals innerhalb eines Flows benötigt. 

...

Hin und wieder kommt es vor, dass man einen Step nahezu identisch in einem anderen Flow wiederverwenden möchte. Besonders beim SpreadsheetMapper kann das sehr hilfreich sein, wenn man ein sehr großes oder aufwändiges Mapping erstellt hat. 
In diesem Fall kann man die "Step in Flow kopieren" Funktion verwenden. Der Step wird dabei mit all seinen Einstellungen ans Ende des gewählten Flows kopiert. 

 


 


Alle Steps bearbeiten

Über den Button "Alle Steps bearbeiten", erreichen Sie eine Massenbearbeitungsansicht für alle Steps. 

...

  • Steps umbenennen
  • Steps farblich markieren
  • Position ändern
    • durch Ziehen per Drag&Drop
    • durch Eingabe der Position
    • nach ganz oben oder ganz unten durch den kleinen Pfeil
  • Steps pausieren
  • Steps in anderen Flow kopieren
  • Steps löschen (Hinweis: Die gleichzeitige Auswahl von Kopieren und Löschen entspricht einem Verschieben. Es wird erst kopiert und dann gelöscht)
  • Step Version ändern

 


Flows automatisieren

Flows zeitgesteuert ausführen

...

  • Alle 15 Minuten
  • Alle 30 Minuten
  • Alle 60 Minuten
  • Alle 2 Stunden
  • Alle 3 Stunden
  • Alle 4 Stunden
  • Alle 6 Stunden
  • Alle 8 Stunden
  • Alle 12 Stunden
  • Alle 24 Stunden
  • Alle 7 Tage
  • Individuelle Intervalle (ab Plus Paket)

 


Info
titleRuns

Jedes mal wenn ein Flow ausgeführt wird, wird ein Run von ihrem monatlichen Kontingent abgezogen. Durch Upgrades können sie Runs dazu buchen, wenn ihr aktuelles Limit nicht ausreichend ist oder durch Flow+ bestimmte Flows mit unbegrenzten Runs ausstatten.

 


Flow+ für unbegrenzte Anzahl Runs

...

Info
titleMehrfachbuchung

Dieses Add-On kann mehrfach gebucht werden. Ihr erlaubtes Flow+ Kontingent erweitert sich dadurch jeweils um 1.

 


Wann brauche ich einen Flow+?

...

Für derartige Aufgaben bräuchten Sie enorm viele Runs. Um Ihr Budget zu schonen können Sie dafür einen Flow+ erwerben und diesen auf einen Flow Ihrer Wahl anwenden. Dadurch belastet dieser Flow nicht mehr Ihr monatliches Run-Limit. 

 


Zeitplanung von Flows


Info
titleStunden und Tage aussetzen

Sie können auch festlegen, dass ein Flow in bestimmten Stunden oder an bestimmten Wochentagen nicht laufen soll. Damit können Sie z.B. einen automatisierten Flow in der Nacht oder am Wochenende pausieren, aber tagsüber stündlich laufen lassen. Auf diese Weise können Sie Flow-Runs sparen und ihre monatlichen Kosten senken.

...

Info
titleHinweis zum Feld Nächste Ausführung

Wichtig: Das Feld Nächste Ausführung muss gesetzt sein, da dies der tatsächliche Zeitpunkt ist, wann der Flow das nächste mal ausgeführt wird. Bei der Ausführung wird dann anhand der der individuellen Startzeiten wiederum die nächste Ausführungszeit ermittelt und aktualisiert usw.

 


Erster und letzter Tag des Monats

Der erweiterte Modus der Zeitplanung (verfügbar ab Plus-Paket oder mit Flow+) erlaubt es außerdem, Flows auf den ersten Tag des Monats bzw. letzten Tag des Monats zu planen.
 

 


Beispiel in dt. Sprache: 

...

Code Block
monday=12:00,13:00,15:31|tuesday=11:00,15:35|friday=13:00,15:35|firstdayofmonth=09:00|lastdayofmonth=23:59

 


URLTrigger - Flows per URL antriggern

...


Mit diesem Mechanismus ergeben sich viele neue Möglichkeiten externe Anwendungen mit Synesty Studio zu kombinieren. Vorstellbar wäre z.B., dass sie bei jeder neuen Bestellung in ihrem Shop automatisch die Flow-URL aufrufen lassen (sofern ihr Shopsystem das erlaubt). Dieser Flow könnte dann diese neue Bestellung abrufen und z.B. in ihre Warenwirtschaft oder zu ihrem Lieferanten exportieren. 

Einrichtung
Neben dem Planen-Button finden Sie einen Button mit dem Sie den URLTrigger konfigurieren können. 

 


 


EinstellungBeschreibung
URLEine Vorschau der URL, die aufgerufen werden kann.
Short-URL

Sie haben die Möglichkeit einen eigenen Bezeichner zu definieren z.B. einen kurz einprägsamen Namen, über den der Flow angesprochen werden kann. Dieser Bezeichner muss systemweit eindeutig sein. Die Short-URL ist standardmäßig mit einer kryptischen langen Zufallszeichenfolge gefüllt. Ersetzen Sie diese einfach durch etwas entsprechenderes.

Sicherheits-Token

Eine Art Passwort, was mit dem Parameter &t= an die URL angefügt werden muss, um den Flow aufzurufen. Dies stellt eine zusätzliche Sicherheit dar. Nur wer die URL und den Token kennt, kann den Flow ausführen. Ändern Sie den Token regelmäßig ohne das sich die Short-URL ändert.
Sicherheitshinweis: Verwenden Sie immer einen Sicherheits-Token.

Info

Sie können auch eine Projekt-Variable referenzieren z.B. ${meineProjektVariable}, wenn Sie den Token für mehrere Flows an einer zentralen Stelle verwalten wollen.

(Wichtig: Projekt-Variable muss vom Eingabetyp Passwort-Feld sein)


Reponse Mode
  • URL Tirgger deaktiviert - in diesem Modus kann der Flow nicht über die URL aufgerufen werden.
  • JSON - beim Aufruf erhält der Aufrufende eine Antwort im JSON-Format. Diese Anwort enthält u.a. die RunID. Diese RunID kann in einer weiteren URL (URL for Status Check) genutzt werden, um den Status bzw. Fortschritt der Flowausführung zu prüfen.
  • Redirect - Anstatt einer JSON Antwort können Sie eine URL angeben, auf die ein Browser weitergeleitet werden soll. Es gibt eine URL sowohl für den Erfolgsfall (SUCCESS) oder Fehlerfall (ERROR). Diese Einstellung ist nur sinnvoll, wenn die Flow URL durch einen Browser aufgerufen wird bzw. durch einen Client, welcher HTTP-Redirects verarbeiten kann. Ein Einsatzbeispiel wäre, dass man den Besucher im Rahmen des Shop-Checkouts nach Bestellabschluss auf die Flow-URL schickt. Dadurch wird der Flow angetriggert. Mit Hilfe der Redirect-URL-SUCCESS kann man dann den Nutzer gleich wieder zurück in den Shop schicken. Es besteht die Möglichkeit die Flow-RunID an die Redirect-URL anzuhängen, um diesem dem Shopsystem mitzuteilen. Damit wäre das Shopsystem anschließend in der Lage über die URL for Status-Check den Fortschritt der Flowausführung abzufragen.
Request Mapping

siehe Request Mapping unten

...

Vor allem die Verarbeitung des HTTP-RequestBody (body) ist praktisch, wenn in externen Applikationen Webhooks nutzen will. Viele Cloud-Dienste bieten heutzutage Webhooks, um andere Applikationen über bestimmte Ereignisse zu informieren und Daten zu synchronisieren. Dabei kann eine externe Applikation die Trigger-URL des Flows mit bestimmten Parametern aufrufen wenn bestimmte Ereignisse eintreten (z.B. neue Bestellung vorhanden). Diese übergebenen Parameter kann man mit per Request Mapping auslesen.

 


Beispiel - Flow per URL antriggern

...

  • Textvariablen
  • Verbindungs-Variablen
  • Datei Uploads
  • Referenzvariablen
  • Output Variablen

 


 


Info
titleÜberschreiben von Projektvariablen

Falls sie auf Projekt-Ebene Variablen definiert haben, ist es auch möglich diese im Flow zu überschreiben. Benennen Sie die Variable dazu genau wie die Projektvariable. Siehe auch hier.

...

EingabetypDarstellungBeschreibung
Einzeiliges Textfeldeinfaches Texteingabefeld 
Mehrzeiliges TextfeldEingabefeld für mehrere Zeilen (sog. Textarea) 
Dropdown AuswahlfeldDie Flow-Variable wird aus Auswahl (Dropdown) dargestellt.

Nach dem Anlegen können die Auswahloptionen eingegeben werden.

Dropdowns vereinfachen Fälle, bei denen man Variablen häufig ändern muss
oder anderen Nutzern die Benutzung von Flows vereinfachen möchte.

Passworteinfaches Textfeld für die Eingabe von sensitiven Informationen wie
Paswörter oder API-Token. Der Wert wird maskiert dargestellt.

 


Durch das Auge-Symbole kann das Passwort bei Bedarf angezeigt werden.

LimitSpezielles Eingabefeld für Zahlenwerte

Dieses spezielle Eingabefeld akzeptiert nur die Eingabe von Zahlenwerten, die zur Limitierung
bestimmter Prozesse verwendet werden können.

Dies wird besonders bei der Entwicklung von Flows benötigt,
die von andere Flows aufgerufen werden (siehe Andere Flows aufrufen)

 

 



Verbindungsvariablen

Damit können Sie ab jetzt auch Accounts, die Sie unter Mein Konto / Meine Verbindungen erreichen, als Variable anlegen und an Steps übergeben. 
Vorteil: Sie haben eine zentrale Stelle im Flow, wenn mehrere Steps den gleichen Account verwenden. 

...

Info
titleHinweis

Hochgeladene Dateien werden nicht dauerhaft gespeichert und regelmäßig gelöscht. Verwenden Sie den Dateiupload nur für kurzzeitige Tests. Die eigentlichen Daten sollten immer per Step aus externen Quellen (HTTP, FTP, usw.) geholt werden.

 


Referenzvariablen

 Referenzvariablen sind relevant, wenn Sie das Flow-in-Flow Feature benutzen, mit dem Sie einen Flow aus anderen Flows heraus aufrufen können und Variablen übergeben können.  

...

DatentypBeschreibungBeispiele
SPREADSHEET

Ein SPREADSHEET, das vom aufrufenden Flow übergeben werden kann.

Optional kann ein Schema angegeben werden, dem das übergebene SPREADSHEET entsprechen muss.
Wird ein Schema gewählt, dann wird dem Aufrufer-Step ein Configure Button angezeigt, womit die Spalten in dieses Schema gemappt werden kann.
Das ist hilfreich um sicher zu stellen, dass das übergebene SPREADSHEET bestimmte Spalten beinhaltet.

 
SPREADSHEETLISTanalog zu SPREADSHEET, aber als Liste 
Datum / ZeitauswahlBei Datumsvariablen wird dem Aufrufer ein kleines Kalender- und Zeitauswahl Popup angezeigt. Datumsvariablen können dann mit Steps verknüpft werden, die eine Datumsvariable erfordern. Das ist meistens bei Datumsfilter mit startDate und endDate der Fall. 
COUNTER

Zählvariablen können verwendet werden, um in Freemarker-Skripten Dinge zu zählen. Es reicht vom einfachen Hochzählen,
bis hin zum Zählen bestimmter IDs oder Wörter. Zählvariablen werden mit 0 initialisiert.


Code Block
${counter.inc()}

Ergebnis: Zählvariable counter wird um 1 hochgezählt

 


Code Block
${counter.inc(3)}

Ergebnis: counter wird um 3 erhöht

 


Code Block
${counter.inc('word1')}

Ergebnis: counter für die Zeichenkette word1 wird um 1 hochgezählt. Die String-Länge des Parameters darf max. 64 Zeichen betragen und es dürfen max. 1000 verschiedene Zeichenketten gezählt werden.

 


Code Block
${counter.inc('word1', 3)}

Ergebnis: counter für die Zeichenkette word1 wird um 3 hochgezählt.


Code Block
${counter!}

Ergebnis: Ausgabe des aktuellen Wertes von counter.

 


Code Block
${counter.get()}

Ergebnis: Aktueller Wert von counter als Zahl (long)

 


Code Block
${counter.get('word1')}

Ergebnis: Aktueller Wert des Zählers für word1


Code Block
${counter.contains('word1')?string}

Ergebnis: gibt true aus, wenn für die Zeichenkette word1 schon ein Zählwert existiert. Ansonsten false.

Hinweis: In einer IF/ELSE Bedingung kann man das ?string weglassen, um nur den boolschen Wert zu verwenden: z.B.

 


Code Block
<#if counter.contains('word1')>Ja, word1 ist enthalten<#else>word1 ist nicht enthalten</#if>


Code Block
${counter.dec()}

Ergebnis: counter wird um 1 runter gezählt.

FILELISTWenn der Aufrufer eine Liste von Dateien übergeben soll, dann können Sie diesen Datentyp wählen. 
OBJECTWenn ihr Flow mit verschiedenen Datentypen umgehen kann und der Aufrufer beliebige Dinge übergeben können soll, dann bietet sich OBJECT an. In diesem Fall müssen sie sich als Flow-Ersteller darum kümmern, den Datentyp entsprechend auszuwerten. 

Arbeiten mit Zählvariablen

...

3. Klicken Sie dann auf "aus Meta-Daten" und wählen Sie den Counter aus. 

 


Daraufhin wird der Counter eingefügt.

...

Info
titleAnwendungsbeispiel

Ein anschauliches Beispiel für Zählvariablen wird in diesem Cookbook beschrieben.

 


Konfiguration: Optionale- und Pflicht-Variablen und PUBLIC / PRIVATE Variablen

...

  • Optionalität (steuert, ob es sich um ein Pflichtfeld oder ein optionales Feld handelt)
  • Sichtbarkeit (steuert, ob die Variable auch von außen (aufrufenden Flows) gesehen werden kann (public), oder nur innerhalb des Flows (private)

 


Info
titleWann brauche ich das?

Die Optionalität und Sichtbarkeit spielen für eigenständige Flows keine Rolle. Ein sinnvoller Einsatz beginnt erst, sobald man mit Funktionen wie Flow-in-Flow - FlowExecutingStep oder FlowTrigger arbeitet. Beide Funktionen erlauben es, aus einem Flow heraus andere Flows aufzurufen. Erst hier werden Aspekte wie Optionalität oder Sichbarkeit relevant.

 

 



Optionalität

OptionalitätBeschreibung
optionales Feld (Standard)
  • Die Variable muss vom aufrufenden Flow nicht zwingend gefüllt werden, sondern kann auch leer gelassen werden.
  • Wenn die Variable mit einem Standardwert belegt ist, dann greift dieser bei nicht ausgefüllter Variable des Aufrufers.
Pflichtfeld
  • Die Variable muss zwingend vom Aufrufer ausgefüllt werden.
  • wenn der Aufrufer keinen Wert übergibt, dann wird der Flow mit einer Fehlermeldung fehlschlagen, dass das Pflichtfeld nicht gesetzt ist.

...

Output Variablen sind auch eine fortgeschrittene Funktion, die nur im Zusammenhang mit dem Flow-in-Flow Feature eine Rolle spielt, wenn der Flow von einem anderen Flow aufgerufen wird.
Man kann damit beliebige Step-Outputs als Flow-Output Variable definieren. Diese Variablen werden dann für den aufrufenden Step sichtbar und können dort weiterverarbeitet werden. 

 


Die Ausgabe-Referenz kann auch im Nachhinein über den Button "Output Mapping ändern" geändert werden. Der Name der Output-Variable bleibt allerdings erhalten. (ansonsten müssten alle aufrufenden Flows auch angepasst werden)

...

Für Kunden ab Plus-Paket gibt es die Möglichkeit der Versionierung für Flows. 
Damit kann man Zwischenstände von Flows wegspeichern (Snapshots), um später ggf. wieder zu einem bestimmten Stand zurückzurollen (Rollback). 
Änderungen können mit einem Kommentar versehen werden, um auch später noch nachzuvollziehen was geändert wurde. 
Hat man z.B. eine versehentliche Änderung gemacht, kann man über einen Klick die Basis-Version wiederherstellen.
Die Basis-Version ist die letzte Version vor der Änderung (dargestellt durch einen grünen Punkt). 

 


Eventlog


Siehe EventLog.

Dokumentationsansicht

...

Der Datenfluss-Graph stellt die Verknüpften Step-Outputs grafisch dar. Damit kann man sehen, welcher Step welchen Output von anderen Steps konsumiert. 

 


Cache leeren

Bei Klick auf Step-Vorschau werden die Daten in einem Cache zwischengespeichert, und bei einer Step-Vorschau in einem späteren Step wiederverwendet. Damit wird vermieden, dass alle Daten immer wieder neu geladen werden müssen, was z.B. einer langsamen API länger dauern kann. Um diesen Cache zu leeren und wieder frische Daten zu erhalten, können Sie diese Funktion benutzen. 
Alternative: ein Klick auf Flow-Variablen speichern hat den gleichen Effekt. Dabei wird der Cache auch geleert. 

...

  1. Rufen Sie ein Projekt auf
  2. Öffnen Sie das Dropdown neben dem Flow erstellen Button
  3. Wählen Sie Flow importieren
  4. Laden Sie die Datei, die Sie zuvor exportiert haben

 


Debug Modus

Wenn der Debug-Mode aktiviert ist, dann werden alle HTTP-Requests für die nächsten 3 Runs mitgeschrieben ("geloggt").
Im Eventlog kann man daraufhin den HTTP-Log als Datei herunterladen. In dieser Datei findet man alle HTTP-Requests / API-Calls, die im Hintergrund gemacht werden. 

...

Info
titleAutomatische Deaktivierung nach 3 Runs

Nach den nächsten 3 Ausführungen wird der Debug-Mode automatisch wieder deaktiviert. Das ist notwendig, da der HTTP-Log enorme Systemlast und Speicherverbrauch erzeugt und diese nur zur Fehlersuche verwendet werden soll. 
Der HTTP-Log im Eventlog ist nur für kurze Zeit nach der Ausführung verfügbar (max. 2 Tage). Danach wird die Datei gelöscht und kann nicht mehr heruntergeladen werden.

 


Event Log

Das Event Log eines Flows zeigt die Historie aller Runs und deren Status, sowie Informationen über die Ausführungsdauer. Damit können Fehler oder ungewöhnliche Abweichungen leicht erkannt, sowie weitere Details wie z.B. Outputs der einzelnen Steps anzeigt werden.

...

StatusStatus Response (JSON)Beschreibung
GEPLANTSCHEDULEDAutomatisierter oder getriggerter Flow der bei erreichen der Startzeit in die Warteschlange verschoben wird.

in WARTESCHLANGE

QUEUEDDie Ausführung steht kurz bevor. Der Flow ist in der Warteschlange. Es kann eine Weile dauern, bis die Flows vor ihnen in der Warteschlange abgearbeitet sind.

WIRD AUSGEFÜHRT

NEWDer Flow wird gerade ausgeführt.

ÜBERSPRUNGEN

SKIPPEDDie geplante Ausführung wurde übersprungen. Das passiert, wenn sie bei der Zeitplanung Stunden oder Tage aussetzen. Immer dann wenn der Run auf eine dieser ausgesetzten Zeiten fällt, wird ein Eventlog-Eintrag erzeugt aber als Übersprungen gekennzeichnet.
ERFOLGREICHSUCCESSDer Flow wurde ohne Fehler und ohne Warnungen ausgeführt.
FEHLERERROR

Während der Ausführung gab es einen Fehler. Die Ausführungen wurde abgebrochen.

 


Wichtig: Keine Panik.

  • Sind Benutzername, Passwort und URL korrekt?
    Kontrollieren Sie ob die gewählten Login Daten korrekt eingetragen sind. Ein häufiger Fehler ist u.a. Leerzeichen am Anfang und am Ende der Eingabe. Oft wird auch vergessen, direkt nach dem Installieren von Vorlagen noch die Flow-Variablen anzupassen.
  • Ist das Zielsystem nicht erreichbar?
    Auch das kann vorkommen. Versuchen Sie den Server oder die Webseite des Zielsystems im Browser oder FTP-Server aufzurufen, um zu sehen, ob diese erreichbar ist. Denken Sie daran, dass Schnittstellen und Systeme zu jeder Zeit ausfallen können. Sie sollten dann einfach den Flow erneut ausführen oder bis zur nächsten automatischen Ausführung warten.
  • Sind im Zielsystem alle nötigen Berechtigungen gesetzt?
    Gehen Sie sicher, dass bei Flows die mit der Schnittstelle eines Zielsystems reden, alle benötigten Berechtigung im Zielsystem gesetzt sind.

mit WARNUNGEN

WARNING

Bei der Ausführung sind Warnungen aufgetreten. Der Flow wurde trotzdem bis zum Ende ausgeführt. Sie sollten die Warnungen prüfen.

Was sind Warnungen?
Warnungen sind Hinweise, dass etwas nicht stimmt. Sie treten meist auf, wenn es bei der Abarbeitung mehrerer Datensätze zu Problemen kommt. 


Warnungen sind in der Regel nicht so kritisch wie Fehler. Sie sollten jedoch trotzdem versuchen die Ursache zu beheben, da sie auf Probleme hinweisen, die evtl. zu Fehlern führen können.
  • Haben sich Spaltennamen in der Quelldatei geändert?
    Gehen Sie sicher, dass die Quelldatei die gleichen Spalten besitzt, wie zum Zeitpunkt der Einrichtung des Flows. Evtl. hat sich eine Spaltenbezeichnung geändert oder eine Spalte ist ganz entfernt wurden.
     
  • Haben Sie Ihre Freemarker-Anweisungen überprüft?
    Kontrollieren Sie ob Ihre Freemarker-Anweisungen korrekt sind. Es kann vorkommen, das erst in einer der letzten Zeilen ein Fehler auftritt und somit in der Anzeige des Mappers nicht sichtbar ist. Oft passiert das, wenn Sie vergessen auf leere Werte zu prüfen.
     
  • Haben Sie den korrekten Spaltentrenner und Textqualifier beim Einlesen der Quelldatei gesetzt?
    Es kommt vor, dass wegen eines falschen Delimiter bzw. Qualifier, die Datei ab einer bestimmten Zeile die Spaltenzuordnung durcheinander gebracht wird. Öffnen Sie zur Kontrolle die Quelldatei in einem Texteditor und schauen Sie ob Sie die richtigen Trennzeichen im Flow gewählt haben.

     

  • Datensätze existieren in externem System nicht mehr?
    Hin und wieder kommt es vor, dass z.B. beim Bestandsabgleich Artikelnummern aktualisiert werden sollen, die bereits im fremden System gelöscht wurden. Je nach System kommt es dann zu Fehlermeldungen, die dann als Warnungen resultieren können. Alle anderen Datensätze wurden korrekt verarbeitet, aber bei einigen tauchte dieses Problem auf. Sie sollten das prüfen und Maßnahmen ergreifen (z.B. gelöscht Artikel filtern)
FEHLER: Limits überschrittenERROR_SKIP

Während der Ausführung wurde min. eines der Limits überschritten (Flows, Runs, Datensätze oder Traffic).

 Die Ausführung wurde abgebrochen. 

...

Info

Wir empfehlen auch die Seite Typische Fehlermeldungen, die viele Details über mögliche Ursachen für Warnungen oder Fehler enthält.


Info

Die Informationen im Eventlog werden nach einigen Tagen (aktuell 10 Tage) automatisch gelöscht. Das ist notwendig, da es sich durch die Summe der Kunden und Flows um enorme Datenmengen handelt und die Systemstabilität sonst negativ beeinflusst. 

Papierkorb

Will man Flows oder Projekte löschen, werden diese erst in den Papierkorb verschoben und noch nicht sofort richtig gelöscht.
Zum Papierkorb gelangt man über Mein Konto / Papierkorb. Dort kann man die Flows oder Projekte wiederherstellen oder endgültig löschen. 

...

 


Diese Steps sind in der Konfiguration ähnlich. Man wählt das Projekt und den Flow der verwendet werden soll und konfiguriert daraufhin noch die zu übergebenden Werte. 

...

  • Der FlowTrigger Step führt einen anderen Flow aus (als neuer Run).
  • Dieser Run taucht auch im Eventlog auf.
  • Nur Flow-Variablen des aufgerufen Flows vom Typ Text-Variable können übergeben werden (keine komplexen Datentype wie z.B. SPREADSHEET).
  • Der angetriggerte Flow wird asynchron ausgeführt. Das heißt:
    • die Ausführung wird nur "veranlasst", und der auszuführende Flow kommt in die Warteschlange.
    • der auszuführende Flow wird zeitnah ausgeführt.
    • nachfolgende Steps werden sofort danach ausgeführt.
  • Das Verhalten entspricht dem des  Buttons. 
  • Die Rückgabewerte des aufzurufenden Flows sind nicht in nachfolgenden Steps verwendbar.
  • Triggert man mehrere Flows damit an, werden diese Runs unabhängig voneinander (evtl. auch parallel) ausgeführt.

 


Einsatzgebiete:

  • zur genaueren Kontrolle zeitlicher Reihenfolgen (z.B. FlowB muss unbedingt nach FlowA ausgeführt werden)
  • Logik soll in einen zentralen Flow ausgelagert werden, die nur mit verschiedenen Parametern (nur STRING) angesteuert werden soll.

 


Flow-in-Flow - Der FlowExecutingStep

  • Der FlowExecutingStep führt den anderen aufzurufenden Flow direkt aus (synchron, d.h. so, als ob die Steps des aufzurufenden Flows direkt selbst Teil des aktuellen Flows wären).
  • Es wird kein separater Run erzeugt.
  • Flow-Variablen des aufgerufenen Flows können als Parameter übergeben werden (im Unterschied zum FlowTrigger sind hier auch komplexe Datentypen wie z.B. SPREADSHEET möglich).
  • Der aktuelle Flow-Run wartet bis der aufzurufende Flow komplett ausgeführt wurde.
  • Die Rückgabewerte des aufzurufenden Flows sind in nachfolgenden Steps verwendbar.
  • Kommt es bei dem aufzurufenden Flow zu einem Fehler, bricht auch der aufrufende Flow ab.

 


Info
Der FlowExecuting Step entspricht von der Art her in etwa einem Funktionsaufruf in einer Programmiersprache (synchron).
Er fördert sehr stark die Wiederverwendung, da man zentrale Funktionalität in den aufzurufenden Flow auslagern kann, und diesen mit verschiedenen Parameters (Variablen) aufrufen kann.

 


Einsatzgebiete: 

  • Logik soll in einen oder mehrere zentrale Flows ausgelagert werden, die mit verschiedenen Parametern angesteuert werden soll
    • bei Anpassung der Logik braucht nur der zentrale aufgerufene Flow angepasst werden und nicht viele verschiedene Stellen

...

Durch Klick auf Edit-Flow gelangt man in die Sub-Flow-Ansicht. Dabei werden alle Parameter, die der Aufrufer-Flow auch bei einer echten Ausführung an den aufgerufenen Flow übergeben würde, mit übergeben. 
Das erleichtert Test und Bearbeiten, da man mit echten Daten arbeiten kann.

 


Flow-Netzwerk Ansicht

Nutzer, die den FlowExecutingStep oder FlowTrigger verwenden, finden unter Projekte / Flow-Netzwerk eine Ansicht, in der man alle Flows sehen kann, die andere Flows aufrufen, oder aufgerufen werden. 
Das macht es einfacher den Überblick zu behalten und die Frage zu beantworten: "Welcher Flow ruft welchen Flow auf? bzw. "Welcher Flow wird von welchem Flow aufgerufen?"

...