ABAP Keyword Documentation →  ABAP - Reference →  Processing External Data →  Data cluster →  IMPORT 

IMPORT - conversion_options

Short Reference

Other versions: 7.31 | 7.40 | 7.54

Syntax

... { { { {[ACCEPTING PADDING] [ACCEPTING TRUNCATION]} 
        | [IGNORING STRUCTURE BOUNDARIES] } 

        [IGNORING CONVERSION ERRORS [REPLACEMENT CHARACTER rc]] } 

    | [IN CHAR-TO-HEX MODE] } 
    [CODE PAGE INTO cp] 

    [ENDIAN INTO endian]. 

Extras

1. ... ACCEPTING PADDING

2. ... ACCEPTING TRUNCATION

3. ... IGNORING STRUCTURE BOUNDARIES

4. ... IGNORING CONVERSION ERRORS [REPLACEMENT CHARACTER rc]

5. ... IN CHAR-TO-HEX MODE

6. ... CODE PAGE INTO cp

7. ... ENDIAN INTO endian

Effect

These additions allow the import of data stored in data clusters into non-type-compliant data objects. They also define appropriate conversion rules. The following table shows which of the additions may be used during imports from the various buffers. The column headings are abbreviations for the following buffers: DATA BUFFER (B), MEMORY (M), SHARED MEMORY (SM), SHARED BUFFER (SB), DATABASE (DB), and INTERNAL TABLE (IT).

Conversion Addition	B	M	IT	DB	SM	SB
ACCEPTING PADDING	+	+	+	+	+	+
ACCEPTING TRUNCATION	+	+	+	+	+	+
IGNORING STRUCTURE BOUNDARIES	+	+	+	+	+	+
IGNORING CONVERSION ERRORS	+	-	+	+	-	-
REPLACEMENT CHARACTER rc	+	-	+	+	-	-
IN CHAR-TO-HEX MODE	+	-	+	+	-	-
CODE PAGE INTO cp	+	-	+	+	-	-
ENDIAN INTO endian	+	-	+	+	-	-

Addition 1

... ACCEPTING PADDING

Effect

This addition expands the rules from the parameter_list for different data types of source field and target field dobj in the data clusters:

• In addition to data objects of the type c, the target field can be longer than the source field for data objects of the type n, p, or x.
• Source fields of the internal type b can be exported into target fields of the types s and i; source fields of the internal type s can be exported into target fields of the type i (but negative numbers are handled incorrectly).
• Source fields of the type c can be exported into target fields of the type string and source fields of the type x can be exported into target fields of the type xstring.
• The rules above also apply if the component involved is the last component of a source or target structure that is otherwise set up in the same manner.
• In a target structure, substructures can also have more components than the substructures of the source structure if the structure is otherwise set up in the same way. The surplus components are provided with type-compliant initial values.
  

Note

The rule that substructures in a target structure can have more components than the source structure can cause problems in relation to structures defined in ABAP Dictionary. This is the case if the structure there is marked as enhanceable. Therefore, this situation triggers a warning message in the enhanced program check.

Example

Without the addition ACCEPTING PADDING, the structure f1 in the data cluster could not be imported into the structure f2 since a substructure of f2 contains a surplus component.

DATA: BEGIN OF f1, 
       col1 TYPE string, 
       BEGIN OF sub, 
         col2 TYPE decfloat16, 
       END OF sub, 
       col3 TYPE i, 
      END OF f1. 

DATA: BEGIN OF f2, 
        col1 TYPE string, 
        BEGIN OF sub, 
          col2 TYPE decfloat16, 
          col3 TYPE xstring, 
        END OF sub, 
        col4 TYPE i, 
      END OF f2. 

EXPORT para = f1 TO MEMORY ID 'HK'. 

... 

IMPORT para = f2 FROM MEMORY ID 'HK' ACCEPTING PADDING. 

Addition 2

... ACCEPTING TRUNCATION

Effect

This addition expands the rules in the parameter_list for different data types of source field in the data cluster and source field dobj in the data cluster. The rule expansion is such that if, in the case of structures that otherwise have the same type, the source structure at the highest level has more components than the target structure in the data cluster, the surplus components are cut off. A substructure of the source structure must not have more components than the corresponding substructure in the target structure.

Example

Without the addition ACCEPTING TRUNCATION, the structure f1 in the data cluster could not be imported into the structure f2 since f2 contains fewer components.

DATA: BEGIN OF f1, 
        col1 TYPE string, 
        BEGIN OF sub, 
          col2 TYPE decfloat34, 
        END OF sub, 
        col3 TYPE i, 
        col4 TYPE xstring, 
      END OF f1. 

DATA: BEGIN OF f2, 
        col1 TYPE string, 
        BEGIN OF sub, 
          col2 TYPE decfloat34, 
        END OF sub, 
        col3 TYPE i, 
      END OF f2. 

EXPORT para = f1 TO MEMORY ID 'HK'. 

... 

IMPORT para = f2 FROM MEMORY ID 'HK' ACCEPTING TRUNCATION. 

Addition 3

... IGNORING STRUCTURE BOUNDARIES

