Start of Content Area

TEXT_INCLUDE_REPLACE   Locate the document in its SAP Library structure

Use this function module to resolve the INCLUDE statements that occur in the text lines, that is, to replace them with the respective lines of the text to be included. If a text module does not exist or if the user has no authorization, the system keeps the INCLUDE statement.

 

Function call:

 

CALL FUNCTION 'TEXT_INCLUDE_REPLACE'

EXPORTING HEADER = ?...

STARTLINE = 1

ENDLINE = 99999

PROGRAM = SPACE

ALL_LEVEL = 'X'

IMPORTING NEWHEADER =

CHANGED =

ERROR_TYPE =

TABLES LINES = ?...

 

Export parameters:

HEADER

The parameter contains the header of the text module whose INCLUDE statements you want to resolve.

Structure: THEAD

STARTLINE

Enter the index of the table line where you want the function module to start. If you omit the parameter or enter an invalid value, the system starts from the first table line.

Reference field: SY-TABIX

Default value: 1

ENDLINE

Enter the index of the table line where you want the function module to end. If you omit the parameter or enter an invalid value, the system ends with the last table line.

Reference field: SY-TABIX

Default value: 99999

PROGRAM

When interpreting control statements, SAPscript must determine the values of program symbols. To do this, it must know which active program contains the work areas for the values to be passed.

If you omit the parameter, the system searches for the field values in the program that was called first (SY-CPROG).

If you enter a program name, the system replaces the program symbols with the values from this program. This applies only for the current call of the function module.

Reference field: SY-REPID

Default value: SPACE

ALL_LEVEL

ALL_LEVEL determines whether to resolve only the INCLUDE statements in the text table or whether to resolve any new INCLUDE statements, which appear after resolving, as well.

 

Possible values:

' ' resolve only existing INCLUDEs

'X' resolve all INCLUDEs

Default value: 'X'

 

Import parameters:

NEWHEADER

The parameter returns the text header with the fields changed according to the executed action.

Structure: THEAD

CHANGED

The parameter indicates whether the system resolved INCLUDEs and thus changed the contents of the text table.

Possible values:

'X' INCLUDEs resolved

' ' no INCLUDEs resolved

ERROR_TYPE

At present, the parameter does not yet return error messages.

Reference field: SY-TABIX

 

Table parameters:

LINES

The table contains the text lines in which to resolve the INCLUDE statements.

Structure: TLINE