SAP Function API_SEMBPS_HIERARCHY_GET - Read hierarchy

Parameter Reference Type Length Default Optional Text
IS_HIEKEY UPC_YS_HIE_KEY u 71 Hierarchy Key
I_AREA UPC_AREA-AREA C 8 Planning Area

Parameter Reference Type Length Text
ES_RETURN BAPIRET2 u 548 Return Parameter
E_SUBRC SYST-SUBRC I 4 Return Code

Parameter Reference Length Optional Text
ETK_HIESTR UPC_YS_API_HIESTR 255 Hierarchy Structure
ETK_HIESTRDEP UPC_YS_API_HIESTRDEP 108 Hierarchy Structure: Values of Compounded Characteristics

Functionality
An external hierarchy (hierarchy in SAP BW) can be read with thisfunction module.

  • The planning area is transferred in the field I_AREA

  • The key of the hierarchy is transferred in the structure IS_HIEKEY

    • HIENM is the hierarchy name
    HIEVER is the hierarchy version (only for version-dependenthierarchies)
    DATETO is the valid to date (only for time-dependent hierarchies)
    CHANM is the hierarchy-bearing characteristic
    • ETK_HIESTR returns the hierarchy structure

      • There are three types of hierarchy nodes:
      Text nodes: CHANM = '0HIER_NODE',,
      Characteristic nodes for the hierarchy-bearing characteristic: CHANM =IS_HEYKEY-CHANM,,
      Characteristic nodes for any characteristic: CHANM <> IS_HEYKEY-CHANMundCHANM <> '0HIERNODE'
      • ETK_HIESTRDEP delivers the values of higher-level characteristics for
        • compounded characteristics

        Description
        This structure can contain a message. In the case E_SUBRC <> 0 itcontains an error message, in the case E_SUBRC = 0 an informationmessage can be in this structure.

        Description
        This return parameter contains the value 0, if the module could beexecuted without errors, otherwise the value of the return parameter islarger than 0.