Strategien zur Fehlerbehandlung für Aufgaben

Die Strategie zur Fehlerbehandlung für eine Aufgabe legt die Aktion fest, die ausgeführt werden soll, wenn die Aufgabe aufgrund eines temporären Fehlers fehlschlägt.

Strategien zur Fehlerbehandlung konfigurieren

So konfigurieren Sie eine Fehlerbehandlungsstrategie für eine Aufgabe:

Klicken Sie in Ihrem Integrationseditor auf die vorhandene Aufgabe. Der Bereich „Aufgabenkonfiguration“ wird angezeigt.
Maximieren Sie im Bereich „Aufgabenkonfiguration“ den Abschnitt Fehlerbehandlung. Das folgende Bild zeigt den Abschnitt Fehlerbehandlung:

Führen Sie im Abschnitt Fehlerbehandlung die folgenden Schritte aus:
1. Wenn Sie eine neue Fehlerrichtlinie hinzufügen möchten, klicken Sie auf + Fehlerrichtlinie hinzufügen. Wenn mehrere Richtlinien für bedingte Fehler konfiguriert sind, werden sie der Reihe nach geprüft und abgeglichen.
  1. Wählen Sie im Feld Wiederholungsstrategie die gewünschte Fehlerbehandlungsstrategie aus. Eine Liste der Strategien finden Sie unter Wiederholungsstrategien.
  2. Geben Sie im Feld Wiederholbedingung die Bedingung ein, die mit dem Fehler übereinstimmen muss, damit diese Fehlerstrategie ausgeführt wird. Wenn Sie beispielsweise für die Aufgabe REST-Endpunkt aufrufen die Fehlerstrategie ausführen möchten, wenn der Fehlercode mit 404 übereinstimmt, geben Sie Folgendes ein:
```
$`ErrorInfo.code`$ = 404
```
    Informationen zum Hinzufügen dieser Bedingungen finden Sie unter Wiederholbedingungen.
2. Fügen Sie im Abschnitt Standardfehlerrichtlinie die Standardrichtlinie hinzu, die angewendet werden muss, wenn keine bedingte Fehlerrichtlinie übereinstimmt. Die Standard-Fehlerrichtlinie ist optional.
3. Fügen Sie im Bereich Error Catcher den Error Catcher für Ihre Integration hinzu.

Informationen zu Fehlercodes und Fehlerbehandlung finden Sie unter Fehlerbehandlung .

Wiederholungsstrategien

In den folgenden Tabellen werden die verschiedenen Strategien zur Fehlerbehandlung beschrieben, die Sie für eine Aufgabe verwenden können:

Strategietyp	Beschreibung
Schwerwiegend	Die Ausführung der gesamten Integration wird beendet und der Ausführungsstatus wird als Fehlgeschlagen markiert.
Ignorieren	Der Fehler der Aufgabe wird ignoriert. Bei der Integration werden die nächsten Aufgaben weiterhin ausgeführt, sofern die fehlgeschlagene Aufgabe den Status Erfolgreich hat.
Keine	Die Ausführung der Aufgabe wird beendet und der Integrationsstatus wird als Fehlgeschlagen gekennzeichnet. Wenn ein alternativer Pfad zur letzten Aufgabe (Blattaufgabe) vorhanden ist, werden Aufgaben im alternativen Pfad ausgeführt. Wenn alle Aufgaben im alternativen Pfad erfolgreich ausgeführt wurden, wird der Integrationsstatus als Erfolgreich gekennzeichnet.
Integration mit Backoff neu starten	Führt die gesamte Integration ab der ersten Aufgabe aus. Die Aufgabe kann jedoch wieder fehlschlagen. Geben Sie im Feld „Wiederholungsintervall (in Sekunden)“ das Zeitintervall zwischen Neustarts und im Feld „Maximale Anzahl der Wiederholungsversuche“ die erlaubten Neustartversuche ein, um Wiederholungsfehler zu vermeiden.
Aufgabe mit exponentiellem Backoff wiederholen	Die Integration wird ab der fehlgeschlagenen Aufgabe ausgeführt. Wenn die Aufgabe bei einem Wiederholungsversuch fehlschlägt, erhöht sich das Zeitintervall zwischen jedem Wiederholungsversuch um die Potenz 2. Die Wartezeit wird um eine Verzögerung von 1 bis 5 Sekunden verlängert. Wenn das angegebene Wiederholungsintervall 3 Sekunden beträgt, findet die erste Wiederholung nach 3 Sekunden statt. Der zweite Wiederholungsversuch wird nach 9 Sekunden, der dritte nach 81 Sekunden usw. ausgeführt. Der Vorgang wird fortgesetzt, bis die maximale Anzahl von Wiederholungen erreicht ist oder die Aufgabe erfolgreich abgeschlossen wurde, je nachdem, was früher eintritt.
Wiederholen mit festem Intervall	Die Integration wird ab der fehlgeschlagenen Aufgabe ausgeführt. Wenn die Aufgabe bei einem Wiederholungsversuch fehlschlägt, bleibt das Zeitintervall zwischen jedem Wiederholungsversuch konstant. Wenn das angegebene Wiederholungsintervall 3 Sekunden beträgt, werden Wiederholungen alle 3 Sekunden ausgeführt. Der Vorgang wird fortgesetzt, bis die maximale Anzahl von Wiederholungen erreicht ist oder die Aufgabe erfolgreich abgeschlossen wurde, je nachdem, was früher eintritt.
Wiederholen mit linearem Backoff	Die Integration wird ab der fehlgeschlagenen Aufgabe ausgeführt. Wenn die Aufgabe bei einem Wiederholungsversuch fehlschlägt, erhöht sich das Zeitintervall zwischen jedem Wiederholungsversuch linear. Die Wartezeit wird um eine Verzögerung von 1 bis 5 Sekunden verlängert. Wenn das angegebene Wiederholungsintervall 3 Sekunden beträgt, findet die erste Wiederholung nach 3 Sekunden statt. Der zweite Wiederholungsversuch wird nach 9 Sekunden, der dritte nach 81 Sekunden usw. ausgeführt. Der Vorgang wird fortgesetzt, bis die maximale Anzahl von Wiederholungen erreicht ist oder die Aufgabe erfolgreich abgeschlossen wurde, je nachdem, was früher eintritt.

