دليل تكامل SAP S/4HANA مع SkyPlanner APS لجدولة الإنتاج

يتيح S/4HANA التكامل عبر خدمات OData المنشورة والمدرجة في SAP Business Accelerator Hub ‏(api.sap.com). ويعتمد تكامل الجدولة على خدمات OData V2. ما زالت IDocs وBAPIs متاحة، لكن هذا الدليل يستخدم واجهات OData API المنشورة.

المصادقة حسب الإصدار

• النشر المحلي وPrivate Edition. تُفعَّل الخدمات في SAP Gateway باستخدام المعاملة /IWFND/MAINT_SERVICE. يحتاج مستخدم التكامل إلى كائنات الصلاحيات المناسبة، مثل C_AFRU_AWK للتأكيدات، وC_AFKO_AWK لبنود حركة البضائع المرحَّلة معها، وM_PLAF_ORG للأوامر المخططة.
• Public Edition. لا تُتاح الخدمات إلا من خلال ترتيبات الاتصال. باتباع إرشادات SAP لإعداد الاتصال الوارد، تنشئ مستخدم اتصال ونظام اتصال وترتيب اتصال في تطبيق Communication Arrangements، استنادًا إلى سيناريو اتصال من SAP (SAP_COM_xxxx). يحدد السيناريو الخدمات المتاحة وطرق المصادقة التي يمكن استخدامها:

– بالرموز: مسارات OAuth أو SAML أو OpenID Connect التي تستخدم رموز الحامل، مع تمرير الهوية إلى مستخدم أعمال – بشهادة العميل – بالمصادقة الأساسية باستخدام مستخدم اتصال تقني

توصي SAP بالمصادقة باستخدام الرموز أو الشهادات.

أما في جانب SkyPlanner، فتتوفر واجهة REST API بمصادقة JWT، موثّقة بصيغة Swagger/OpenAPI ‏(مرجع API). لذا تتولى البرمجيات الوسيطة مصادقة SAP من جهة، ومصادقة JWT من الجهة الأخرى.

واجهات API لجدولة الإنتاج

الخدمة	الكيانات والإجراءات المستخدمة	الغرض
API_PRODUCTION_ORDER_2_SRV (Production Order, Version 2)	A_ProductionOrder_2، A_ProductionOrderItem_2، A_ProductionOrderOperation_2، A_ProductionOrderComponent_2، A_ProductionOrderStatus_2، A_ProductionRsceTools_2؛ والإجراءات ReleaseOrder، ReleaseOperation، ScheduleProductionOrderOperation	الأوامر والعمليات والمكونات وموارد وأدوات الإنتاج (PRTs) والحالة، وإرسال بيانات الجدولة إلى النظام المصدر
API_WORK_CENTERS	A_WorkCenters, A_WorkCenterAllCapacity_2, A_WorkCenterCapacity, A_WorkCenterCapacityInterval_2, A_WorkCenterCapacityShift_2, A_WorkCenterCapPerBucket	مراكز العمل وفئات الطاقة الإنتاجية وفتراتها والورديات
API_PRODUCTION_ROUTING	ProductionRoutingHeader, ProductionRoutingSequence, ProductionRoutingOperation, ProductionRoutingSubOperation, ProductionRoutingMatlAssgmt, ProductionRoutingOpCompAlloc	مسارات الإنتاج القياسية للتخطيط قبل إنشاء الأوامر
API_BILL_OF_MATERIAL_SRV;v=2	MaterialBOM, MaterialBOMItem, MaterialBOMSubItem	هيكل المنتج متعدد المستويات
API_PRODUCT_SRV (Product Master A2X)	A_Product	المواد (تُسمى Product في واجهة API). توصي SAP الآن باستخدام واجهة Product (Version 2) لمعظم كيانات المنتجات
API_PLANNED_ORDERS	A_PlannedOrder, A_PlannedOrderComponent, A_PlannedOrderCapacity	مخرجات MRP Live قبل التحويل
API_MATERIAL_STOCK_SRV	A_MaterialStock, A_MatlStkInAcctMod	المخزون حسب المصنع وموقع التخزين، لتحديد مدى توافر المواد
API_PURCHASEORDER_PROCESS_SRV	A_PurchaseOrder, A_PurchaseOrderItem	أوامر الشراء المفتوحة للمواد الواردة
API_PROD_ORDER_CONFIRMATION_2_SRV	ProdnOrdConf2، ProdnOrdConfMatlDocItm؛ والإجراءات GetConfProposal، GetGdsMvtProposal، CancelProdnOrdConf	التأكيدات وحركات البضائع من صالة الإنتاج

