RHPH_STRUCTURE_READ SAP Function module - Organizational structure of an organizational unit

RHPH_STRUCTURE_READ 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 RHPH_STRUCTURE_READ into the relevant SAP transaction such as SE37 or SE80.

Associated Function Group: RHPH
Released Date: Not Released
Processing type: Remote-Enabled

Pattern for FM RHPH_STRUCTURE_READ - RHPH STRUCTURE READ

CALL FUNCTION 'RHPH_STRUCTURE_READ' "Organizational structure of an organizational unit
  EXPORTING
    plvar =                     " hrp1000-plvar  Plan Version
    otype =                     " hrp1000-otype
    objid =                     " hrp1000-objid  Object ID
    wegid =                     " hrrhas-wegid
*   begda = SY-DATUM            " hrp1000-begda  From selection date
*   endda = SY-DATUM            " hrp1000-endda  Selection date "to"
*   pup_info = 'X'              " sy-input
*   with_stext = 'X'            " sy-input
*   tdepth = 0                  " hrrhas-tdepth
  TABLES
    stru_tab =                  " qcat_stru
  EXCEPTIONS
    CATALOGUE_PROBLEM = 1       "
    ROOT_NOT_FOUND = 2          "               Root object not found
    WEGID_NOT_FOUND = 3         "               Evaluation path not found
    .  "  RHPH_STRUCTURE_READ

ABAP code example for Function Module RHPH_STRUCTURE_READ

The ABAP code below is a full code listing to execute function module RHPH_STRUCTURE_READ 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:
it_stru_tab  
 
 TYPE STANDARD TABLE OF QCAT_STRU,"TABLES PARAM
wa_stru_tab
 
 LIKE LINE OF it_stru_tab
.

 

SELECT single PLVAR 
  FROM HRP1000 
  INTO @DATA(ld_plvar).

 

SELECT single OTYPE 
  FROM HRP1000 
  INTO @DATA(ld_otype).

 

SELECT single OBJID 
  FROM HRP1000 
  INTO @DATA(ld_objid).



DATA(ld_wegid) = some text here
 

SELECT single BEGDA 
  FROM HRP1000 
  INTO @DATA(ld_begda).

 

SELECT single ENDDA 
  FROM HRP1000 
  INTO @DATA(ld_endda).


DATA(ld_pup_info) = 'some text here'.

DATA(ld_with_stext) = 'some text here'.


DATA(ld_tdepth) = Check type of data required
 

"populate fields of struture and append to itab
append wa_stru_tab to it_stru_tab.
.

CALL FUNCTION 'RHPH_STRUCTURE_READ'
  EXPORTING
    plvar =                      ld_plvar
    otype =                      ld_otype
    objid =                      ld_objid
    wegid =                      ld_wegid
*   begda =                      ld_begda
*   endda =                      ld_endda
*   pup_info =                   ld_pup_info
*   with_stext =                 ld_with_stext
*   tdepth =                     ld_tdepth
  TABLES
    stru_tab =                   it_stru_tab
  EXCEPTIONS
    CATALOGUE_PROBLEM =          1
    ROOT_NOT_FOUND =             2
    WEGID_NOT_FOUND =            3
    .  "  RHPH_STRUCTURE_READ

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
ELSEIF SY-SUBRC EQ 3. "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_plvar
 
 TYPE HRP1000-PLVAR ,
it_stru_tab
 
 TYPE STANDARD TABLE OF QCAT_STRU ,
wa_stru_tab
 
 LIKE LINE OF it_stru_tab,
ld_otype
 
 TYPE HRP1000-OTYPE ,
ld_objid
 
 TYPE HRP1000-OBJID ,
ld_wegid
 
 TYPE HRRHAS-WEGID ,
ld_begda
 
 TYPE HRP1000-BEGDA ,
ld_endda
 
 TYPE HRP1000-ENDDA ,
ld_pup_info
 
 TYPE SY-INPUT ,
ld_with_stext
 
 TYPE SY-INPUT ,
ld_tdepth
 
 TYPE HRRHAS-TDEPTH .



SELECT single PLVAR 
  FROM HRP1000 
  INTO ld_plvar.
 

"populate fields of struture and append to itab
append wa_stru_tab to it_stru_tab.

SELECT single OTYPE 
  FROM HRP1000 
  INTO ld_otype.


SELECT single OBJID 
  FROM HRP1000 
  INTO ld_objid.


ld_wegid = some text here

SELECT single BEGDA 
  FROM HRP1000 
  INTO ld_begda.


SELECT single ENDDA 
  FROM HRP1000 
  INTO ld_endda.

ld_pup_info = 'some text here'.
ld_with_stext = 'some text here'.

ld_tdepth = Check type of data required