ajanzen.com Aktualisieren der ALV-Anzeige nach Daten- bzw. Eigenschaftsänderung

Transkript

1 Aktualisieren der ALV-Anzeige nach Daten- bzw. Eigenschaftsänderung

2 1 Einleitung Der Fokus des vorliegenden Dokumentes liegt auf dem Vorgehen zum Einbinden einer eigenen Toolbarfunktion bei ALV-Erzeugung unter Verwendung von Klasse CL_SALV_TABLE und dem Aktualisieren der Anzeige. Im Rahmen dessen wird auch auf die Behandlung des Ereignisses auslösen der eigenen Toolbarfunktion eingegangen. Zur besseren Strukturierung des Codes ist die Ereignisbehandlung in ein eigenständiges INCLUDE ausgelagert. In dem vorliegenden Beispiel wurden drei Funktionen ausgeprägt: Spalten grün einfärben Spalten rot einfärben Inhalt der Spalte CARRID ändern Das komplette Beispielcoding ist in Kapitel 3 enthalten. Nähere Informationen zum Ablauf können Kapitel 2 entnommen werden. 1

3 2 Informationen zur Programmlogik Im vorliegenden Beispiel werden vorbereitend die Informationen aus Tabelle SFLIGHT in eine interne Tabelle selektiert und in Form eines ALVs visualisiert. Anschließend wird gezeigt, wie die Toolbar der ALV-Anzeige um eigene Funktionen erweitert werden kann. Das Ergebnis kann Abbildung 1 entnommen werden. Aus Gründen der Übersichtlichkeit sind Hauptprogramm und das INCLUDE zur Ereignisbehandlung in eigenständigen Kapiteln enthalten. 2.1 Hauptprogramm In Kapitel 2.1 wird zwischen dem umgesetzten Vorgehen (siehe Unterkapitel 2.1.1) und einer anderen möglichen Vorgehensweise (siehe Unterkapitel 2.1.2) unterschieden Umgesetztes Vorgehen Im ersten Schritt des ALV-Aufrufes wird über die FACTORY-Methode der Klasse CL_SALV_TABLE eine Instanz derselben Klasse erzeugt. Dabei wird der Factory- Methode die Tabelle mit den anzuzeigenden Informationen direkt mitgegeben. Eine zusätzliche Angabe eines Feldkataloges ist nicht notwendig, da sich die CL_SALV_TABLE-Klasse die Dictionary-Informationen anhand der Tabellenfelder ermittelt. Zu beachten ist, dass beim Aufruf der FACTORY-Methode der optionale Parameter R_CONTAINER mit einem Default-Container belegt wird. Die Begründung für den Container-Einsatz ist in Kapitel enthalten. Über eine Instanz von Klasse CL_SALV_COLUMNS_TABLE wird die Spaltenbreite an den Inhalt angepasst (optimiert). Zum besseren Auswählen der einzelnen Zeilen, erfolgt das Aktivieren des Selektionsmodus. Für diese Aktivität wird zum ALV eine Instanz der Klasse CL_SALV_SELECTIONS erzeugt und der Selektionsmodus durch Aufruf von Methode SET_SELECTION_MODE( ) gesetzt. Für das Erweitern der Toolbar um die gewünschte Funktion, ist eine Instanz der Klasse CL_SALV_FUNCTIONS_LIST zum ALV notwendig. Vor dem Einfügen der eigenen Funktion werden über Methode SET_ALL( ) der soeben erzeugten Instanz alle SAP- Standard ALV-Funktionen aktiviert. In Abbildung 1 sind diese Funktionen links vom roten Rahmen aufgeführt. 2