في واجهة API لأوامر الإنتاج، تُعرَّف العمليات بالمفتاحين OrderInternalBillOfOperations وOrderIntBillOfOperationsItem معًا، وليس برقم العملية الذي يراه المخطط. أما الإجراء GetConfProposal في واجهة API للتأكيدات، فيشير إلى العملية نفسها باستخدام OrderID وOrderOperation. خزّن المفاتيح الداخلية ورقم العملية في SkyPlanner منذ التحميل الأول.

الأحداث

يُصدر S/4HANA حدثَي أعمال هما Production Order Created وProduction Order Changed، وتتضمن بياناتهما ManufacturingOrder وProductionOrder وProductionOrderType وProductionPlant. لا تحمل بيانات الحدث سوى المفاتيح، لذا يعيد التكامل قراءة الأمر وعملياته. يُطلَق حدث Changed عند كل تغيير في الأمر، لذا طبّق آلية لتجميع الإشعارات المتقاربة قبل معالجتها. وفي الاتجاه الآخر، تُرسل إشعارات SkyPlanner عبر webhooks في الوقت الفعلي عند تغيّر الجدول الزمني أو حالة المهمة.

البدء باستخدام الملفات

خلال التجربة، صدّر أوامر الإنتاج ومراكز العمل من تقارير القوائم في S/4HANA إلى Excel أو CSV، ثم استوردها إلى SkyPlanner. بذلك تتحقق من صلاحية الجدول قبل إجراء أي تعديل على Gateway أو ترتيبات الاتصال.

1. تحميل البيانات الرئيسية. حمّل المواد وقوائم المواد BOM ومراكز العمل بفترات طاقتها الإنتاجية ووردياتها، ومسارات الإنتاج. حدّد في هذه المرحلة النظام المسؤول عن الورديات. ومن التقسيمات العملية أن يبقى تقويم المصنع في S/4HANA، بينما تُدار أنماط الورديات التفصيلية والغياب والعمل الإضافي في SkyPlanner، حيث يعدّلها المخططون يوميًا.

2. مزامنة الأوامر. اشترك في أحداث Production Order Created/Changed، أو استعلم دوريًا عن A_ProductionOrder_2 بحسب الطابع الزمني للتغيير إذا لم تكن أحداث الأعمال مُعدّة. رشّح النتائج بحسب المصنع ونوع الأمر وحالته. أرسل الأوامر عند إنشائها ليتمكن SkyPlanner من التخطيط المسبق، ثم أصدرها للتنفيذ في S/4HANA باستخدام ReleaseOrder أو ReleaseOperation بمجرد أن ينتهي SkyPlanner من جدولتها.

3. إرسال بيانات الجدولة إلى النظام المصدر. عندما يُبلغ webhook من SkyPlanner عن تغيير في الجدول الزمني، يستدعي التكامل الإجراء ScheduleProductionOrderOperation في API_PRODUCTION_ORDER_2_SRV لكل عملية تغيّرت. ويرسل ما يلي:

• ManufacturingOrder وOrderInternalBillOfOperations وOrderIntBillOfOperationsItem بوصفها مفاتيح
• OpSchedulingMode بالقيمة F (الجدولة إلى الأمام)، مع تاريخ ووقت البداية المحددين في SkyPlanner في OpSchedldStartDate وOpSchedldStartTime
• OpSchedulingStatus بالقيمة DISP (الإسناد للتنفيذ)، والحقل الإلزامي OpSchedulingStrategy بالقيمة M
• قيمة ETag في if-match

