CL_FMHIE_TREE_HANDLER - Sevices for budget distribution

Vendor Master (General Section)   BAL_S_LOG - Application Log: Log header data  
This documentation is copyright by SAP AG.

Functionality

Use the methods of this class to obtain information on the hierarchical position of FM addresses or relationships between FM addresses. The following methods should be used:

• GET_RECEIVERS - gets the subtree for the given address (excluding the entry address).

• GET_SINGLE_ADDRESS_INFO - gets the information on one hierarchy node, its path to the top, the whole subtree, and whether the given address is a root in the hierarchy.

• GET_RELATIONSHIP - gets information about hierarchical relationships of two addresses (whether distribution is possible, path to the top, 1st common parent), etc.

The parameters have the following meaning:

• IM_HEADER - header data (your work area)

• IM_ADDRESS_UPPER - your first address for checking the relationship

• IM_ADDRESS_LOWER - your second address for checking the relationship

• IM_FLG_CHECK_ADDRESS_ORDER - checks whether the lower address is really on a lower level than theupper address. If this is not the case, an exception INVALID_LOWER_ADDRESS is returned. If this flagis not set, the program will automatically determine the real lower address and real upper address fromthe given parameters IM_ADDRESS_LOWER and IM_ADDRESS_UPPER and will continue processing using the determined real lower and upper addresses.

In further documentation text, the terms lower address and upper address refer to the real upper andlower address in the hierarchy. Using the following parameters the calling application determines the information which it is searching for:

• IM_FLG_CHECK_CHILD - checks whether the lower address is the child (direct) of the upper address. The result is returned in E_FLG_IS_CHILD

• IM_FLG_GET_COMMON_PARENT - checks whether the both addresses have a common parent (that is, are members of the same tree) the result is returned in E_FLG_COMMON_PARENT_EXISTS and E_COMMON_PARENT.

• IM_FLG_CHECK_DISTRIB_POSSIBLE - checks whether the budget distribution is possible from an upperaddress to a lower address (that is, the upper address lies on the lower address's path to the top). The result is returned in E_FLG_DISTRIB_POSSIBLE.

• IM_FLG_GET_PATH - gets the path for both upper and lower addresses in the E_T_PATH_LOWER and E_T_PATH_UPPER. Sorted by descending levels (from the lowest node to the top).

You can also use the other public methods of the class, however these methods are originally intended to provide subtasks of the above desribed methods.

Relationships

Example

Notes

Further information

Addresses (Business Address Services)   PERFORM Short Reference  
This documentation is copyright by SAP AG.


Length: 2876 Date: 20120526 Time: 125120     triton ( 119 ms )