Aktionsfehlerauswertung

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 4 Minuten Lesedauer

    • Aktivieren Sie Aktionen, um Schrittfehler zu erfassen und die Ausführung fortzusetzen. Identifizieren Sie, wann bestimmte Fehlerbedingungen auftreten, und geben Sie Ihren eigenen Aktionsstatuscode, die Statusmeldung und den Fehlerstatus zurück.

    Vorteile

    Aktivieren Sie die Aktionsfehlerauswertung, um diese Vorteile zu erhalten.
    • Erfassen Sie Schrittfehler, und lassen Sie zu, dass eine Aktion weiterhin ausgeführt wird. Geben Sie das Fehlerverhalten jedes Schritts an, den Sie einer Aktion hinzufügen.
    • Erstellen Sie eigene Fehlerbedingungen. Geben Sie an, wann eine Aktion einen Fehlerstatus zurückgibt, sowie die Statuscodes und Nachrichten, die sie zurückgibt.
    • Stellen Sie Flow Designer weitere Informationen zur Fehlerbehandlung und Optionen bereit. Verwenden Sie Ihre eigenen Aktionsstatuscodes und -Nachrichten, um Probleme zu identifizieren und Details für Korrekturmaßnahmen bereitzustellen.

    Komponenten des Aktionsfehlerauswertungsschritts

    Jeder Schritt bietet diese Fehlerauswertungskomponenten.

    Abbildung : 1. Komponenten des Fehlerauswertungsschritts
    Beispielschritt, der so konfiguriert ist, dass die Aktion nicht angehalten und mit dem nächsten Schritt fortgefahren wird, wenn dieser Schritt fehlschlägt.
    1. Wenn dieser Schritt fehlschlägt, Option
    Option, um den nächsten Schritt fortzusetzen oder zur Fehlerauswertung zu wechseln. Diese Option hat keine Auswirkungen auf den Schrittstatus.
    2. Schrittstatus
    Objektdatenpille mit Laufzeitdetails zum Schritt. Jeder Schritt in einer Aktion gibt einen Schrittstatus zurück.
    3. Schrittstatus > Code
    Ganzzahldatenpille, die angibt, ob der Schritt einen Fehler verursacht hat. Ein Schritt gibt einen Wert von 1 zurück, wenn er aus irgendeinem Grund einen Fehler verursacht. Beispielsweise kann ein Schritt zu einem Fehler führen, wenn er obligatorische Eingabedaten fehlt oder Ausgabe im falschen Datentyp zurückgibt. Ein Schritt gibt einen Wert von 0 zurück, wenn er erfolgreich ausgeführt wird. Sie können diese Codes nicht anpassen.
    4. Schrittstatus > Nachricht
    Zeichenfolgendatenpille, die die vom Schritt oder Systemvorgang erzeugte Fehlermeldung enthält. Sie können die Schrittstatusnachricht nicht anpassen.

    Konfigurationskomponenten der Aktionsfehlerauswertung

    Die Aktionsfehlerauswertung besteht aus diesen Konfigurationskomponenten.

    Abbildung : 2. Konfigurationskomponenten der Fehlerauswertung
    Beispiel für einen Fehlerauswertungsabschnitt mit einer Fehlerbedingung. Die Beispielfehlerbedingung gibt den Aktionsstatuscode 100 und die Aktionsstatusnachricht „keine Incident-Aufgabe erstellt“ zurück.
    5. Abschnitt „Fehlerauswertung“
    Abschnitt mit möglichen Fehlerbedingungen. Wenn eine Aktion ausgeführt wird, werden die verfügbaren Fehlerbedingungen von oben nach unten ausgewertet, um nach einer möglichen Übereinstimmung zu suchen. Eine Aktion gibt den Aktionsstatus zurück, der von der ersten übereinstimmenden Fehlerbedingung angegeben wird. Wenn keine übereinstimmende Fehlerbedingung vorhanden ist, wird der Aktionsstatus auf den Schrittstatus der letzten Schrittausführung festgelegt.
    Hinweis:
    Datenstromaktionen haben einen Fehlerauswertungsabschnitt für REST-, SOAP- und JDBC-Schritte. Weitere Informationen finden Sie unter Data Stream actions and pagination.
    6. Fügen Sie die Fehlerbedingungsoption hinzu
    Option zum Hinzufügen einer Fehlerbedingung. Jede Fehlerbedingung entspricht einem else IF-Flow-Logikblock. Es kann jeweils nur eine Fehlerbedingung „wahr“ sein.
    7. Konfiguration der Fehlerbedingung
    Verfügbare Optionen zum Konfigurieren einer Fehlerbedingung.
    • Bezeichnung, die Sie zur Identifizierung dieser Fehlerbedingung verwenden möchten
    • Bedingungen, die erfüllt sein müssen, um diese Fehlerbedingung zu erfüllen
    • Fehlerstatus, in dem die Aktion an den Flow zurückgegeben werden soll
    • Aktionsstatuscode, für den die Aktion an den Flow zurückgegeben werden soll
    • Aktionsstatusnachricht, in der die Aktion an den Flow zurückgegeben werden soll
    8. Aktionsstatus
    Objektdatenpille mit Laufzeitdetails zur Aktion. Eine Aktion gibt immer einen Aktionsstatus zurück.
    9. Aktionsstatus > Code
    Ganzzahldatenpille, die den Code enthält, der von der ersten übereinstimmenden Fehlerbedingung oder der letzten Schrittausführung zurückgegeben wird. Sie können Ihren eigenen Code zurückgeben, wenn Sie eine anwenderdefinierte Fehlerbedingung erstellen.
    10. Aktionsstatus > Nachricht
    Zeichenfolgendatenpille, die die Nachricht enthält, die durch eine übereinstimmende Fehlerbedingung oder die letzte Schrittausführung erzeugt wurde. Sie können Ihre eigene Nachricht zurückgeben, wenn Sie eine anwenderdefinierte Fehlerbedingung erstellen.

    Flow- und Aktionsfehlerbehandlungsressourcen

    Weitere Informationen zur Verwendung der Fehlerbehandlung in Aktionen und Flows finden Sie unter ServiceNow® Community-Post Übersicht über die Fehlerbehandlung für Flow und Aktion: Warum und wie auf Fehler getestet werden soll – Kompetenzzentrum „Worfklow-Automatisierung“ .

    Allgemeine Leitlinien

    Befolgen Sie diese allgemeinen Richtlinien, um die Vorteile der Aktionsfehlerbewertung zu erzielen.

    Zulassen, dass nur unabhängige Schritte ausgeführt werden
    Lassen Sie zu, dass ein Schritt weiterhin ausgeführt wird, wenn er keine Daten zurückgibt, die für einen späteren Schritt erforderlich sind. Wenn ein Schritt Daten bereitstellt, die für spätere Schritte erforderlich sind, wissen Sie, dass die späteren Schritte nicht erfolgreich ausgeführt werden können.
    Vermeiden Sie mehr als 10 Fehlerbedingungen
    Die Anzahl der Fehlerbedingungen, die Sie erstellen können, ist zwar nicht begrenzt, jede Fehlerbedingung muss jedoch ausgewertet werden. Je mehr Fehlerbedingungen Ihre Aktion auswerten muss, desto langsamer kann Ihre Aktion ausgeführt werden.
    Identifizieren Sie bestimmte Schrittfehler
    Sie können den Schrittstatus verwenden, um zu identifizieren, wann ein bestimmter Schritt fehlschlägt. Die Identifizierung eines bestimmten Schritts kann nützlich sein, wenn Ihre Aktion mehrere Instanzen desselben Schritttyps enthält. Möglicherweise möchten Sie auch einen bestimmten Schritt identifizieren, damit ein Flow-Fehler-Handler bestimmte Korrekturmaßnahmen für den Fehler ergreifen kann.
    Setzen Sie bestimmte Fehlerbedingungen vor allgemeine Fehlerbedingungen
    Die Fehlerauswertung wird angehalten, wenn die Aktion eine übereinstimmende Fehlerbedingung findet. Wenn Sie allgemeine Fehlerbedingungen zuerst setzen, kann dies verhindern, dass die Aktion bestimmte Fehlerbedingungen erfüllt.
    Verwenden Sie beschreibende Fehlerbedingungsbezeichnungen
    Identifizieren Sie eine Fehlerbedingung, ohne sie bearbeiten zu müssen. Standardmäßig werden Fehlerbedingungen nur angezeigt, wenn Sie sie bearbeiten.