تُرسل جميع عمليات الأمر الواحد في مجموعة تغييرات واحدة، وفق تسلسلها في SkyPlanner، ليتمكّن S/4HANA من إسناد خطة الأمر كاملةً باستدعاء واحد. لا يُستخدم الوضع K مطلقًا، لأنه يُبقي تواريخ العمليات الأصلية ويتجاهل التواريخ المُرسلة.

يستخلص SkyPlanner مدد العمليات من القيم القياسية لمسار الإنتاج ومعادلات الطاقة الإنتاجية لمراكز العمل نفسها التي يستخدمها S/4HANA. لذا يتوافق تاريخ الانتهاء الذي يحسبه S/4HANA انطلاقًا من تاريخ البدء المُرسل مع خطة SkyPlanner. بعد كل مجموعة تغييرات، يعيد التكامل قراءة العمليات ويضع علامة على أي تاريخ مختلف، ليراه المخطط قبل الوردية التالية.

4. تأكيدات صالة الإنتاج. يتحول كل سجل وقت من Mobile Confirmations أو Production Timer إلى تأكيد في S/4HANA. يُطلق webhook من SkyPlanner طلب ترحيل ProdnOrdConf2 يتضمن كميات الإنتاج السليم والخردة وأزمنة الأنشطة. يستدعي التكامل GetConfProposal أولًا، ليقترح S/4HANA الكميات والأنشطة والتواريخ وبيانات العاملين. ويقترح GetGdsMvtProposal حركات البضائع.

المواد الواردة. تشمل المزامنة الواردة أوامر الشراء المفتوحة. ويعتبر SkyPlanner المواد المطلوبة متاحة في تاريخ التسليم المتوقع لأمر الشراء. تُجدول المهام التي تنتظر مكونات مشتراة في يوم وصول المواد، بدلًا من تعطيلها بسبب رصيد المخزون الحالي.

يبقى S/4HANA المرجع المعتمد لعمليات الاستلام: عند ترحيل استلام بضاعة، يرتفع المخزون وتنخفض الكمية المفتوحة في بند أمر الشراء. تُحدّث المزامنة التالية المخزون في SkyPlanner وتضع أمر الشراء المستلم بالكامل في حالة Delivered؛ أما عند الاستلام الجزئي، فتبقى الكمية المفتوحة المتبقية متوقعة الوصول في تاريخ سطر جدول التسليم. توضح وثائق SkyPlanner كيفية التعامل مع أوامر الشراء.

5. قواعد المسؤولية عن البيانات. يتولى S/4HANA إدارة الكميات وقائمة المواد BOM ومسار الإنتاج وحساب التكاليف والحالة. ويتولى SkyPlanner إدارة التسلسل وتعيين محطات العمل وتواريخ العمليات. لا تسمح مطلقًا للنظامين بالكتابة في الحقل نفسه. إذا كان المخططون لا يزالون ينقلون العمليات في Capacity Scheduling Board، فحدّد أي تعديل له الأولوية. إما أن تنقل مزامنة الأوامر التالية تعديلهم إلى SkyPlanner، وإما أن يبقى مركز العمل المعني خارج نطاق SkyPlanner.

