מרכז BAPI / FM PMBAPI_ALM_ORDER_MAINTAIN

BAPI_ALM_ORDER_MAINTAIN

Released BAPIRFCPMפקודות עבודהשינוי

מאומת בתיעוד SAPמורכבReleased APIדורש COMMITBOR: BUS2007

Maintenance Order

שאל AI

אמון ואימות

רמת האמון והמקור — שקוף לחלוטין

מאומת בתיעוד SAPודאות: גבוהה

מקור אימות: SAP Help Portal — verified 2026-07-15
אומת לאחרונה: 2026-07-15
שיטת אימות: מקור SAP מאוחסן

לא ממציאים מספרי SAP Note או מקורות. סטטוס «מאומת» מוצג רק כאשר מקור אמיתי מאוחסן ברשומה.

רמת מורכבות — כיצד חושבה

מחושב מכללים מתועדים · אינו שיפוט איכות או חשיבות

מורכבזמן למידה משוער: 60–120 דק׳

הסיבות לרמה זו:

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

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

התנהגות COMMIT

שמירה, ROLLBACK וטיפול ב-RETURN

לאחר קריאה מוצלחת יש לבצע BAPI_TRANSACTION_COMMIT כדי לשמור את השינוי במסד הנתונים. ה-BAPI עצמו אינו שומר.

1קרא את ה-BAPI עם נתוני הקלט
2בדוק את טבלת RETURN (BAPIRET2) — TYPE='E'/'A' מציין שגיאה
3אם אין שגיאה → קרא BAPI_TRANSACTION_COMMIT (עם WAIT='X' לסנכרון)
4אם יש שגיאה → קרא BAPI_TRANSACTION_ROLLBACK

טעות נפוצה: שכחת COMMIT — ה-RETURN נראה תקין אך השינוי לא נשמר (מתגלה רק כשהנתון חסר בהמשך).

תאימות ECC ↔ S/4HANA

אין להניח שאובייקט מתנהג זהה ב-S/4HANA

ECC

נתמך

S/4 On-Prem

נתמך

S/4 Private

נתמך

S/4 Public

לא ידוע

דורש SAVE לפני COMMITדורש BAPI_TRANSACTION_COMMITReleased · RFCRFC-enabled

מה זה?

יצירה/שינוי הזמנת אחזקה (PM) בשיטת methods table — Header/Operation/Component/Status בקריאה אחת. דורש COMMIT. מקבילת API ל-IW31/IW32.

Create/change a maintenance order (PM) via a methods table — header/operation/component/status in one call. Requires COMMIT. API equivalent of IW31/IW32.

למה קיים ומתי להשתמש

מערכת CMMS/נייד יוצרת פקודת אחזקה מהודעה, מוסיפה פעולות ורכיבים, משחררת ומדווחת — הכול דרך קריאה אחת מונחית-מתודות.

תרחישי שימוש טיפוסיים

CMMS / אפליקציה ניידתאינטגרציית PI/PO / RESTיצירת פקודות אצווה מ-MRP

מתי לא להשתמש · מלכודות

שכחת שורת SAVE ב-IT_METHODS → שום דבר לא נשמר
שכחת BAPI_TRANSACTION_COMMIT
ערבוב objecttype שגוי ב-IT_METHODS
התעלמות מ-RETURN לפני ה-SAVE

ממשק ופרמטרים

IN: IT_METHODS + IT_HEADER/IT_OPERATION/IT_COMPONENT · OUT: RETURN, ES_HEADER (order number).

SAVE נדרשRETURN (BAPIRET2) + COMMIT

דוגמת ABAP בטוחה

טיפול ב-BAPIRET2 · COMMIT / ROLLBACK

DATA: lt_methods TYPE TABLE OF bapi_alm_order_method,
      lt_header  TYPE TABLE OF bapi_alm_order_headers_i,
      lt_return  TYPE TABLE OF bapiret2,
      lt_numbers TYPE TABLE OF bapi_alm_numbers.

