SAP ABAP IMG Activity CPRO_BAPIBUS2173IAPP (BAdI: Individual Approval for BOR Object Phase)
Hierarchy
☛ CPRXRPM (Software Component) SAP Portfolio and Project Management 6.0
   ⤷ PPM-PRO (Application Component) Project Management
     ⤷ DEVELOPMENT_PROJECTS_CUSTOMIZE (Package) General Customizing for Project Management
IMG Activity
ID CPRO_BAPIBUS2173IAPP BAdI: Individual Approval for BOR Object Phase  
Transaction Code S_CP4_60000023   (empty) 
Created on 20040205    
Customizing Attributes CPRO_BAPIBUS2173IAPP   BAdI: Individual Approval for BOR Object Phase 
Customizing Activity CPRO_BAPIBUS2173IAPP   BAdI: Individual Approval for BOR Object Phase 
Document
Document Class SIMG   Hypertext: Object Class - Class to which a document belongs.
Document Name BAPIEXT_BUS2173_IAPP    

Use

This Business Add-In (BAdI) is used in the Project Management (PPM-PRO) component. This BAdI enables you to use the customer-defined fields for the individual approval of a phase in the BAPIs too. Each decision maker for an approval then represents an individual approval.

The IndividualApprovalAdd, IndividualApprovalChange, and IndividualApprovalRemove methods each contain the importing parameter IS_EXTENSION_IN and the exporting parameter ES_EXTENSION_OUT. The ApprovalGetDetail method delivers the individual approvals to the ET_IND_APPROVAL exporting table. The customer-defined fields that belong to the individual approvals are available in the ET_IND_APPROVAL_EXTENSION_OUT exporting table.

  • If you fill the IS_EXTENSION_IN extension structure correctly and have implemented the methods named below of the BAdI you can carry out customer-defined checks before the action that belongs to the method is performed for the current individual approval.
    If the method in the return table returns at least one message of the type 'E', 'A', or 'X', the system cancels the processing of the BAPI.

Method        Action

ADD_EXIT_IN        Create individual approval

CHANGE_EXIT_IN        Change individual approval

REMOVE_EXIT_IN        Delete individual approval

  • If you fill the IS_EXTENSION_IN extension structure correctly in the IndividualApprovalAdd or IndividualApprovalChange method and have set the Extensions indicator in the update structure, you can use the ADD_EXIT_MAP or CHANGE_EXIT_MAP method of the BAdI to fill the customer-defined fields of the CI_DPR_IND_APPROVAL CI structure with the values of this extension structure.

  • After the action for the current individual approval has been performed, you can fill the ES_EXTENSION_OUT exporting structure, provided that the IS_EXTENSION_IN importing structure has been filled correctly and you have implemented the methods named below of the BAdI.
    This method cannot undo the action. All messages in the return table are transferred to the log.

Method        Action

ADD_EXIT_OUT        Create individual approval

CHANGE_EXIT_OUT        Change individual approval

REMOVE_EXIT_OUT        Delete individual approval

  • If you request the ET_IND_APPROVAL_EXTENSION_OUT table in the BAPI interface in the ApprovalGetDetail method, the system generates a table entry for each individual approval. You can use the <DS:IO.IF_EX_BAPIEXT_BUS2173_IAPP GET_DETAIL_EXIT_MAP>GET_DETAIL_EXIT_MAP method of the existing BAdI to transfer the customer-defined fields (that is, the content of the CI_DPR_IND_APPROVAL CI include for the current individual approval) to the appropriate row in the ET_IND_APPROVAL_EXTENSION_OUT table. Mapping ET_IND_APPROVAL and ET_IND_APPROVAL_EXTENSION_OUT then takes place in that sequence so that an individual approval has the same sequence number in both tables.

Note:

  • You can publish the customer-defined fields of an approval externally using the GET_DETAIL_EXIT_MAP method of the BAPIEXT_BUS2173_APP BAdI (parameter ES_EXTENSION_OUT of BAPI_BUS2173_APPR_GET_DETAIL or ApprovalGetDetail).
  • You can publish the customer-defined fields of an individual approval externally using the <DS:IO.IF_EX_BAPIEXT_BUS2173_APP GET_DETAIL_EXIT_MAP>GET_DETAIL_EXIT_MAP method of the almost identical BAdI BAPIEXT_BUS2173_IAPP (rows in table ET_IND_APPROVAL_EXTENSION_OUT of BAPI_BUS2173_APPR_GET_DETAIL or ApprovalGetDetail).

Requirements

Standard settings

  • The BAdI is not active in the standard system and there is no default code.
  • The BAdI is not filter-dependent and cannot be used more than once.

Activities

After you call the IMG activity, the system displays a dialog box where you enter a name for the implementation.

If implementations of this Business Add-In have already been created, the system displays them in a dialog box. You then choose one of them by choosing Create, and continue as follows:

  1. In the dialog box, enter a name for the implementation of the Add-In and choose Create.
    The system displays the initial screen for creating Business Add-In implementations.
  2. On this screen, enter a short description for your implementation in the Implementation Short Text field.
  3. If you choose the Interface tab, you will notice that the system has populated the Name of the Implementing Class field automatically, by assigning a class name based on the name of your implementation.
  4. Save your entries and assign the Add-In to a package.
  5. To edit a method, double-click its name.
  6. Enter your implementation code between the method <Interface Name>~<Name of Method>. and endmethod. statements.
  7. Save and activate your code. Navigate back to the Change Implementation screen.
    Note: You can also create an implementation for an Add-In and not activate it until later. If you want to do this, do not perform the following step:
  8. Choose Activate.
    When the application program is executed, the code you created is run through.

Example

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 
Maintenance Objects
Maintenance object type E   Business Add-In - Definition 
History
Last changed by/on SAP  20040205 
SAP Release Created in 310