Ansicht
Dokumentation
MSAM10_NOTIFICATION_CREATE - PM/CS Notification Create
ABAP Short Reference rdisp/max_wprun_time - Maximum work process run timeThis documentation is copyright by SAP AG.
Functionality
You use this method to create a new maintenance or service notification. You can create certain fields from the notification header as well as items, causes, tasks, activities, user status and long texts for this. You can also maintain partner data. Attachment can also be created using this method.
If the Industry Solution Utilities (ISU) is enabled in the back end, then this method can be used to create new meter reading results and meter installations /replacements /removals for a new maintenance or service notification.
Notes
Errors are transferred in the RETURN table.
Technical note
To create a new maintenance or service notification, following are the mandatory parameters:,,
- NOTIFICATION_HEADER-NOTIF_TYPE,,
To create items, causes, tasks, or activities, the sort field must be filled.
When you create a cause, the sort field of the item must also be filled.
When you create a long text, the fields OBJTYP and OBJKEY must be filled. OBJTYP can have the following values:
- QMEL - Notification header
- QMFE - Notification item
- QMUR - Notification cause
- QMSM - Notification task
- QMMA - Notification action
OBJKEY must have the corresponding sort field for the values named above. The combination of sort field of item/cause, item/task and item/action must be unique within a notification. If you leave the sort field empty and the OBJTYP = QME, then a long text is created for the notification header.
Customer Enhancements
The BAPI wrapper customer enhancement concept allows customers to use additional data that was not planned for the interface. The ExtensionIn parameter acts as a data container where the additional values are transferred during import.
In addition to the extension parameters at the interface, there are BAdIs (Business Add-Ins) in the BAPI wrapper function module. These BAdIs can be used to check the data that is transferred to the method by the customer, and perform additional processing activities.
If the ISU is enabled in the back end, then the existing BAdIs in the applicable ISU function module(s) is called for the creation of new meter reading results, new meter installations / replacements / removals and new meter reading notes.
Available BAdIs
- BADI_EAM_MSAM_NOTIF - Customer BAdI for Notification Object
Example
Notes
Utilities-related processes may only be successfully invoked if the ISU is enabled in the backend, otherwise the ISU functionally will not be executed.
Special upload-only tables exist that are used for the execution of the utilities processes. The entries within these tables are considered creation requests and, with the exception of the meter replacement / removal, which does not affect any change to the existing data (that is, it is not possible to change or delete any existing meter reading results).
| ISU Process | Table Name |
|---|---|
| Meter Reading Notes* | NOTIF_ISU_MTR_RDNG_NOTE |
| Meter Reading Results | NOTIF_ISU_MR_RESULT |
| Meter Installations/Replacements/Removals | NOTIF_ISU_MTR_REPL |
| NOTIF_ISU_MTR_REPL_DEVICE | |
| NOTIF_ISU_MTR_REPL_REGISTER | |
| NOTIF_ISU_MTR_REPL_TRANSFORMER |
Further information
BAdIs available for ISU only:
- BADI_ISU_MSAM_MR_NOTE - MSAM: ISU Customer BAdI for Meter Reading Note
- BADI_ISU_MSAM_MR_RESULT - MSAM: ISU Customer BAdI for Meter Reading Result
- BADI_ISU_MSAM_METER_REPL - MSAM: ISU Customer BAdI for Meter Installation /Replacement /Removal
Parameters
ATTACHMENTCE_EXTENSION
NOTIFICATION_HEADER
NOTIF_ACTIVITY
NOTIF_CAUSE
NOTIF_ISU_MR_RESULT
NOTIF_ISU_MTR_RDNG_NOTE
NOTIF_ISU_MTR_REPL
NOTIF_ISU_MTR_REPL_DEVICE
NOTIF_ISU_MTR_REPL_REGISTER
NOTIF_ISU_MTR_REPL_TRANSFORMER
NOTIF_ITEM
NOTIF_LONGTEXT
NOTIF_NO
NOTIF_PARTNER
NOTIF_TASK
NOTIF_USER_STATUS
RETURN
USER
WSAP_EXTENSION
Exceptions
Function Group
MSAM_MOREP_NOTIFICATIONBAL Application Log Documentation Vendor Master (General Section)
This documentation is copyright by SAP AG.
Length: 5162 Date: 20240523 Time: 061138 sap01-206 ( 84 ms )
