Umgang mit Fehlern in der Assembly

Verwenden Sie den Abschnitt "Catch" der Assembly, um den Umgang mit Fehlern, die bei der Assembly-Ausführung ausgelöst werden, zu beschreiben.

Informationen zu dieser Task

Hinweis:
  • Diese Task bezieht sich auf die Konfiguration einer OpenAPI 3.0-API-Definition. Details zum Konfigurieren einer OpenAPI 2.0 -API-Definition finden Sie unter Bearbeiten einer OpenAPI 2.0 -API-Definition.
  • OpenAPI 3.0 -APIs werden nur mit dem DataPower® API Gatewayunterstützt, nicht mit dem DataPower Gateway (v5 compatible).
  • Details zu aktuellen OpenAPI 3.0 -Unterstützungseinschränkungen finden Sie unter OpenAPI 3.0 -Unterstützung in IBM® API Connect.

Sie können diese Task entweder mithilfe der UI-Anwendung API Designer oder mithilfe der browserbasierten Benutzerschnittstelle von API Manager ausführen.

Der Abschnitt "Catch" der Assembly wird verwendet, um eine Assembly in der Instanz zu implementieren, für die bei der Assembly-Ausführung ein Fehler ausgelöst wird. Beispielsweise könnte die Assembly ein Element throw enthalten, die Authentifizierung des API-Aufrufenden fehlschlagen oder eine Richtlinie nicht ordnungsgemäß ausgeführt werden. Jeder Fehler kann mit einem anderen Catch verarbeitet werden und jeder Catch kann mehrere Statusfehler verarbeiten.

Vorgehensweise

Führen Sie die folgenden Schritte durch, um einen Catch zu erstellen und Elemente darin einzuschließen:

  1. Klicken Sie im Navigationsfenster auf Symbol 'Entwickeln' im Navigationsfenster Entwickelnund wählen Sie dann die Registerkarte APIsaus.
    Die Seite Entwickeln wird angezeigt.
  2. Klicken Sie auf den Titel der API-Definition, auf die Sie einen Catch anwenden möchten.
  3. Wählen Sie die Registerkarte Gateway aus und klicken Sie dann im Navigationsfenster auf Richtlinien .
  4. Setzen Sie die Umschaltfläche Catches anzeigen in der Menüleiste des Erstellungsbereichs auf die Position Anzeigen .
  5. Klicken Sie im Erstellungsbereich auf Catches oder auf ein Symbol Catch Das Symbol 'Abfangen' , wenn ein Symbol angezeigt wird.
    Das Eigenschaftenblatt für die Catches der API wird geöffnet.
  6. Um einen Standard-Catch hinzuzufügen, der ausgeführt wird, wenn ein ansonsten nicht abgefangener Fehler ausgelöst wird, klicken Sie auf Standard-Catch hinzufügen.
    Hinweis: Wenn Sie einen Standard-Catch vor einem anderen Catch mit Vorrang haben, wird der Standard-Catch auch dann aktiviert, wenn der Fehler des anderen Catch ausgelöst wird.
  7. Klicken Sie zum Hinzufügen eines neuen Catch auf Add catch.
  8. Verwenden Sie das Feld Fehler auswählen , um anzugeben, für welche Fehler der Catch gilt.
  9. Optional: Um einen Fehlerfall aus einem Catch zu entfernen, wählen Sie das entsprechende Markierungsfeld in der Dropdown-Liste Fehler auswählen ab. Um alle Fehlerfälle aus einem Catch zu löschen, klicken Sie auf das Kreuz, das der Gesamtzahl der Fehlerfälle im Feld Fehler auswählen entspricht.
  10. Optional: Verwenden Sie die Symbole Nach oben verschieben Das Symbol 'Nach oben' oder Nach unten verschieben Das Symbol "Nach unten" , um die Rangfolge Ihrer Fänge zu ändern.
    Wenn eine Fehlersituation von mehreren Catches verarbeitet wird, wird der Catch am Anfang der Liste angewendet.
  11. Klicken Sie zum Hinzufügen eines Elements zu einem Element aus der Palette auf das Plussymbol Pluszeichen innerhalb eines Kreises an der entsprechenden Position im Assembly-Ablauf. Wählen Sie ein Element aus, das auf den Catch angewendet werden soll, indem Sie darauf klicken.
  12. Klicken Sie auf Speichern , um Ihre Änderungen zu speichern.

Nächste Schritte

Wenn Sie einen Haken für Verbindungsfehler, SOAPFehler, oder Vorgangsfehler müssen Sie den gleichen Fehler zu den Bei Fehler anhalten Einstellung für dieInvoke Politik in Ihrer Versammlung. Wenn der Fehler während der Ausführung der Invoke -Richtlinie auftritt, wird er nicht abgefangen, die Richtlinienausführung wird abgeschlossen und der Assembly-Ablauf wird fortgesetzt. Details zum Konfigurieren einer Invoke -Richtlinie finden Sie unter Aufrufen.

Details zu allen Fehlern, die von der Assembly zurückgegeben werden können und für die Catch-Funktion verfügbar sind, finden Sie unter Von Assembly-Catches unterstützte Fehlerfälle.