CL_HRPAY00_EXAMPLE_MESSAGES - Beispielklasse zur Nutzung des Message-Handlers

RFUMSV00 - Advance Return for Tax on Sales/Purchases   General Material Data  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Über die Klasse wird die Verwendung des Message-Handlers CL_HRPAY00_MESSAGE_HANDLER beispielhaft dargestellt.

In der Methode CALCULATE(Durchführung einer Berechnung mit NutzungMessage-Handler) wird jeweils für jeden dritten Aufruf eine Fehlermeldung in den Message-Handler übergeben oder ein Protokoll über den LOG-Builder erstellt.

Als Import-Parameter wird eine Referenz des InterfacesIF_HRPAY00_MESSAGE_HANDLER(Message-Handler) übergeben. Über dieses Interface können die Fehlermeldungen gesammeltund das Protokoll erstellt werden. Der Export-Parameter E_IS_OK dient dazu,dem aufrufendem Programm oder Baustein anzuzeigen, ob ein Fehler vorliegt und eine Fehlermeldung anden Message-Handler übergeben wurde. Das Absetzen einer Fehlermeldung und Setzen des Export-Parameters E_IS_OKsollte immer einher gehen.

Zu Beginn der Verarbeitung wird dieser Parameter auf den Wert ABAP_TRUE ('X') gesetzt.

Fehlermeldungen
Im Fehlerfall wir eine Meldung mit dem Befehl MESSAGE ennn(id) INTO l_dummy erzeugt und durch Aufruf der Methode ADD_MESSAGE(Aufnahme Nachricht in Message-Tabelle) an den Message-Handler übergeben. Anschließendwird Export-Parameter E_IS_OK auf den Wert ABAP_FALSE (' ')gesetzt und die Verarbeitung mit RETURN verlassen.

Protokollierung
Für die 'nicht-fehlerhaften' Personalfälle wird eineProtokollierung über den LOG-Builder vorgenommen. Dazu wird als Erstes die Methode LOG_CREATE_INSTANCE zum Anlegen des Protokolls für die Personalnummer gerufen.

Anschließend werden die unterschiedlichen ADD-Methoden zur Protokollierung des InterfacesIF_HRPAY00_LOG_BUILDER (Protokollierung HCM) exemplarisch verwendet.

Die Methode CALCULATE_WITH_EXCEPTION (Durchführung einer Berechnungmit Nutzung von Ausnahmen) wirft immer im Wechsel die Ausnahme CX_HRPAY00_EXAMPLE_MESSAGES (MessageHandler Example Exceptionklasse) und CX_HRPAY00_EXAMPLE_MESSAGES_TX (Message Handler Example Exceptionklasseohne T100). Diese Ausnahmeklassen unterscheiden sich darin, dass die Klasse CX_HRPAY00_EXAMPLE_MESSAGES das Interface IF_T100_MESSAGE verwendet und die andere nicht. Beide Varianten können vom Aufrufer durch den Message-Handler abgefangen und weiterverarbeitet werden.

Im Unterschied zur Methode CALCULATE wird kein Message-Handler und demzufolgeauch kein Parameter E_IS_OK verwendet. Das Errorhandling läuft alleineüber Ausnahmen und soll verdeutlichen, wie beispielsweise beim Aufruf von Basismethoden mit Ausnahmen verfahren werden kann.

Beziehungen

Der Aufruf der Methode erfolgt in dem Report RPMUST_MESSAGE_HANDLER (Beispielprogramm Nutzung Message-Handler).

Beispiel

Hinweise

Weiterführende Informationen

ROGBILLS - Synchronize billing plans   PERFORM Short Reference  
Diese Dokumentation steht unter dem Copyright der SAP AG.


Length: 3714 Date: 20120527 Time: 155300     triton ( 176 ms )