SAP ABAP IMG Activity /IPRO/RULES (Enhance Rules)
Hierarchy
SAP_BS_FND (Software Component) SAP Business Suite Foundation
   CA-GTF-DOB (Application Component) Document Builder
     /IPRO/PROGS (Package) programs
IMG Activity
ID /IPRO/RULES Enhance Rules  
Transaction Code /IPRO/67000040   (empty) 
Created on 20040908    
Customizing Attributes /IPRO/RULES   Enhance Rules 
Customizing Activity /IPRO/RULES   Enhance Rules 
Document
Document Class SIMG   Hypertext: Object Class - Class to which a document belongs.
Document Name /IPRO/RULES    

Use

Implement this Business Add-In to enhance the Formula Builder used for creating rules in SAP Document Builder.

The Business Add-In consists of the method described below, which defines the new functions to be added.

GET

The following import parameter is available:

  • IM_KEY
    Current function symbol being evaluated.

The following change parameter must be updated to provide the new features definitions for the Formula Builder:

  • CH_OPERANDS
    Internal table of the operands used for the current function symbol.

Requirements

The new function must be defined as a public static method of a global class.

You must implement a class as a subclass of /IPRO/CL_RULE_ENGINE if access to the current document structure is required.

Standard settings

Activities

After calling up the IMG activity, a dialog box appears, in which you can enter a name for the implementation.

If you have already made other implementations for this BAdI, another dialog box appears, in which the existing implementations are displayed. In this case, choose Create, and proceed as follows:

1. In the dialog box, enter a name for the BAdI implementation in the Implementation field, and choose Create.

The screen for creating BAdI implementations is now displayed.

2. Enter a short text for the implementation in the Short text for implementation field.

3. From the tab index, choose Interface.

The Name of implemented class field is already filled on the tab page, as a class name was automatically assigned to the implementation when you named it.

4. Save your entries, and assign the implementation to a development class.

5. Place the cursor on the method, and double-click to enter method processing.

6. Enter the coding for the implementation between the statements method <Interface name> ~ <Name of method> and endmethod.

7. Save and implement your coding. Return to the Edit Implementation screen.

8. Save the entries on the Edit Implementation screen.

Note: You can also create an implementation, and then activate it at a later time. In such a case, end the processing stage at this point.

9. Choose Activate.

The coding you stored in the methods will be run when the application program is executed.

Example

The following is a sample code used to add the extra function ''. This example uses the class ZZ_NEW_FUNCS that is created as a subclass of /IPRO/CL_RULE_ENGINE. The new functions must be defined as static public methods in the class to be used by the Formula Builder.

Additional hints

For more information on using Business Add-Ins, see the SAP Library under Basis Components -> ABAP Workbench (BC-DWB) -> Changing the SAP Standard (BC) -> Business Add-Ins.

Business Attributes
ASAP Roadmap ID 257   Create User Exits 
Mandatory / Optional 2   Optional activity 
Critical / Non-Critical 2   Non-critical 
Country-Dependency A   Valid for all countries 
Assigned Application Components
Documentation Object Class Documentation Object Name Current line number Application Component Application Component Name
SIMG /IPRO/RULES 0 HLB0009110 Cross-Application Components 
Maintenance Objects
Maintenance object type E   Business Add-In - Definition 
History
Last changed by/on SAP  20050119 
SAP Release Created in 100