Ansicht
Dokumentation

CL_HRPAY00_EXAMPLE_MESSAGES - Beispielklasse zur Nutzung des Message-Handlers

Fill RESBD Structure from EBP Component Structure   TXBHW - Original Tax Base Amount in Local Currency  
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 Nutzung Message-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 Interfaces IF_HRPAY00_MESSAGE_HANDLER (Message-Handler) übergeben. Über dieses Interface können die Fehlermeldungen gesammelt und 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 an den 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ßend wird 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 eine Protokollierung ü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 Interfaces IF_HRPAY00_LOG_BUILDER (Protokollierung HCM) exemplarisch verwendet.

Die Methode CALCULATE_WITH_EXCEPTION (Durchführung einer Berechnung mit Nutzung von Ausnahmen) wirft immer im Wechsel die Ausnahme CX_HRPAY00_EXAMPLE_MESSAGES (Message Handler Example Exceptionklasse) und CX_HRPAY00_EXAMPLE_MESSAGES_TX (Message Handler Example Exceptionklasse ohne 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 demzufolge auch 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   Fill RESBD Structure from EBP Component Structure  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 3770 Date: 20240427 Time: 013652     sap01-206 ( 75 ms )