Show TOC Anfang des Inhaltsbereichs

Hintergrunddokumentation IF_WD_MESSAGE_MANAGER Dokument im Navigationsbaum lokalisieren

Dieses Interface dient als Message Manager für die Integration von Meldungen und steht über den Web-Dynpro-Code-Wizard dem Anwendungsentwickler zur Verfügung.

Im Folgenden sind lediglich die wichtigsten Methoden kurz aufgelistet.

Methoden

Hinweis

Beachten Sie, dass die RAISE-Methoden deprecated sind. Verwenden Sie sie daher nicht.

Beachten Sie zusätzlich, dass der bei den meisten Methoden verwendete Parameter msg_user_data nur für spezielle Zwecke zur Verfügung steht. Verwenden Sie ihn daher nicht.

Sie können bei den entsprechenden Methoden über den optionalen Parameter VIEW den Namen des Windows oder der View mitgeben, auf der die Meldung angezeigt werden soll.

Damit Anwendungsmeldungen nicht nur für die Dauer eines Roundtrips im Message-Manager gehalten werden (wodurch diese Meldungen für jeden Roundtrip neu erzeugt werden müssen), stehen auch permanente Meldungen zur Verfügung. Damit kann für eine Meldung ein Gültigkeitszeitraum eingeführt werden. Mögliche Gültigkeitszeiträume sind:

      Lebensdauer der Component

      Lebensdauer des Controllers

      Lebensdauer des Contextes (nur für Meldungen, die sich auf ein Context-Attribut beziehen)

Dafür stehen die Parameter IS_PERMANENT und SCOPE_PERMANENT_MSG zur Verfügung.

REPORT_EXCEPTION

Berichtet eine Web-Dynpro-Ausnahme (kehrt eventuell zurück).

Eine Beschreibung der einzelnen Parameter dieser Methode finden Sie in der Methodendokumentation im System.

REPORT_SUCCESS

Berichtet eine Erfolgsmeldung (Diese Grafik wird im zugehörigen Text erklärt).

Eine Beschreibung der einzelnen Parameter dieser Methode finden Sie in der Methodendokumentation im System.

REPORT_WARNING

Berichtet eine Warnung (Diese Grafik wird im zugehörigen Text erklärt).

Eine Beschreibung der einzelnen Parameter dieser Methode finden Sie in der Methodendokumentation im System.

REPORT_ATTRIBUTE_ERROR_MESSAGE

Berichtet eine Web-Dynpro-Ausnahme zu einem Context-Attribut.

Diese Methode berichtet eine Fehlermeldung zu einem Context-Attribut. Eine Fehlermeldung mit Context-Bezug beeinflußt den Ablauf des Web-Dynpro-Phasenmodells. Wird eine solche Fehlermeldung vor dem Aufruf eines Action-Handlers (z.B. in den Methoden WDDOBEFOREACTION) erzeugt, dann werden Actions des Typs Standard nicht mehr ausgeführt. Eine sich daran anschließende Navigation sowie die Methoden WDDOMODIFYVIEW werden ebenfalls nicht mehr ausgeführt. Actions des Typs Validierungsunabhängig werden dagegen auch bei vorhandenen Fehlermeldungen ausgeführt. Eine sich daran anschließende Navigation sowie die Methoden WDDOMODIFYVIEW werden ebenfalls ausgeführt.

Eine Beschreibung der einzelnen Parameter dieser Methode finden Sie in der Methodendokumentation im System.

REPORT_ATTRIBUTE_EXCEPTION

Berichtet eine Web-Dynpro-Ausnahme zu einem Context-Attribut.

