חזרה ל-BAPIs / FMsלא נשמר מסלול הגעה בביקור הזה

BAPI · PM · CS

BAPI_ALM_NOTIF_CREATE

יצירת הודעת אחזקה (PM/CS) בבאפר העדכון — מקבל מספר זמני.

Create a PM/CS maintenance notification in the update buffer (returns a temporary number).

אומת מול תיעוד SAPמתועד לעומקPM · אחזקההודעותיצירהבינונישלמות הרשומה 11/12 שדות מאומתים ברשומה

S/4HANA

זמין ב-S/4HANA. חלופה: OData API_MAINTENANCENOTIFICATION / Fiori "Manage Notifications".

אומת מול תיעוד SAPקיימת אמירת S/4 ברשומה

מה כתוב במאגר על S/4HANA: זמין ב-S/4HANA. חלופה: OData API_MAINTENANCENOTIFICATION / Fiori "Manage Notifications".
מה כתוב על ECC: זמין ב-ECC.
זמינות לפי הרשומה: ECC — כן
S/4HANA On-Premise — כן
S/4HANA Cloud — לא צוין במאגר
יציבות הממשק: Released: ממשק משוחרר

מעמד הטבלאות הקלאסיות שהרשומה נשענת עליהן

מה זה ומתי

מה האובייקט עושה: יצירת הודעת אחזקה (Maintenance Notification) — סוג הודעה, אובייקט ייחוס, תיאור תקלה.
מתי משתמשים בו: פתיחת תהליך אחזקה (PM). שלב ראשון לתיעוד תקלה/בקשה. בשילוב BAPI_ALM_NOTIF_DATA_ADD ו-..._SAVE. QA בודק קודי קטלוג, אובייקט ייחוס וסטטוס.
תרחיש עסקי: מערכת חיצונית יוצרת הודעת אחזקה ב-SAP — למשל אפליקציה ניידת בשטח או חיישן IoT שמזהה תקלה במשאבה ופותח הודעה אוטומטית.
מיקום בתהליך: Malfunction → Notification → (Items/Causes) → Order
הודעת אחזקה
פקודת אחזקה
תכנון
דיווח
תנועת סחורה
סילוק
סוג פעולה: יצירה
תחום תהליכי: הודעות אחזקה
הקשרי שימוש: אפליקציית אחזקה ניידת
התראת IoT / חיישן מפעל
אינטגרציית PI/PO
REST/OData דרך Middleware

חוזה הקריאה

פרמטרים נכנסים: NOTIF_TYPE (חובה): סוג הודעה (M1/M2/M3)
NOTIFHEADER: אובייקט ייחוס (EQUIPMENT/FUNCTLOC), תיאור קצר
פרמטרים יוצאים: NOTIFHEADER_EXPORT — מספר ההודעה שנוצרה (זמני עד SAVE)
RETURN — טבלת הודעות BAPIRET2 — בדוק TYPE='E' לשגיאה. חובה לקרוא BAPI_TRANSACTION_COMMIT לאחר הצלחה.
תקציר פרמטרים: IMP EXTERNAL_NUMBER · NOTIF_TYPE · NOTIFHEADER · TAB NOTITEM · NOTIFCAUS · NOTIFACTV · NOTIFTASK · NOTIFPARTNR · RETURN
COMMIT: כן
נדרשת קריאת SAVE: כן
Remote-Enabled (RFC): כן
רצף קריאה: BAPI_ALM_NOTIF_CREATE
BAPI_ALM_NOTIF_DATA_ADD / DATA_MODIFY / DATA_DELETE
BAPI_ALM_NOTIF_PUTINPROGRESS / CHANGEUSRSTAT / CLOSE
BAPI_ALM_NOTIF_SAVE
BAPI_TRANSACTION_COMMIT
שלד ABAP: DATA: ls_hdr TYPE bapi2080_nothdri, ls_exp TYPE bapi2080_nothdre, lt_ret TYPE STANDARD TABLE OF bapiret2. ls_hdr-short_text = 'Pump vibration'. CALL FUNCTION 'BAPI_ALM_NOTIF_CREATE' EXPORTING notif_type = 'M1' notifheader = ls_hdr IMPORTING notifheader_export = ls_exp TABLES return = lt_ret. CALL FUNCTION 'BAPI_ALM_NOTIF_SAVE' IMPORTING notifheader = ls_exp TABLES return = lt_ret. CALL FUNCTION 'BAPI_TRANSACTION_COMMIT' EXPORTING wait = 'X'.

אובייקטים, טבלאות וטרנזקציות

