Start of Content Area

READ_FORM_ELEMENTS   Locate the document in its SAP Library structure

The function module fills a table with all text elements that appear in one form.

If you specify no form name, the system includes all elements of the currently open form. If you specify a form, the system uses the information about the active version of the form, retrieved from the database.

 

Function call:

 

CALL FUNCTION 'READ_FORM_ELEMENTS'

EXPORTING FORM = SPACE

LANGUAGE = SPACE

TABLES ELEMENTS = ?...

EXCEPTIONS FORM =

UNOPENED =

 

Export parameters:

FORM

Specify the name of the form whose element list you want to create. If you leave the field blank, the system uses the currently active form.

Default value: SPACE

LANGUAGE

Specify the desired form language.

Default value: SPACE

 

Table parameters:

ELEMENTS

The table contains all windows defined in a form together with the corresponding text elements. For each text element, the system specifies the number of text lines (editor lines) it consists of.

Structure: ITCWE

 

Exceptions:

FORM

The parameter FORM contains the name of a form which could not be found.

Possible reasons:

  • The form does not exist.
  • There is no active version of this form.

SAPscript first searches for the form in the current client and in the specified language. If the form does not exist there, it tries the original language of the form. If the form is still not found, it searches in client 0, first in the specified language, than in the original form language.

UNOPENED

The current form function could not be executed, since the form output was no yet initialized using OPEN_FORM.