ABAP Keyword Documentation →  ABAP − Reference →  Processing External Data →  Data Clusters →  IMPORT → 

IMPORT - parameter_list

Short Reference

Syntax

... {p1 = dobj1 p2 = dobj2 ...}
  | {p1 TO dobj1  p2 TO dobj2 ...}
  | (ptab) ... .

Extras:

1. ... p1 = dobj1 p2 = dobj2 ...

2. ... p1 TO dobj1 p2 TO dobj2 ...

3. ... (ptab)

Effect

A data cluster can be read statically by a list in the form p1 = dobj1 p2 = dobj2 ... or p1 TO dobj1 p2 TO dobj2 ... and dynamically through the specification of a bracketed, internal table ptab.

If a parameter p is specified and it is not stored in the data cluster, the specification will be ignored and the data object dobj retains its current value. The data objects dobj must have the same data type as the parameter p of the cluster, in the standard version. With internal tables, only the row type and not the table type is relevant. The following exceptions apply:

When structures are exported, information is stored as to whether the structure contains components that were adopted using the statement INCLUDE or adopted in ABAP Dictionary from other structures. A structure into which data is imported must also match the structure in the data cluster with regard to components adopted using INCLUDE. Only for structures that were stored prior to Release 6.10 and structures where all the components of the uppermost hierarchy level were adopted using INCLUDE does the target structure not necessarily need to be set up with the identical INCLUDE statements.

When importing from internal tables with non-unique table keys, the sequence of duplicate rows in relation to these keys is not retained.

The additions specified under conversion_options allow additional conversions and define other conversion rules. If structured data with same-type components are imported into Unicode systems, and these components were exported in a MDMP system and vice versa, a special text language rule applies.

Note

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

Addition 1

... p1 = dobj1 p2 = dobj2 ...

Addition 2

... p1 TO dobj1 p2 TO dobj2 ...

Effect

In the static case, the contents of the cluster parameter p are read and passed to the data objects dobj. The syntax styles p1 = dobj1 p2 = dobj2 ... and p1 TO dobj1 p2 TO dobj2 ... are the same. If a data object dobj is an internal table with a header line, not the header line, but the table body is addressed.

Programming Guideline

Using consistent spelling

Notes

Addition 3

... (ptab)

Effect

In the dynamic case, the parameter list is inherited from the two-column internal table ptab, whose columns must be character-like. The first column in ptab must contain the names of the parameters, and the second must contain the data objects in uppercase. If the first column of ptab is initial or an object name is listed twice, an exception that cannot be handled is raised.

Outside of classes, a single-column internal table for parameter_list can be used in the dynamic form. In this case, the parameters are searched for implicitly in the cluster under the name of the specified data object.

Note

Outside of classes, a single-column internal table for parameter_list can also be used. This is the dynamic variant of the obsolete short form used to search for the data objects saved in the data cluster (under the names of the data objects specified in the table).