4 Das Hinzufügen der eigenen Funktionen erfolgt über Methode ADD_FUNCTION( ) der Klasse CL_SALV_FUNCTIONS_LIST. In dem vorliegenden Beispiel sind alle Schnittstellenparameter der Methode belegt und die neuen Funktionen rechts neben den Standard-Funktionen positioniert. Das Ergebnis des bisher beschriebenen Vorgehens ist in Abbildung 1 visualisiert. Der rote Rahmen hebt die eigene Funktion hervor. Abbildung 1: Um eigene Funktionen erweiterte Toolbar Wie bereits einleitend erwähnt, wird beim Klick auf die neu eingefügten Funktionen ein Ereignis ausgelöst. Die Ereignisbehandlung findet über eine eigenständige lokale Klasse statt. Nähere Informationen zu der Klasse können Kapitel 2.2 entnommen werden. Damit das ALV weiß, wo das Klick-Ereignis behandelt wird, ist eine Verbindung zwischen Ereignis und Ereignis-Behandler herzustellen, also das Ereignis zu registrieren. Zum Registrieren wird eine Instanz der Klasse CL_SALV_EVENTS_ TABLE benötigt. Das Objekt der Klasse verwaltet die SALV-Ereignisse. Da zur Ereignisbehandlung eine eigenständige Klasse zum Einsatz kommt, muss diese ebenfalls instanziiert werden. Nach Instanziieren der lokalen Behandler-Klasse wird diese über die Anweisung SET HANDLER der Instanz von CL_SALV_EVENTS_ TABLE zugeordnet und damit die Verbindung zwischen Ereignis und Ereignisbehandlung hergestellt. Hinweis: Bei dem ausgelösten Ereignis handelt es sich um ADDED_FUNCTION. Dieses kann der Registerkarte Ereignisse der Klasse CL_SALV_EVENTS_TABLE entnommen werden (siehe Abbildung 2). In der Behandler-Klasse kommt für die Ereignisbehandlung Methode HANDLE_TOOLBAR_CLICK zum Einsatz. 3

5 Abbildung 2: Ereignis ADDED_FUNCTION der Klasse CL_SALV_EVENTS_TABLE Das eigentliche Visualisieren erfolgt durch Methode DISPLAY( ) der ALV-Klasse. Da der Factory-Methode ein Container mitgegeben wurde, ist auch eine Art Träger- Dynpro notwendig. Dieses ist erforderlich, damit sich der Container irgendwo andocken kann. In diesem Beispiel wird das Dynpro über die Anweisung WRITE erzeugt Exkurs Mir sind zwei Vorgehen bekannt, die beim Einsatz der CL_SALV_TABLE-Klasse das Einbinden eigener Funktionen in die Toolbar ermöglichen. In Kapitel ist eines der Vorgehen beschrieben. Das zugehörige Coding kann Kapitel 3 entnommen werden. Die zweite Möglichkeit basiert auf dem Einsatz des PF-STATUS. Der PF-Status mit allen ALV-Standardfunktionen kann aus dem Demo-Report SALV_DEMO_TABLE_ FUNCTIONS kopiert werden und hat hier die Bezeichnung SALV_STANDARD. Nach dem Kopieren lässt sich der PF-Status durch eigene Funktionen erweitern (sieh Abbildung 3). Abbildung 3: Um eigene Funktion erweiterter PF-Status Hinweis: Die in Abbildung 3 hinzugefügte Funktion weicht von den Funktionen aus Abbildung 1 ab. 4

6 Das Bekanntmachen des PF-Status der SALV-Instanz erfolgt über folgende Anweisung: gr_salv->set_screen_status( pfstatus = 'SALV_STANDARD' report = sy-repid set_functions = gr_salv->c_functions_all ). Auch eine über den PF-Status eingefügte Funktion erscheint in der Toolbar und das Ausführen dieser Funktion erzeugt ein Ereignis. Die Ereignisbehandlung unterscheidet sich nicht von der Ereignisbehandlung beim ersten Vorgehen und kann dem vorliegenden Dokument entnommen werden. Welches der beiden Vorgehen zum Erweitern der Toolbar eingesetzt werden kann, hängt davon ab, ob der FACTORY-Methode der Klasse CL_SALV_TABLE ein Container mitgegeben wird oder nicht. Wird auf das Mitgeben eines Containers verzichtet, erfolgt im Rahmen der Ausführung der DISPLAY( ) Methode ein Dynproaufruf. Bei diesem Vorgehen können eigene Funktionen nur über den PF- Status mitgeteilt werden. Bei Angabe eines Containers, ist das Erweitern der Toolbar nur über die Methode ADD_FUNCTION( ) möglich. Da in diesem Fall kein Dynpro-Aufruf in Methode DISPLAY( ) erfolgt, ist der zusätzliche Aufruf eines Träger-Dynpros im Programm notwendig. In diesem Beispiel habe ich mich für die Variante mit Container entschieden. Das hat m.e. den Vorteil, dass der Beispielcode direkt kopiert und getestet werden kann. Statt der WRITE-Anweisung für das Träger-Dynpro kann zum Aufruf eines Dynpros auch die Anweisung CALL-Screen verwendet werden. Auch bei der Verwendung der Container hat der Entwickler freie Hand. So kommen hier beispielsweise folgende Container in Frage: CL_GUI_DOCKING_CONTAINER CL_GUI_DIALOGBOX_CONTAINER CL_GUI_CUSTOM_CONTAINER 2.2 INCLUDE zur Ereignisbehandlung Wie bereits im Vorfeld beschrieben, ist für die Behandlung des Ereignisses Button- Click eine Behandler-Klasse notwendig. In dem vorliegenden Beispiel wurde die 5

