IF_WD_MESSAGE_MANAGER 

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. Eine Beschreibung der einzelnen Parameter dieser Methoden finden Sie in der Methodendokumentation im System.

Methoden

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.

Informationen über den Parameter ENABLE_MESSAGE_NAVIGATION bei den REPORT_-Methoden finden Sie unter MessageArea-Ereignisse.

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).

REPORT_SUCCESS

Berichtet eine Erfolgsmeldung ().

REPORT_WARNING

Berichtet eine Warnung ().

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.

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.

REPORT_ERROR_MESSAGE

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

IS_EMPTY

Abfrage, ob Meldungen vorhanden sind.

REPORT_T100_MESSAGE

Berichtet eine Meldung mit Hilfe eines T100-Eintrags.

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.

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.

CLEAR_MESSAGES

Löscht alle Meldungen.

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.

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.

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.

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.

HAS_VALIDATION_ERRORS

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

GET_MESSAGES

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

GET_MESSAGE_FOR_ID

Diese Methode gibt Informationen zu einer Meldung zurück