StopFlowIF Step

Mit dem Step StopFlowIF kann man die Ausführung eines Flows stoppen, wenn eine bestimmte Bedingung eintritt.

Konfiguration

InputBeschreibung
conditionBeschreibt die Bedingung, die zum Stoppen des Flows eintreten muss. Die Konfiguration der Bedingung (condition) verhält sich analog zum Filter Step.
actionBeschreibt "was" passieren soll. D.h. man kann den Flow stoppen, und dann als FEHLER, WARNUNG oder ERFOLGREICH markieren.
Folgende Werte sind möglich: 
  • Error (Standardwert) - Flow stoppt mit Status FEHLER
  • Silent Success - Flow stoppt, wird aber als ERFOLGREICH gezählt. (manchmal ist das wirklich gewünscht)
  • Stop with warning (Flow stoppt, aber im Status WARNUNG)
    (sinnvoll, wenn ERROR nicht gewünscht ist oder es normal ist, dass das immer mal vorkommt)
  • Continue with warning (Sonderfall: Flow stoppt nicht, aber wird mit dem Status WARNUNG markiert.)
    (sinnvoll, um mitzubekommen, wenn bestimmte Dinge auftreten, die mal genauer untersucht werden sollten)
errorMessageEine Meldung, die beim Eintreten der condition in das Eventlog geschrieben wird, damit man hinterher besser sehen kann, warum der Flow z.B. gestoppt wurde.
Man kann in der errorMessage auch Freemarker Variablen aus dem aktuellen Flow-Kontext benutzen, um die errorMessage dynamisch zu gestalten.

Beispiel - Flow abbrechen, wenn Datei zu klein

Viele Kunden nutzen den StopFlowIF Step, um einen Flow zu stoppen, wenn eine herunter geladene Datei zu klein ist. Das ist hin und wieder der Fall, wenn man z.B. von einem Lieferanten eine Datei mit Warenbeständen bekommt, diese aber aus irgendeinem Grund unvollständig ist oder der Webserver fehlerhaft ist.

Angenommen, man weiß, dass die Dateigröße in der Regel mindestens 1000 Byte sein muss, dann könnte man dies prüfen, und den Flow abbrechen, wenn die Dateigröße kleine ist.

Der Flow würde abbrechen, wenn die Bedingung erfüllt ist. Im Eventlog-Eintrag würde die Meldung "Achtung: Datei zu klein: [aktuelle Dateigröße] auftauchen.

Weitere Beispiele finden Sie in diesem Cookbookopen in new window.

Weitere Beispiele

Der +-Button am condition Feld zeigt einige vorgefertigte Beispiele, die auf Klick eingefügt werden können.

  • Datei kleiner als 1MB: *file@UrlDownload_6?? && file@UrlDownload_6.length() < (1000 * 1024) *
  • Spreadsheet ist leer: !(spreadsheet@SearchMasterDatastore_1?? && spreadsheet@SearchMasterDatastore_1.hasRows())

Inputs

Das sind die Optionen, mit denen man den Step konfigurieren kann.

Name Datentyp Beschreibung Pflichtfeld Werte
condition STRING Ein boolscher Ausdruck in Freemarker Syntax um die Bedingungen festzulegen, unter welchen die Ausführung des Flows beendet werden soll bzw. die Bedingung TRUE zurückgibt (z.B. someVariable! == '1'). Ja
action STRING Die Aktion die stattfinden soll wenn eine Bedingung TRUE zurück gibt. 'Fehler' beendet den Flow umgehend und setzt den Status ERROR.'Stiller Erfolg' beendet den Flow, zeigt ihn aber als SUCCESSFUL. 'Mit Warnung beenden' beendet den Flow und setzt den Status WARNING. 'Mit Warnung fortsetzen' beendet den FLow NICHT, sondern erzeugt eine Meldung im Eventlog. Der Lauf wird mit dem Status WARNING markiert. Ja
  • Mit Fehler beenden
  • Erfolgreich beenden
  • Mit Warnung beenden
  • Mit Warnung fortsetzen
  • Ohne Warnung fortsetzen
errorMessage STRING Eine optionale Nachricht die ausgegeben wird wenn eine Bedingung TRUE zurückgibt. Diese kann genutzt werden um benutzerfeundliche Nachrichten zu erzeugen. (e´z.B. 'Dieser Flow wurde beendet da die Datei leer ist.') Nein