Hierarchy
EA-APPL (Software Component) SAP Enterprise Extension PLM, SCM, Financials⤷
PM-EQM-CC (Application Component) Configuration Control⤷
DI_CCM (Package) Configuration Control
IMG Activity
| ID | BADI_CCM_INST_PROPSL | BAdI: Create Proposal for Installation Location |
| Transaction Code | S_KA5_12001076 | (empty) |
| Created on | 20010903 | |
| Customizing Attributes | BADI_CCM_INST_PROPSL | BAdI: Create Proposal for Installation Location |
| Customizing Activity | BADI_CCM_INST_PROPSL | BAdI: Create Proposal for Installation Location |
Document
| Document Class | SIMG | Hypertext: Object Class - Class to which a document belongs. |
| Document Name | BADI_CCM_INST_PROPSL |
This BAdI contains several methods to allow the generation of proposal values at installation. For the installation of equipments with IE4N it is possible to generate proposal values for both installation location and allowed material number.
DETERMINE_INSTALLATION_LOC
Input : IV_EQUNR (Equipment to be installed)
IV_TOP_TPLNR , IV_TOP_EQUNR (Physicial top object of actual configuration where equipment should be installed),
IV_AS_MAINTND_CONFIG ,IV_CONFIG_MGR
Output : ET_HOLES (List of found structure gaps)
Based on a given equipment, this method can be used to return proposal values for possible installation locations (structure gaps).
This BAdI contains several methods for generating default values during the installation. When installing equipment with transaction IE4N, default values for the installation location and the allowed material number can be generated.
DETERMINE_INSTALLATION_LOC
Input: IV_EQUNR (Equipment to be installed)
IV_TOP_TPLNR, IV_TOP_EQUNR (Physical top-level object of the actual configuration, where equipment can be installed)
IV_AS_MAINTND_CONFIG ,IV_CONFIG_MGR
Output: ET_HOLES (list of the structure gaps found)
Based on a particular piece of equipment, this method can be used to return default values for possible installation locations (structure gaps). IV_AS_MAINTND_CONFIG Output: EV_EQUNR, ET_VALID_PARTS (list of the material numbers allowed)
Based on a particular structure gap (IV_STPLNR or IV_SEQUNR+IV_POSNR), you can use this mthod to return a list of the valid material numbers as default for the installation (Under Use of the Data Structure from MPL nodes)
DISPLAY_PROPOSAL_VALUES
Input: IT_MPL_NODES (Table of the MPL nodes)
Output: RV_MATNR_SELECTED (a particular material number)
If the selection of the possible material numbers (see DETERMINE_VALID_PART) was not unique, you can use this method to implement a logic to restrict the select to exactly one material number. The values resulting from this are transferred directly to the screen.
ACTIVATE_INSTLOC_BTN / ACTIVATE_VPARTS_BTN
By implementing this method you can control whether the pushbuttons that trigger the generation of the default values should be visible or not.
Example
Requirements
Standard settings
The BadI will be delivered with a SAP default implementation that ensures complete integration with the configuration control functionality / processes.
DETERMINE_INSTALLATION_LOC
For any given equipment the system first tries to find exactly one structure gap where the removed object is equal to equipment to be installed . This will cover the closed loop-scenario, where the same equipment is installed into same location again. An additional check is performed when the top element of the configuration is entered by the user to ensure that only structure gaps are used from the same technical structure (e.g. aircraft).
This first search will only return successful in case it finds exactly one gap for the equipment .
Otherwise (none or more gaps) the system proceeds with a second check.
Here, all gaps in the allowed configuration (given by top element) are searched, for which the FID is equal to the FID value from the equipment to be installed. This should support the open-loop scenario, where different parts are used as replacements. The FID approach will make sure that only valid locations are returned for which the equipment can be used.
IF exactly one gap is found the system will return this directly. If multiple gaps are found the system will pass on the table of gaps to the method �DISPLAY_HOLE_SELECTION� for further selection.
If no gap is found, the 3rd check is executed which searches for all structure gaps with the same material number then the one from the equipment to be installed.
The rest of the logic is the same as above.
DISPLAY_HOLE_SELECTION
This method has the intention to return one specific structure gap out of a list of several gaps. Within the IE4N installation process it is called automatically after the DETERMINE_INST_LOCATION method when the structure gap selection is not unique.
By default, this method sends a popup (F4-Search help-technique) with all table entries, so that the user can select one for later processing, however other implementations using other techniques (e.g. always use the first found gap without manual user selection) are possible.
DETERMINE_VALID_PART
For any given installation location (structure gap) specified by superior object ( tplnr, equnr, posnr ) the system calls an MPL service method to retrieve all allowed (valid) parts for that location . Precondition for the valid parts service is that at least one structure gap exists for the location and that this gaps has a FID and material number assigned.
With FID and material number the MPL function is able to determine a list of valid parts.
DISPLAY_PROPOSAL_VALUES
This method has the intention to return one specific material number out of a list of several materials. Within the IE4N installation process it is called automatically after the DETERMINE_VALID_PART method when the material selection is not unique.
By default, this method sends s popup (F4-Search help-technique) with all table entries, so that the user can select one entry for later processing, however other implementations using other techniques (e.g. always use the first found material without manual user selection) are possible.
ACTIVATE_INSTLOC_BTN / ACTIVATE_VPARTS_BTN
These two methods control whether the buttons on the installation screen should be displayed or not. In the default implementation they are only visible when a FID value is found for the equipment ( for the INSTLOC_BTN) or the structure gap (for the VPARTS_BTN).
Recommendation
Activities
Further notes
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 |
Assigned Application Components
| Documentation Object Class | Documentation Object Name | Current line number | Application Component | Application Component Name |
|---|---|---|---|---|
| SIMG | BADI_CCM_INST_PROPSL | 0 | HLA0006642 O | |
| SIMG | BADI_CCM_INST_PROPSL | 1 | ALR0000082 | Basic Data |
Maintenance Objects
| Maintenance object type | E | Business Add-In - Definition |
History
| Last changed by/on | SAP | 20030626 |
| SAP Release Created in | 46C2 |
