Fonction SAP BAPI_IE4N_BOM_INSTALL - Installation of Equipment BOM Item with Goods Movemement, Notif., and CCM

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
BATCH BAPI_ITOB_EQ_ONLY-BATCH C 10 X Batch Number
BOM_HEADER_EQUIPMENT BAPI_ITOB_PARMS-EQUIPMENT C 18 X Equipment Number
BOM_HEADER_UII BAPI_IE4N_UII-UII C 72 X Unique Item Identifier
DATA_GOODS_MOVEMENT BAPI_IE4N_GOODS_MOVEMENT u 441 X BAPI for IE4N: Goods Movement Data
DATA_NOTIFICATION BAPI_IE4N_NOTIFICATION u 29 X Notification Data for Equipment Installation/Dismantling with Goods Movement
FUNCTION_IDENTIFIER BAPI_ITOB_EQ_ONLY-FUNC_ID C 40 X Function Identifier
INST_DATE BAPI_ITOB_EQ_INSTALL_EXT-INST_DATE D 8 SY-DATUM X Date on which installation location of equipment was changed
INST_POSITION BAPI_ITOB_EQ_INSTALL_EXT-INST_POS C 4 X Equipment position at InstallLoc (Superior Equip./FunctLoc)
INST_TIME BAPI_ITOB_EQ_INSTALL_EXT-INST_TIME T 6 SY-UZEIT X Time at which installation location of equipment was changed
MATERIAL BAPI_ITOB_EQ_ONLY-MATERIAL C 18 X Material Number
MATERIAL_EVG BAPIMGVMATNR u 82 X BAPI Structure for Transfer of External Material No, Ver.,
NO_MATERIAL_MOVEMENT BAPIFLAG-BAPIFLAG C 1 SPACE X No Goods Movement
NO_MPL_LOCAL_CHECK BAPIFLAG-BAPIFLAG C 1 SPACE X No Local Configuration Check
QUANTITY BAPI2017_GM_ITEM_CREATE-QUANTITY P 7 X Quantity
REFERENCE_ORDERID BAPI_IE4N_GOODS_MOVEMENT-REFERENCE_ORDERID C 12 X Order Number
SIMULATION BAPIFLAG-BAPIFLAG C 1 SPACE X Simulation
VALUATION_TYPE BAPI2017_GM_ITEM_CREATE-VAL_TYPE C 10 X Valuation type

Paramètre Reférence Long. Facultatif Description
EXTENSION_IN BAPIPAREX 990 X Reference Structure for BAPI Parameters ExtensionIn/ExtensionOut
LONGTEXT BAPI2080_NOTFULLTXTI 152 X Notification Long Text
RETURN BAPIRET2 548 Return Parameter(s)

Functionality
You use this function module to install a non-serialized material intothe BOM header of a piece of equipment without any user interactionrequired in transaction IE4N. The equipment must be defined as anequipment BOM header.
Configuration Control checks that the installation is allowed and alsowhether there is a structure gap at the installation position. Eitherthe structure gap is deleted by the installation, or the quantity of thestructure gap is decreased by the specified quantity.
If the material movement parameter in the BAPI interface is set, then agoods movement of the material from the warehouse is carried out duringinstallation. Installation without material movement is possible only inthe BAPI. Transaction IE4N does not support this function.
A maintenance notification is created to document the installation.

Notes
An update is triggered within the function module, that is, eachnon-serialized material installation is updated immediately. An updateis not triggered in simulation mode (import parameter SIMULATION).
A long text for the maintenance notification that is created can bedefined in the LONGTEXT table. Only one long text is supported for thenotification header. Therefore, the OBJTYPE field must contain the valueQMEL. The OBJKEY field must be initial.
Customer-specific fields can be transferred to the function module usingthe EXTENSION import table. The fields must then be entered in therelevant structures using the MODIFY_DATA method in 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 theMESSAGES table. If errors occur, the table also stores the relevanterror messages.
The ITEM_FUNCID interface contains an attribute that is not available intransaction IE4N. This attribute can specify the BOM item in theequipment BOM header if the BOM items used the same materials.

Further information
For more information about the installation of equipment, see SAPLibrary for SAP ERP Central Component on SAP Help Portal athttp://help.sap.com.

Description
Identifies the number of the batch from which the material is to beinstalled, if the material is batch managed.
For information on the definition of batch number, see the correspondingdata element documentation: CHARG_D.

Default
None

Description
Identifies the number of the piece of equipment into which the specifiedmaterial is to be installed.
For information on the definition of equipment number, see thecorresponding data element documentation: EQUNR.

Default
None

Description
Identifies the unique item identifier of the piece of equipment intowhich the specified material is to be installed.
For information on the definition of unique item identifier, see thecorresponding data element documentation:
UII_CHAR72.

Default
None

Description
This parameter contains the data required to perform the goods movementfor the installation. Certain fields such as SPEC_STOCK are not used.

Default
None

Description
This parameter contains the data required to create a notification. If anotification number is specified, the relevant notification is modified,otherwise a new notification is created. The fields DISM_PLANNED,DISM_UNPLANNED, PART_SERVICEABLE, PART_DEFECT, and PART_UNDEFINED arenot used for equipment installation. Use the table IT_LONGTEXT to createa long text for the installation notification.
INCLUDE BAPI_DATAELEMENT

Description
For information on the definition of function identifier, see thecorresponding data element documentation: CC
C_FUNCID.
If the material is used only in one BOM item, then it is not mandatory.

Default
None

Description
Specifies the date of the installation.
For information on the definition of date on which installation locationof equipment was changed, see the corresponding data elementdocumentation: INSTALLDAT.

Default
None

Description
Identifies the position at which the specified material is to beinstalled in the equipment BOM header.
For information on the definition of equipment position at installationlocation, see the corresponding data element documentation:INSTALLPOS.

Default
None

Description
Specifies the time of installation.
For information on the definition of Time at which the InstallLoc of theequipment was changed, see the corresponding data element documentation:INSTALLTIM.

Default
None

Description
Identifies the material number that uniquely identifies the material tobe installed.
For information on the definition of material number, see thecorresponding data element documentation: MATNR.

Default
None

Description
You use this field to determine whether or not a goods movement takesplace when the non-serialized material is installed.

Value range
'X' and SPACE

Default
SPACE

Description
You use this parameter to deactivate the local configuration check.

Value range
'X' and SPACE

Default
SPACE

Description
Identifies the quantity of the material to be installed under the BOMheader of a piece of equipment.

Default
None

Description
This parameter contains the order number, to reference the installation.In the processing a BAPI is called.
For information on the definition of Reference Order, see thecorresponding data element documentation: AUFNR.

Default
None

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

Value range
'X' and SPACE

Default
SPACE

Description
Identifies the valuation type of the material to be installed, if thematerial is valuated.
For information on the definition of valuation type, see thecorresponding data element documentation: BWTAR_D.

Default
None

Description
Additional fields can be transferred to the BAPI using this table.
The fields can be processed using the BAdI method MODIFY_DATA of BAdIBAPI_IE4N_EXTEND.

Default
Empty

Description
The lines of the notification long text are specified in this 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.