Diese Methode berichtet eine Fehlermeldung zu einem Context-Attribut. Eine Fehlermeldung mit Context-Bezug beeinflußt den Ablauf des Web Dynpro-Phasenmodells. Wird eine solche Fehlermeldung vor dem Aufruf eines Action-Handlers (z.B. in den Methoden WDDOBEFOREACTION) erzeugt, dann werden Actions des Typs Standard nicht mehr ausgeführt. Eine sich daran anschließende Navigation sowie die Methoden WDDOMODIFYVIEW werden ebenfalls nicht mehr ausgeführt. Actions des Typs Validierungsunabhängig werden dagegen auch bei vorhandenen Fehlermeldungen ausgeführt. Eine sich daran anschließende Navigation sowie die Methoden WDDOMODIFYVIEW werden ebenfalls ausgeführt.

Eine Beschreibung der einzelnen Parameter dieser Methode finden Sie in der Methodendokumentation im System.

REPORT_ERROR_MESSAGE

Berichtet eine Web-Dynpro-Fehlermeldung (Diese Grafik wird im zugehörigen Text erklärt) mit optionalen Parametern. Hier können Sie einen String übergeben. Dies sollte entweder ein frei definierter StrukturlinkOTR-Text sein oder ein Text einer Exception-Klasse. Verwenden Sie keine harte Kodierung des Textes, um die leichte Übersetzbarkeit zu gewährleisten.

Eine Beschreibung der einzelnen Parameter dieser Methode finden Sie in der Methodendokumentation im System.

IS_EMPTY

Abfrage, ob Meldungen vorhanden sind.

REPORT_T100_MESSAGE

Berichtet eine Meldung mit Hilfe eines T100-Eintrags.

Eine Beschreibung der einzelnen Parameter dieser Methode finden Sie in der Methodendokumentation im System.

Sie finden ein Beispiel unter Einbindung von Meldungen in das Meldungsprotokoll.

REPORT_FATAL_EXCEPTION

Diese Methode berichtet eine Abbruchmeldung. Das Berichten einer Meldung dieses Typs in den Methoden

      WDDOINIT

      WDDOEXIT

      WDDOMODIFYVIEW

      sowie innerhalb eines Inbound-Plug-Event-Handlers

führt zu einem Abbruch der Web Dynpro-Anwendung mit einem Laufzeitfehler.

Wird eine Meldung dieses Typs in den Methoden WDDOBEFORENAVIGATION, WDDOPOSTPROCESSING oder innerhalb eines Action-Handlers erzeugt, dann wird die Verarbeitung an der entsprechenden Stelle unterbrochen und eine Fehlermeldung angezeigt.

Eine Beschreibung der einzelnen Parameter dieser Methode finden Sie in der Methodendokumentation im System.

REPORT_FATAL_ERROR_MESSAGE

Berichtet eine fatale WDA-Meldung mit optionalen Parametern.

Das Berichten einer Meldung dieses Typs in den Methoden

      WDDOINIT

      WDDOEXIT

      WDDOMODIFYVIEW

      sowie innerhalb eines Inbound-Plug-Event-Handlers

führt zu einem Abbruch der Web-Dynpro-Anwendung mit einem Laufzeitfehler.

Wird eine Meldung dieses Typs in den Methoden WDDOBEFORENAVIGATION, WDDOPOSTPROCESSING oder innerhalb eines Action-Handlers erzeugt, dann wird die Verarbeitung an der entsprechenden Stelle unterbrochen und eine Fehlermeldung angezeigt.

Eine Beschreibung der einzelnen Parameter dieser Methode finden Sie in der Methodendokumentation im System.

CLEAR_MESSAGES

Löscht alle Meldungen.

Eine Beschreibung der einzelnen Parameter dieser Methode finden Sie in der Methodendokumentation im System.

REPORT_ATTRIBUTE_T100_MESSAGE

Berichtet eine Web-Dynpro-Ausnahme zu einem Context-Attribut

REPORT_ELEMENT_ERROR_MESSAGE

Berichtet eine Web-Dynpro-Ausnahme zu Context-Attributen.

