Fehler

Interne ID: agorum.dev.assert.fail

Sie können mit diesem Knoten eine Fehlermeldung in der Bedienoberfläche ausgeben. Das System unterbricht den Workflow, der Benutzer kann den Workflow nicht mehr fortsetzen. Der Workflow ist beendet.

Verhaltensweise

---

Erreicht das System den Knoten im Workflow, wertet das System die Fehlermeldung aus und zeigt diese dem Benutzer in der Bedienoberfläche an. Der Workflow ist an dieser Stelle beendet.

Endpoints

---

Standard	Veränderbar?	Weitere Endpoints möglich?
Default (Inlet)	Nein, kann nur ausgeblendet werden.	nicht nötig

Parameter

---

Parameter	Beschreibung	Beispiel
Fehlermeldung	Definiert eine Fehlermeldung, die dem Benutzer angezeigt wird.	Fehlermeldung

Fehlermeldung
 

Im Editor

Angegebene Fehlermeldung als Parameter im Editor:

Nicht möglich!

Eine statische Fehlermeldung, wie im obigen Beispiel angegeben, ist sinnvoll, wenn zuvor über den Knoten Ist Array leer eine Variable auf deren leeres Array geprüft wird. Wenn das Array leer ist, würde die angegebene Fehlermeldung ausgegeben werden.

Sie können außerdem auch Variablen im Editor verwenden:

Fehlermeldung: ${error_message}

In diesem Beispiel wird der Text mitsamt dem Inhalt der Variable als Fehlermeldung angezeigt. Die Variable error_message muss zu diesem Zeitpunkt bereits vorhanden sein. Sie können sie etwa über einen Skript-Knoten erstellen:

/* global sc, sca, token, instance, outlets, inlet, parameters */

token.variables.error_message = 'Datei nicht vorhanden';

token.leave('');

Es würde hier folgende Fehlermeldung in der Bedienoberfläche auftauchen:

Als Expression

Angegebene Fehlermeldung als Expression:

'Fehler - zu viele Suchergebnisse. Anzahl: ' + token.variables.test_array.lenght

In diesem Beispiel wird der String Fehlermeldung - zu viele Suchergebnisse. Länge: inklusive der Variable test_array mit dessen Länge ausgegeben. Die Variable muss zu diesem Zeitpunkt bereits vorhanden sein, Sie können die Variable etwa über einen Skript-Knoten erstellen. Der Inhalt eines solchen Skript-Knotens könnte etwa so aussehen:

/* global sc, sca, token, instance, outlets, inlet, parameters */

// Durchführen einer Suche oder Aufbereitung von Daten 
token.variables.test_array = [ 'Ergebnis1', 'Ergebnis2', 'Ergebnis3' ];

Die Ausgabe als Fehlermeldung wäre in diesem Fall Fehlermeldung - zu viele Suchergebnisse. Länge: 3.

Ein anderes Beispiel mit der Variable test_array, die bestimmte Werte (hier Objekte und deren Namen) ausgibt:

'Fehler - falsches Suchergebnis: ' + test_arry.map(el => el.name).join('; ')

In diesem Fall führt test_array.map dazu, dass jedes Element im Array (Ergebnis1, Ergebnis2, Ergebnis2) durchlaufen und der Name des Objekts (el.name) ausgegeben wird. Mit join wird das Array zu einem Text (String) zusammengeführt, damit es besser lesbar dargestellt werden kann.

Auch in diesem Fall muss die Variable test_array bereits etwa über einen Skript-Knoten erstellt und befüllt sein:

/* global sc, sca, token, instance, outlets, inlet, parameters */

// Objekte finden
token.variables.test_array = [ objects.find(112233), objects.find(112234), objects.find(112235) ];