EXPORT_TEXT SAP Function module - Text Conversion: Convert Text and Store on GUI File

EXPORT_TEXT is a standard SAP function module available within R/3 SAP systems depending on your version and release level. Below is the pattern details for this FM showing its interface including any import and export parameters, exceptions etc as well as any documentation contributions (Comments) specific to the object.

See here to view full function module documentation and code listing, simply by entering the name EXPORT_TEXT into the relevant SAP transaction such as SE37 or SE80.

Associated Function Group: STXK
Released Date: 12.01.2001
Processing type: Normal fucntion module

Pattern for FM EXPORT_TEXT - EXPORT TEXT

CALL FUNCTION 'EXPORT_TEXT' "Text Conversion: Convert Text and Store on GUI File
  EXPORTING
*   codepage = '0000'           " tcp02-cpcodepage  Target character set
    file =                      " rlgrap-filename  Name of target file (with path!)
*   formatwidth = 72            " itctk-tdlinesize  Line width of target file (40 to 132)
*   format_type = 'RTF'         " c             Format of target files ('ITF','RTF'or'ASCII')
*   header = SPACE              " thead         Text Header of Original Text
*   ssheet = SPACE              " c             Print format; only effective for print format conversion
*   with_tab = SPACE            " tdbool        Print format conversion; 'X' = yes or ' ' = no
*   tab_substitute = 'X09  '    " c             Replacement for Tab
*   replace_symbols = 'X'       " tdbool        Evaluate symbols
*   replace_sapchars = 'X'      " tdbool        Evaluate SAP Characters
  TABLES
    itf_lines =                 " tline         SAPscript text table to be exported
  EXCEPTIONS
    DOWNLOAD_ERROR = 1          "               Other error in downloading the file
    FILE_OPEN_ERROR = 2         "               File cannot be opened
    FILE_WRITE_ERROR = 3        "               Cannot write to file
    .  "  EXPORT_TEXT

ABAP code example for Function Module EXPORT_TEXT

The ABAP code below is a full code listing to execute function module EXPORT_TEXT including all data declarations. The code uses the latest in-line data DECLARATION SYNTAX but I have included an ABAP code snippet at the end to show how declarations would look using the original method of declaring data variables up front. This will allow you to compare and fully understand the new inline method. Please note some of the newer syntax such as the @DATA is not available until a later 4.70 service pack (SP8).

DATA:
it_itf_lines  
 
 TYPE STANDARD TABLE OF TLINE,"TABLES PARAM
wa_itf_lines
 
 LIKE LINE OF it_itf_lines
.

 

SELECT single CPCODEPAGE 
  FROM TCP02 
  INTO @DATA(ld_codepage).



DATA(ld_file) = some text here


DATA(ld_formatwidth) = Check type of data required

DATA(ld_format_type) = 'Check type of data required'.

DATA(ld_header) = 'Check type of data required'.

DATA(ld_ssheet) = 'Check type of data required'.

DATA(ld_with_tab) = 'Check type of data required'.

DATA(ld_tab_substitute) = 'Check type of data required'.

DATA(ld_replace_symbols) = 'Check type of data required'.

DATA(ld_replace_sapchars) = 'Check type of data required'.
 

"populate fields of struture and append to itab
append wa_itf_lines to it_itf_lines.
.

CALL FUNCTION 'EXPORT_TEXT'
  EXPORTING
*   codepage =                   ld_codepage
    file =                       ld_file
*   formatwidth =                ld_formatwidth
*   format_type =                ld_format_type
*   header =                     ld_header
*   ssheet =                     ld_ssheet
*   with_tab =                   ld_with_tab
*   tab_substitute =             ld_tab_substitute
*   replace_symbols =            ld_replace_symbols
*   replace_sapchars =           ld_replace_sapchars
  TABLES
    itf_lines =                  it_itf_lines
  EXCEPTIONS
    DOWNLOAD_ERROR =             1
    FILE_OPEN_ERROR =            2
    FILE_WRITE_ERROR =           3
    .  "  EXPORT_TEXT

IF SY-SUBRC EQ 0.
  "All OK
ELSEIF SY-SUBRC EQ 1. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 2. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 3. "Exception
  "Add code for exception here
ENDIF.

ABAP code to compare 7.40 inline data declaration with original syntax

The below ABAP code uses the older none in-line data declarations. This allows you to see the coding differences/benefits of the later inline syntax. It may also be useful if you are using an older version of SAP as some of the newer syntax above, such as the @DATA is not available until 4.70 EHP 8.

DATA:

ld_codepage
 
 TYPE TCP02-CPCODEPAGE ,
it_itf_lines
 
 TYPE STANDARD TABLE OF TLINE ,
wa_itf_lines
 
 LIKE LINE OF it_itf_lines,
ld_file
 
 TYPE RLGRAP-FILENAME ,
ld_formatwidth
 
 TYPE ITCTK-TDLINESIZE ,
ld_format_type
 
 TYPE C ,
ld_header
 
 TYPE THEAD ,
ld_ssheet
 
 TYPE C ,
ld_with_tab
 
 TYPE TDBOOL ,
ld_tab_substitute
 
 TYPE C ,
ld_replace_symbols
 
 TYPE TDBOOL ,
ld_replace_sapchars
 
 TYPE TDBOOL .



SELECT single CPCODEPAGE 
  FROM TCP02 
  INTO ld_codepage.
 

"populate fields of struture and append to itab
append wa_itf_lines to it_itf_lines.

ld_file = some text here

ld_formatwidth = Check type of data required
ld_format_type = 'Check type of data required'.
ld_header = 'Check type of data required'.
ld_ssheet = 'Check type of data required'.
ld_with_tab = 'Check type of data required'.
ld_tab_substitute = 'Check type of data required'.
ld_replace_symbols = 'Check type of data required'.
ld_replace_sapchars = 'Check type of data required'.

SAP Documentation for FM EXPORT_TEXT