OTHERS = 22.Description
Number of bytes transferred.
Value range
Any natural number including zero.
Description
By default, existing local files are overwritten by new versions. Bysetting APPEND to 'X', the downloaded data is appended to an existingfile. If the file does not yet exist, it is created.
Value range
'X' = Data is appended.
SPACE = Data is overwritten if the file already exists.
Default
SPACE
Description
When creating a binary file, you must specify the file length, becausethe transfer table (single-column, type X) in the last row must not beabsolutely valid.
If the parameter is set in a text download, the exceptionFILESIZE_NIT_ALLOWED is triggered.
Value range
Any natural number including zero.
Default
The entire data table is downloaded.
Description
Use parameter CODEPAGE to specify the desired target codepage. If thisparameter is not set, the codepage of the SAP GUI is used as the targetcodepage.
Value range
4-digit number of the SAP codepage. The function moduleSCP_CODEPAGE_BY_EXTERNAL_NAME returns the SAP codepage number for anexternal character set name, for example, "iso-8859-1". The functionmodule NLS_GET_FRONTEND_CP returns the appropriate non-Unicode frontendcodepage for a language.
You can determine the desired codepage interactively, if the parameterwith_encoding of method file_save_dialog is set bycl_gui_frontend_services.
SPACE: Codepage of the SAP GUI
Default
SPACE
Description
Activate column selection. You use column selection to select thecolumns to be transferred to the file. This parameter is available onlyfor FILETYPE 'DAT' and 'DBF'.
Value range
'X': Activate selection
SPACE: Do not activate selection
Default
SPACE
Description
Masking the columns selection. In connection with COL_SELECT a columnselection becomes possible.
Value range
Character field of up to 128 characters, consisting of SPACE and 'x'.Every character represents a column of the table. A SPACE represents acolumn to be omitted, any other character represents a column to beinserted.
Example: COL_SELECT = 'X'
COL_SELECTMASK = 'X X X'
The columns 1,3,5 are downloaded.
Default
SPACE
Description
If this parameter is set, a file is overwritten only after aconfirmation by the user.
Value range
'X': Confirmation required.
SPACE: No confirmation required.
Default
SPACE
Description
If parameter DAT_MODE is set, the file is stored in 'DAT' format. Noconversion exits are performed. Number and date fields are stored in astandard format which makes it possible, to later import the file usinggui_upload.
Value range
'X': DAT_MODE is switched on.
SPACE: DAT_MODE is not switched on.
Default
SPACE
Description
Name of the file to be created locally (if required with path name as aprefix). If the path is invalid or the file cannot be opened forwriting, the respective exceptions are triggered.
Value range
A valid file name.
Default
Description
During download, the data can be transferred in different formats,depending on the value of the FILETYPE parameter.
Value range
'ASC' :
ASCII format. The table is transferred as text. Conversion exits areperformed. The output format additionally depends on the parametersCODEPAGE, TRUNC_TRAILING_BLANKS, and TRUNC_TRAILING_BLANKS_EOL.
'IBM' :
ASCII format with IBM codepage conversion (DOS). This format correspondsto the 'ASC' format when using target codepage 1103. This codepage isfrequently used for data exchange via floppy disk.
'DAT' :
Column-by-column transfer. With this format, the data is transferred astext as with ASC. However, no conversion exits are performed and thecolumns are separated by tab characters. This format generates filesthan can be uploaded again using gui_upload or ws_upload.
'DBF' :
Data is downloaded in dBase format. Since in this format the data typesof the individual columns are stored as well, you can often avoid importproblems, for example, into Microsoft Excel, especially wheninterpreting numeric values.
'WK1' :
Data is downloaded in Lotus 1-2-3 format.
'BIN' :
Binary format. Data is transferred binarily. There is no formatting andno codepage conversion. The data is interpreted row by row; it is notformatted by columns. Specify the data length in parameter BIN_FILESIZE.The table should consist of a column of type X, because especially inUnicode systems, the conversion of structured into binary data causeserrors.Default
'ASC'Description
This parameter allows you to prefix the data with individual bytesduring a binary download.
Value range
Hexadecimal string with a length of up to 1023 bytes.
Default
'00'
Description
Specifies whether errors during a character set conversion shall beignored.
Value range
ABAP_FALSE
Errors during a character set conversion, which result in using thereplacement character, are not ignored but trigger an exception.
ABAP_TRUE
If a character cannot be converted correctly and must be represented bythe replacement character, no exception is triggered.Default
ABAP_TRUE
Description
This parameter is transferred to the customer exit to check the accessrights.
Value range
'X': Switch check off
SPACE: Keep check switched on
Default
SPACE
Description
Specifies the replacement character to be used when during a characterset conversion a character cannot be converted.
Value range
An individual character.
Default
'#'
Description
By default, possible blanks at the end of a text column are nottransferred. You can use this parameter to change the behavior to keepthe blanks. However, this does not include the blanks at the end of thelast column. If you want to keep them as well, use parameterTRUNC_TRAILING_BLANKS_EOL instead.
Value range
'X': Blanks are removed.
SPACE: Blanks are transferred.
Default
'X'
Description
By default, possible blanks at the end of a text column are nottransferred. You can use this parameter to change this behavior for thelast column of the table so that the blanks are kept. The parameter doesnot influence the other columns of the table. To keep them, useparameter TRUNC_TRAILING_BLANKS.
Value range
'X': Blanks in the last column are removed.
SPACE: Blanks in the last column are transferred.
Default
'X'
Description
Format for value columns of WK1 file type
Value range
'0' : Standard format
'1x' : Fixed point format with x decimal places
'2x' : Currency format with x decimal places
Default
SPACE
Description
Column width for value columns of WK1 file type
Sets the column width for value columns. If WK1_N_SIZE is not set, forevery value column the output length of the field is set as width.
Default
SPACE
Description
Format for text columns of WK1 file type
Value range
'0' : Left-justified
'1' : Right-justified
'2' : centered
Default
SPACE
Description
Column width for text columns of WK1 file type
Determines the column width for text columns. If WK1_T_SIZE is not set,for every text column the output length of the field is used as width.
Value range
Maximum value is 240, otherwise the value is reduced to 240.
Default
SPACE
Description
If the data is written in a Unicode codepage, at the beginning of thefile the respective byte order mark (BOM) is inserted.
Unicode - Little Endian Codepage 4103, binary values 'FFFE'
Unicode - Big Endian Codepage 4102, binary values 'FEFF'
UTF-8 Codepage 4110, binary values 'EFBBBF'
Note: Microsoft Excel only supports Unicode data if they have beenwritten in the format Unicode - Little Endian.Value range
'X': Write BOM.
SPACE: Do not write BOM.
Default
SPACE
Description
In the downloaded file, the columns are separated by tab characters(cl_abap_char_utilities=>horizontal_tab). You should use this setting ifyou want to upload the data from the file at a later time, because thisis the only way of identifying individual columns.
The parameter makes sense only for the FILETYPE values ASC, DAT and IBM;for DAT it is set implicitly.
Value range
'X' : Write separator.
SPACE : Do not write separator.
Default
SPACE
Description
If this parameter is set, at the end of each row a row separator isinserted by CL_ABAP_CHAR_UTILITIES=>CR_LF. This parameter makes senseonly for FILETYPE 'ASC', 'DAT' and 'IBM'. If this parameter is not set,blanks at the end of a row are not removed.
Value range
'X': Row separator is inserted.
SPACE: Row separator is not inserted.
Default
'X'
Description
Data table which contains the data to be downloaded.
Value range
An internal table with any number of fields which must be of theelementary type.
Description
Optional table with column names for the individual columns.
- 'DBF': The column names are entered into the structure definition of the
DBF file.
- 'DAT': An additional row with the column names is inserted at the
beginning of the table.