SAP Function SELECT_TEXT - SAPscript: Select text

Parameter Reference Type Length Default Optional Text
ARCHIVE_HANDLE SYST-TABIX I 4 0 X Archive handle
CLIENT SYST-MANDT C 3 SY-MANDT X Client
DATABASE_ONLY 0 SPACE X Indicator: Search in text file only
ID THEAD-TDID C 4 '*' X Text ID of texts to be searched for
LANGUAGE THEAD-TDSPRAS C 1 '*' X Language of texts to be searched for
LOCAL_CAT 0 SPACE X Text catalog local
NAME THEAD-TDNAME C 70 '*' X Name of text to be searched for
OBJECT THEAD-TDOBJECT C 10 '*' X Text object of texts to be searched for
TEXTMEMORY_ONLY 0 SPACE X Indicator: Search in text memory only
WILDCARD_PLUS 0 SPACE X

Parameter Reference Type Length Text
ENTRIES SYST-TFILL I 4 Number of texts found

Parameter Reference Length Optional Text
I_NAME STEXTNAME 70 X Structure Contains Elementary Type TDNAME
SELECTIONS THEAD 375 X Text header of texts found
T_ID STXDRID 11 X Table for text IDs (RANGES)
T_LANGUAGE STXDRLANG 5 X Table for text languages (RANGES)
T_NAME STXDRNAME 143 X Table for text names (RANGES)
T_OBJECT STXDROBJ 23 X Table for text objects (RANGES)

Exception Text
WRONG_ACCESS_TO_ARCHIVE Archive handle invalid for access


INCLUDE STXD_PF_SELECT_TEXT OBJECT DOKU ID TX
INCLUDE STXD_PP_ENTRIES OBJECT DOKU ID TX
INCLUDE STXD_PP_ARCHIVE_HANDLE OBJECT DOKU ID TX
INCLUDE STXD_PP_CLIENT OBJECT DOKU ID TX
INCLUDE STXD_PP_DATABASE_ONLY OBJECT DOKU ID TX
INCLUDE STXD_PP_ID OBJECT DOKU ID TX
INCLUDE STXD_PP_LANGUAGE OBJECT DOKU ID TX
INCLUDE STXD_PP_NAME OBJECT DOKU ID TX
INCLUDE STXD_PP_OBJECT OBJECT DOKU ID TX
INCLUDE STXD_PP_TEXTMEMORY_ONLY OBJECT DOKU ID TX

Description
Table is used to copy a large number of text names EXACTLY. If filled,name tables have priority over others.

Default
Space
INCLUDE STXD_PP_SELECTIONS OBJECT DOKU ID TX

Description
You can use tables parameter T_ID to pass a ranges tables of text IDsthat are to be saved either through an update or directly. The textkeys of the table can also be generic. In this case, all texts areselected whose text IDs have the same characters up to the firstoccurrence of '*'.
Parameter T_ID is a table of reference type STXDRID. Parameter T_IDgenerally overrides the text key field ID that can be additionallyspecified as an import parameter in the function call of SELECT_TEXT.

Example
...
ranges:
r_name for stxh-tdname,
r_object for stxh-tdobject,
r_id for stxh-tdid,
r_language for stxh-tdspras.
r_name-sign = 'I'.
r_name-option = 'CP'.
r_name-low = '0000004711*'.
append r_name.
r_object-sign = 'I'.
r_object-option = 'CP'.
r_object-low = 'VBB*'.
append r_object.
r_id-sign = 'I'.
r_id-option = 'EQ'.
r_id-low = '0001'.
append r_id.
call function 'COMMIT_TEXT'
exporting
object = 'TEXT'
tables
t_name = r_name
t_object = r_object
t_id = r_id
* t_language = r_language
* importing
* COMMIT_COUNT =
.
In this example, text object 'TEXT' of the texts to be updated isoverridden by the generic specification of 'VBB*'.

Description
You can use tables parameter T_LANGUAGE to pass a ranges table of textlanguages that are to be saved either through an update or directly.The text keys of the table can also be generic. In this case, all textsare selected whose text languages have the same characters up to thefirst occurrence of '*'.
Parameter T_LANGUAGE is a table of reference type STXDRLANG. ParameterT_LANGUAGE generally overrides the text key field LANGUAGE that can beadditionally specified as an import parameter in the function call ofSELECT_TEXT.

Example
...
ranges:
r_name for stxh-tdname,
r_object for stxh-tdobject,
r_id for stxh-tdid,
r_language for stxh-tdspras.
r_name-sign = 'I'.
r_name-option = 'CP'.
r_name-low = '0000004711*'.
append r_name.
r_object-sign = 'I'.
r_object-option = 'CP'.
r_object-low = 'VBB*'.
append r_object.
r_id-sign = 'I'.
r_id-option = 'EQ'.
r_id-low = '0001'.
append r_id.
call function 'COMMIT_TEXT'
exporting
object = 'TEXT'
tables
t_name = r_name
t_object = r_object
t_id = r_id
* t_language = r_language
* importing
* COMMIT_COUNT =
.
In this example, text object 'TEXT' of the texts to be updated isoverridden by the generic specification of text object 'VBB*'.

Description
You can use tables parameter T_NAME to pass a ranges table of textnames that are to be saved either through an update or directly. Thetext keys of the table can also be generic. In this case, all texts areselected whose text names have the same characters up to the firstoccurrence of '*'.
Parameter T_NAME is of table of reference type STXDRNAME. ParameterT_NAME generally overrides the text key field NAME that can beadditionally specified as an import parameter in the function call ofSELECT_TEXT.

Example
...
ranges:
r_name for stxh-tdname,
r_object for stxh-tdobject,
r_id for stxh-tdid,
r_language for stxh-tdspras.
r_name-sign = 'I'.
r_name-option = 'CP'.
r_name-low = '0000004711*'.
append r_name.
r_object-sign = 'I'.
r_object-option = 'CP'.
r_object-low = 'VBB*'.
append r_object.
r_id-sign = 'I'.
r_id-option = 'EQ'.
r_id-low = '0001'.
append r_id.
call function 'COMMIT_TEXT'
exporting
object = 'TEXT'
tables
t_name = r_name
t_object = r_object
t_id = r_id
* t_language = r_language
* importing
* COMMIT_COUNT =
.
In this example, text object 'TEXT' of the texts to be updated isoverridden by the generic specification of text object 'VBB*'.
You can use tables parameter T_OBJECT to pass a ranges table of textobjects that are to be saved either through an update or directly. Thetext keys of the table can also be generic. In this case, all texts areselected whose text objects have the same characters up to the firstoccurrence of '*'.
Parameter T_OBJECT is a table of reference type STXDROBJ. ParameterT_OBJECT generally overrides the text key field OBJECT that canadditionally be specified as an import parameter in the function callof SELECT_TEXT.

Example
...
ranges:
r_name for stxh-tdname,
r_object for stxh-tdobject,
r_id for stxh-tdid,
r_language for stxh-tdspras.
r_name-sign = 'I'.
r_name-option = 'CP'.
r_name-low = '0000004711*'.
append r_name.
r_object-sign = 'I'.
r_object-option = 'CP'.
r_object-low = 'VBB*'.
append r_object.
r_id-sign = 'I'.
r_id-option = 'EQ'.
r_id-low = '0001'.
append r_id.
call function 'COMMIT_TEXT'
exporting
object = 'TEXT'
tables
t_name = r_name
t_object = r_object
t_id = r_id
* t_language = r_language
* importing
* COMMIT_COUNT =
.
In this example, text object 'TEXT' of the texts to be updated isoverridden by the generic specification of text object 'VBB*'.