Das Assert-Ereignis ist ein Debugging-Tool, ähnlich wie das Conditional-Ereignis, das die Logik Ihrer Kette testet und überprüft, ob sie wie vorgesehen funktioniert. Grundsätzlich gilt, dass eine Kettenverzweigung ununterbrochen fortgesetzt wird, wenn eine Assertion bestanden wird, und dass sie anhält, wenn eine Assertion fehlschlägt - es gibt jedoch eine Reihe von Bedingungen, die diese Regel beeinflussen. Eine Liste der häufigsten Anwendungsfälle finden Sie unter am Ende dieses Artikels.
Schritt 1: Hinzufügen des Ereignisses zur Kette
- Klicken Sie in Chain Builder auf der Registerkarte Chains auf Edit for the chain.
- Klicken Sie auf Chain Events, und verschieben Sie Assert an die Stelle, an der das Ereignis in der Kette auftreten soll.
- Ziehen Sie eine Verknüpfung zu dem Ereignis vom vorhergehenden Knoten in der Kette.
Hinweis: Um die Position eines Knotens in der Kette zu ändern, heben Sie die Verknüpfung mit anderen Knoten auf und verschieben Sie ihn dann an die Stelle, an der er erscheinen soll. Um mehrere Knoten auf einmal zu verschieben, halten Sie SHIFT gedrückt, während Sie sie auswählen.
- Wählen Sie den Knoten des Ereignisses aus, und klicken Sie auf Bearbeiten .
- Geben Sie unter Basic Info einen eindeutigen Namen und eine Beschreibung ein, um das Ereignis zu identifizieren.
Hinweis: Aktivieren Sie Stop Chain on Fail, wenn die gesamte Kette anhalten soll, wenn diese Behauptung fehlschlägt. Wenn dieses Kontrollkästchen nicht aktiviert ist, werden andere Kettenzweige zu Ende geführt, auch wenn dieser spezielle Zweig fehlschlägt.
Schritt 2: Einrichten der bedingten Logik
Unter Bedingungen können Sie die bedingte Logik als Regeln oder Gruppen von Regeln erstellen, um Ausgaben und Variablen verschiedener Datentypen zu testen:
- String, für ein oder mehrere Zeichen
- Integer, für jeden ganzen, nicht dezimalen numerischen Wert
- Datum, für eine Datumszeichenfolge oder eine Variable
- Float, für einen beliebigen numerischen Wert
- JSON, für Javascript Object Notation
Hinweis: Verwenden Sie für JSON eine Variablentransformation zum Parsen von Werten.
- Wählen Sie, ob Sie eine Regel oder eine Gruppe von Regeln hinzufügen möchten.
- Wenn Sie mehrere Regeln oder Gruppen einbeziehen, verbinden Sie sie mit einem AND oder OR Booleschen Wert:
- Wenn alle Regeln oder Gruppen wahr sein müssen, damit die Bedingung erfüllt ist, wählen Sie AND.
- Wenn irgendeine Regel oder Gruppe wahr sein muss, damit die Bedingung erfüllt ist, wählen Sie ODER.
- Wählen Sie für jede Regel den Datentyp und die zu prüfende Ausgabe oder Variable aus, und legen Sie die Kriterien für das Bestehen der Bedingung fest:
- Um zu prüfen, ob der Wert leer ist, wählen Sie Ist leer oder Ist nicht leer.
- Um zu prüfen, ob der Wert bestimmte Zeichen oder einen anderen Ausgabe- oder Variablenwert enthält, wählen Sie Enthält, und geben Sie den entsprechenden Wert ein oder wählen Sie ihn aus.
- Um zu prüfen, ob der Wert einem regulären Ausdruck entspricht, wählen Sie Matches RegExp, und geben Sie den entsprechenden Ausdruck ein.
- Um zu prüfen, ob der Wert mit bestimmten Zeichen oder einem anderen Ausgabe- oder Variablenwert beginnt oder endet, wählen Sie Beginnt mit oder Endet mit, und geben Sie den entsprechenden Wert ein oder wählen Sie ihn aus.
- Um zu prüfen, ob ein numerischer Wert gleich einem Betrag ist, wählen Sie = oder !=, und geben Sie den Betrag ein oder wählen Sie ihn aus.
- Um zu prüfen, ob ein numerischer Wert größer oder kleiner als ein Betrag ist, wählen Sie < oder >, und geben Sie den Betrag ein oder wählen Sie ihn aus.
- Um zu prüfen, ob ein numerischer Wert größer oder kleiner oder gleich einem Betrag ist, wählen Sie <= oder >=, und geben Sie den Betrag ein oder wählen Sie ihn aus.
- Nachdem Sie die bedingte Logik eingerichtet haben, klicken Sie auf Speichern.
Hinweis: Um eine Regel aus der bedingten Logik zu entfernen, klicken Sie auf Löschen .
Bedingungen und allgemeine Anwendungsfälle
Das Ereignis "Assert" kann zu mehreren Pfaden oder "Zweigen" einer Kette hinzugefügt werden. Jede Assertion arbeitet unabhängig, d.h. eine fehlgeschlagene Assertion hält nur die Verzweigung an, in der sie platziert ist - alle anderen Verzweigungen werden bis zum Abschluss weitergeführt. Wenn jedoch eine einzelne Assertion fehlschlägt, wird die gesamte Kette als "Fehlgeschlagen" markiert.
Wissenswertes:
- Aktivieren Sie die Option Stop chain on fail, um die gesamte Kette sofort anzuhalten, wenn eine Assertion fehlschlägt.
- Sie können einen Kettenfehler außer Kraft setzen, indem Sie ein Set Chain Result Ereignis hinzufügen. Wenn der Knoten "Set Chain Result" auf "Succeed" gesetzt ist, wird die Kette unabhängig von fehlgeschlagenen Assertions immer bestanden.
Bedingung |
Ergebnis |
Erklärung |
|---|---|---|
| Behauptung besteht | Ausführung wird fortgesetzt; Kette ist erfolgreich | Der Kettenlauf wird ohne Unterbrechung fortgesetzt. |
|
Assertion schlägt fehl (einzelne Behauptung) |
Ausführung schlägt fehl, Kette schlägt fehl |
Wenn eine einzelne Assertion auf einem Kettenpfad platziert ist, wird der Kettenlauf angehalten, wenn die Assertion fehlschlägt. Beispiel: (Zum Vergrößern anklicken) Hinweis: Ein Assert-Ereignis kann als "Wächter" verwendet werden, der eine Kette vor kritischen Punkten anhält, wenn eine Bedingung nicht erfüllt ist. Wenn ein Assert-Ereignis eine Abhängigkeit von den nachfolgenden Knoten ist, wird die gesamte Kette angehalten. |
|
Assertion schlägt fehl (mit aktiviertem "Stop Chain on Fail") |
Ausführung schlägt fehl, Kette schlägt fehl; Kette stoppt sofort |
Wenn die Option "Kette bei Fehler stoppen" aktiviert ist und diese Assertion fehlschlägt, werden alle anderen Zweige sofort angehalten. Beispiel: (Zum Vergrößern anklicken) |
|
Assertion schlägt fehl (mehrere Verzweigungen/Behauptungen) |
Der Kettenlauf wird bei der fehlgeschlagenen Verzweigung angehalten, aber für alle anderen Verzweigungen fortgesetzt, bis eine Guard/Stop-Bedingung erfüllt ist |
Das Ereignis "Assert" kann auf mehreren Pfaden oder "Zweigen" innerhalb derselben Kette platziert werden. Bei einer fehlgeschlagenen Assertion wird der betreffende Zweig angehalten, alle anderen Zweige werden jedoch weiter ausgeführt. Auf diese Weise können Sie mehrere Bedingungen innerhalb der gleichen Kette testen. Beispiel: (Zum Vergrößern anklicken) |
Assert-Ereignis vs. Bedingtes Ereignis
Das Ereignis Conditional kann in Kombination mit dem Ereignis Set Chain Result verwendet werden, um ähnliche Ergebnisse zu erzielen - im Vergleich zum Ereignis Assert sind jedoch mehrere Knoten und Verzweigungspfade erforderlich. Das Ereignis "Assert" soll diesen komplexeren Prozess vereinfachen und ersetzen.
Zur Veranschaulichung hier ein Beispiel für die typische Logik, die erforderlich ist, um einen "Pass"- und "Fail"-Zweig mit einem bedingten Ereignis zu erstellen:
Und hier ist die gleiche Logik mit einem einzigen Assert-Ereignis:
Hinweis: Bei Verwendung in der gleichen Kette überschreibt das Ereignis "Set Chain Result" immer die Ergebnisse eines "Assert"-Ereignisses. Eine Kette mit einem Knoten "Set Chain Result", der auf "Succeed" gesetzt ist, wird beispielsweise unabhängig vom Ereignis "Assert" immer bestehen.