7 Klasse in ein eigenständiges INCLUDE ausgelagert. Die ausgeprägte Logik ist in Kapitel 2.2 beschrieben. Die Behandler-Klasse besteht neben der Constructor-Methode ausschließlich aus Methode HANDLE_TOOLBAR_CLICK. Letztere wurde als Event-handler für das Ereignis ADDED_FUNCTION der CL_SALV_EVENTS_TABLE definiert. Beim Instanziieren der Behandler-Klasse werden der Constructor-Methode eine Instanz der SALV-Klasse und die Tabelle mit den Daten übergeben. Der Inhalt beider Parameter wird in klassenglobalen Attributen abgelegt und damit für die Weiterverarbeitung vorgehalten. Bei Ablage der Datentabelle ist zu beachten, dass diese nicht über ein = sondern über die Anweisung GET REFERENCE OF erfolgt. Siehe nachfolgende Erklärung: Bei Verwenden des = für die Datenzuweisung wird der Inhalt der Importparameter- Tabelle IT_SFLIGHT in das globale Klassenattribut kopiert. Dadurch existieren die Informationen (Tabellen) doppelt (siehe Abbildung 4). Importparameter IT_SFLIGHT Mandant Carrier Flug-Nr. Flugdatum Flugpreis 001 AA , AA , AZ , AZ , AZ ,00 Globales Attribut GT_SFLIGHT_CLASS Mandant Carrier Flug-Nr. Flugdatum Flugpreis 001 AA , AA , AZ , AZ , AZ ,00 Abbildung 4: Doppeln der Daten bei Zuweisung über = Bei Verwendung der Anweisung GET REFERENCE OF wird ein Zeiger auf die übergebenen Daten erzeugt. Dadurch sind die Informationen nur einmal vorhanden und alle Änderungen (z.b. sortieren der Tabelle im ALV) sind ohne weiteren Aufwand ersichtlich (siehe Abbildung 5). Importparameter IT_SFLIGHT Mandant Carrier Flug-Nr. Flugdatum Flugpreis 001 AA , AA , AZ , AZ , AZ ,00 Globales Attribut GT_SFLIGHT_CLASS Abbildung 5: Zeiger auf Ursprungsdaten bei der Zuweisung GET REFERENCE OF 6

8 Hinweis: In der FACTORY( )-Methode der SALV-Klasse wird ebenfalls nur eine Referenz auf die übergebenen Daten erzeugt. Bei den umgesetzten Funktionen wird grundsätzlich zwischen der Farbänderung und der Datenänderung unterschieden. Farbänderung: Bei der Farbänderung wird zu Beginn der Verarbeitung unter Verwendung des globalen Klassenattributs zur SALV-Klasse eine Instanz des Spaltenverwaltungsobjektes CL_SALV_COLUMNS_TABLE erzeugt. Durch Aufruf vom Methode GET( ) des Objektes erhält man alle vorhandenen Spalten der im ALV angezeigten Datentabelle als interne Tabelle. Durch einen Loop über diese interne Tabelle kann über Methode SET_COLOR( ) die eigentliche Farbsetzung pro Spalte erfolgen. Dazu ist jedoch im Vorfeld ein Cast vorzunehmen. Grund für diese Cast ist die Typisierung der einzelnen Spaltenobjekte über die Klasse CL_SALV_COLUMN. Zur Farbsetzung wird jedoch ein Objekt von Klasse CL_SALV_COLUMN_TABLE erwartet. Das lässt sich am einfachsten direkt im Debugger nachvollziehen. Im Falle der Farbänderung ist Refresh der ALV-Anzeige nicht notwendig, da dieser bereits im Rahmen der Farbänderung erfolgt. Hinweis: Aus dem Ergebnis des Einfärbens ist ersichtlich, dass die Farbe der Schlüsselfelder nicht angepasst wird und somit blau bleibt. Datenänderung: Im Gegensatz zur Farbänderung wird bei der Änderung der anzuzeigenden Informationen direkt auf die Daten zugegriffen. Unter Verwendung von Feldsymbolen wird der Inhalt der Spalte CARRID des klassenglobal vorliegenden Attributes mit den angezeigten Informationen entsprechend angepasst. Damit diese Anpassung für den Anwender sichtbar wird, ist zusätzlich der Aufruf von Methode REFRESH( ) zum global vorliegenden SALV-Objekt notwendig. 7