• تُرسل البيانات إلى النظام المصدر باستدعاء إجراء مع ETag. الطريقة الموثقة لجدولة عملية هي ScheduleProductionOrderOperation، وليس طلب PATCH على A_ProductionOrderOperation_2. يُجري الوضع F الجدولة إلى الأمام انطلاقًا من موعد بداية، والوضع B إلى الخلف انطلاقًا من موعد نهاية، بينما يُبقي الوضعان K وS التواريخ الحالية ويتجاهلان التواريخ التي ترسلها. تُنشأ قيمة ETag في if-match من LastChangeDateTime الخاص بالأمر (YYYYMMDDHHMMSS)، لذا فإن أي تغيير في الأمر يجعلها قديمة. طبّق القراءة قبل الكتابة، وأنشئ طابورًا لإعادة المحاولة.
• الطاقة الإنتاجية ليست ضمن البيانات العامة لمركز العمل. تُحدَّد الطاقة الإنتاجية المتاحة من فئة الطاقة الإنتاجية (001 للآلات، 002 للعمالة)، وتقويم المصنع، والفترات والورديات التي تتجاوز إعداداته. تحوّل صيغ الطاقة الإنتاجية القيم القياسية لمسار الإنتاج إلى متطلبات الإعداد والتشغيل والفك. اقرأ A_WorkCenterCapacityInterval_2 وكيانات الورديات، واتفق على كيفية تحويل نتائج الصيغ إلى مدد في SkyPlanner.
• القيم القياسية تحتاج إلى تنقيح. غالبًا ما تتضمن مسارات الإنتاج المعدّة لحساب التكاليف متوسطات لأوقات الإعداد، أو أوقات إعداد مسجّلة ضمن فئة طاقة إنتاجية غير صحيحة.
• قواعد التأكيدات صارمة. توصي SAP باستخدام استدعاءات الدفعات للترحيل الجماعي. تُنفَّذ مجموعة التغييرات كاملة أو لا تُنفَّذ إطلاقًا، لذا فإن خطأ في بطاقة وقت واحدة يمنع ترحيل بقية المجموعة. يجب تنفيذ الإلغاءات ضمن الدفعة بترتيب عكسي لقيمة ConfirmationCount. لا يمكنك خلط أنواع التأكيدات في أمر واحد، أو ترحيل حركات بضائع دون تأكيد، أو تأكيد عمليات تتطلب نقاط تشغيلها مربع حوار.
• تحقّق مما إذا كان PP/DS مفعّلًا. يتطلب PP/DS المضمّن نشاط Customizing المسمّى Activate Advanced Planning and Scheduling وSAP HANA integrated liveCache. وتبيعه SAP كمنتج منفصل باسم SAP S/4HANA Manufacturing for planning and scheduling. عند تفعيله، حدّد الجهة المسؤولة عن الجدولة لكل مادة: المواد المحدّدة للتخطيط المتقدم تقع ضمن مسؤولية PP/DS. وتذكر SAP أيضًا بشأن واجهة API للأوامر المخططة: “Automatic integration to PP/DS is not enabled from this API.” (لا تتيح هذه الواجهة هذا التكامل التلقائي).
• وحدات القياس. قد تختلف كميات العمليات والكميات الأساسية لمسارات الإنتاج ووحدات التأكيد. أجرِ التحويل صراحةً باستخدام وحدة العملية، لا وحدة المادة الأساسية.
• الاختلافات بين الإصدارات. توضح SAP Learning استبدال جدول التخطيط التقليدي CM21/CM22 بتطبيقات Manage Work Center Capacity وCapacity Scheduling Table وCapacity Scheduling Board. لا يتيح Public Edition واجهات API إلا عبر سيناريوهات الاتصال، وقد تختلف إصدارات الخدمات المتاحة فيه عن تلك المتاحة في النشر المحلي. ولا تستطيع واجهة API لمسارات الإنتاج حذف المسارات أو تحديث ارتباطات المواد بها. خلال تحديد النطاق، يثبّت فريق SkyPlanner إصدارات الخدمات لكل نظام عميل، بالرجوع إلى صفحة الإصدار المعني في API Business Accelerator Hub.
• قيود لا تتضمنها مسارات الإنتاج. أدِر أوقات التغيير المرتبطة بالتسلسل وتعارض استخدام الأدوات والعمليات التي تتطلب عدة مشغّلين في SkyPlanner، لا ضمن القيم القياسية لمسار الإنتاج. تحتفظ مصفوفة أوقات الإعداد بوقت التغيير لكل زوج من المنتجات. وتُعامل الأدوات الواردة في PRTs الخاصة بالأمر كموارد محدودة، فلا تُستخدم إلا في محطة عمل واحدة في الوقت نفسه، وقد تتطلب العملية عدة أشخاص في آن واحد.