عمليات التكامل / ERP / SAP Business ByDesign
دليل تكامل SAP Business ByDesign لجدولة الإنتاج باستخدام SkyPlanner APS
يوضح دليل تكامل SAP Business ByDesign للشركاء وفرق تقنية المعلومات كيفية ربط ByDesign بـSkyPlanner APS. يتكامل SkyPlanner مع ByDesign في الاتجاهين باستخدام خدمات الويب التي أصدرتها SAP:
- يستقبل SkyPlanner أوامر الإنتاج الصادرة مع عملياتها، وProduction Models، وBills of Material، وBills of Operations، وموارد المعدات والعمالة، والمواد، والمخزون، وأوامر الشراء.
- تُعاد إلى ByDesign بيانات البداية المخططة لكل أمر إنتاج والمورد الرئيسي لكل عملية.
- يمكن تسجيل الكميات المؤكدة والهالك والمهام المكتملة في دفعات الإنتاج في ByDesign.
- تُرسل آليات webhooks في SkyPlanner تغييرات الجدول فور حدوثها.
يضبط فريق SkyPlanner التكامل مع بيئة ByDesign الخاصة بكم عبر REST API أثناء التهيئة، ويواصل دعمه بعد بدء التشغيل الفعلي. هذا الدليل موجه للشركاء والمطورين الراغبين في المشاركة، أو في تطوير التكامل بأنفسهم بالاعتماد على REST API الموثقة لدى SkyPlanner (مرجع API).
واجهات التكامل في SAP ByDesign
ينشر ByDesign خدمات الويب A2X SOAP المتاحة لكل إصدار في قائمة API لخدمات الويب. ويستخدم تكامل الجدولة الخدمات التالية:
- Manage Production Orders (ManageProductionOrderIn). تُرجع READ_PROD_ORDER مواعيد البدء والانتهاء المطلوبة، وأقرب مواعيد البدء والانتهاء وأبعدها، والموارد مع المدد المخططة والمنفذة، والأولوية، وحالة التنفيذ، وحالة الجدولة. وتحدّث MAINTAIN_BUNDLE_V2 الحقل EarliestStartPeriod أو LatestEndPeriod، وكذلك الحقل MainResourceID للعملية (مساعدة SAP).
- Manage Production Lots (ManageProductionLotsIn). تُنشئ MaintainBundle مهام الإنتاج أو تحدّثها، بما يشمل الكمية المؤكدة والهالك ومؤشر اكتمال التأكيد لكل نقطة إبلاغ، وإنهاء المهمة مع تسجيل الموظف المنفذ ووقت التنفيذ، واستخدام الموارد (مساعدة SAP).
- خدمات الاستعلام. Query Production Orders، وQuery Production Lots، وQuery Production Model، وQuery Production Bill of Materials، وQuery Production Bill of Operations (حسب المورد أيضًا)، وQuery Materials، وRead Equipment Resources، وQuery Labour Resource، وQuery Purchase Orders، وQuery Identified Stocks، وDetermine Availability of Products.
- OData. خدمات OData مخصصة لكائنات الأعمال، إلى جانب OData لمصادر البيانات والتقارير التحليلية. وتقول SAP: “companies are fully empowered to decide which business objects” (للشركات كامل الصلاحية لتحديد كائنات الأعمال التي تُتاح عبر الواجهات) (سيناريوهات التكامل لدى SAP).
استخدموا خدمات Query أو OData للقراءة، وخدمتي Manage لجميع عمليات الكتابة.
المصادقة والترخيص
في ByDesign، أنشئوا نظام اتصال لـSkyPlanner وترتيب اتصال للخدمات التي تستخدمونها. لكل ترتيب مستخدم تقني خاص به. يحدد دليل الأمان لدى SAP وسائل المصادقة لتكامل التطبيقات بالعبارة “user ID plus password, and the X.509 client certificate” (معرّف المستخدم مع كلمة المرور، وشهادة العميل المذكورة) (دليل الأمان). ويمكن إعداد OAuth 2.0 لخدمات OData. نزّلوا ملف WSDL لكل خدمة من ترتيب الاتصال أو من Service Explorer.
في SkyPlanner، يتضمن كل استدعاء رمز API في ترويسة Authorization-Token. أنشئوا الرمز في SkyPlanner من Settings > API. يكفي رمز API لبدء التطوير.
الأحداث والاستقصاء الدوري
يرسل SkyPlanner إشعارات webhook عند كل تغيير في الجدول، فتُكتب التحديثات في ByDesign مع تغيّر الخطة.
لاستقبال التغييرات من ByDesign، استعلموا دوريًا عبر خدمات Query. اقرأوا أوامر الإنتاج الصادرة ودفعات الإنتاج كل بضع دقائق، والمواد والمخزون وأوامر الشراء بوتيرة أقل. تُقسّم نتائج الاستعلام إلى صفحات باستخدام QueryHitsMaximumNumberValue وLastReturnedObjectID؛ وتوثّق SAP حجم الصفحة الافتراضي في صفحة خدمات الويب.
مطابقة البيانات
| كائن ByDesign (الواجهة) | كائن SkyPlanner | الاتجاه | وتيرة التحديث |
|---|---|---|---|
| المواد (Query Materials) | المنتجات والمواد | ByDesign → SkyPlanner | تحميل أولي، ثم استعلام دوري |
| Production Bill of Material (Query Production Bill of Materials) | بنية المنتج والمواد اللازمة لكل منتج | ByDesign → SkyPlanner | تحميل أولي، ثم عند التغيير |
| Production Bill of Operations: العمليات وأنشطة Setup وProduce وTear down (Query Production Bill of Operations) | خطوات الإنتاج ومددها وأوقات الإعداد والتفكيك | ByDesign → SkyPlanner | تحميل أولي، ثم عند التغيير |
| Production Model (Query Production Model) | مسار الإنتاج للمنتج في كل موقع | ByDesign → SkyPlanner | تحميل أولي، ثم عند التغيير |
| موارد المعدات ومجموعات الموارد (Read Equipment Resources) | محطات عمل ومجموعات محطات عمل وأدوات | ByDesign → SkyPlanner | تحميل أولي، ونادرًا بعد ذلك |
| موارد العمالة وأوقات العمل (Query Labour Resource) | الموظفون والورديات | ByDesign → SkyPlanner | يوميًا، أو إدارة الورديات في SkyPlanner |
| أوامر الإنتاج الصادرة وعملياتها (Query Production Orders، READ_PROD_ORDER) | الأوامر والمهام مع مواعيد استحقاقها واحتياجاتها من المواد | ByDesign → SkyPlanner | استعلام دوري كل بضع دقائق |
| دفعات الإنتاج ومهامها (Query Production Lots) | تقدم تنفيذ المهام | ByDesign → SkyPlanner | استعلام دوري كل بضع دقائق |
| المخزون المعرّف وتوافر المنتجات (Query Identified Stocks، Determine Availability of Products) | أرصدة المخزون | ByDesign → SkyPlanner | استعلام دوري كل ساعة أو عند تشغيل الجدولة |
| أوامر الشراء (Query Purchase Orders) | أوامر الشراء والمواد الواردة حسب تاريخ التسليم | ByDesign → SkyPlanner | استعلام دوري كل ساعة أو عند تشغيل الجدولة |
| EarliestStartPeriod وMainResourceID للعملية (Manage Production Orders، MAINTAIN_BUNDLE_V2) | البداية المخططة ومحطة العمل المعيّنة | SkyPlanner → ByDesign | عند تغيير الجدول، عبر إشعار webhook من SkyPlanner |
| الكمية المؤكدة والهالك وإنهاء المهمة (Manage Production Lots، MaintainBundle) | سجلات الوقت وتأكيدات المشغلين | SkyPlanner → ByDesign | مع كل تأكيد أو كل وردية، إذا اختير ذلك |
| غير موجودة في ByDesign | مصفوفة أوقات الإعداد، ومتطلبات تعدد المشغلين، والآلات والموظفون البدلاء | تُدار في SkyPlanner | تُضبط أثناء التهيئة |
أنماط التكامل
1. التحميل الأولي للبيانات الرئيسية. اقرأوا المواد وProduction Models وBills of Material وBills of Operations وموارد المعدات والعمالة. حدّدوا بعناية كيفية ربط الموارد: مجموعة موارد تضم أربع آلات تقابلها مجموعة واحدة من محطات العمل أو أربع محطات عمل. أما موارد المعدات التي تمثل أدوات، فتُعرّف في SkyPlanner كأدوات محدودة التوافر.
2. مزامنة أوامر الإنتاج. اقرأوا أوامر الإنتاج الصادرة مع عملياتها وموادها، إلى جانب أوامر الشراء المفتوحة. يعتبر SkyPlanner المواد المطلوبة متاحة في تاريخ تسليم أمر الشراء، ويحدّث المخزون عند تعيين حالة أمر الشراء إلى Delivered. وتبقى مقترحات الإنتاج في ByDesign Supply Planning إلى أن تتحول إلى أوامر إنتاج.
3. إعادة كتابة بيانات الجدولة. عندما يُدرج المحرك أمرًا في الجدول أو يغيّر موعده، يُطلق إشعار webhook من SkyPlanner استدعاء MAINTAIN_BUNDLE_V2 في Manage Production Orders. ويضبط الاستدعاء EarliestStartPeriod وMainResourceID للعملية التي اختارها SkyPlanner.
4. تأكيدات التنفيذ في أرض المصنع. يسجل المشغلون العمل باستخدام SkyPlanner Mobile Confirmations أو Production Timer، وتُبقي سجلات الوقت الجدول محدّثًا. أنتم تقررون ما إذا كانت بيانات التنفيذ الفعلية ستُعاد إلى ByDesign. إذا اخترتم ذلك، تسجّل MaintainBundle في Manage Production Lots الكمية المؤكدة والهالك والمهمة المكتملة مع الموظف المنفذ. وإن لم تختاروا ذلك، تُدخل التأكيدات في ByDesign كالمعتاد.
5. قواعد مسؤولية البيانات وحل التعارضات. وثّقوها قبل بدء التشغيل الفعلي:
| البيانات | النظام المسؤول |
|---|---|
| المواد وProduction Models والكميات وحالة الأوامر والدفعات | ByDesign |
| تسلسل العمليات وأوقات البدء والانتهاء وتعيين الموارد | SkyPlanner |
| مصفوفة أوقات التجهيز ومتطلبات الأدوات والمشغّلين والموارد البديلة | SkyPlanner |
| الورديات وأيام العطلات | نظام واحد يُختار أثناء تحديد النطاق |
| التأكيدات وحركات البضائع واحتساب التكاليف | ByDesign؛ تُدخل فيه مباشرة أو تُرحّل إليه من سجلات الوقت في SkyPlanner |
حدّدوا نظامًا واحدًا لكتابة تواريخ الأوامر. لا تشغّلوا Load Leveling على الموارد التي يجدولها SkyPlanner، وتحققوا من أن تشغيل التخطيط لا يغيّر مواعيد الأوامر الصادرة التي يتولى SkyPlanner إدارتها.
خطوات المشروع المعتادة
يكتمل التنفيذ عادةً خلال أسابيع من بدء التهيئة. وقبل ذلك، تحققوا من صحة الجدول خلال الفترة التجريبية المجانية البالغة 30 يومًا، باستخدام الموارد وBills of Operations وأوامر الإنتاج المفتوحة التي تُصدّر من ByDesign بصيغة CSV أو Excel.
- ربط البيانات. اعتمدوا جدول ربط البيانات وقواعد المسؤولية عن تحديثها ووتيرة المزامنة، وحدّدوا ما إذا كانت التأكيدات ستُعاد إلى ByDesign.
- الوصول إلى ByDesign. أنشئوا نظام الاتصال وترتيبات الاتصال، ونزّلوا ملفات WSDL. اختبروا أولًا في بيئة الاختبار الخاصة بكم في ByDesign.
- التحميل الأولي. المواد وProduction Models وBills of Material وBills of Operations والموارد وأوقات العمل.
- مزامنة أوامر الإنتاج والشراء. استعلام دوري مع تقسيم النتائج إلى صفحات، وتصفية النتائج، وإعادة المحاولة.
- إعداد القيود في SkyPlanner. مصفوفة أوقات التهيئة، والأدوات، وعدد المشغلين لكل مهمة، والآلات أو الموظفون البدلاء.
- إعادة كتابة بيانات الجدولة. استدعاءات MAINTAIN_BUNDLE_V2 التي تُطلقها إشعارات webhook من SkyPlanner، إلى جانب تأكيدات الدفعات إذا اختير ذلك.
- الاختبار بالتوازي. شغّلوا SkyPlanner بالتوازي مع الخطة الحالية، وقارنوا التواريخ، وصحّحوا البيانات الرئيسية.
- بدء التشغيل الفعلي. فعّلوا إعادة كتابة البيانات بعد تطابقها.
ما ينبغي مراعاته عند التخطيط للتكامل مع SAP ByDesign
- تاريخ واحد لكل استدعاء. “The EarliestStartPeriod and the LatestEndPeriod cannot be updated together.” (لا يمكن تحديث EarliestStartPeriod وLatestEndPeriod معًا.) اعتمد تاريخ البدء مرجعًا لإعادة كتابة البيانات.
- لا تتوفر آلية قفل. خدمات A2X لا تحتفظ بالحالة، ولذلك توضح SAP أنه لا يمكن فرض قفل على مستوى المعاملات أو قفل منطقي. أعد قراءة الأمر قبل كل عملية كتابة، وعالج التعارضات.
- إنهاء المهمة نهائي. “Confirmation Finished Indicator cannot be unchecked once it is set.” (لا يمكن إلغاء تحديد Confirmation Finished Indicator بعد تفعيله.) لا تسجّل الإنهاء إلا عندما يُغلق المشغّل المهمة.
- الموارد الأساسية والإضافية. تراعي الجدولة في ByDesign الموارد الأساسية. عرّف المشغّلين والأدوات المدرجة ضمن الموارد الإضافية بوصفها موارد ذات طاقة محدودة في SkyPlanner، لكي تتحقق الجدولة من توافرها.
- التجهيز والتفكيك. تتضمن Bills of Operations التجهيز والتفكيك بوصفهما أنشطة. انقل أوقات التغيير التي تعتمد على تسلسل العمليات إلى مصفوفة أوقات التجهيز.
من يتولى إعداد التكامل مع SAP ByDesign ودعمه؟
- يتولى فريق SkyPlanner إعداد التكامل خلال التهيئة الأولية ودعمه بعد بدء التشغيل الفعلي، وذلك لخدمات الويب واستعلامات OData المتفق عليها. تختلف طريقة استخدام ByDesign من شركة إلى أخرى، وهنا تُوظَّف الخبرة بهذه الاختلافات.
- يمكن لشريك SAP ByDesign الذي تتعامل معه المشاركة. فهو يعرف بيئة ByDesign الخاصة بك ونطاقها المحدد والإضافات المستخدمة فيها، ويمكنه إعداد ترتيبات الاتصال بالتعاون مع فريق SkyPlanner.
- يمكن لمطوّريك تطوير هذا التكامل باستخدام REST API الخاصة بـ SkyPlanner، مع رمز API في ترويسة
Authorization-Token. ويقدّم فريق SkyPlanner المساعدة عند الحاجة. تتوفر الوثائق في وثائق التكامل مع SkyPlanner.
يبدأ سعر SkyPlanner من 199 € شهريًا، ويشمل 5 محطات عمل، مع فوترة شهرية. ويُقدَّم عرض سعر التكامل مسبقًا مع باقتك، وفقًا لسير عملك واحتياجاتك. اطّلع على الأسعار، وتخطيط الإنتاج في SAP ByDesign بما يراعي الطاقة الفعلية للآلات والعاملين، وصفحة SAP Business ByDesign، ومركز التكامل مع أنظمة ERP. ولأنظمة SAP الأخرى أدلة خاصة بها: SAP Business One وSAP S/4HANA.
آراء المصنّعين في SkyPlanner
2 ساعةتوفيرًا كل أسبوع
“نقل SkyPlanner تخطيط الإنتاج لدينا من جداول Excel إلى تحسين الإنتاج لحظيًا.”
Kalle Kalliomäki، أخصائي سلسلة الإمداد
UTU · لوحات التوزيع ومعدات الفصل والتوصيل الكهربائية
يوفّر تخطيط الإنتاج 2 ساعة من وقت العمل أسبوعيًا، وتصل قائمة مهام جديدة إلى خط الإنتاج في ثوانٍ.
+90%في كفاءة الإنتاج
“ارتفعت كفاءة الإنتاج بنسبة 90%.”
Abdul Rucyinga، رئيس قسم تقنية المعلومات
Laboratory & Allied · تصنيع الأدوية
ارتفعت كفاءة الإنتاج بنسبة 90%، ويستغرق إعداد خطة محسّنة لثلاثة أشهر تشمل جميع محطات العمل أقل من 30 دقيقة.
100%نسبة الالتزام بمواعيد التسليم منذ 2021
“يمنحنا SkyPlanner رؤية واضحة للطاقة الإنتاجية ويجعل نتائج التخطيط قابلة للتوقع.”
Dan Berglund، COO/CFO
Opes Corporation · الصناعات الكيميائية والغذائية
بلغت نسبة الالتزام بمواعيد التسليم 100% طوال فترة استخدام SkyPlanner، منذ 2021.
توقفات أقلبسبب نقص المواد
“تكمن قيمة SkyPlanner بالنسبة إلينا في أنه أداة فعّالة في العمل اليومي، لا سيما عند تحديد مواعيد التسليم.”
Tommi Männistö، مدير تخطيط الإنتاج
Eskomatic · التشغيل الميكانيكي حسب التعاقد
تتيح الجدولة التلقائية لأحمال العمل تحديد مواعيد تسليم أدق، وقد انخفضت توقفات الإنتاج الناجمة عن نقص المواد انخفاضًا حادًا.
الأسئلة الشائعة
ما واجهات API التي يستخدمها SkyPlanner في SAP ByDesign؟
يستخدم خدمات الويب A2X التي أصدرتها SAP. وتتم القراءة عبر خدمات Query، مثل Query Production Orders وQuery Purchase Orders، أو عبر OData مخصّصة. أما الكتابة فتتم عبر Manage Production Orders وManage Production Lots.
ما البيانات التي يعيد SkyPlanner كتابتها في ByDesign؟
يعيد كتابة EarliestStartPeriod وMainResourceID الخاص بالعملية في كل أمر إنتاج. ويمكنك أيضًا اختيار تسجيل الكميات المؤكدة والهالك والمهام المكتملة في دفعة الإنتاج.
هل يرسل ByDesign أحداثًا إلى SkyPlanner؟
يستعلم SkyPlanner من خدمات Query في ByDesign كل بضع دقائق عن الأوامر ودفعات الإنتاج. ويرسل SkyPlanner نفسه webhooks عند كل تغيير في الجدول، فتُطلِق هذه الاستدعاءات عملية إعادة كتابة البيانات.
كيف يجري SkyPlanner المصادقة لدى ByDesign؟
عبر نظام اتصال وترتيب اتصال باستخدام مستخدم تقني، وفقًا لما يوضحه دليل الأمان من SAP. أما API الخاصة بـ SkyPlanner فتستخدم رمز API في ترويسة Authorization-Token.
هل تُرسَل مقترحات الإنتاج إلى SkyPlanner؟
يجدول SkyPlanner أوامر الإنتاج التي أُصدرت للتنفيذ. وتبقى المقترحات في ByDesign Supply Planning إلى أن تتحول إلى أوامر إنتاج.
من يتولى بناء التكامل؟
يتولى فريق SkyPlanner إعداد التكامل خلال التهيئة الأولية ودعمه بعد بدء التشغيل الفعلي. ويمكن أيضًا لشريك SAP ByDesign الذي تتعامل معه أو لمطوّريك تطوير التكامل باستخدام REST API الخاصة بـ SkyPlanner ورمز API.