9 3 Coding Wie aus der Überschrift ersichtlich ist, enthält Kapitel 3 das komplette Beispielcoding. Genau wie beim Aufbau von Kapitel 2 sind Hauptprogramm und das INCLUDE zur Ereignisbehandlung in eigenständigen Unterkapiteln enthalten. 3.1 Hauptprogramm * * * Das vorliegende Programm dient der Demonstration eines SALV mit der * Möglichkeit Daten bzw. Anzeigeeigenschaften nach Ausgabe zu * aktualisieren * * Date: * * * Änderungen * * REPORT zaj_refresh_own_funct_salv. *** * Include zur Ereignisbehandlung *** INCLUDE zaj_refresh_own_funct_salv_cl. DATA: gr_salv DATA: gr_columns DATA: gr_functions DATA: gr_selections DATA: gt_sflight DATA: gr_err_salv DATA: gr_err_salv_exist DATA: gr_err_wrong_call DATA: gv_string DATA: gr_events DATA: gr_event_handler TYPE REF TO cl_salv_table. TYPE REF TO cl_salv_columns_table. TYPE REF TO cl_salv_functions_list. TYPE REF TO cl_salv_selections. TYPE flighttab. TYPE REF TO cx_salv_msg. TYPE REF TO cx_salv_existing. TYPE REF TO cx_salv_wrong_call. TYPE string. TYPE REF TO cl_salv_events_table. TYPE REF TO gcl_event_handler. START-OF-SELECTION. ***

10 * Selektion der anzuzeigenden Daten *** SELECT * FROM sflight INTO CORRESPONDING FIELDS OF TABLE gt_sflight. IF sy-subrc NE 0. * In diesem Fall wird eine leere Tabelle angezeigt ENDIF. *** * Daten anzeigen *** TRY. * ALV-Instanz erzeugen CALL METHOD cl_salv_table=>factory EXPORTING list_display = if_salv_c_bool_sap=>false r_container = cl_gui_custom_container=>default_screen IMPORTING r_salv_table = gr_salv CHANGING t_table = gt_sflight. CATCH cx_salv_msg INTO gr_err_salv. * Fehler anzeigen gv_string = gr_err_salv->get_text( ). MESSAGE gv_string TYPE 'E'. ENDTRY. * Instanz für Spalten holen gr_columns = gr_salv->get_columns( ). * Spaltenbreite optimieren gr_columns->set_optimize( abap_true ). " nur ein 'X' *** * Selection-Mode aktivieren

