Fonction SAP BAPI_IE4N_DISMANTLE - Equipment Dismantling with Goods Movement, Notification, and CCM

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
IS_DATA_GOODS_MOVEMENT BAPI_IE4N_GOODS_MOVEMENT u 441 X BAPI for IE4N: Goods Movement Data
IS_DATA_NOTIFICATION BAPI_IE4N_NOTIFICATION u 29 X Notification Data for Equipment Installation/Dismantling with Goods Movement
I_DISM_DATE BAPI_ITOB_EQ_INSTALL_EXT-INST_DATE D 8 Dismantling Date
I_DISM_TIME BAPI_ITOB_EQ_INSTALL_EXT-INST_TIME T 6 Time at which the InstallLoc of the equipment was changed
I_EQUIPMENT BAPI_ITOB_PARMS-EQUIPMENT C 18 X Equipment Number
I_FORCED_DISMANTLE BAPIFLAG-BAPIFLAG C 1 SPACE X Forced Dismantling
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_SERIALNUMBER BAPI_ITOB_EQ_ONLY-SERIALNO C 18 X Serial Number
I_SIMULATION BAPIFLAG-BAPIFLAG C 1 X Checkbox

Paramètre Reférence Long. Facultatif Description
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 dismantling function to transaction IE4N withoutan interface being processed.
An item of equipment can be dismantled at its superior item of equipmentor technical location using this function module. The equipment must bea serial number.
The configuration control checks whether the dismantling is allowed. Astructure gap is created at the installation position if required.
A goods movement of the material to the warehouse is carried out duringthe dismantling.
A maintenance notification is created to document the dismantling.

Notes
An update is triggered within the function module, that is, eachequipment dismantling is updated immediately. An update is not triggeredin 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.
Customer-specific fields can be transferred to the module using theimport table EXTENSION_IN. 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 there are errors, the table also contains 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.

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.
Use the table IT_LONGTEXT to create a long text for the installationnotification.

Default
None

Description
Date on which the equipment is due to be dismantled.

Default
None

Description
Time at which the equipment is due to be dismantled.

Default
None

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

Default
None

Description
If this indicator is set, the relevant technical object has beendismantled despite a CCM validation error.

Value range
'X' and SPACE

Default
Not set

Description
Material number of the equipment being dismantled. 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
Serial number of the equipment being dismantled. 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 dismantling of the equipment is simulated.No actual changes 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 supported for the notification header,that is, 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 had not been saved.