# Schwierige Fehlersuche: Was Sie tun können wenn Ihr Formular nicht funktioniert Quelle: https://mind-forms.de/sap-formulartechnologien/adobe-forms/schwierige-fehlersuche-was-sie-tun-koennen-wenn-ihr-formular-nicht-funktioniert/ Stand: 2026-07-28 Immer wieder kommt es bei der Druckvorschau von [Adobe-Forms](https://mind-forms.de/knowhow/adobe-forms/)-Formularen zu Problemen. Die Formulare lassen sich zum Beispiel nicht anzeigen und auf eine Fehlermeldung warten Nutzer vergebens. Aber wie können Sie einen Fehler ohne Fehlermeldung finden? Die Antwort liegt in der Formular-Schnittstelle. Beim Debuggen dieser Schnittstelle lässt sich in solchen Fällen oft feststellen, dass der SY-SUBRC beim Aufruf den Wert 1 (Usage Error) oder 2 (System Error) hat. Sie können den konkreten Fehler schnell finden, wenn Sie wissen, wo Sie suchen müssen. In diesem Blogbeitrag erfahren Sie, wo Sie beim Debuggen Breakpoints setzen können, um die Fehlerursache ausfindig zu machen. ## Kurzanleitung für die Fehlerbehebung ### So debuggen Sie den Usage Error (SY-SUBRC = 1) Rufen Sie zuerst den Funktionsbaustein der Formularschnittstelle auf und setzen Sie in diesem Fall bei der Anweisung *PERFORM %work* einen Breakpoint. [![Abb. 1 - Aufruf von PERFORM %WORK in der Formularschnittstelle](https://mind-forms.de/files/2020/09/Abbildung_1_Schwierige-Fehlersuche-e1599572800616.png)](https://mind-forms.de/files/2020/09/Abbildung_1_Schwierige-Fehlersuche-e1599572800616.png) Abb. 1 - Aufruf von *PERFORM %WORK* in der Formularschnittstelle Innerhalb dieser Routine werden die einzelnen Formularfelder verarbeitet. So können Sie herausfinden, welches der Felder den Fehler verursacht (und eventuell auch schon, warum). [![Abb. 2 - Verarbeitung der Formularfelder in PERFORM %WORK](https://mind-forms.de/files/2020/09/Abbildung_2_Schwierige_Fehlversuche-e1599573269784.png)](https://mind-forms.de/files/2020/09/Abbildung_2_Schwierige_Fehlversuche-e1599573224999.png) Abb. 2 - Verarbeitung der Formularfelder in *PERFORM %WORK* ### So debuggen Sie den System Error (SY-SUBRC = 2) Während der Usage Error leicht zu beheben ist, erfordert der System Error etwas mehr Aufwand. Im ersten Schritt rufen Sie dazu den Funktionsbaustein der Formularschnittstelle auf. Dabei setze Sie bei *‚FPCOMP_FORM_END‘* einen Breakpoint. [![Abb. 3 - Aufruf von 'FPCOMP_FORM_END' in der Formularschnittstelle](https://mind-forms.de/files/2020/09/Abbildung_3_Schwierige-Fehlersuche-e1599573530330.png)](https://mind-forms.de/files/2020/09/Abbildung_3_Schwierige-Fehlersuche-e1599573530330.png) Abb. 3 - Aufruf von *'FPCOMP_FORM_END'* in der Formularschnittstelle Debuggen Sie anschließend in den Funktionsbaustein hinein und setzen Sie bei der Anweisung *‚PERFORM finish_form‘* einen Breakpoint. [![Abb. 4 - Breakpoint bei PERFORM finish_form setzen](https://mind-forms.de/files/2020/09/Abbildung_4_Schwierige-Fehlersuche-e1599573635262.png)](https://mind-forms.de/files/2020/09/Abbildung_4_Schwierige-Fehlersuche-e1599573635262.png) Abb. 4 - Breakpoint bei *PERFORM finish_form* setzen Debuggen Sie danach in die Routine hinein und setzen Sie den nächsten Breakpoint bei der Anweisung *‚PERFORM create_output_current_form‘*. [![Abb. 5 - Breakpoint bei PERFORM create_output_current_form setzen](https://mind-forms.de/files/2020/09/Abbildung_5_Schwierige-Fehlersuche-e1599573724299.png)](https://mind-forms.de/files/2020/09/Abbildung_5_Schwierige-Fehlersuche-e1599573724299.png) Abb. 5 - Breakpoint bei *PERFORM create_output_current_form* setzen Rufen Sie innerhalb dieser Subroutine den Funktionsbaustein *'FPCOMP_CREATE_PDX'* auf. Dieser fängt im Anschluss diverse Fehler ab. [![Abb. 6 - CATCH-Block hinter 'FPCOMP_CREATE_PDX'](https://mind-forms.de/files/2020/09/Abbildung_6_Schwierige-Fehlersuche.png)](https://mind-forms.de/files/2020/09/Abbildung_6_Schwierige-Fehlersuche.png) Abb. 6 - *CATCH*-Block hinter *'FPCOMP_CREATE_PDX'* Bereits hier können Sie in den meisten Fällen feststellen, wo der Fehler liegt. Beim Debuggen lassen sich zu dem die aktuellen *SY-MSG*-Werte ermitteln, die der Funktionsbaustein erzeugt hat: [![Abb. 7 - Aufruf Funktionsbaustein 'FPCOMP_CREATE_PDX'](https://mind-forms.de/files/2020/09/Abbildung_7_Schwierige-Fehlersuche-e1599574356705.png)](https://mind-forms.de/files/2020/09/Abbildung_7_Schwierige-Fehlersuche-e1599574321266.png) Abb. 7 - Aufruf Funktionsbaustein *'FPCOMP_CREATE_PDX'* Falls Sie tiefer debuggen möchten (oder müssen), können Sie innerhalb des Funktionsbausteins weitere Breakpoints setzen. Dieser ruft zunächst eine *execute*-Methode des Objektes *l_pdfo* auf, an der Sie einen Breakpoint setzen. [![Abb. 8 - Breakpoint bei Aufruf der execute-Methode setzen](https://mind-forms.de/files/2020/09/Abbildung_8_Schwierige-Fehlersuche-e1599575060553.png)](https://mind-forms.de/files/2020/09/Abbildung_8_Schwierige-Fehlersuche-e1599575060553.png) Abb. 8 - Breakpoint bei Aufruf der *execute*-Methode setzen Innerhalb dieser *execute*-Methode wird eine weitere Methode *execute_internal* aufgerufen, an der Sie ebenfalls einen Breakpoint setzen. [![Abb. 9 - Breakpoint bei Aufruf der execute_internal-Methode setzen](https://mind-forms.de/files/2020/09/Abbildung_9_Schwierige-Fehlersuche-e1599575527497.png)](https://mind-forms.de/files/2020/09/Abbildung_9_Schwierige-Fehlersuche-e1599575527497.png) Abb. 9 - Breakpoint bei Aufruf der *execute_internal*-Methode setzen Zurück im Funktionsbaustein: dort finden Sie ziemlich am Ende eine *CATCH*-Anweisung. Setzen Sie dort eine Break-Anweisung. Wird diese erreicht, können Sie die aktuelle Fehlermeldung im Objekt *l_fpex* finden. [![Abb. 10 - Breakpoint am Ende von 'FPCOMP_CREATE_PDX'](https://mind-forms.de/files/2020/09/Abbildung_10_Schwierige-Fehlersuche.png)](https://mind-forms.de/files/2020/09/Abbildung_10_Schwierige-Fehlersuche.png) Abb. 10 - Breakpoint am Ende von *'FPCOMP_CREATE_PDX'* ### Wie heißt der Funktionsbaustein der Formularschnittstelle? Starten Sie die Transaktion *SFP* und geben Sie den Namen ihres Formulars ein. [![Abb. 11 - Einstiegsmaske des Formbuilder (SFP)](https://mind-forms.de/files/2020/09/Abbildung_11_Schwierige-Fehlersuche.png)](https://mind-forms.de/files/2020/09/Abbildung_11_Schwierige-Fehlersuche.png) Abb. 11 - Einstiegsmaske des Formbuilder (*SFP*) Drücken Sie nun die Taste *F8!* Es öffnet sich die Debugging-Sicht für Funktionsbausteine, in der auch der Name des Funktionsbausteins steht: [![Abb. 12 - Eingabebemaske des Debuggers der SE37 mit dem Namen des Funktionsbausteins](https://mind-forms.de/files/2020/09/Abbildung_12_Schwierige-Fehlersuche.png)](https://mind-forms.de/files/2020/09/Abbildung_12_Schwierige-Fehlersuche.png) Abb. 12 - Eingabebemaske des Debuggers der *SE37* mit dem Namen des Funktionsbausteins ### Tipp: So legen Sie einen Break-Point aus dem Debugger direkt am Funktionsbaustein an Wenn Sie den System Error debuggen, können Sie bei Bedarf die einzelnen Breakpoints überspringen und direkt den Funktionsbaustein *‚FPCOMP_CREATE_PDX‘* debuggen. Aktivieren Sie dazu mit */hs* den Debugger. Sobald sich dieser öffnet, können Sie unter dem Reiter Breakpoints einen neuen Breakpoint für den Funktionsbaustein *‚FPCOMP_CREATE_PDX‘* anlegen. [![Abb. 13 - Breakpoint im Debugger anlegen](https://mind-forms.de/files/2020/09/Abbildung_13_Schwierige-Fehlersuche.png)](https://mind-forms.de/files/2020/09/Abbildung_13_Schwierige-Fehlersuche.png) Abb. 13 - Breakpoint im Debugger anlegen [![Abb. 14 - Hinzugefügter und aktiver Breakpoint im Debugger](https://mind-forms.de/files/2020/09/Abbildung_14_Schwierige-Fehlersuche.png)](https://mind-forms.de/files/2020/09/Abbildung_14_Schwierige-Fehlersuche.png) Abb. 14 - Hinzugefügter und aktiver Breakpoint im Debugger Führen Sie mit *F8* das Programm weiter aus. Der Debugger sollte automatisch an der ersten (funktionalen) Zeile des Funktionsbausteins anhalten: [![Abb. 15 - Debugger hält an erster Zeile des Funktionsbausteins an](https://mind-forms.de/files/2020/09/Abbildung_15_Schwierige-Fehlersuche.png)](https://mind-forms.de/files/2020/09/Abbildung_15_Schwierige-Fehlersuche.png) Abb. 15 - Debugger hält an erster Zeile des Funktionsbausteins an Von dort können Sie den letzten Breakpoint bei der Anweisung CATCH *cx_fp_runtime INTO l_fpex* setzen. ## Fazit: So finden Sie Fehler in der Druckvorschau Probleme bei der Formularerzeugung mit Adobe Forms liegen oft an einem Usage- oder System Error. Mit Breakpoints können Sie die Fehler schnell identifizieren und beheben. Auch ich habe diese Erfahrung bereits gemacht: Mit den Breakpoints konnte ich herausfinden, dass das Firmenlogo auf einem Formular wegen eines Schreibfehlers in der URL nicht angezeigt wurde. Sie haben weitere Fragen zu Adobe-Forms-Formularen? Melden Sie sich gerne persönlich bei mir, sodass ich Sie bei Ihrem Anliegen unterstützen kann.