Ansicht
Dokumentation
MSAM10_EQUIPMENT_CREATE - PM/CS: Create equipment
SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up Addresses (Business Address Services)This documentation is copyright by SAP AG.
Functionality
You use this method to create new equipment from a template equipment. Following are the functionalities provided:
- Copying of partners, classes, warranty and measuring points from the template equipment
- Add partners in addition to partners copied from the template equipment
- Update characteristics values for the classes copied from the template equipment
- Update user status for the user status profile assigned to the equipment category in the PM customizing
- Create Address
- Create attachments
Technical Note
- Error messages during processing are collected in the RETURN table
- Error messages during address create are converted into warning messages. This is done so that the middleware does not interpret that there is an error in equipment create. This is because equipment is created before the address create function is called and any error in address create does not affect the already created equipment.
Note
- To create a new equipment, following is the mandatory importing parameter:
- EQUIPMENT_HEADER - Equipment Header
- The fields TEMP_EQUI and EQTYP must be populated in the importing parameter EQUIPMENT_HEADER
- If the field EQTYP is not populated in the importing parameter EQUIPMENT_HEADER, then user creating the equipment must have been assigned an equipment profile in the authority object I_MSAM_PRF in the user's profile. The equipment profile can be created in customizing Define profile for equipment(transaction MSAM_EQTEMP). Only one equipment profile is to be assigned to a user
- To create equipment, business process business process Technical Objects and Master Data Createmust be active in customizing (Transaction MSAM_ACTBPRO)
- To create address for the equipment, business process Create/Change Address for Technical Objects must be active in customizing (Transaction MSAM_ACTBPRO)
Customer Enhancements
The BAPI wrapper customer enhancement concept allows customers to use additional data that was not planned for the interface. The Extension TABLES parameter acts as a data container where the additional values are transferred during import.
In addition to the extension parameters at the interface, BAdI (Business Add-Ins) will be provided in the method. This BAdI can be used to check the data that is transferred to the method by the customer, and perform additional processing activities.
Available BAdIs
- BADI_EAM_MSAM_EQUIPMENT: Customer BAdI for Equipment Object
- BAdI method EQUIPMENT_CREATE_PREPROCESS can be used to perform preprocessing of the data before the standard logic is called. If the standard logic is to be skipped then the importing parameter LV_SKIP_STANDARD is to be set.
- BAdI method EQUIPMENT_CREATE_OUTBOUND can be used by the customer to perform outbound processing after the standard logic.
- BADI_EAM_MSAM_TECHOBJ_ADDR: Customer BAdI to Create Address for Technical Objects
- Standard implementation BADI_EAM_MSAM_IMPL_TECHOBJ_ADD is provided to create address for the technical object. Customer can enhance the address create functionality if there is a requirement
Example
Notes
Further information
Parameters
CE_EXTENSIONEQUIPMENT_ATTACHMENT
EQUIPMENT_CLASS
EQUIPMENT_CLASSVAL
EQUIPMENT_CONTRACTS
EQUIPMENT_HEADER
EQUIPMENT_INST_EQUIS
EQUIPMENT_MEAS_POINTS
EQUIPMENT_NOTIF_HIST
EQUIPMENT_ORDER_HIST
EQUIPMENT_PARTNERS
EQUIPMENT_USER_STATUS
EQUIPMENT_WARRANTY
EQUNR
INSTALLATION_CHANGE
RETURN
USER
WSAP_EXTENSION
Exceptions
Function Group
MSAM_MOREP_EQUIPMENTABAP Short Reference SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up
This documentation is copyright by SAP AG.
Length: 4808 Date: 20240603 Time: 225810 sap01-206 ( 81 ms )