Diese Methode berichtet eine Fehlermeldung zu einem Context-Element. Eine Fehlermeldung mit Context-Bezug beeinflußt den Ablauf des Web-Dynpro-Phasenmodells. Wird eine solche Fehlermeldung vor dem Aufruf eines Action-Handlers (z.B. in den Methoden WDDOBEFOREACTION) erzeugt, dann werden Actions des Typs Standard nicht mehr ausgeführt. Eine sich daran anschließende Navigation sowie die Methoden WDDOMODIFYVIEW werden ebenfalls nicht mehr ausgeführt. Actions des Typs Validierungsunabhängig werden dagegen auch bei vorhandenen Fehlermeldungen ausgeführt. Eine sich daran anschließende Navigation sowie die Methoden WDDOMODIFYVIEW werden ebenfalls ausgeführt.

Eine Beschreibung der einzelnen Parameter dieser Methode finden Sie in der Methodendokumentation im System.

REPORT_ELEMENT_EXCEPTION

Berichtet eine Web-Dynpro-Ausnahme zu Context-Attributen.

Diese Methode berichtet eine Fehlermeldung zu einem Context-Element. Eine Fehlermeldung mit Context-Bezug beeinflußt den Ablauf des Web-Dynpro-Phasenmodells. Wird eine solche Fehlermeldung vor dem Aufruf eines Action-Handlers (z.B. in den Methoden WDDOBEFOREACTION) erzeugt, dann werden Actions des Typs Standard nicht mehr ausgeführt. Eine sich daran anschließende Navigation sowie die Methoden WDDOMODIFYVIEW werden ebenfalls nicht mehr ausgeführt. Actions des Typs Validierungsunabhängig werden dagegen auch bei vorhandenen Fehlermeldungen ausgeführt. Eine sich daran anschließende Navigation sowie die Methoden WDDOMODIFYVIEW werden ebenfalls ausgeführt.

Eine Beschreibung der einzelnen Parameter dieser Methode finden Sie in der Methodendokumentation im System.

REPORT_ELEMENT_T100_MESSAGE

Berichtet eine Web-Dynpro-Ausnahme zu Context-Attributen.

Diese Methode berichtet eine Fehlermeldung zu einem Context-Element. Eine Fehlermeldung mit Context-Bezug beeinflußt den Ablauf des Web-Dynpro-Phasenmodells. Wird eine solche Fehlermeldung vor dem Aufruf eines Action-Handlers (z.B. in den Methoden WDDOBEFOREACTION) erzeugt, dann werden Actions des Typs Standard nicht mehr ausgeführt. Eine sich daran anschließende Navigation sowie die Methoden WDDOMODIFYVIEW werden ebenfalls nicht mehr ausgeführt. Actions des Typs Validierungsunabhängig werden dagegen auch bei vorhandenen Fehlermeldungen ausgeführt. Eine sich daran anschließende Navigation sowie die Methoden WDDOMODIFYVIEW werden ebenfalls ausgeführt.

Eine Beschreibung der einzelnen Parameter dieser Methode finden Sie in der Methodendokumentation im System.

REMOVE_MESSAGE

Diese Methode löscht die Meldung zu der angegebenen ID.

HAS_VAL_ERRORS_FOR_WINDOW

Mit dieser Methode kann festgestellt werden, ob für ein bestimmtes Window Fehlermeldungen mit Context-Bezug existieren.

Eine Beschreibung der einzelnen Parameter dieser Methode finden Sie in der Methodendokumentation im System.

HAS_VALIDATION_ERRORS

Mit dieser Methode kann geprüft werden, ob Fehlermeldungen mit Context-Bezug vorliegen.

Eine Beschreibung der einzelnen Parameter dieser Methode finden Sie in der Methodendokumentation im System.

GET_MESSAGES

Diese Methode gibt eine Liste aller vorhandenen Meldungen zurück.

Eine Beschreibung der einzelnen Parameter dieser Methode finden Sie in der Methodendokumentation im System.

 

Ende des Inhaltsbereichs