Objekt messages 
Das Objekt messages ist vom Typ wie die Klasse CL_BSP_MESSAGES. Dieses Objekt ist ein Nachrichten-Container und dient der Ausgabe von unterschiedlichen Arten von Fehlermeldungen. Es enthält eine Liste von Fehlermeldungen mit Schwere, Bedingung und dem zugehörigen Text.
Dieses Objekt setzen Sie ein, um bei BSP-Applikationen Fehleingaben von Benutzern zu behandeln. Weitere Informationen finden Sie unter Behandlung von Fehleingaben.
Treten bei automatischen Seitenattributen Syntaxfehler auf - etwa, wenn eine Eingabe nicht in ein bestimmtes Format konvertiert werden kann - wird ein Eintrag in die Liste gemacht. Die Bedingung ist dabei der Attributname.
Sie können während der Eingabeverarbeitung von der BSP-Anwendung weitere Einträge in das messages-Objekt hinzufügen. Texte und Bedingungen sind dabei frei wählbar.
Struktur
Die folgenden Methoden stehen zur Verfügung:
NUM_MESSAGES
Bei Aufruf dieser Methode wird die Anzahl der Meldungen geliefert.
ADD_MESSAGE
Bei Aufruf dieser Methode wird eine einzelne Meldung hinzugefügt.
GET_MESSAGE
Bei Aufruf dieser Methode wird die angeforderte Meldunge geliefert.
ASSERT
Bei Aufruf dieser Methode wird der Index der Meldung zu einer bestimmten Kondition geliefert oder 0.
ASSERT_SEVERITY
Bei Aufruf dieser Methode wird die Schwere des Fehlers zu einer bestimmten Kondition geliefert oder 0.
ASSERT_MESSAGE
Bei Aufruf dieser Methode wird die Meldung zu einer bestimmten Kondition geliefert oder ein Leerstring.
Die Konditionen geben die Meldungsarten oder Fehlerstufen an. Folgende Fehlerstufen sind vorgesehen:
Attributname |
Initialwert |
Beschreibung der Fehlerstufe |
CO_SEVERITY_ERROR |
2 |
normaler Fehler |
CO_SEVERITY_FATAL_ERROR |
1 |
fataler Fehler |
CO_SEVERITY_INFO |
4 |
Information |
CO_SEVERITY_SUCCESS |
5 |
Erfolgsmeldung |
CO_SEVERITY_WARNING |
3 |
Warnung |
Die jeweiligen Meldungen werden in einer Tabelle (Attribut M_MESSAGES) zusammengefaßt.
Beispiel
Ein Beispiel für den Einsatz dieses Objekts ist im SAP-System die BSP-Applikation bsptutorialmessages, die sich im Paket SBSP_DOCU befindet.