אובייקט עסקי (BOR): BUS2038
טבלאות שהאובייקט נוגע בהן: QMEL
QMFE
QMMA
QMSM
QMUR
טרנזקציות: IW21
IW22
IW23
IW28
IW29
אובייקטי הרשאה: I_QMEL
I_SWERK
I_INGRP
I_BEGRP
טרנזקציות ברשומה המורחבת: IW21
IW22

הפעלה ובדיקה

לפני שמשתמשים: סוג ההודעה (NOTIF_TYPE) קיים ומוגדר ב-Customizing
ציוד / מיקום פונקציונלי קיים (אם משויך)
מפעל תכנון + קבוצת מתכננים תקפים
הרשאה I_QMEL לסוג ההודעה
חיבור RFC stateful לשיתוף הבאפר בין הקריאות
תלויות: סוג הודעה (SPRO)
Catalog Profile
ציוד/מיקום פונקציונלי
מה לבדוק: יצירת M1 עם ציוד
הוספת פריט/סיבה דרך DATA_ADD
שמירה דרך NOTIF_SAVE
תרחיש בדיקה: צור M1 לציוד EQUI, הוסף פריט, קרא NOTIF_SAVE+COMMIT, ודא QMEL.

תקלות ואבחון

שגיאות נפוצות: IW 034 — סוג הודעה לא קיים
IW 215 — ציוד/מיקום לא נמצא
00 344 — הרשאה חסרה
Catalog Profile חסר לסוג הודעה
אובייקט ייחוס לא קיים
שכחת NOTIF_SAVE+COMMIT
טעויות מימוש: שכחת BAPI_TRANSACTION_COMMIT — ההודעה לא נשמרת
חיבור RFC לא-stateful → הבאפר לא משותף בין CREATE ל-SAVE
עדכון סטטוס מערכת ישירות במקום BAPI_ALM_NOTIF_CHANGEUSRSTAT
התעלמות מטבלת RETURN (TYPE=E/A)
סיבות שורש: Customizing חסר לסוג ההודעה
הרשאה I_QMEL חסרה
הבאפר לא נשמר (SAVE/COMMIT)
חיבור RFC לא-stateful
איך לאבחן: נקודת עצירה ב-BAPI_ALM_NOTIF_SAVE; בדוק EXPORT NOTIFHEADER + טבלת RETURN; SLG1 ליומן יישום.
טבלאות לאבחון: QMEL
QMFE
QMUR
QMSM

מורכבות מימושבינוני

רמה: בינוני
מדוע: דורש BAPI_TRANSACTION_COMMIT
כותב/משנה נתונים עסקיים
תלות חוצת-מודולים (PM + CS)
רצף קריאה רב-שלבי (5 שלבים)
מורכבות הרשאות
דורש הכנה/Customizing מוקדם
זמן לימוד מוערך: 20–45 דקות: נגזר ממודל המורכבות המתועד של הפרויקט, לא ממדידה.

להמשך קריאה

מקורות שהרשומה מפנה אליהם: עיבוד הודעות אחזקה
סוגי הודעות ו-Customizing
נתוני אב PM (ציוד ומיקומים)

מה זה ומתי

מה האובייקט עושה

יצירת הודעת אחזקה (Maintenance Notification) — סוג הודעה, אובייקט ייחוס, תיאור תקלה.

מתי משתמשים בו

פתיחת תהליך אחזקה (PM). שלב ראשון לתיעוד תקלה/בקשה. בשילוב BAPI_ALM_NOTIF_DATA_ADD ו-..._SAVE. QA בודק קודי קטלוג, אובייקט ייחוס וסטטוס.

תרחיש עסקי

מערכת חיצונית יוצרת הודעת אחזקה ב-SAP — למשל אפליקציה ניידת בשטח או חיישן IoT שמזהה תקלה במשאבה ופותח הודעה אוטומטית.

מיקום בתהליך

Malfunction → Notification → (Items/Causes) → Order

הודעת אחזקה
פקודת אחזקה
תכנון
דיווח
תנועת סחורה
סילוק

סוג פעולה

יצירה

תחום תהליכי

הודעות אחזקה

הקשרי שימוש

אפליקציית אחזקה ניידת
התראת IoT / חיישן מפעל
אינטגרציית PI/PO
REST/OData דרך Middleware

חוזה הקריאה

פרמטרים נכנסים

NOTIF_TYPE (חובה): סוג הודעה (M1/M2/M3)
NOTIFHEADER: אובייקט ייחוס (EQUIPMENT/FUNCTLOC), תיאור קצר

פרמטרים יוצאים

NOTIFHEADER_EXPORT — מספר ההודעה שנוצרה (זמני עד SAVE)
RETURN — טבלת הודעות BAPIRET2 — בדוק TYPE='E' לשגיאה. חובה לקרוא BAPI_TRANSACTION_COMMIT לאחר הצלחה.

תקציר פרמטרים

