Reporting-Ereignisse
Siehe Reporting.
Ein Report durchläuft eine Reihe von vordefinierten Ereignissen.
Ab ERP 5.0 ist es möglich, ein Programm mit mehreren gleichen Ereignissen zu versehen! So kann ein Programm durchaus mehrmals das Ereignis "INITIALIZATION" haben. Das ist sicherlich kein schöner Programmierstil, wenn man dies absichtlich so programmiert, aber es gibt so die Möglichkeit, in Includes dieses Ereignis zu benutzen und im Hauptprogramm kann INITIALIZATION trotzdem weiterhin syntaxkonform verwendet werden.
Wenn ein Programm angelegt wird, dann definiert man einen Report mit dem Programmtyp 1. Ein Report wird definiert durch die Ereignisblöcke, die in einer festen zeitlichen Reihenfolge ablaufen vom "Load-of-Program" bis "End-of-Selection" oder ggf. "At-Line-Selection". Sie müssen im Coding nicht in dieser Reihenfolge angegeben werden. Aber es erleichtert die Übersicht, wenn man das Coding auch in dieser Reihenfolge schreibt.
LOAD-OF-PROGRAM
- Als erstes beim Start eines Reports (SAP-Programmtyp = 1) wird das Ereignis Load-Of-Program durchlaufen.
- Dieses Ereignis wird extrem selten genutzt.
- Das Ereignis wird meist genutzt um eine Berechtigungsabfrage durchzuführen und bei einer negativen Antwort eine entsprechende Meldung auszugeben und dann das Programm zu verlassen.
INITIALIZATION
- Bevor der Selektionsbildschirm angezeigt wird, wird das Ereignis INITIAlIZATION durchlaufen.
- Das Ereignis wird genutzt um Felder vom Selektionsbildschirm vorzubelegen.
- Initialization
AT SELECTION-SCREEN OUTPUT
- Das Ereignis wird nach INITIALIZATION und vor START-OF-SELECTION aufgerufen
- At Selection-Screen Output
- Das Ereignis wird genutzt, um Felder auf Inaktiv (nicht eingabefähig), auszublenden oder in Abhängigkeit von einem Radiobutton ein-/auszublenden.
AT SELECTION-SCREEN
- Nach dem Anzeigen des Selektionsbildes und vor START-OF-SELECTION
Beim Ereignis At-Selection-Screen finden in der Regel Prüfungen von Werten von Selektionsfeldern statt.
AT SELECTION-SCREEN ON VALUE-REQUEST FOR feldname
- AT SELECTION-SCREEN ON VALUE-REQUEST FOR feldname
- Das Ereignis wird genutzt, um Coding bei einem Selektionsfeld und der F4-Hilfe zu durchlaufen, um letztlich einen Wert in das Feld zurückzuschreiben.
START-OF-SELECTION
- Ab dem Ereignis Start-of-Selection werden die eigentlichen Daten vom Report selektiert. Das Programm wird über den Selektionsbildschirm hinaus ausgeführt.
- Dieses Ereignis wird in einem Report auch manchmal weggelassen, da die Laufzeitumgebung alles Coding, was nicht explizit einem Ereignis zugewiesen wird, diesem Ereignis zuweist. Aber es ist guter Stil und übersichtlich, wenn man das Ereignis "Start-of-Selection" angibt.
END-OF-SELECTION (obsolet)
- Dieses Ereignis wird häufig auch weggelassen, da sie nur in Verbindung mit logischen Datenbanken weitergehende Funktionalität hat, siehe SAP-Hilfe: END-OF-SELECTION.
- Logische Datenbanken sollten bei aktuellen Reporten nicht mehr verwendet werden, da logische Datenbanken schwer verständlich uind schwer wartbar sind.
AT-LINE-SELECTION
- Werden in einer Write-Liste Selektionen durchgeführt wie Doppelklicks, kann das im Ereignis "At-Line-Selection" abgefangen werden.
- Da Write-Listen nur noch sehr selten benutzt werden, wird auch das Ereignis AT-LINE-SELECTION nur noch sehr selten benötigt. Meist wird man hier eine ALV-Liste ausgeben, die nicht auf das Ereignis AT-LINE-SELECTION reagiert.
