SAP Function BAPI_IE4N_INSTALL - Equipment Installation with Goods Movement, Notification, and CCM

Parameter Reference Type Length Default Optional Text
IS_DATA_GOODS_MOVEMENT BAPI_IE4N_GOODS_MOVEMENT u 441 X BAPI for IE4N: Goods Movement Data
IS_DATA_INSTALL BAPI_ITOB_EQ_INSTALL_EXT u 76 Installation Data
IS_DATA_NOTIFICATION BAPI_IE4N_NOTIFICATION u 29 X Notification Data for Equipment Installation/Dismantling with Goods Movement
I_EQUIPMENT BAPI_ITOB_PARMS-EQUIPMENT C 18 X Equipment Number
I_FORCED_INSTALL BAPIFLAG-BAPIFLAG C 1 SPACE X Forced Installation
I_MATERIAL BAPI_ITOB_EQ_ONLY-MATERIAL C 18 X Material Number
I_MATERIAL_EVG BAPIMGVMATNR u 82 X BAPI Structure for Transfer of External Material No, Ver.,
I_NO_MATERIAL_MOVEMENT BAPIFLAG-BAPIFLAG C 1 X CCM: Material Movement (`X': No Mvmt, ' ': with Mvmt)
I_NO_MPL_LOCAL_CHECK BAPIFLAG-BAPIFLAG C 1 X MPL Flag: ' ' - Execute MPL Check; 'X' - No Check
I_SERIALNUMBER BAPI_ITOB_EQ_ONLY-SERIALNO C 18 X Serial Number
I_SIMULATION BAPIFLAG-BAPIFLAG C 1 X Simulation Mode

Parameter Reference Length Optional Text
EXTENSION_IN BAPIPAREX 990 X Reference Structure for BAPI Parameters EXTENSIONIN/EXTENSIONOUT
IT_LONGTEXT BAPI2080_NOTFULLTXTI 152 X Notification Long Text
RETURN BAPIRET2 548 Return Parameter(s)

Functionality
This BAPI provides the installation function to transaction IE4N withoutan interface being processed.
Using this function module, an item of equipment can be installed inanother item of equipment or technical location. The equipment must be aserial number.
The configuration control checks if the installation is allowed, or ifthere is a structure gap at the installation position. The structure gapis deleted by the installation.
A goods movements of the material from the warehouse is carried outduring the installation.
A maintenance notification is created to document the installation.

Notes
An update is triggered within the function module, that is, eachequipment installation is updated immediately. An update is not tri
ggered in simulation mode (import parameter I_SIMULATION).
A long text for the maintenance notification being created can bedefined in table IT_LONGTEXT. Only one long text is supported for thenotification header, therefore the OBJTYPE field must contain the valueQMEL. The OBJKEY field must be initial.
Using the import table EXTENSION_IN, customer-specific fields can betransferred to the module. The fields must then be entered in therelevant structures using the MODIFY_DATA method in the BAdIBAPI_IE4N_EXTEND. Other customer enhancements and checks can also beimplemented in this method. Note that no dialogs are processed in themethod, however.
All messages that accumulate during processing are returned in tableRETURN. If errors occur, the table also stores the relevant errormessages.

Further information
For more information, see the online documentation for transaction IE4N.

Description
The data required to perform the goods movement in the installation istransferred in this structure.
Certain fields (such as SPEC_STOCK) are not used for the installation.

Default
None

Description
This structure is used to specify the installation location, theinstallation position, and the time at which the installation is due tobe carried out.

Default
None

Description
The data required to create a notification is transferred in thisstructure.
If a notification number is specified, the relevant notification ismodified, otherwise a new notification is created.
The fields DISM_PLANNED, DISM_UNPLANNED, PART_SERVICEABLE, PART_DEFECT,and PART_UNDEFINED are not used for equipment installation.
Use the table IT_LONGTEXT to create a long text for the installationnotification.

Default
None

Description
Number that uniquely identifies the equipment tobe installed.
The equipment must be a serial number. Alternatively, the materialnumber and the serial number can be specified.

Default
None

Description
If this indicator is set, the relevant equipment has been installeddespite validation errors in the configuration control.

Value range
'X' and SPACE

Default
Not set

Description
Material number of the equipment being installed. The combination ofmaterial number and serial number uniquely identifies the equipment.
Alternatively, the equipment number can be entered directly.

Default
None

Description
Parameter for long material number
You can use this parameter to transfer long material numbers, with amaximum length of 40 characters.
Before you can use this parameter, you must switch on the switch forbusiness function LAMA (long material number) in the system.
Business function LAMA is available as part of the business function setfor DIMP.

Value range
None

Default
None

Description
You can use this field to determine whether or not a goods movementtakes place when the equipment is dismantled.

Value range
'X' and SPACE

Default
Not set

Description
You can use this parameter to deactivate the planned structure (masterpart list).

Value range
'X' and SPACE

Default
Not set

Description
Serial number of the equipment being installed. The combination ofserial number and material number uniquely identifies the equipment.
Alternatively, the equipment number can be entered directly.

Default
None

Description
If this indicator is set, the equipment installation is simulated. Nochanges are made.

Value range
'X' and SPACE

Default
Not set

Description
Additional fields can be transferred to the BAPI using this table.
The fields can be processed using the BAdI methodBAPI_IE4N_EXTEND->MODIFY_DATA.

Default
Empty

Description
The lines of the notification long text are specified in the table.
Long texts are currently only created for the notification header, thatis, the OBJTYPE field must contain the value 'QMEL', and the OBJKEYfield must be initial.

Default
None

Description
Return table based on BAPI standard containing all messages generatedduring processing. If there are category E or A messages, this meansthat the data has not been saved.