IMP EXTERNAL_NUMBER · NOTIF_TYPE · NOTIFHEADER · TAB NOTITEM · NOTIFCAUS · NOTIFACTV · NOTIFTASK · NOTIFPARTNR · RETURN

COMMIT

כן

נדרשת קריאת SAVE

כן

Remote-Enabled (RFC)

כן

רצף קריאה

BAPI_ALM_NOTIF_CREATE
BAPI_ALM_NOTIF_DATA_ADD / DATA_MODIFY / DATA_DELETE
BAPI_ALM_NOTIF_PUTINPROGRESS / CHANGEUSRSTAT / CLOSE
BAPI_ALM_NOTIF_SAVE
BAPI_TRANSACTION_COMMIT

שלד ABAP

DATA: ls_hdr TYPE bapi2080_nothdri,
      ls_exp TYPE bapi2080_nothdre,
      lt_ret TYPE STANDARD TABLE OF bapiret2.

ls_hdr-short_text = 'Pump vibration'.

CALL FUNCTION 'BAPI_ALM_NOTIF_CREATE'
  EXPORTING notif_type = 'M1' notifheader = ls_hdr
  IMPORTING notifheader_export = ls_exp
  TABLES    return = lt_ret.

CALL FUNCTION 'BAPI_ALM_NOTIF_SAVE'
  IMPORTING notifheader = ls_exp
  TABLES    return = lt_ret.

CALL FUNCTION 'BAPI_TRANSACTION_COMMIT' EXPORTING wait = 'X'.

הפעלה ובדיקה

לפני שמשתמשים

סוג ההודעה (NOTIF_TYPE) קיים ומוגדר ב-Customizing
ציוד / מיקום פונקציונלי קיים (אם משויך)
מפעל תכנון + קבוצת מתכננים תקפים
הרשאה I_QMEL לסוג ההודעה
חיבור RFC stateful לשיתוף הבאפר בין הקריאות

תלויות

סוג הודעה (SPRO)
Catalog Profile
ציוד/מיקום פונקציונלי

מה לבדוק

יצירת M1 עם ציוד
הוספת פריט/סיבה דרך DATA_ADD
שמירה דרך NOTIF_SAVE

תרחיש בדיקה

צור M1 לציוד EQUI, הוסף פריט, קרא NOTIF_SAVE+COMMIT, ודא QMEL.

תקלות ואבחון

שגיאות נפוצות

IW 034 — סוג הודעה לא קיים
IW 215 — ציוד/מיקום לא נמצא
00 344 — הרשאה חסרה
Catalog Profile חסר לסוג הודעה
אובייקט ייחוס לא קיים
שכחת NOTIF_SAVE+COMMIT

טעויות מימוש

שכחת BAPI_TRANSACTION_COMMIT — ההודעה לא נשמרת
חיבור RFC לא-stateful → הבאפר לא משותף בין CREATE ל-SAVE
עדכון סטטוס מערכת ישירות במקום BAPI_ALM_NOTIF_CHANGEUSRSTAT
התעלמות מטבלת RETURN (TYPE=E/A)

סיבות שורש

Customizing חסר לסוג ההודעה
הרשאה I_QMEL חסרה
הבאפר לא נשמר (SAVE/COMMIT)
חיבור RFC לא-stateful

איך לאבחן

נקודת עצירה ב-BAPI_ALM_NOTIF_SAVE; בדוק EXPORT NOTIFHEADER + טבלת RETURN; SLG1 ליומן יישום.

טבלאות לאבחון

QMEL
QMFE
QMUR
QMSM

מורכבות מימושבינוני

רמה

בינוני

מדוע

דורש BAPI_TRANSACTION_COMMIT
כותב/משנה נתונים עסקיים
תלות חוצת-מודולים (PM + CS)
רצף קריאה רב-שלבי (5 שלבים)
מורכבות הרשאות
דורש הכנה/Customizing מוקדם

זמן לימוד מוערך

20–45 דקות: נגזר ממודל המורכבות המתועד של הפרויקט, לא ממדידה.

זמין ב-S/4HANA. חלופה: OData API_MAINTENANCENOTIFICATION / Fiori "Manage Notifications".

מה זה ומתי

חוזה הקריאה

אובייקטים, טבלאות וטרנזקציות

הפעלה ובדיקה

תקלות ואבחון

מורכבות מימושבינוני

אובייקטים קשורים4 רשומות

להמשך קריאה

זמין ב-S/4HANA. חלופה: OData API_MAINTENANCENOTIFICATION / Fiori "Manage Notifications".

מה זה ומתי

חוזה הקריאה

אובייקטים, טבלאות וטרנזקציות

הפעלה ובדיקה

תקלות ואבחון

מורכבות מימושבינוני

אובייקטים קשורים4 רשומות

להמשך קריאה