ALV-Event-Handling: SALV & OO ALV

Verwendung des Event-Mechanismus zur Verwaltung von Benutzerinteraktionen, zum Hinzufügen von Toolbar-Schaltflächen und zum Erfassen von Doppelklicks und Zelländerungen in ALV-Bildschirmen.

In der Welt des SAP ABAP-Reportings nutzen wir den Event-Mechanismus, um Benutzeraktionen auf gelisteten Daten zu erfassen und dynamische Geschäftslogik zu erstellen. Aktionen wie das Drücken einer Schaltfläche in der Toolbar, ein Doppelklick auf eine Zelle oder Datenänderungen in einer bearbeitbaren Zelle werden durch Events verwaltet, die von den entsprechenden Kontrollklassen ausgelöst werden.

In diesem Leitfaden finden Sie die am häufigsten verwendeten Event-Strukturen und Integrationsmethoden für sowohl SALV (Object-Oriented Simple ALV) als auch die traditionelle OO ALV (CL_GUI_ALV_GRID) Architektur.

💡 Regeln für das Event-Management

Obligatorische Registrierung (Registration): Damit die definierten Event-Methoden ausgelöst werden können, müssen sie gemäß den Regeln der objektorientierten ABAP-Programmierung zur Laufzeit (runtime) mit der Anweisung SET HANDLER im System registriert werden.
Hotspot-Einschränkung: Damit das hotspot_click-Event ausgelöst werden kann, muss die Hotspot-Eigenschaft in den Katalogeigenschaften der entsprechenden Spalte (im Feldkatalog oder den SALV-Spalteneinstellungen) aktiviert sein.
Datenvalidierung (Validation): Der ideale Ort, um vom Benutzer manuell im ALV geänderte Daten zu überprüfen und vor dem Schreiben in die Datenbank zu validieren, ist das data_changed-Ereignis.

💻 Technische Referenz für ALV-Events

1. SALV Added Function (Toolbar-Button-Verwaltung)

In der SALV-Architektur wird das added_function-Ereignis überwacht, um Klicks auf benutzerdefinierte Schaltflächen zu erfassen, die der Toolbar hinzugefügt wurden.

* Method DefinitionMETHODS on_added_function
  FOR EVENT added_function OF cl_salv_events_table
  IMPORTING e_salv_function.

* Method ImplementationMETHOD on_added_function.
  CASE e_salv_function.
    WHEN 'CREATE'.
      create_orders( ).
  ENDCASE.ENDMETHOD.

* Event RegistrationDATA(lo_events) = go_alv->get_event( ).
SET HANDLER on_added_function FOR lo_events.

2. SALV-Doppelklick & Hotspot-Navigation

Dies ist ein Beispiel für das Erfassen eines Doppelklicks eines Benutzers auf eine Zeile oder Zelle, um durch Übergabe von Parametern zum entsprechenden Transaktionscode (z. B. `VA03`, `VF03`) zu navigieren.

* Method DefinitionMETHODS on_double_click
  FOR EVENT double_click OF cl_salv_events_table
  IMPORTING row column.

* Method Implementation with Defensive Table AccessMETHOD on_double_click.
  TRY.
      DATA(ls_out) = gt_out[ row ].
    CATCH cx_sy_itab_line_not_found.
      RETURN.
  ENDTRY.

  CASE column.
    WHEN 'CUSTOMER_ORDER'.
      SET PARAMETER ID 'AUN' FIELD ls_out-customer_order.
      CALL TRANSACTION 'VA03' AND SKIP FIRST SCREEN.
    WHEN 'TRD_SERVICE_ORDER'.
      SET PARAMETER ID 'AUN' FIELD ls_out-trd_service_order.
      CALL TRANSACTION 'VA03' AND SKIP FIRST SCREEN.
  ENDCASE.ENDMETHOD.

3. OO ALV Hotspot-Klick & dynamisches Toolbar-Management

Dies ist der Mechanismus zum Erfassen von Hotspot-Klicks in einem traditionellen Grid (cl_gui_alv_grid) und zum dynamischen Hinzufügen/Erfassen von Schaltflächen in der Standard-Toolbar.

* Hotspot Click ImplementationMETHOD handle_hotspot_click.
  READ TABLE gt_list REFERENCE INTO gr_list INDEX e_row_id.
  IF sy-subrc IS INITIAL.
    CASE e_column_id.
      WHEN 'VBELN'.
        SET PARAMETER ID 'VL' FIELD gr_list->vbeln.
        CALL TRANSACTION 'VL03N' AND SKIP FIRST SCREEN.
    ENDCASE.ENDIF.ENDMETHOD.

* Injecting Custom Button to OO ALV ToolbarMETHOD handle_toolbar.
  APPEND VALUE stb_button( function = 'CREATE'
                           icon     = icon_create
                           text     = 'Create' ) TO e_object->mt_toolbar.
ENDMETHOD.

* Handling Custom Button User CommandMETHOD handle_user_command.
  CASE e_ucomm.
    WHEN 'CREATE'.
      MESSAGE 'Button Triggered.' TYPE 'S'.
  ENDCASE.ENDMETHOD.

4. Datenvalidierung (Erfassen von Zelländerungen)

Dies ist die Geschäftslogik, die ausgeführt wird, wenn der Benutzer den Zellinhalt ändert und die Eingabetaste drückt, und die die Informationen der geänderten Zelle erfasst.

METHOD handle_data_changed.
  LOOP AT er_data_changed->mt_good_cells INTO DATA(ls_cell).
    " Accessing modified row_id, fieldname, and entry value
    WRITE: / ls_cell-row_id, ls_cell-fieldname, ls_cell-value.
  ENDLOOP.ENDMETHOD.

5. SALV Top of Page & End of List Layout

Dies ist die Layout-Grid-Architektur, die verwendet wird, um einen Kopfbereich am Anfang der Berichtsliste oder eine Zusammenfassungs-/Summenzeile am Ende hinzuzufügen.

* Top of Page ConfigurationDATA(lo_header) = NEW cl_salv_form_layout_grid( ).
lo_header->create_label( row = 1 column = 1 text = 'Sales Order Overview' ).
go_alv->set_top_of_list( lo_header ).

* End of List ConfigurationDATA(lo_footer) = NEW cl_salv_form_layout_grid( ).
lo_footer->create_label( row = 1 column = 1 text = 'Total Records: 120' ).
go_alv->set_end_of_list( lo_footer ).

Verpassen Sie nicht den neuen Code in der Bibliothek!

Abonnieren Sie den Newsletter, um sofort über wöchentlich aktualisierte unternehmensweite ABAP-Komponenten, Leistungstipps und Architekturentwürfe informiert zu werden.