Ansicht
Dokumentation
BADI_MPE_CIMA_AO_QV - BAdI: Extension of Quick View Details for Analysis Objects
TXBHW - Original Tax Base Amount in Local Currency BAL Application Log DocumentationThis documentation is copyright by SAP AG.
You can use this Business Add-In (BAdI) to define and implement custom fields for the quick view, which is available for analysis objects when you display the network graph in the change impact analysis.
Specifically, you can use this BAdI to:
- Add custom fields to the quick view of SAP-delivered analysis objects
- Define and implement quick view fields for custom analysis objects
The BAdI interface has the following methods:
- GET_AOBJ_CSTM_FLD_STRUCTURE: This method retrieves the quick view structure name for custom analysis objects.
- Note: For SAP-delivered objects, the customizable quick view structures and table types are predefined.
- This method has the changing parameter CV_STRUCT_NAME, which is used to return the name of the quick view structure for custom analysis objects.
- Since the quick view structure is mapped to the analysis object using the field OBJ_KEY (of type MPE_CIMA_AOBJ_KEY_TYP), it is mandatory to include this field in any custom object quick view structure. This field contains the concatenated object key for an analysis object.
- GET_AOBJ_QUICK_VIEW_ADDL_DETS: This method retrieves additional object details for the quick view and enters the data into the quick view table type for the analysis object.
- Note: For SAP-delivered objects, this table type is predefined and must be used to fill the data and return the result. This table type contains the analysis object’s key fields, which are passed to the BAdI for retrieval of the data.
- For custom analysis objects, a table type with the row type of the structure being returned by the GET_AOBJ_CSTM_FLD_STRUCTURE must be defined and used to retrieve and fill the data and return the result. The mapping from this table to the analysis result is done using the field OBJ_KEY, which contains the concatenated object key. For this reason, you must consider these recommendations regarding the quick view structure for custom objects.
- This method has the changing parameter CT_ANALYSIS_OBJECT, which is the table used to fill the data for the quick view.
- The table has the following structure:
Object Key Field(s) | Custom Field1 | Custom Field 2 | Custom Field 3...n |
---|---|---|---|
(filled by the | (to be filled | (to be filled | (to be filled |
calling method) | in the method) | in the method) | in the method) |
To use this BAdI, you must consider the following:
- The analysis object types must be defined in Customizing for Production under Manufacturing for Production Engineering and Operations -> Production Engineering -> Change Impact Analysis.
- The analysis object must be part of the result.
- For SAP-delivered objects, the quick view structures delivered by SAP must be extended and used.
- For custom analysis objects, the quick view structure must have the OBJ_KEY field of type MPE_CIMA_AOBJ_KEY_TYP. This field holds the concatenated object key and is used to map the quick view information to the analysis result. The table type must contain the same structure as this row type and used to fill the data.
- When defining custom fields in the quick view structures, you must ensure that you include appropriate labels for the data elements used to define the fields, because the labels in the quick view are retrieved from the large or medium field labels of these data elements.
This BAdI is designed for is a multiple use BAdI. It has a filter OBJ_TYPE, which means that you can create implementations for different analysis object types.
You define analysis object types in Customizing for Production under Manufacturing for Production Engineering and Operations -> Production Engineering -> Change Impact Analysis.
For SAP delivered analysis objects, the predefined structures to be extended and used for each of the analysis objects are as follows:
Analysis Object Type | Analysis Object Description | Structure to Be Enhanced | Table Type to Be Used for Information Retrieval | |
---|---|---|---|---|
EBOM | Engineering Bill of Material | MPES_CIMA_EBOM_ADDL_DETL_INCL | MPET_CIMA_EBOM_BADI_ADDL_DETL | |
MBOM | Manufacturing Bill of Material | MPES_CIMA_MBOM_ADDL_DETL_INCL | MPET_CIMA_MBOM_BADI_ADDL_DETL | |
PBOM | Planning Bill of Material | MPES_CIMA_PBOM_ADDL_DETL_INCL | MPET_CIMA_PBOM_BADI_ADDL_DETL | |
ROU | Routing | MPES_CIMA_ROU_ADDL_DETL_INCL | MPET_CIMA_ROU_BADI_ADDL_DETL | |
NETW | Network | MPES_CIMA_NETW_ADDL_DETL_INCL | MPET_CIMA_NETW_BADI_ADDL_DETL | |
PRO | Production Order | MPES_CIMA_PRO_ADDL_DETL_INCL | MPET_CIMA_PRO_BADI_ADDL_DETL | |
PUO | Purchase Order | MPES_CIMA_PUO_ADDL_DETL_INCL | MPET_CIMA_PUO_BADI_ADDL_DETL | |
PMI | Product Manufacturing Information | MPES_CIMA_PMI_ADDL_DETL_INCL | MPET_CIMA_PMI_BADI_ADDL_DETL |
Proceed as follows:
- Extend the structure named under Structure to Be Enhanced to include custom fields for each object type.
- Implement the BAdI giving the object type as the filter value.
- In the BAdI implementation class, implement the method GET_AOBJ_QUICK_VIEW_ADDL_DETS. The changing parameter CT_ANALYSIS_OBJECT has the key fields relevant to the respective analysis object passed from the calling method. Use it to retrieve the custom additional information for the analysis objects and fill the same parameter.
- This additional information passed back is combined with the pre-delivered additional information for the analysis object by the calling method and is used to build the quick view in the network graph of the change impact analysis.
For custom analysis objects, proceed as follows:
- Create your own DDIC structure that groups together the quick view fields relevant for the custom analysis object.
- Note: You must include a field OBJ_KEY, which holds the concatenated object key of the analysis object. This field is of type MPE_CIMA_AOBJ_KEY_TYP. It is required to map the additional quick view information to the analysis result.
- Create a table type with this structure as the row type.
- Implement the BAdI using the object type as the filter value.
- In the BAdI implementation class, implement the method GET_AOBJ_CSTM_FLD_STRUCTURE and fill the parameter CV_STRUCT_NAME with the quick view structure.
- In the BAdI implementation class, implement the method GET_AOBJ_QUICK_VIEW_ADDL_DETS with the logic to retrieve the additional information for each analysis object key passed by the calling method in the field OBJ_KEY. This information can be passed back to the calling method in the parameter CT_ANALYSIS_OBJECT. This additional info is mapped to the analysis result and used to build the quick view in the network graph of the change impact analysis.
Example class for analysis object additional details: CL_MPE_CIMA_AOBJ_ADDL_DETS_EXM,,
Vendor Master (General Section) RFUMSV00 - Advance Return for Tax on Sales/Purchases
This documentation is copyright by SAP AG.
Length: 10004 Date: 20240524 Time: 001021 sap01-206 ( 132 ms )