Ansicht
Dokumentation

BAL_GLB_MSG_DEFAULTS_SET - Anwendungs-Log: Global: Vorbelegungen für Meldungen setzen

BAL Application Log Documentation   SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Manche Informationen, die zum Verständnis einer Meldung wichtig wären, sind am Ort des Entstehens einer Meldung gar nicht bekannt, sondern eventuell nur in der Programmebene darüber.

Beispiel
In einer sehr tiefliegenden Routine wird der Angabe des Zielorts für einen LKW-Transport überprüft. An dieser Stelle ist weder die Transportnummer noch die Teilstrecke bekannt, für die dies durchgeführt wird.

Damit die von dieser Routine abgesetzten Meldungen die korrekten Kontext-Informationen enthalten, kann man diese vor dem Aufruf dieser Routine vorbelegen (Defaults setzen).
Dies geschieht mit BAL_GLB_MSG_DEFAULTS_SET. Diesem Funktionsbaustein wird der Datentyp BAL_S_MDEF übergeben, der neben dem Kontext noch weitere Daten (wie Meldungsattribute, Parameter, das Default-Protokoll, etc.) enthält.
Die aktuell gültigen Vorbelegungen kann man sich auch mit BAL_GLB_MSG_DEFAULTS_GET besorgen. Dies ist vor allem wichtig, wenn man die Vorbelegungen nicht komplett neu setzen sondern nur einen bestimmten Aspekt verändern möchte (z.B. die Positionsnummer des Kontextes aber nicht die Auftragsnummer).

• ==>Hinweis
  Es ist immer empfehlenswert, die Funktionsbausteine BAL_GLB_MSG_DEFAULTS_GET und BAL_GLB_MSG_DEFAULTS_SET in Kombination zu verwenden, da man nicht sicher sein kann, welche Vorbelegungen zur Zeit gesetzt sind.

Die Vorbelegungen wirken auf die folgenden Funktionsbausteine:
BAL_LOG_MSG_ADD Meldung einem Protokoll hinzufügen
BAL_LOG_EXCEPTION_ADD Ausnahme einem Protokoll hinzufügen
BAL_LOG_MSG_CUMULATE Meldung kumuliert hinzufügen
BAL_LOG_MSG_REPLACE Die letzte Meldung ersetzen
BAL_LOG_MSG_ADD_FREE_TEXT Meldung als freien Text hinzufügen

==> Hinweis
Dieser Funktionsbaustein enthält den optionalen Parameter I_AUTHORIZATION, die sogenannte Autorisation. Diese Autorisation dient dazu, "unberechtigte" Aufrufe von Funktionsbausteinen, die kritische Aktivitäten wie Initialisierungen durchführen, zu unterbinden. In diesem Fall wird die Exception NOT_AUTHORIZED ausgelöst. Zur Erläuterung siehe bitte Autorisation im Application Log.

Weiterführende Informationen

Übersicht der wichtigsten Funktionsgruppen

Quickstart-Dokumentation

Application Log: Technische Dokumentation

Parameter

I_AUTHORIZATION
I_S_MSG_DEFAULTS

Ausnahmen

DEFAULTS_INCONSISTENT
NOT_AUTHORIZED

Funktionsgruppe

SBAL_TOOLBOX

BAL Application Log Documentation   BAL_S_LOG - Application Log: Log header data  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 3697 Date: 20240523 Time: 102235     sap01-206 ( 68 ms )