Ansicht
Dokumentation

BAL_CNTL_CREATE - Anwendungs-Log: Ausgabe in einem Control-Container: Control erzeugen

rdisp/max_wprun_time - Maximum work process run time   PERFORM Short Reference  
Diese Dokumentation steht unter dem Copyright der SAP AG.

|---------------------------------------------------------------------|
| Protokollanzeige im Control-Container |
|---------------------------------------------------------------------|

Funktionalität

Die Protokollanzeige des Application Logs kann in einem beliebigen Control-Container erscheinen.

Beispiel

Report SBAL_DEMO_04_CONTROL zeigt, wie eine Einbindung realisiert sein kann
(==>Ausführen ==>Coding).

Verwandte Funktionsbausteine

BAL_CNTL_CREATE,, Control erzeugen
BAL_CNTL_REFRESH,, Auffrischen mit neuen Daten
BAL_CNTL_FREE,, Control wieder zerstören

Vorgehensweise
==========================================================

Control-Container erzeugen

Z.B. auf einem Dynpr durch einen Custom-Container,
als amodale Dialogbox, etc. (siehe die entsrpechenden Klassen).

Application-Log-Control erzeugen mit BAL_CNTL_CREATE

Diesem Baustein gibt man mit I_CONTAINER den den Container mit, in dem das Control erscheinen soll.

Mit dem Parameter I_S_DISPLAY_PROFILE (Anzeigeprofil) wird definiert, wie die Anzeige aufgebaut werden soll (näheres siehe hier).
Im Standard gibt es vordefinierte Anzeigeprofile, die genutzt werden können (siehe hier).

Die Parameter I_T_LOG_HANDLE gibt an, welche Protokolle dargestellt werden sollen. Diese Protokolle müssen sich bereits im Hauptspeicher des Application Logs befinden.
Protokolle sind im Hauptspeicher, wenn sie gerade frisch erstellt und noch nicht gelöscht wurden, oder wenn sie mit dem Funktionsbaustein BAL_DB_LOAD von der Datenbank geladen wurden.
Ist I_T_LOG_HANDLE leer, dann werden alle im Hauptspeicher befindlichen Daten genommen.

Zusätzlich kann die anzuzeigende Datenmenge noch durch die Parameter I_S_LOG_FILTER, I_T_LOG_CONTEXT_FILTER, I_T_MSG_HANDLE, I_S_MSG_FILTER, I_T_MSG_CONTEXT_FILTER weiter eingeschränkt werden (näheres siehe hier).

Mit dem Exporting-Parameter E_CONTROL_HANDLE erhält man ein Handle auf dieses Control, mit dem man es mit neuen Daten versorgen (BAL_CNTL_REFRESH) oder auch wieder zerstören kann (BAL_CNTL_FREE).

Die Exporting-Parameter E_NO_DATA_AVAILABLE und E_NO_AUTHORITY stehen auf 'X', wenn es keine Meldungen im Hauptspeicher gibt, die den Kriterien genügen oder wenn die Berechtigung zur Anzeige fehlt.

Daten auffrischen mit BAL_CNTL_REFRESH

Mit diesem Baustein kann die anzuzeigende Datenmenge aktualisiert werden (z.B. weil neue Protokolle hinzugekommen sind oder weil sich die Meldungen in einem Protokoll verändert haben).
Der Parameter I_CONTROL_HANDLE bezeichnet das Control, das aufgefrischt werden soll.
Die anderen Parameter definieren analog zum Funktionsbaustein BAL_CNTL_CREATE die anzuzeigende Datenmenge.

Zertören des Controls mit BAL_CNTL_FREE

Mit diesem Baustein wird das Control mit dem Handle I_CONTROL_HANDLE am Frontend zerstört und die Resourcen im ABAP wieder freigegeben.

Informationen im Umfeld

Das Prinzip der Protokollanzeige

Verwandte Funktionsbausteine

Funktionsbausteine für Anzeigeprofile

Weiterführende Informationen

Übersicht der wichtigsten Funktionsgruppen

Quickstart-Dokumentation

Application Log: Technische Dokumentation

Parameter

E_CONTROL_HANDLE
E_NO_AUTHORITY
E_NO_DATA_AVAILABLE
I_CONTAINER
I_MSG_CONTEXT_FILTER_OPERATOR
I_SRT_BY_TIMSTMP
I_S_DISPLAY_PROFILE
I_S_LOG_FILTER
I_S_MSG_FILTER
I_T_LOG_CONTEXT_FILTER
I_T_LOG_HANDLE
I_T_MSG_CONTEXT_FILTER
I_T_MSG_HANDLE

Ausnahmen

INTERNAL_ERROR
PROFILE_INCONSISTENT

Funktionsgruppe

SBAL_CNTL

Addresses (Business Address Services)   CL_GUI_FRONTEND_SERVICES - Frontend Services  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 6102 Date: 20240523 Time: 100519     sap01-206 ( 77 ms )