APPEND VALUE #( refnumber = '1' objecttype = 'HEADER' method = 'CREATE' ) TO lt_methods.
APPEND VALUE #( refnumber = '1' objecttype = ''       method = 'SAVE'   ) TO lt_methods.
APPEND VALUE #( orderid = '%00000000001' order_type = 'PM01' planplant = '1000' ) TO lt_header.

CALL FUNCTION 'BAPI_ALM_ORDER_MAINTAIN'
  TABLES it_methods = lt_methods it_header = lt_header
         return = lt_return et_numbers = lt_numbers.

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

אובייקטים קשורים

טרנזקציות

IW31 IW32 IW38

טבלאות

AUFK AFIH AFVCAFVVRESB

הרשאות

I_AUARTI_IWERKI_INGRPI_BEGRP

BAPIs / FMs קשורים

BAPI_ALM_ORDER_GET_DETAILהצגת פרטי הזמנת אחזקה (כותרת, פעולות, רכיבים, עלויות). קריאה בלבד (RFC).BAPI_ALM_CONF_CREATEדיווח פעולה בהזמנת אחזקה (PM) — זמנים/פעילויות. דורש COMMIT. מקבילת API ל-IW41.BAPI_ALM_NOTIF_CREATEיצירת הודעת אחזקה (PM/CS) בבאפר העדכון — מקבל מספר זמני.BAPI_TRANSACTION_COMMITביצוע COMMIT WORK חיצוני לאחר קריאות BAPI — מסד הנתונים נשמר רק לאחר קריאה זו.

תהליך עסקי

הודעהפקודת אחזקהשחרורדיווחתנועת סחורהסגירה טכנית (TECO)סילוק (KO88)

לפני השימוש — צ׳קליסט

סוג פקודה (AUART) קיים ומוגדר
מרכז עבודה + מפעל תכנון תקפים
הרשאה I_AUART לסוג הפקודה
IT_METHODS מסתיים בשורת SAVE
רצף מתודות תקין (HEADER לפני OPERATION/COMPONENT)

כשלים נפוצים ופתרון

שגיאות

IW 302 — סוג פקודה לא קיים
CO 111 — מרכז עבודה חסר
IW 083 — הרשאה חסרה

סיבות

Customizing חסר לסוג פקודה
IT_METHODS ללא SAVE
לא בוצע COMMIT

דיבוג: נקודת עצירה ב-IBAPI_ALM_ORDER; בדוק ET_NUMBERS + RETURN; SLG1.

AUFKAFIHAFVCRESB

מקורות ואימות (§ שקיפות)

סטטוס: מאומת בתיעוד SAP

רמת ודאות: high

אומת בתאריך: 2026-07-15

מקור: SAP Help Portal — verified 2026-07-15

הערות QA: בדוק טבלת RETURN; חובה BAPI_TRANSACTION_COMMIT (WAIT='X'). בשגיאה — ROLLBACK.

שאל את NEOBAPI · BAPI_ALM_ORDER_MAINTAIN

שאלות מהירות בהקשר הנוכחי:

SAP by Sali · Project NEO

טוען את נוף ה-SAP…

DATA: lt_methods TYPE TABLE OF bapi_alm_order_method, lt_header TYPE TABLE OF bapi_alm_order_headers_i, lt_return TYPE TABLE OF bapiret2, lt_numbers TYPE TABLE OF bapi_alm_numbers. APPEND VALUE #( refnumber = '1' objecttype = 'HEADER' method = 'CREATE' ) TO lt_methods. APPEND VALUE #( refnumber = '1' objecttype = '' method = 'SAVE' ) TO lt_methods. APPEND VALUE #( orderid = '%00000000001' order_type = 'PM01' planplant = '1000' ) TO lt_header. CALL FUNCTION 'BAPI_ALM_ORDER_MAINTAIN' TABLES it_methods = lt_methods it_header = lt_header return = lt_return et_numbers = lt_numbers. CALL FUNCTION 'BAPI_TRANSACTION_COMMIT' EXPORTING wait = 'X'.