SAP ABAP IMG Activity REFXBADIREITOPTRATE (Option Rate Determination)
Hierarchy
☛ EA-FIN (Software Component) EA-FIN
   ⤷ RE-FX (Application Component) Flexible Real Estate Management
     ⤷ RE_CA_CU (Package) RE: Customizing (IMG) and Area Menu
IMG Activity
ID REFXBADIREITOPTRATE Option Rate Determination  
Transaction Code S_E4E_66000005   (empty) 
Created on 20071115    
Customizing Attributes REFXBADIREITOPTRATE   Option Rate Determination (BAdI) 
Customizing Activity REFXBADIREITOPTRATE   Option Rate Determination (BAdI) 
Document
Document Class SIMG   Hypertext: Object Class - Class to which a document belongs.
Document Name BADI_REIT_OPTION_RATE    

Use

The Business Add-In (BAdI) supports enhancements to the standard functions of option rate determination.

For information about possible enhancement scenarios, see the Overview of Enhancement Methods for Master Data Objects and the Real Estate Contract.

Standard settings

In the standard system, there is no activated BAdI implementation.

Activities

Create a BAdI implementation and implement the methods you require for your enhancement. Then activate the BAdI implementation.

For information on using BAdIs, see this documentation.

The following methods exist:

  • CALCULATE_OPTION_RATE

    Calculates the option rate

  • CHECK_FOLLOW_ON_CONTRACT

    Is used for controlling whether a follow-on contract should be considered or not during the determination of the option rate

  • CHANGE_PROPOSED_OPTMETH

    Is used to change the default method determined during the creation of new master data

Warning
The implementation of the methods has to be independent of the interface. It must not contain any COMMIT WORK or ROLLBACK WORK statements. For example, direct output of messages using the MESSAGE statement is not allowed.

Method description

  • CALCULATE_OPTION_RATE

    This method is used for calculating the individual option rate.

    The prerequisite for this is that you defined an option rate method with automatic determination and set the Customer Exit indicator in Customizing for Flexible Real Estate Management under Option Rate Determination and Input Tax Distribution -> Option Rate Methods. For more information, refer to the documentation for the indicator.

    You can use the following input parameters:

    • ID_INTRENO: Internal key of the real estate object for which you want to determine the option rate. The data for the object can be read using the API modules for the individual object types (name pattern API_RE_*_GET_DETAIL).
    • ID_KEYDATE: Key date for which you want to determine the option rate.
    • ID_OPTMETH: Option rate method. If several methods have been defined with the Customer Exit indicator, this value must be queried in the implementation.

      The option rate is output using the CD_OPTRATE parameter. If there are warning or error messages during option rate determination, the messages can be passed on to the application using the CT_MESSAGE parameter. Information for determining the option rates of subobjects can be transferred using the parameter CT_VIITORCSUBOBJ.

  • CHECK_FOLLOW_ON_CONTRACT

    If you want the system to determine the option rate of a rental object dependent on a follow-on contract, you can use this method to control whether the system actually uses the follow-on contract that is determined. If you do not want to use the follow-on contract, the system determines the option rate of the rental object as in the case of a vacancy without a follow-on contract.

    You can use the following input parameters:

    • IO_CONTRACT: This parameter contains the follow-on contract determined by the system.
    • IO_RENTAL_OBJECT: This parameter contains the rental object.
    • ID_ORDATE: This parameter contains the key date for the option rate determination.
    • CF_CN_NOT_BE_USED: Using this indicator, you inform the system if the determined follow-on contract should actually be used. Set the indicator to TRUE if you do not want the follow-on contract to be considered.

  • CHANGE_PROPOSED_OPTMETH

    Based on the Customizing settings or through inheritance, an option rate method is determined that is used as the default when new master data objects are created. You can change the default method using this BAdI method.

    You can use the following parameters:

    • IO_BUSOBJ: This parameter contains the current master data object.
    • IT_VALID_METHOD: This table contains the option rate methods permitted for the object type.
    • CS_PROPOSED_OPTRATE: This structure contains the data for the default method determined by the system. The individually determined default method must be returned in this structure. The option rate method has to be an option rate method that is contained in the table IT_VALID_METHOD. Otherwise, the default method determined by the system is used.

Example

Example implementations are provided for the corresponding methods.

  • CALCULATE_OPTION_RATE

    Example class CL_EXM_IM_REIT_OPTION_RATE for determining the option rate using the revenue of the subobjects.

  • CHECK_FOLLOW_ON_CONTRACT

    Example class CL_EXM_IM_REIT_OR_FOLLOW_ON_CN for considering the follow-on contract during option rate determination, if the date the contract was signed (RECNDAT) is before the key date of option rate determination.

  • CHANGE_PROPOSED_OPTMETH

    Example class CL_EXM_IM_REIT_OR_PROPOSE_METH for replacing the default method for settlement units (based on apportionment factors in the system, now based on area ratio)

See also

This BAdI uses the interface IF_EX_REIT_OPTION_RATE. For more information, display the interface in the Class Builder.

Notes for Developers

Business Attributes
ASAP Roadmap ID 204   Establish Functions and Processes 
Mandatory / Optional 2   Optional activity 
Critical / Non-Critical 2   Non-critical 
Country-Dependency A   Valid for all countries 
Maintenance Objects
Maintenance object type E   Business Add-In - Definition 
History
Last changed by/on SAP  20101213 
SAP Release Created in 604