SAVE_TEXT (SAP Library - BC SAPscript: Printing with Forms)

SAVE_TEXT

SAVE_TEXT writes a text module back to the text file or the text memory, depending on the storage mode of the corresponding text object.

You can use this module either to change existing texts or to create new texts. If you know for sure that the text is new, use the parameter INSERT to indicate this. The system then does not have to read the text first, which improves the performance of the function module.

If the lines table passed with the function module is empty, the system deletes the text from the text file.

Function call:

CALL FUNCTION 'SAVE_TEXT'

EXPORTING CLIENT = SY-MANDT

HEADER = ?...

INSERT = SPACE

SAVEMODE_DIRECT = SPACE

OWNER_SPECIFIED = SPACE

IMPORTING FUNCTION =

NEWHEADER =

TABLES LINES = ?...

EXCEPTIONS ID =

LANGUAGE =

NAME =

OBJECT =

Export parameters:

CLIENT	Specify the client under which to store the text. If you omit this parameter, the system uses the current client as default. Reference field: SY-MANDT Default value: SY-MANDT
HEADER	Enter the structure that contains the text header of the text you want to save. Structure: THEAD
INSERT	This parameter indicates that the text module is new. Usually, SAPscript reads the text file first to check whether the text module exists. If you know that the text is new before the application program calls the function module, use this parameter to prevent the system from this read process and thus improve the performance. Possible values: ' ' Determine update mode automatically 'X' Text is new Default value: SPACE
SAVEMODE_DIRECT	You determine the storage mode of a text module (direct, in update task) via the text object in table TTXOB. However, it may be necessary to replace storage in update task with direct storage of a text (for example, for background processing). Possible values: ' ' Storage mode according to text object 'X' Save text module directly Default value: SPACE
OWNER_SPECIFIED	When creating a new text, the parameter indicates whether the creation information in the text header is filled in automatically by SAPscript, or whether to use the data passed in the header. The parameter concerns the fields TDFUSER, TDFDATE, TDFTIME, and TDFRELES in the text header. Possible values: ' ' Information taken from SAPscript 'X' Information taken from header If you use this parameter, but one of the required fields is initial, this field is filled by SAPscript. You use this parameter if you use a program to insert text under a certain owner or a certain release information, which do not correspond to the current environment (for example, a migration program for transferring texts from the R/2 system to SAPscript). Default value: SPACE

Import parameters:

FUNCTION

The parameter returns the processing status of the text module for the current call.

Possible values:

' ' no action

'I' text module was created

'U' text module was modified

'D' text module was deleted

Table parameters:

LINES

The table contains the text lines of the text to be saved.

Structure: TLINE

Exceptions:

ID	The text ID specified in the parameter ID does not exist in table TTXID. It must be defined there together with the object of the text module.
LANGUAGE	The parameter LANGUAGE contains a language key that does not exist in table T002.
NAME	The parameter NAME contains the name of a text module that does not correspond to the SAPscript conventions. Possible errors: · The field contains only blanks. · The field contains the invalid characters ‘*’ or ‘,’.
OBJECT	The parameter OBJECT contains the name of a text object that does not exist in table TTXOB.