SOTR_STRING_READ_TEXT_WITH_KEY SAP Function module

SOTR_STRING_READ_TEXT_WITH_KEY is a standard SAP function module available within R/3 SAP systems depending on your version and release level. Below is the pattern details for this FM showing its interface including any import and export parameters, exceptions etc as well as any documentation contributions (Comments) specific to the object.

See here to view full function module documentation and code listing, simply by entering the name SOTR_STRING_READ_TEXT_WITH_KEY into the relevant SAP transaction such as SE37 or SE80.

Associated Function Group: SOTR_DB_STRING_READ
Released Date: Not Released
Processing type: Normal fucntion module

Pattern for FM SOTR_STRING_READ_TEXT_WITH_KEY - SOTR STRING READ TEXT WITH KEY

CALL FUNCTION 'SOTR_STRING_READ_TEXT_WITH_KEY' "
  EXPORTING
*   langu = SY-LANGU            " sy-langu
*   context =                   " sotr_cntxt    Context
    sotr_key =                  " sotr_key      Key for Accessing OTR Texts
*   flag_context =              " as4flag
  IMPORTING
    header =                    " sotr_head     Header Table for OTR Texts
    entry =                     " sotr_textu    Text Table in the OTR
  EXCEPTIONS
    NO_ENTRY_FOUND = 1          "
    LANGUAGE_MISSING = 2        "
    .  "  SOTR_STRING_READ_TEXT_WITH_KEY

ABAP code example for Function Module SOTR_STRING_READ_TEXT_WITH_KEY

The ABAP code below is a full code listing to execute function module SOTR_STRING_READ_TEXT_WITH_KEY including all data declarations. The code uses the latest in-line data DECLARATION SYNTAX but I have included an ABAP code snippet at the end to show how declarations would look using the original method of declaring data variables up front. This will allow you to compare and fully understand the new inline method. Please note some of the newer syntax such as the @DATA is not available until a later 4.70 service pack (SP8).

DATA:
ld_header  
 
 TYPE SOTR_HEAD
,
ld_entry  
 
 TYPE SOTR_TEXTU
.


DATA(ld_langu) = 'Check type of data required'.

DATA(ld_context) = 'Check type of data required'.

DATA(ld_sotr_key) = 'Check type of data required'.

DATA(ld_flag_context) = 'Check type of data required'.
.

CALL FUNCTION 'SOTR_STRING_READ_TEXT_WITH_KEY'
  EXPORTING
*   langu =                      ld_langu
*   context =                    ld_context
    sotr_key =                   ld_sotr_key
*   flag_context =               ld_flag_context
  IMPORTING
    header =                     ld_header
    entry =                      ld_entry
  EXCEPTIONS
    NO_ENTRY_FOUND =             1
    LANGUAGE_MISSING =           2
    .  "  SOTR_STRING_READ_TEXT_WITH_KEY

IF SY-SUBRC EQ 0.
  "All OK
ELSEIF SY-SUBRC EQ 1. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 2. "Exception
  "Add code for exception here
ENDIF.

ABAP code to compare 7.40 inline data declaration with original syntax

The below ABAP code uses the older none in-line data declarations. This allows you to see the coding differences/benefits of the later inline syntax. It may also be useful if you are using an older version of SAP as some of the newer syntax above, such as the @DATA is not available until 4.70 EHP 8.

DATA:

ld_header
 
 TYPE SOTR_HEAD ,
ld_langu
 
 TYPE SY-LANGU ,
ld_entry
 
 TYPE SOTR_TEXTU ,
ld_context
 
 TYPE SOTR_CNTXT ,
ld_sotr_key
 
 TYPE SOTR_KEY ,
ld_flag_context
 
 TYPE AS4FLAG .


ld_langu = 'Check type of data required'.
ld_context = 'Check type of data required'.
ld_sotr_key = 'Check type of data required'.
ld_flag_context = 'Check type of data required'.