SAP ASSIGN DYNAMIC COMPONENTS ABAP Statements

Get Example source ABAP code based on a different SAP table
  ABAP Statement

• COMPONENT OF STRUCTURE ASSIGN
• ASSIGN COMPONENT ABAP Statement
• OF STRUCTURE ASSIGN COMPONENT

ASSIGN, dynamic_components
Short Reference

ABAP_SYNTAX
... ${ struc-(comp) $}
$| ${ dref->(comp_name) $}
$| ${ COMPONENT comp OF STRUCTURE struc $} ...

ABAP_ALTERNATIVES:
1 ... struc-(comp)
2 ... dref->(comp_name)
3 ... COMPONENT comp OF STRUCTURE struc

What does it do?
These variants for specifying the memory area mem_area of the statement ASSIGN access components of structures dynamically.
In these variants, the statement ASSIGN sets the return code sy-subrc. If the assignment is successful, sy-subrc is set to 0. In these variants, also exceptions can occur in case of some invalid dynamic specifications. If the assignment is not successful and no exception occurs, sy-subrc is set to 4. If sy-subrc is set to 4, the state of the field symbol depends on the addition ELSE UNASSIGN:

If ELSE UNASSIGN is not specified, the field symbol keeps its previous state.

If ELSE UNASSIGN is specified, no memory area is assigned to the field symbol. The field symbol has the state unassigned after the ASSIGN statement.



Latest notes:
If ELSE UNASSIGN is not specified, it is not sufficient to evaluate the predicate expression <(><)> IS ASSIGNED but sy-subrc must be checked. If ELSE UNASSIGN is specified, the predicate expression as well as sy-subrc can be evaluated.
NON_V5_HINTS
ABAP_HINT_END

ABAP Alternative 1 ... struc-(comp)
BEGIN_SECTION ID ASSIGN-DYNAMIC-STRUC

What does it do?
This variant of mem_area assigns the memory area of a component specified in comp of a structure struc to the field symbol. struc is a result position. The structure can be specified as a data object or as a writable expression. If it is detected at compile time that struc is not a structure, a syntax error occurs. If that is detected at runtime, the runtime error STRUCTURE_ILLEGAL occurs.
For comp, either a character-like data object or a numeric data object of type i can be specified:

If comp is character-like, its content is interpreted as the name of the component. The name is not case-sensitive. It may contain offsets and lengths, structure component selectors, and component selectors.

If comp is of type i, its value is interpreted as the position of the component in the structure. If the value of comp is 0, the memory area of the entire structure is assigned to the field symbol.

If comp has a different type, a syntax error or runtime error occurs.

ABAP_EXAMPLE_VX5
Two dynamic assignments with dynamic specification of components:

in the first, the structure is specified directly and the component is specified by its position.

in the second, the structure is specified by a writable expression with constructor operator NEW and the component is specified by its name, which can have an offset/length specification.
ABEXA 01674
ABAP_EXAMPLE_END
END_SECTION ID ASSIGN-DYNAMIC-STRUC

ABAP_EXAMPLE_ABEXA
Field Symbols, Dynamic Structure Components
ABAP_EXAMPLE_END

ABAP Alternative 2 ... dref->(comp_name)
BEGIN_SECTION ID ASSIGN-DYNAMIC-OREF

What does it do?
This variant accesses components of structures that are referenced by a data reference variable dref. dref can be any data reference variable that points to structure that contains the component specified in a character-like field comp_name.
The component name does not have to be in uppercase letters. It can contain offsets/lengths, structure component selectors, object component selectors, and class component selectors, in order to assign parts of the component or referenced objects of the component.
Unlike all other operand positions, where a data reference that does not point to a data object raises an exception, no exception occurs in the statement ASSIGN and sy-subrc is set to 4.
BEGIN_SECTION SAP_INTERNAL_HINT
The exception is either the uncatchable DATREF_NOT_ASSIGNED or the catchable CX_SY_ASSIGN_ILLEGAL_COMPONENT. The latter is raised for a dynamic target.
END_SECTION SAP_INTERNAL_HINT



Latest notes:
This syntax form corresponds to dynamic access to object components.
NON_V5_HINTS
ABAP_HINT_END