11 *** * Instanz des Selection-Objektes holen gr_selections = gr_salv->get_selections( ). * Selektionsmodus setzen gr_selections->set_selection_mode( if_salv_c_selection_mode=>row_column ). *** * Alle Standard-Funktionen auf aktiv setzen *** * Instanz für Funktionen holen gr_functions = gr_salv->get_functions( ). * Alle Standardfunktionen aktivieren gr_functions->set_all( abap_true ). " nur ein 'X' *** * Toolbar um eigene Funktionen erweitern *** TRY. * Neue Funktion zum grün einfärben gr_functions->add_function( name = 'GREEN' icon = '@5B@' "Beliebiges Icon aus Tabelle ICON text = 'Grüne Farbe' tooltip = 'Grüne Farbe' position = if_salv_c_function_position=>right_of_salv_functions ). * Neue Funktion zum rot einfärben gr_functions->add_function( name = 'RED' icon = '@5C@' "Beliebiges Icon aus Tabelle ICON text = 'Rote Farbe' tooltip = 'Rote Farbe' position = if_salv_c_function_position=>right_of_salv_functions

12 ). * Neue Funktion zum Daten ändern gr_functions->add_function( name = 'CHANGE' icon = '@0Z@' "Beliebiges Icon aus Tabelle ICON text = 'Daten ändern' tooltip = 'Daten ändern' position = if_salv_c_function_position=>right_of_salv_functions ). CATCH cx_salv_existing INTO gr_err_salv_exist. * Fehler anzeigen gv_string = gr_err_salv_exist->get_text( ). MESSAGE gv_string TYPE 'E'. CATCH cx_salv_wrong_call INTO gr_err_wrong_call. * Fehler anzeigen gv_string = gr_err_wrong_call->get_text( ). MESSAGE gv_string TYPE 'E'. ENDTRY. *** * Ereignis zum Behandeln des Button-Click registrieren *** * Das Objekt für die möglichen ALV-Ereignisse holen gr_events = gr_salv->get_event( ). * Objekt für die Ereignisbehandlung erzeugen... CREATE OBJECT gr_event_handler EXPORTING ir_salv = gr_salv it_sflight = gt_sflight. *... und bei den ALV-Ereignissen registrieren SET HANDLER gr_event_handler->handle_toolbar_click FOR gr_events. *** * ALV-Anzeige anstoßen

13 *** * ALV-Anzeige anstoßen gr_salv->display( ). * Trägerbildschirm" für Container rufen WRITE space. 3.2 INCLUDE zur Ereignisbehandlung *** * Definition der Klasse *** CLASS gcl_event_handler DEFINITION. PUBLIC SECTION. METHODS: constructor IMPORTING ir_salv TYPE REF TO cl_salv_table it_sflight TYPE flighttab. METHODS: handle_toolbar_click FOR EVENT added_function OF cl_salv_events_table IMPORTING e_salv_function. PROTECTED SECTION. DATA: gr_salv_class TYPE REF TO cl_salv_table. DATA: gr_sflight_class TYPE REF TO flighttab. METHODS: set_color IMPORTING iv_color TYPE lvc_col. ENDCLASS. "gcl_event_handler DEFINITION *** * Implementierung der Klasse *** CLASS gcl_event_handler IMPLEMENTATION. METHOD constructor. * Importparameter in globale Klassenattribute übernehmen

14 gr_salv_class = ir_salv. GET REFERENCE OF it_sflight INTO gr_sflight_class. ENDMETHOD. "constructor METHOD handle_toolbar_click. FIELD-SYMBOLS: <ls_sflight> TYPE sflight. FIELD-SYMBOLS: <lv_carrid> TYPE s_carr_id. CASE e_salv_function. WHEN 'GREEN'. *** * Farbcode für GRÜN setzen *** set_color( 5 ). WHEN 'RED'. *** * Farbcode für ROT setzen *** set_color( 6 ). WHEN 'CHANGE'. *** * Inhalt von Spalte CARRID ändern *** * Wertänderung vornehmen LOOP AT gr_sflight_class->* ASSIGNING <ls_sflight>. * Komponente über ein Feldsymbol ansprechen ASSIGN COMPONENT 'CARRID' OF STRUCTURE <ls_sflight> TO <lv_carrid>. * Wert ändern IF <lv_carrid> EQ 'XX'. MOVE 'AA' TO <lv_carrid>. ELSE.

15 MOVE 'XX' TO <lv_carrid>. ENDIF. ENDLOOP. * Hier ist das eigentliche Aktualisieren der Anzeige gr_salv_class->refresh( ). WHEN OTHERS. *** * Wenn sonst irgendwas passiert, soll keine Reaktion erfolgen *** RETURN. ENDCASE. ENDMETHOD. METHOD set_color. DATA: lr_columns DATA: lr_column DATA: lt_columns DATA: ls_columns DATA: ls_color "handle_toolbar_click TYPE REF TO cl_salv_columns_table. TYPE REF TO cl_salv_column_table. TYPE salv_t_column_ref. TYPE salv_s_column_ref. TYPE lvc_s_colo. * spaltenobjekt holen lr_columns = gr_salv_class->get_columns( ). * Sämtliche Spalten bestimmen lt_columns = lr_columns->get( ). ls_color-col = iv_color. LOOP AT lt_columns INTO ls_columns. * Typcast durchführen lr_column?= ls_columns-r_column. * Hier erfolgt das eigentliche Setzen der Farbe lr_column->set_color( ls_color ). ENDLOOP. ENDMETHOD. ENDCLASS. "set_color "gcl_event_handler IMPLEMENTATION