SAP Function RH_READ_OBJECT - Read Object

Parameter Reference Type Length Default Optional Text
BEGDA PLOG-BEGDA D 8 SY-DATUM X Start Date for Reading Text
CHECK_STRU_AUTH HRRHAS-AUTHY C 1 'X' X X=Display/M=Maintain Authorization Check
ENDDA PLOG-ENDDA D 8 SY-DATUM X End Date for Reading Text
ISTAT PLOG-ISTAT C 1 SPACE X Status for Reading Text
LANGU SYST-LANGU C 1 SY-LANGU X Language for Reading Text
OBJID PLOG-OBJID N 8 X Object ID
OINTERVAL HRPP0C-TEST C 1 'X' X Return Object Validity Period ' '/X/I
OTYPE PLOG-OTYPE C 2 Object Type
PLVAR PLOG-PLVAR C 2 Plan Version
READ_DB HRPP0C-TEST C 1 SPACE X X = Object is Read From Database (Buffer Replaced)
REALO OBJEC-REALO C 45 SPACE X Extended Object ID (External Object)
STORE HRPP0C-TEST C 1 'X' X Buffer Data ' '/X

Parameter Reference Type Length Text
DISPLAY_TEXT P1000-STEXT C 40 Object Description
HISTO PLOG-HISTO C 1 Historical Record Flag
OBEG PLOG-BEGDA D 8 Object Start Date
OEND PLOG-ENDDA D 8 Object End Date
OSTAT PLOG-ISTAT C 1 Object Status
SHORT P1000-SHORT C 12 Abbreviation
STEXT P1000-STEXT C 40 Name
TISTAT P1000-ISTAT C 1 Status of Texts Returned
TLANGU P1000-LANGU C 1 Language of Texts Returned

Parameter Reference Length Optional Text
EXISTENCE HROEXIST 17 X Status-Dependent Existence Intervals

Exception Text
NOT_FOUND Object Not Found

Functionality
This function returns the text and validity of an object.
If you want to output the object text in a list, use the DISPLAY_TEXTparameter instead of STEXT.

Notes
This function does not perform an existence check. In particular, itcannot check whether an object is valid in a given period. To do that,look at the parameters OBEG and OEND, and compare them with therequired period.
The LANGU parameter is only a recommendation, in other words if aparticular text does not exist, the system reads it in other languages(analogous to table T778L).
The function does not perform a basis authorization check.
If you want to read more than one object, we recommend that you useRH_READ_OBJECT_SET, which allows mass access. Alternatively you cancall RH_TEXT_BUFFER_FILL(_EXT) to prepare reading.

Description
This parameter contains the display text of the object. If STEXT isfilled, the system transfers it. Otherwise, it transfers SHORT.

Description
Start data for a text selection: this date is a recommendation, and thefunction ignores it if no text is available in this period.
This parameter is not suitable for existence checks.

Description
End date for a text selection: this date is a recommendation, and thefunction ignores it if no text exists in this period.
This parameter is not suitable for existence checks.

Description
Preferred language for reading texts: if a text is available in thislanguage, the system returns it. If no text is available in the desiredlanguage, the system searches in alternative languages (table T778L).

Description
ID for Personnel Planning Objects: if this parameter is not filled, youmust transfer the parameter REALO.
The parameter can have 3 values
Value Definition
Space The validity interval is not returned
X The validity interval is returned
I Only the validity interval is returned, no text

Description
Enforced re-reading of database records: only set this parameter if youexplicitly want to override the buffer for the function.

Value range
' ' (SPACE) first looks for the text in the buffer, 'X' forces thesystem to read from the database.

Default
SPACE

Description
ID for internal and external objects. You transfer the ID of therequired object in this parameter if the object is not a PersonnelPlanning object, or does not have a key of type NUMC8 (for example,user).
If you do not want to differentiate between internal and externalobjects, you can also transfer internal objects in the first eightcharacters of the parameter.

765523Unnecessary error message in formula processing
499170RHPREL00 incorrect existence check