ABAP_EXAMPLE_VX5
Dynamic assignment of a component of a structure to a field symbol. The default value of comp_name denotes a substring of a component of a substructure.
ABEXA 01581
ABAP_EXAMPLE_END

ABAP_EXAMPLE_VX5
Dynamic assignment of a component of a structure with an initial reference variable. No exception occurs but sy-subrc is set to 0 in this case.
ABEXA 01560
ABAP_EXAMPLE_END
END_SECTION ID ASSIGN-DYNAMIC-OREF

ABAP Alternative 3 ... COMPONENT comp OF STRUCTURE struc

What does it do?
This variant of mem_area assigns the memory area of a component comp of a structure struc to the field symbol.
struc is a result position. The structure can be specified as a data object or as a writable expression. If it is detected at compile time, that struc is not a structure:

A syntax error occurs if it is specified as an expression.

No syntax error occurs, if it is specified directly as a data object.
If it is detected at runtime that struc is not a structure, in both cases, sy-subrc is set to 4 and the state of the field symbol depends on addition ELSE UNASSIGN.
comp is a character-like or numeric expression position. The evaluation depends on the data type of comp:

If the field comp has a text-like type (c or string ) or the type of a flat structure, which exclusively contains character-like components, its content is interpreted as the name of the component. The name must be in uppercase letters. It may contain offsets and lengths, structure component selectors, and component selectors for assigning structured data objects and attributes in classes or objects.

If the field comp has a non-text-like elementary type, the content is converted to the type i and interpreted as the position of the component in the structure. If the value of comp is 0, the memory area of the entire structure is assigned to the field symbol.

If comp has a different type, a syntax error or runtime error occurs.



Latest notes:

If the structure struc is specified as a table expression and the corresponding line is not found, the exception CX_SY_ITAB_LINE_NOT_FOUND is raised.

Writable expressions can be specified for struc but no other expressions, since only these can have a non-temporary result. Assigning a component of a temporary structure to a field symbol would not make sense.

If struc is specified directly as a data object, it is advisable to specify only structures and to check this in advance if necessary. Just evaluating sy-subrc is not enough to determine why an assignment was not successful.

Identifying a component by its name is far less efficient than using its position, since far more internal processes are involved. Using COMPONENTS OF, however, is always more efficient than specifying the name after the structure component selector within a fully dynamically specified component in a parenthesized data object name .
NON_V5_HINTS

For the latter see this executable example.
ABAP_HINT_END

ABAP_EXAMPLE_VX5
Assignment of all components of a structure to a field symbol in a loop. In every loop pass, the component is assigned whose position is determined by the loop index.
ABEXA 00031
ABAP_EXAMPLE_END

ABAP_EXAMPLE_VX
The following two methods show the dynamic assignment of the components of a structure that is passed to the parameter para of the methods to a field symbol < comp>.

The first implementation does not use RTTI. The statement DESCRIBE FIELD is used to check whether the passed data object is a structure. The components are then assigned one after another to the field symbol in a DO loop.

The second implementation uses RTTI. A downcast of the type description object to the class CL_ABAP_STRUCTDESCR for the passed data object ensures that the object is a structure. A loop across the component table COMPONENTS assigns the components to the field symbol via their names.
ABEXA 00032
ABAP_EXAMPLE_END

ABAP_EXAMPLE_V5
The following method shows the dynamic assignment of the components of a structure that is passed to the parameter para of the method to a field symbol < comp>. The implementation uses RTTI. A downcast of the type description object to the class CL_ABAP_STRUCTDESCR for the passed data object ensures that the object is a structure. A loop across the component table COMPONENTS assigns the components to the field symbol via their names.
ABEXA 01618
ABAP_EXAMPLE_END

ABAP_EXAMPLE_VX5
Assignment of a component of a line of an internal table to a field symbol.
ABEXA 00033
ABAP_EXAMPLE_END

ABAP_EXAMPLE_VX5
Trying to assign a component of data object that is not a structure to a field symbol. This is detected only at runtime in this variant. sy-subrc is set to 4 and using ELSE UNASSIGN the field symbol that was assigned before is unassigned.
ABEXA 01468
ABAP_EXAMPLE_END

Return to menu