Backoff-Wiederholungsversuche

Das standardmäßige Limit für Nebenläufigkeit ist auf 50 Ausführungen pro Projekt und Region festgelegt. Fehlgeschlagene Ausführungen werden in die Warteschlange gestellt und mit einem exponentiellen Backoff-Algorithmus wiederholt, der die Wartezeit zwischen zwei Wiederholungen schrittweise bis zu zehnmal verlängert. Beispiel:

Integration ausführen
Wenn die Anfrage fehlschlägt, wird 10 Minuten gewartet, um die Anfrage zu wiederholen.
Wenn die Anfrage fehlschlägt, wird 20 Minuten gewartet, um die Anfrage zu wiederholen.
Wenn die Anfrage fehlschlägt, wird 40 Minuten gewartet und die Anfrage wiederholt.
Und so weiter, bis zu einer maximalen Backoff-Wiederholungsversuche von zehnmal.

Wiederholungsbedingungen

Mit der Wiederholungsbedingung wird die Bedingung angegeben, die erfüllt sein muss, damit die Strategie zur Fehlerbehandlung ausgeführt wird. In der folgenden Tabelle werden die unterstützten Operatoren und Funktionen beschrieben, die Sie in der Wiederholungsbedingung verwenden können:

Unterstützte Operatoren

In der folgenden Tabelle werden die für Wiederholungsbedingungen unterstützten Operatoren beschrieben.

Operator	Beschreibung	Beispiel
=	Prüft zwei Werte auf Gleichheit	`$var$ = "value"`
!=	Prüft zwei Werte auf Ungleichheit	`$var$ != "value"`
<	Prüft, ob ein Wert kleiner als ein anderer Wert ist	`5 < 10`
<=	Prüft, ob ein Wert kleiner oder gleich einem anderen Wert ist	`$var$ <= 5`
>	Prüft, ob ein Wert größer als ein anderer Wert ist	`1 > 0`
>=	Prüft, ob ein Wert größer oder gleich einem anderen Wert ist	`$var$ >= 0`
:	Prüft, ob ein String einen Teilstring enthält, oder prüft, ob eine Liste einen bestimmten einfachen Wert enthält	`$longString$ : "substring"` `$list of values$ : "value"`
UND	Prüft zwei Ausdrücke und gibt "true" zurück, wenn beide Ausdrücke als wahr ausgewertet werden.	`$a$ > $b$ AND $b$ < $c$`
ODER	Prüft zwei Ausdrücke und gibt "true" zurück, wenn einer der Ausdrücke als wahr ausgewertet wird.	`$a$ > $b$ OR $b$ < $c$`
NOT	Negationsoperator. Spiegelt das Ergebnis eines Ausdrucks.	`NOT($var$ = "value")`

Unterstützte Funktionen

In der folgenden Tabelle werden die unterstützten Funktionen beschrieben, die für die Verwendung in Wiederholungsbedingungen verfügbar sind.

Funktion	Beschreibung
`exists(VARIABLE)`	Prüft, ob eine bestimmte Variable vorhanden ist
`does_not_exist(VARIABLE)`	Prüft, ob eine bestimmte Variable nicht vorhanden ist
`is_empty(VARIABLE)`	Prüft, ob eine bestimmte Variable eine Liste ist UND leer ist. Unterstützt Arrayvariablentypen mit Ausnahme von JSON-Arrays.
`is_not_empty(VARIABLE)`	Prüft, ob eine bestimmte Variable eine Liste ist UND nicht leer ist. Unterstützt Arrayvariablentypen mit Ausnahme von JSON-Arrays.