Excel-Dateiverarbeitung: Frontend-Dienste & CL_FDT_XL_SPREADSHEET

Auswahl einer Excel-Datei vom Computer des Benutzers (Frontend) in der SAP GUI, Hochladen im Binärformat und Importieren mit nativen Klassen ohne externe Bibliothek.

In ABAP-Projekten ist das Lesen einer Excel-Datei (`.xlsx`) vom lokalen Computer des Benutzers und die Übertragung in interne Tabellenstrukturen innerhalb von SAP eines der häufigsten Integrationsszenarien. Die in der Vergangenheit für diesen Prozess verwendeten OLE-Automatisierungen oder externen Funktionen (z. B. `TEXT_CONVERT_XLS_TO_SAP`) können zu Leistungseinbußen oder Einschränkungen bei Hintergrundprozessen (Background Job) führen.

In der modernen ABAP-Welt ist einer der stabilsten und leistungsfähigsten Ansätze, die Datei mit cl_gui_frontend_services als Binärdatei (`BIN`) vom Server abzurufen und anschließend mit Hilfe der Klasse cl_fdt_xl_spreadsheet die Daten im Office Open XML-Format direkt zur Laufzeit zu parsen und an eine Field-Symbol-Struktur zu binden.

💡 Ansätze und Regeln zum Lesen von Excel-Dateien

Binärer Upload (GUI_UPLOAD): Das Lesen von Excel-Dateien als Text (ASCII) führt zu Datenbeschädigungen. Daher muss die Datei immer mit dem Parameter filetype = 'BIN' in eine rohe Binärdatentabelle (SOLIX) hochgeladen werden.
XSTRING-Konvertierung: Die Klasse `CL_FDT_XL_SPREADSHEET` erwartet als Eingabe einen XSTRING (hexadezimaler String). Die mit `GUI_UPLOAD` gefüllte `SOLIX`-Tabelle muss mit der Hilfsmethode cl_bcs_convert=>solix_to_xstring in einen einzigen Binärstring umgewandelt werden.
Dynamische Tabellenzuweisung (Interface Call): Die aus dem Excel-Dokument extrahierten Daten werden als dynamische Datenreferenz (REF TO DATA) zurückgegeben, unabhängig von der Spaltenanzahl und dem Typ. Um diese Daten zu verarbeiten oder anzuzeigen, wird der Mechanismus ASSIGN ...->* TO FIELD-SYMBOL verwendet.

💻 Referenzprogramm für ausführbaren Excel-Reader

1. Vollständiger ausführbarer ABAP-Report

Das folgende Programm zeigt dem Benutzer einen Dateiauswahldialog an, analysiert das erste Arbeitsblatt der ausgewählten Excel-Datei und simuliert dessen Inhalt auf dem Bildschirm mithilfe der integrierten HTML-Browser-Komponente.

REPORT zr_demo_excel_reader.

DATA: lv_rc     TYPE i,
      it_files  TYPE filetable,
      lv_action TYPE i.

TRY.
    " Step 1: Open file dialog to select the target Excel file from frontend
    cl_gui_frontend_services=>file_open_dialog(
      EXPORTING
        file_filter = |xlsx (*.xlsx)\|*.xlsx\|{ cl_gui_frontend_services=>filetype_all }|
      CHANGING
        file_table  = it_files
        rc          = lv_rc
        user_action = lv_action ).

    IF lv_action = cl_gui_frontend_services=>action_ok
       AND lines( it_files ) > 0.

      DATA: lv_filesize TYPE w3param-cont_len,
            it_bin_data TYPE w3mimetabtype.

      " Step 2: Upload the frontend file into SAP application memory as binary data
      cl_gui_frontend_services=>gui_upload(
        EXPORTING
          filename   = CONV string( it_files[ 1 ]-filename )
          filetype   = 'BIN'
        IMPORTING
          filelength = lv_filesize
        CHANGING
          data_tab   = it_bin_data ).

      " Step 3: Convert binary SOLIX table to a single XSTRING container
      DATA(lv_bin_data) = cl_bcs_convert=>solix_to_xstring(
                            it_solix = it_bin_data ).

      " Step 4: Parse the spreadsheet binary data via FDT core engine class
      DATA(lo_excel) = NEW cl_fdt_xl_spreadsheet(
                        document_name = CONV #( it_files[ 1 ]-filename )
                        xdocument     = lv_bin_data ).

      DATA lt_worksheet_names TYPE if_fdt_doc_spreadsheet=>t_worksheet_names.

      " Step 5: Extract worksheet identifiers contained inside the spreadsheet
      lo_excel->if_fdt_doc_spreadsheet~get_worksheet_names(
        IMPORTING
          worksheet_names = lt_worksheet_names ).

      IF lines( lt_worksheet_names ) > 0.

        " Step 6: Convert the target active sheet into a dynamic internal table
        DATA(lo_worksheet) =
          lo_excel->if_fdt_doc_spreadsheet~get_itab_from_worksheet(
            lt_worksheet_names[ 1 ] ).

        ASSIGN lo_worksheet->* TO FIELD-SYMBOL(<worksheet>).

        " Step 7: Stream parsed dynamic structural data into browser component
        cl_demo_output=>write_data( <worksheet> ).
        DATA(lv_html) = cl_demo_output=>get( ).

        cl_abap_browser=>show_html(
          EXPORTING
            title       = 'Excel Worksheet Output'
            html_string = lv_html
            container   = cl_gui_container=>default_screen ).

        WRITE space.
      ENDIF.
    ENDIF.

  CATCH cx_root INTO DATA(lx_error).
    MESSAGE lx_error->get_text( ) TYPE 'S' DISPLAY LIKE 'E'.
ENDTRY.

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.