Effect

This addition expands the rules from the parameter list for different data types of source field in the data cluster and target field dobj in the data cluster. In structures, this produces an (insignificantly) different setup, with the differences resulting from substructures or from different adopted components of other structures with the statement INCLUDE.

The components of source and target structure are viewed at the same level, independently of the setup inherited from substructures or from components adopted using INCLUDE. Source and target structures must both have the same number of components and these must be of the same type. Any alignment gaps that have resulted from substructures are insignificant.

This addition cannot be used together with the additions ACCEPTING PADDING and ACCEPTING TRUNCATION.

Example

Without the addition IGNORING STRUCTURE BOUNDARIES, the structure f1 in the data cluster could not be imported into the structure f2 since f1 and f2 are set up differently from substructures.

DATA: BEGIN OF incl_struc, 
        cola TYPE string, 
        colb TYPE i, 
      END OF incl_struc. 

DATA: BEGIN OF f1. 
        INCLUDE STRUCTURE incl_struc. 

DATA:  col1 TYPE string, 
       BEGIN OF sub, 
         col2 TYPE decfloat16, 
         col3 TYPE decfloat34, 
       END OF sub, 
       col4 TYPE i, 
      END OF f1. 

DATA: BEGIN OF f2, 
        cola TYPE string, 
        colb TYPE i, 
        col1 TYPE string, 
        BEGIN OF sub, 
          col2 TYPE decfloat16, 
        END OF sub, 
        col3 TYPE decfloat34, 
        col4 TYPE i, 
      END OF f2. 

EXPORT para = f1 TO MEMORY ID 'HK'. 

... 

IMPORT para = f2 FROM MEMORY ID 'HK' 
                 IGNORING STRUCTURE BOUNDARIES. 

Addition 4

... IGNORING CONVERSION ERRORS [REPLACEMENT CHARACTER rc]

Effect

This addition suppresses an exception of the class CX_SY_CONVERSION_CODEPAGE, raised when a conversion to another code page is carried out at import, and a character does not exist in the target code page.

If the addition REPLACEMENT CHARACTER is specified, each non-convertible character is replaced during the conversion by the character in rc. rc expects a character-like data object containing a single character. If the addition is not specified, the character "#" is used as a replacement character.

The addition IGNORING CONVERSION ERRORS also suppresses the exception if the number of bytes of an imported character-like component increases during a conversion to another code page, and therefore does no longer fit into the target object. If you specify the addition, surplus characters are cut off on the right. If the addition is not specified, only superfluous blanks are cut off on the right (without raising an exception).

Addition 5

... IN CHAR-TO-HEX MODE

Effect

This addition has the effect that data that is stored in the data cluster under the data type c is assigned to target fields of the type x. The contents of the source fields are not converted to the code page of the target system, and are left unconverted and passed to the target fields instead. A single source field or a structure component of the type c can be assigned to a single target field or to a structure component of the type x, which has the same length in bytes. For target fields of the type c, the addition has no effect.

This addition cannot be used together with the previous conversion additions.

Note

Note that a program using this addition cannot be transported between systems where character representations require different numbers of bytes. This addition designed only for temporary programs, enabling them to import byte strings stored incorrectly in fields of the type c and to store them again for the correct type.

Addition 6

... CODE PAGE INTO cp

Effect

This addition assigns the ID of the code page of the exported data to the data object cp. This object must have a character-like data type. The ID of the code page is the content of the column CPCODEPAGE of the database table TCP00.

Note

The code page can be used to edit data objects imported using CHAR-TO-HEX MODE. Conversions between code pages can be performed using system classes described in the section Classes for Conversion of External Data Formats.

Addition 7

... ENDIAN INTO endian

Effect

This addition assigns the ID of the byte order of the exported data to the data object ENDIAN, which must have the data type ABAP_ENDIAN from the type group ABAP. The ID for big endian is "B"; the identification for little endian is "L".

Note

The byte order can be used to process data objects imported using CHAR-TO-HEX MODE, since code pages in which a character takes up more than one byte can be dependent on the byte order.

Example

The target field f2-col2 contains, after the import, the unconverted, binary content of f1-col2. The code page and the byte order in which the data is stored is in cp and en. Normally, the data in such a case is exported and imported in another program. Note that this example only works in a system in which a character is displayed using two bytes, since f2-col2 is double the length of f1-col2.

DATA: BEGIN OF f1, 
        col1 TYPE c LENGTH 10 VALUE '1234567890', 
        col2 TYPE c LENGTH 10 VALUE '1234567890', 
      END OF f1. 

DATA: BEGIN OF f2, 
        col1 TYPE c LENGTH 10, 
        col2 TYPE x LENGTH 20, 
      END OF f2. 

DATA: cp TYPE string, 
      en TYPE abap_endian. 

EXPORT para = f1 TO DATABASE demo_indx_table(hk) ID 'HK'. 

... 

IMPORT para = f2 FROM DATABASE demo_indx_table(hk) ID 'HK' 
                 IN CHAR-TO-HEX MODE 
                 CODE PAGE INTO cp 
                 ENDIAN INTO en.