دليل تكامل JobBOSS² لجدولة الإنتاج باستخدام SkyPlanner APS
يوضح هذا الدليل للشركاء وفرق تقنية المعلومات كيفية ربط JobBOSS² من ECI بنظام SkyPlanner APS. يتكامل SkyPlanner مع JobBOSS² في الاتجاهين، باستخدام واجهات API الخاصة بـECI:
- تُستورد بيانات Orders وOrder Line Items وOrder Routings وEstimates وRoutings والمواد وWork Centers وEmployees وCompany Calendar وJob Requirements وبنود أوامر الشراء.
- تُعاد تواريخ البدء والانتهاء المخططة إلى كل خطوة في Order Routing.
- يمكن إعادة إرسال سجلات وقت المشغّلين بصيغة Time Ticket Details، إذا اخترت ذلك.
- تُرسل آليات webhooks في SkyPlanner تغييرات الجدول فور حدوثها.
يضبط فريق SkyPlanner التكامل بما يناسب إعدادات JobBOSS² لديك خلال مرحلة التهيئة، ويواصل دعمه بعد بدء التشغيل الفعلي. هذا الدليل موجه للشركاء والمطورين الراغبين في المشاركة أو في تطوير حلول بأنفسهم باستخدام REST API الموثقة من SkyPlanner (مرجع API). وقد نفذت ورشة تصنيع حسب الطلب في الولايات المتحدة ذلك بالفعل:
واجهات التكامل في JobBOSS²
تنشر ECI واجهات API الخاصة بالتصنيع، مع مواصفات OpenAPI، على موقع توثيق واجهات API للتصنيع من ECI. ولأغراض الجدولة، تهمنا واجهتان:
- JobBOSS² API (v1). واجهة خاصة بـJobBOSS² تستخدم REST وJSON. تتيح قراءة وكتابة الطلبات وOrder Line Items وOrder Routings وEstimates وRoutings والمواد وJob Requirements وWork Centers وCompany Calendar وEmployees وأوامر الشراء وTime Tickets وTime Ticket Details. وتذكر ECI أنها “is currently only supported for JobBOSS² hosted (Cloud) customers.” (مدعومة حاليًا فقط لعملاء JobBOSS² المستضاف سحابيًا).
- ECI ERP API (v2.1). واجهة REST API مشتركة لا ترتبط بمنتج بعينه، وتخدم Deacom وM1 وJobBOSS². وفي JobBOSS²، تشمل أوامر الإنتاج وعملياتها وموادها، والأصناف وعملياتها، ومراكز العمل، وبنود أوامر الشراء، وبنود بطاقات الوقت. وتشير ECI إلى أن “the actual ERP database could be a cloud hosted ERP or on premises install,” (قد تكون قاعدة بيانات ERP الفعلية مستضافة سحابيًا أو مثبتة محليًا)، لذا فهذه هي الواجهة المناسبة لنسخة JobBOSS² المثبتة محليًا.
تتبع الواجهتان القواعد نفسها: تعبيرات تصفية مثل lastModDate[gte]=، ومعامل fields=، وsort=، وتقسيم النتائج إلى صفحات باستخدام take وskip، حيث تكون القيمة الافتراضية لـtake هي 200. “All dates submitted to the API are assumed to be in UTC.” (يُفترض أن جميع التواريخ المرسلة إلى API بتوقيت UTC).
تشترط ECI للواجهتين ما يلي: “All APIs must be activated by ECI before use.” (يجب أن تُفعّل ECI جميع واجهات API قبل استخدامها). تواصل مع مدير حسابك لدى ECI مبكرًا.
المصادقة والوصول
- مستخدمو API. يعتمد التكامل على مستخدم API يُنشأ من خلال Integration Engine Management Console لدى ECI. ويحدد هذا المستخدم المنتج والعميل وقاعدة البيانات التي تصل إليها الاستدعاءات.
- بيانات اعتماد العميل في OAuth 2.0. يُستخدم معرّف العميل وسرّه للحصول على رمز من نقطة نهاية الرموز في Authentication API. ثم يُرسل
Authorization: Bearer [token]مع كل استدعاء. - نطاق الصلاحيات. امنح مستخدم API صلاحية الوصول إلى الموارد المطلوبة في جدول ربط البيانات أدناه فقط، دون غيرها.
أما في SkyPlanner، فتستخدم REST API رمز API للمصادقة (SkyPlanner Settings > API)، ويتوفر توثيقها بصيغة Swagger/OpenAPI. ويشرح الدليل التطبيقي للتكامل كيفية إجراء الاستدعاءات الأولى.
الأحداث والاستقصاء الدوري
لا تتضمن وثائق أي من واجهتي ECI توثيقًا لإشعارات الويب. لذلك تُجلب بيانات JobBOSS² بالاستقصاء الدوري: تُصفّى Order Line Items وOrder Routings وبنود أوامر الشراء بحسب lastModDate منذ آخر تشغيل، وتُقسّم النتائج إلى صفحات باستخدام take وskip. يُحدد التكرار لكل ورشة، من كل بضع دقائق لأوامر الإنتاج إلى كل ساعة للمخزون.
يرسل SkyPlanner إشعارات ويب عند تغير الحالة أو الجدول، لذا تعتمد إعادة البيانات إلى JobBOSS² على الأحداث.
ربط البيانات
| كائن JobBOSS² (المورد في JobBOSS² API) | كائن SkyPlanner | الاتجاه | التكرار |
|---|---|---|---|
Estimates (/estimates)، المواد (/materials) | المنتجات والمواد وهيكل المنتج | JobBOSS² → SkyPlanner | تحميل أولي، ثم عند التغيير |
Routings (/routings): مركز العمل، وقت التهيئة، زمن الدورة، حجم الفريق، الآلات المخصصة لأمر الإنتاج | خطوات العملية مع مددها وأوقات التهيئة | JobBOSS² → SkyPlanner | تحميل أولي، ثم عند التغيير |
Work Centers (/work-centers): ساعات كل وردية، التشغيل في الورديات من 1 إلى 3، أيام العمل | محطات العمل ومجموعاتها ومعدلات كفاءتها | JobBOSS² → SkyPlanner | تحميل أولي، ثم نادرًا بعد ذلك |
Company Calendar (/company-calendars)، Employees (/employees) | الورديات وأيام العطلات والعاملون | JobBOSS² → SkyPlanner | يوميًا، أو إدارة الورديات في SkyPlanner |
Orders وOrder Line Items (/order-line-items): رقم أمر الإنتاج، موعد التسليم، الأولوية، الكمية المطلوب إنتاجها | الطلبات مع مواعيد التسليم والأولويات | JobBOSS² → SkyPlanner | استقصاء كل بضع دقائق |
Order Routings (/order-routings): خطوات أمر الإنتاج، الحالة، الساعات المتبقية | مهام لكل خطوة من خطوات العملية | JobBOSS² → SkyPlanner | استقصاء كل بضع دقائق |
Job Requirements (/job-requirements)، بنود أوامر الشراء (/purchase-order-line-items) | احتياجات المواد، وأوامر الشراء بحسب تاريخ التسليم | JobBOSS² → SkyPlanner | استقصاء كل ساعة أو عند تشغيل الجدولة |
حقول Order Routing: estimatedStartDate، estimatedEndDate، workCenter، employeeCode (PATCH) | البدء والانتهاء المخططان، والآلة والمشغّل لكل خطوة | SkyPlanner → JobBOSS² | عند تغيير الجدول، عبر إشعار ويب من SkyPlanner |
| Time Ticket Details (POST): أمر الإنتاج، الخطوة، مركز العمل، الموظف، وقت التهيئة، زمن الدورة، القطع المنجزة والتالفة، وقتا البدء والانتهاء | سجلات الوقت وتأكيدات المشغّلين | SkyPlanner → JobBOSS² | مع كل تأكيد أو كل وردية، إذا اختير ذلك |
| غير موجودة في JobBOSS² | مصفوفة أوقات التجهيز والانتقال بين المهام، والأدوات كموارد محدودة السعة، والآلات والعاملون البدلاء | تُدار في SkyPlanner | تُعدّ خلال مرحلة التهيئة |
في نسخة JobBOSS² المثبتة محليًا، تُقرأ الكائنات نفسها عبر موارد ERP API التالية: /jobs و/job-operations و/job-materials و/parts و/part-operations و/work-centers و/purchase-order-lines، وتُرسل سجلات الوقت إلى /timecard-lines.
أنماط التكامل
1. التحميل الأولي للبيانات الرئيسية. اقرأ Estimates وRoutings والمواد وWork Centers وCompany Calendar وEmployees. حدّد بعناية كيفية تمثيل مراكز العمل: فمركز العمل الذي يضم أربع مخارط يُمثَّل بمجموعة محطات عمل واحدة أو بأربع محطات عمل، ليتمكن SkyPlanner من ترتيب العمل على كل آلة.
2. مزامنة أوامر الإنتاج. اقرأ Order Line Items المفتوحة مع Order Routings وJob Requirements المرتبطة بها، وبنود أوامر الشراء المفتوحة. يعتبر SkyPlanner المواد المطلوبة متاحة في تاريخ تسليم أمر الشراء، ويحدّث المخزون عند تعيين حالة أمر الشراء إلى Delivered. استبعد أوامر الإنتاج المعلّقة والمغلقة.
3. إعادة بيانات الجدولة. عندما يجدول المحرك خطوة أو ينقلها، يُطلق إشعار ويب من SkyPlanner طلب PATCH إلى /api/v1/orders/{orderNumber}/order-line-items/{itemNumber}/order-routings/{stepNumber}. يعيّن الطلب estimatedStartDate وestimatedEndDate بتوقيت UTC، ويعيّن workCenter وemployeeCode إذا نقل SkyPlanner الخطوة إلى آلة أو شخص آخر. تُسجَّل التواريخ على خطوات أوامر الإنتاج التي تعرضها بالفعل Whiteboard وPlanning Board وScheduling Advisor.
4. تأكيدات التنفيذ في أرض المصنع. يسجّل المشغّلون العمل باستخدام SkyPlanner Mobile Confirmations أو Production Timer، وتُبقي سجلات الوقت الجدول محدّثًا. وأنت تختار ما إذا كانت الأوقات الفعلية ستُعاد إلى JobBOSS². إذا اخترت ذلك، يتحول كل تأكيد إلى Time Ticket Detail يتضمن وقت التهيئة وزمن الدورة وعدد القطع. وإن لم تختر ذلك، يظل جمع البيانات في JobBOSS²، ويقرأ SkyPlanner تقدم العمل من Order Routings.
5. قواعد ملكية البيانات وحل التعارضات. دوّنها قبل بدء التشغيل الفعلي:
| البيانات | النظام المسؤول |
|---|---|
| Estimates وRoutings والكميات ومواعيد التسليم وحالة أمر الإنتاج | JobBOSS² |
| تسلسل الخطوات، وأوقات البدء والانتهاء، والآلة والمشغّل لكل خطوة | SkyPlanner |
| مصفوفة أوقات التجهيز والانتقال بين المهام، ومتطلبات الأدوات والمشغّلين، والموارد البديلة | SkyPlanner |
| الورديات وأيام العطلات | نظام واحد يُختار خلال تحديد النطاق |
| بطاقات الوقت، وصرف المواد، والاستلام، وحساب التكاليف | JobBOSS²، وتُدخل فيه البيانات أو تُرسل إليه من سجلات الوقت في SkyPlanner |
حدّد نظامًا واحدًا لكتابة تواريخ خطوات أوامر الإنتاج. يحل SkyPlanner محل إعادة الجدولة في Whiteboard لأوامر الإنتاج التي يجدولها؛ لذا ينقل المخططون العمل داخل SkyPlanner، وتنتقل التواريخ إلى JobBOSS².
خطوات المشروع المعتادة
يكتمل التنفيذ عادةً خلال أسابيع من بدء مرحلة التهيئة. وقبل ذلك، تحقّق من صحة الجدول خلال التجربة المجانية لمدة 30 يومًا، باستخدام بيانات Work Centers ومسارات الإنتاج وأوامر الإنتاج المفتوحة المصدّرة من JobBOSS² بصيغة CSV أو Excel.
- ربط البيانات. اعتمد جدول ربط البيانات وقواعد ملكيتها وتكرار المزامنة، وحدّد ما إذا كانت بطاقات الوقت ستُعاد إلى JobBOSS².
- إتاحة الوصول من ECI. اطلب من ECI تفعيل JobBOSS² API أو ERP API وإنشاء مستخدم API. اختبر التكامل على شركة ضمن بيئة اختبار إن كانت متاحة لديك.
- التحميل الأولي. يشمل Estimates وRoutings وWork Centers والتقويم والموظفين.
- مزامنة أوامر الإنتاج والشراء. استعلم دوريًا باستخدام مرشحات
lastModDate، مع تقسيم النتائج إلى صفحات وإعادة المحاولة عند الحاجة. - إعداد القيود في SkyPlanner. اضبط مصفوفة أوقات التجهيز والانتقال بين المهام، والأدوات، وعدد المشغّلين لكل مهمة، والآلات أو العاملين البدلاء.
- إعادة بيانات الجدولة. استدعاءات PATCH لتحديث Order Routing استجابةً لإشعارات webhooks من SkyPlanner، مع إرسال Time Ticket Details أيضًا إذا اخترت ذلك.
- الاختبار بالتوازي. شغّل SkyPlanner إلى جانب لوحة التخطيط الحالية، وقارن التواريخ وصحّح البيانات الرئيسية.
- بدء التشغيل الفعلي. فعّل إعادة الكتابة بمجرد تطابق البيانات.
ما يجب مراعاته عند التخطيط لتكامل JobBOSS²
- الاستضافة أو التثبيت المحلي. تخدم JobBOSS² API العملاء الذين يستخدمون النسخة المستضافة. أما التثبيتات المحلية فتستخدم ERP API، التي تختلف قائمة مواردها. احسم مسار التكامل في الخطوة 1.
- توقيت UTC في كل المواضع. تقرأ API التوقيت وتكتبه بصيغة UTC. حوّله إلى توقيت المصنع، وإلا فسيُسجَّل موعد البدء 7:00 في ساعة غير صحيحة.
- مراكز عمل لا تُظهر الآلات منفردة. قد يمثّل مركز العمل آلة أو مجموعة آلات أو خلية إنتاج أو أفرادًا. ويحدّد عدد الآلات وحجم الفريق في كل خطوة من مسار الإنتاج عدد الموارد التي تحتاجها الخطوة في SkyPlanner.
- الخدمات الخارجية. الخطوات المسندة إلى مورّد بدلًا من مركز عمل تُحتسب ضمن المهلة الزمنية (Lead Time)، لا ضمن طاقتك الإنتاجية. مثّلها كخطوات زمنية فقط.
- الخطوات المتداخلة والتشغيل دون إشراف. يمكن وضع علامات على خطوات مسار الإنتاج للسماح بتداخلها أو تشغيلها دون إشراف. انقل العلامتين عبر التكامل حتى يُخطَّط العمل دون وجود مشغّلين بصورة صحيحة.
- وحدات الزمن. لكل من وقت التهيئة ووقت الدورة وحداته الخاصة، ووقت الانتظار ليس وقت تشغيل للآلة. حوّل الوحدات عند الاستيراد، وإلا فستكون جميع المدد غير صحيحة.
- تقسيم النتائج إلى صفحات. تضم الصفحة افتراضيًا 200 سجل. اجلب جميع الصفحات في كل عملية قراءة.
من يتولى إعداد تكامل JobBOSS² ودعمه؟
- يتولى فريق SkyPlanner إعداد التكامل خلال مرحلة التهيئة ويدعمه بعد بدء التشغيل الفعلي، وفق الموارد وقواعد الاستعلام الدوري المتفق عليها. تختلف طريقة استخدام JobBOSS² من مصنع إلى آخر، ويُراعى هذا الاختلاف عند إعداد التكامل ودعمه.
- يمكن لشريك JobBOSS² الذي تتعامل معه المشاركة. فهو يعرف إعدادات نظامك، ويمكنه التنسيق مع ECI لتفعيل API وإنشاء مستخدمها، بالتعاون مع فريق SkyPlanner.
- يمكن لمطوّريك تطوير التكامل باستخدام REST API الخاصة بـSkyPlanner ورمز API. يكفي رمز API للبدء، ويساعد فريق SkyPlanner عند الحاجة. تجد وثائق التكامل في وثائق تكامل SkyPlanner.
يبدأ سعر SkyPlanner من 199 € شهريًا، ويشمل 5 محطات عمل، مع فوترة شهرية. يُقدَّم عرض سعر التكامل مسبقًا مع باقتك، وفق عملياتك واحتياجاتك. اطّلع على الأسعار، وتخطيط الإنتاج مع JobBOSS² بما يراعي الطاقة الفعلية للآلات والعاملين، وصفحة JobBOSS²، وميزات SkyPlanner، ومركز تكاملات ERP.
شركات تصنيع تستخدم SkyPlanner
2 ساعةتوفير كل أسبوع
“نقل SkyPlanner تخطيط الإنتاج لدينا من جداول Excel إلى تحسين الإنتاج في الوقت الفعلي.”
Kalle Kalliomäki، أخصائي سلسلة الإمداد
UTU · لوحات التوزيع ومعدات الفصل والتوصيل الكهربائية
يوفّر تخطيط الإنتاج 2 ساعة من وقت العمل كل أسبوع، وتصل قائمة مهام جديدة إلى خط الإنتاج في ثوانٍ.
+90%في كفاءة الإنتاج
“ارتفعت كفاءة الإنتاج بنسبة 90%.”
Abdul Rucyinga، رئيس قسم تقنية المعلومات
Laboratory & Allied · تصنيع الأدوية
ارتفعت كفاءة الإنتاج بنسبة 90%، ويستغرق إعداد خطة محسّنة لثلاثة أشهر تشمل جميع محطات العمل أقل من 30 دقيقة.
آلاف (1,000s)من أوامر العمل تُجدول تلقائيًا
“أصبحنا نتحكم في الإنتاج بطريقة مختلفة، وأصبح فهمنا للطاقة الإنتاجية على مستوى مختلف تمامًا.”
Hannu Ryynänen، الرئيس التنفيذي
Mamec · خلاطات صناعية ومضخات وتصنيع تعاقدي بتقنيات متقدمة
تُجدول آلاف أوامر العمل تلقائيًا، مع إتاحة رؤية آنية للإنتاج على مستوى المؤسسة بأكملها.
98%نسبة الالتزام بمواعيد التسليم، بعد أن كانت نحو 50%
“يؤدي SkyPlanner دورًا حاسمًا في الحفاظ على التزامنا بمواعيد التسليم.”
Hannu Lahtinen، المدير العام
KJH-Comp · تصنيع الأجزاء الميكانيكية من الصفائح المعدنية والتصنيع التعاقدي
ارتفعت نسبة الالتزام بمواعيد التسليم من نحو 50% لتصل إلى 98%، وأصبحت الجدولة تحتاج إلى مشرف واحد بدلًا من مشرفَين.
الأسئلة الشائعة
هل تتوفر API لنظام JobBOSS²؟
نعم. تتيح ECI كلًا من JobBOSS² API وERP API غير المرتبطة بمنتج محدد، وكلتاهما تعتمد REST مع مواصفات OpenAPI. تتيح JobBOSS² API قراءة الطلبات وOrder Routings وEstimates وWork Centers وأوامر الشراء وTime Tickets وكتابتها للعملاء الذين يستخدمون النسخة المستضافة.
كيف تتم مصادقة التكامل مع JobBOSS²؟
باستخدام بيانات اعتماد العميل في OAuth 2.0. تفعّل ECI واجهة API، ويُنشأ مستخدم API من Integration Engine Management Console، ويحمل كل استدعاء رمز Bearer.
هل يدعم JobBOSS² آلية webhooks؟
لا تذكر وثائق واجهات API لدى ECI أي دعم لآلية webhooks، لذلك يستعلم التكامل دوريًا من JobBOSS² باستخدام مرشحات lastModDate وفق جدول يُحدَّد لكل مصنع. أما webhooks الخاصة بـSkyPlanner فتُرسل تغييرات الجدول فور حدوثها.
كيف تُعاد كتابة التواريخ المخططة في JobBOSS²؟
تُكتب لكل خطوة من خطوات أمر الإنتاج على حدة. يحدّث SkyPlanner كل Order Routing باستدعاء PATCH يتضمن estimatedStartDate وestimatedEndDate، إضافةً إلى workCenter وemployeeCode عند نقل الخطوة إلى آلة أو مشغّل آخر.
هل ينبغي لشريك JobBOSS² أن يقترح ECI APS أم SkyPlanner؟
SkyPlanner، عندما يريد العميل تشغيل تخطيط إنتاج متعدد الموارد يراعي الطاقة الفعلية للآلات والعاملين خلال أسابيع. أما ECI APS فهو إضافة منفصلة تعمل بتقنية LYNQ. يتصل SkyPlanner عبر JobBOSS² API الخاصة بـECI، ويخطّط لعمليات التبديل وفرق العمل وتجهيزات التثبيت والمواد، ويعيد التخطيط تلقائيًا، ويبدأ سعره من 199 € شهريًا.
هل يمكننا تجربة SkyPlanner قبل بناء التكامل؟
نعم. تدعم التجربة المجانية لمدة 30 يومًا ما يصل إلى 20 محطة عمل، مع استيراد البيانات من JobBOSS² بصيغة CSV أو Excel، دون الحاجة إلى بطاقة ائتمان. ابدأ التجربة، أو تواصل مع المبيعات لتحديد نطاق التكامل.
