Open Excel sheet from DMS

[Former Member]

Original of this article is published on my personal site at oprsteny.com

In this article I'll show you how to retrieve an Excel sheet from SAP DMS (Document management System) where it is stored as "original" in a Document container.

Let's presume that:

• we already have our document stored in DMS and we know the document's number, type, version and part (these are key fields we have to know to be able to retrieve the document)
• We know how to create a webdynpro component/application
• We have already created new WDY component/application with one Window containing one View where we placed the OfficeControl of type MS_EXCEL from the Integration layout controls.

1. Read document information (metadata)

DATA:

  ls_document_data  TYPE bapi_doc_draw2,

  ls_return         TYPE bapiret2,

  lt_document_files TYPE TABLE OF bapi_doc_files2_keys.



FIELD-SYMBOLS:

  <ls_document_file> LIKE LINE OF lt_document_files.



* Specify our document key

ls_document_data-documenttype    = 'ZTP'.

CALL FUNCTION 'CONVERSION_EXIT_ALPHA_INPUT'

  EXPORTING

    input         = '3000000000003'

  IMPORTING

    OUTPUT        = ls_document_data-documentnumber.

ls_document_data-documentversion = '00'.

ls_document_data-documentpart    = '000'.



* Read document info

CALL FUNCTION 'BAPI_DOCUMENT_GETLIST2'

      EXPORTING

        select_documentdata = ls_document_data

        getdocfiles         = 'X'

      IMPORTING

        return              = ls_return

      TABLES

        documentfiles       = lt_document_files.



    IF ls_return-type CA 'EA'

      OR lines( lt_document_files ) = 0.

*      RAISE EXCEPTION document_does_not_exist.

    ENDIF.



* To simplify our example we read just the first file from

* the document container

    READ TABLE lt_document_files ASSIGNING <ls_document_file> INDEX 1.

2. Read document contents (binary data)

DATA:

  lt_cvapi_files   TYPE TABLE OF cvapi_doc_file,

  lt_bapi_files    TYPE t_bapi_doc_files2,

  lt_drao          TYPE dms_tbl_drao,

  ls_message       TYPE messages,

  lt_orblk         TYPE TABLE OF orblk,

  lv_excel_xstring TYPE xstring

  lv_data_size     TYPE i.



FIELD-SYMBOLS:

       TYPE drao,

      TYPE orblk.



* Convert BAPI file structure to CVAPI file structure

APPEND <ls_document_file> TO lt_bapi_files.

CALL FUNCTION 'MAP2I_BAPI_FILE2_TO_API_FILE'

  TABLES

    bapi_doc_file = lt_bapi_files

    api_doc_file  = lt_cvapi_files.



* Get binary data from system

* Content provider is set to 'TBL'

* -> tabular data filled in lt_drao

CALL FUNCTION 'CVAPI_DOC_CHECKOUTVIEW'

  EXPORTING

    pf_dokar           = <ls_document_file>-documenttype

    pf_doknr           = <ls_document_file>-documentnumber

    pf_dokvr           = <ls_document_file>-documentversion

    pf_doktl           = <ls_document_file>-documentpart

    pf_content_provide = 'TBL'

  IMPORTING

    psx_message        = ls_message

  TABLES

    pt_files           = lt_cvapi_files

    ptx_content        = lt_drao

  EXCEPTIONS

    error_message      = 1

    OTHERS             = 2.



* Get the binary data and its length

LOOP AT lt_drao ASSIGNING <ls_drao>.

  APPEND INITIAL LINE TO lt_orblk ASSIGNING <ls_orblk>.

  <ls_orblk> = <ls_drao>-orblk.



  IF lv_data_size IS INITIAL.

    lv_data_size = <ls_drao>-orln.

  ENDIF.

ENDLOOP.



* Convert binary data from itab to xstring

CALL FUNCTION 'SCMS_BINARY_TO_XSTRING'

  EXPORTING

    input_length       = lv_data_size

  IMPORTING

    BUFFER             = lv_excel_xstring

  tables

    binary_tab         = lt_orblk.

3. Initialize the WDY Office Control

As we initially presumed - we have a WDY component with one View which contains the OfficeControlof type MS_EXCEL element in the Layout. Now we have to create a context Attribute where we will store the Excel binary data.

1. In the View's Context tab create new Attribute of type XSTRING and name it e.g. XLS_DATA
2. In the View's Layout select the OfficeControl and bind its dataSource to the context attribute XLS_DATA

If you reached this point, you already know how to read the Excel data, you know how to integrate OfficeControl to the WDY view and bind it to the view's Context attribute. Now we just have to fill the Context attribute with data we've already prepared before - you can put the following piece of code e.g. in the View's WDDOMODIFYVIEW method in case you want to initialize the Excel control in the WDY right from the start

wd_context->set_attribute(

  EXPORTING

    value = lv_excel_xstring

    name  = 'XLS_DATA'

).

Now if you try to run your WDY application in browser, you should see the Excel being displayed within the browser window and loaded with data of the XLS sheet from your DMS document.