دليل تكامل HELIOS لجدولة الإنتاج باستخدام SkyPlanner APS
يوضح هذا الدليل لشركاء HELIOS وفرق تقنية المعلومات كيفية ربط HELIOS iNuvio وHELIOS Nephrite بـ SkyPlanner APS. يتكامل SkyPlanner مع HELIOS في الاتجاهين عبر واجهات HELIOS نفسها:
- تُستورد أوامر الإنتاج (výrobní příkazy) وعملياتها، إلى جانب الأجزاء المصنّعة وقوائم المواد ومسارات الإنتاج ومراكز العمل والآلات والمهن وموارد الأفراد والمخزون وأوامر الشراء.
- تُعاد تواريخ البدء والانتهاء المخططة إلى أوامر الإنتاج.
- يمكن إعادة إرسال سجلات وقت المشغّلين لتسجيلها كسجلات عمليات (evidence výrobních operací)، إذا اخترت ذلك.
- تُرسل آليات webhooks في SkyPlanner تغييرات الجدول فور حدوثها.
يضبط فريق SkyPlanner التكامل ليتوافق مع إعدادات HELIOS لديك خلال مرحلة التهيئة، ويواصل دعمه بعد بدء التشغيل الفعلي. هذا الدليل موجّه إلى شركاء HELIOS والمطوّرين الراغبين في المشاركة أو في بناء التكامل بأنفسهم باستخدام REST API الموثّقة لدى SkyPlanner (مرجع API).
واجهات التكامل في HELIOS
Helios Inuvio Server (Inuvio REST API). تصفه Asseco بأنه جزء مستقل من HELIOS iNuvio يتيح الوصول إلى سجلات وحدات HELIOS iNuvio عبر REST API (مساعدة Helios Inuvio Server). يأتي ضمن حزمة توزيع iNuvio، وتُنشر مواصفات OpenAPI بصيغتي Rapidoc وRedoc. تعمل API على عروض HELIOS (browses)، ولكل عرض معرّفه وصلاحياته الخاصة:
- يعرض GET /browses/list وGET /browses/meta العروض المتاحة وأعمدتها.
- يقرأ /browses/data صفوف العرض، ويكتب فيها إذا كان العرض يسمح بالإنشاء والتحديث والحذف.
- يشغّل /api/v1/actions/meta و/api/v1/actions/execute/{dbName}/{browseIdent}/{actionIdent} إجراءات خارجية على أحد العروض. وتشمل الإجراءات الخارجية المدعومة حاليًا الأنواع Procedure وBrowse وPlugin.
تشمل عروض الإنتاج التي يستخدمها مسؤول الجدولة خطة الإنتاج (výrobní plán)، وأوامر الإنتاج (výrobní příkazy)، وأجزاء أوامر الإنتاج، والمواد والمنتجات نصف المصنّعة اللازمة للإنتاج، والمهن، وموارد الأفراد، والإعدادات المسبقة لعمليات مسار الإنتاج، وسجلات العمليات. ويمكن الوصول بالطريقة نفسها إلى المخزون وحركات الاستلام والصرف وأوامر الشراء الصادرة (vydané objednávky).
HELIOS Nephrite REST API. تتضمن خارطة طريق Nephrite تطوير REST API (خارطة طريق HELIOS Nephrite). خلال تحديد النطاق، يؤكد فريق SkyPlanner معك ومع شريك HELIOS نقاط نهاية Nephrite المتاحة في بيئتك، وتبقى تدفقات البيانات الموضّحة أدناه كما هي.
Excel وCSV. يتيح كل عرض في HELIOS تصدير البيانات إلى Microsoft Office، وهو ما يكفي لتحميل البيانات للتجربة.
المصادقة والترخيص
- طريقتان للمصادقة. يوفّر iNuvio واجهة API قديمة خاصة به للمصادقة (/api/token)، وأخرى أحدث تستخدم OAuth2 وتستند إلى RFC 6749 (/oauth/token، /oauth/revoke). تُجدَّد الرموز عبر POST /oauth/token أو GET /api/token.
- الترخيص. يتوفر Helios Inuvio Server نفسه مجانًا، بينما يتطلب استخدام REST API ترخيصًا. بدءًا من الإصدار 3.0.2026.0301، دُمجت واجهات API للنظام والوحدات في واجهة واحدة هي Inuvio REST API، ولم يعد الوصول إلى API مقيّدًا بعدد المستخدمين.
- الصلاحيات. يحتاج حساب مستخدم التكامل إلى صلاحيات قراءة عروض الإنتاج والمخزون، وإلى صلاحية تشغيل الإجراءات الخارجية المتفق عليها.
في SkyPlanner، تستخدم REST API رمز API للمصادقة في الترويسة Authorization-Token (SkyPlanner Settings > API)، وهي موثّقة في Swagger/OpenAPI. يشرح البرنامج التعليمي للتكامل كيفية تنفيذ الاستدعاءات الأولى.
الأحداث والاستطلاع الدوري
يقرأ SkyPlanner بيانات HELIOS وفق جدول زمني. وتلتقط استدعاءات /browses/data الأعمال الجديدة باستخدام مرشّحات لأوامر الإنتاج المفتوحة والتغييرات الأخيرة. تُحدَّد وتيرة القراءة لكل مصنع، من مرة كل بضع دقائق لأوامر الإنتاج إلى مرة كل ساعة للمخزون.
يرسل SkyPlanner إشعارات webhook عند تغيّر الحالة أو الجدول، لذا تتم إعادة الكتابة استجابةً للأحداث.
مواءمة البيانات
| كائن HELIOS (العرض) | كائن SkyPlanner | الاتجاه | وتيرة التحديث |
|---|---|---|---|
| بطاقات الأصناف والأجزاء المصنّعة (vyráběné dílce)، والوحدات | المنتجات والمواد | HELIOS → SkyPlanner | تحميل أولي، ثم استطلاع دوري |
| قوائم المواد (kusovník, kusovníkové vazby) مع تواريخ سريانها | بنية المنتج، والمنتجات الفرعية، والمواد لكل منتج | HELIOS → SkyPlanner | تحميل أولي، ثم عند حدوث تغيير |
| مسارات الإنتاج (technologický postup): العملية، ومركز العمل، ووقت تجهيز الآلة والمشغّل، ووقت الوحدة، ووقت الإنهاء، والوقت بين العمليات | خطوات العملية ومددها وأوقات التجهيز والتفكيك | HELIOS → SkyPlanner | تحميل أولي، ثم عند حدوث تغيير |
| مراكز العمل (pracoviště)، والآلات (stroje)، ومراكز العمل البديلة | محطات العمل، ومجموعات محطات العمل، ومحطات العمل البديلة | HELIOS → SkyPlanner | تحميل أولي، ونادرًا ما يُحدّث بعد ذلك |
| المهن (výrobní profese)، وموارد الأفراد (výrobní personální zdroje) | الأفراد وأعداد المشغّلين لكل مهمة | HELIOS → SkyPlanner | تحميل أولي، ثم عند حدوث تغيير |
| تقاويم التخطيط (plánovací kalendáře) | الورديات وأيام العطلة | HELIOS → SkyPlanner | يوميًا، أو إعداد ورديات مستقلة في SkyPlanner |
| أوامر الإنتاج (výrobní příkazy)، وأجزاؤها وعملياتها، والمواد اللازمة للإنتاج | الأوامر والمهام مع مواعيد استحقاقها واحتياجاتها من المواد | HELIOS → SkyPlanner | استطلاع كل بضع دقائق |
| المخزون (stav skladu) | أرصدة المخزون | HELIOS → SkyPlanner | استقصاء كل ساعة أو عند تشغيل الجدولة |
| أوامر الشراء الصادرة (vydané objednávky) مع تواريخ التسليم | أوامر الشراء والمواد الواردة حسب تاريخ التسليم | HELIOS → SkyPlanner | استطلاع كل ساعة أو عند تشغيل الجدولة |
| البدء والانتهاء المخططان لكل عملية في أمر الإنتاج (إجراء خارجي) | البدء والانتهاء المخططان لكل مهمة | SkyPlanner → HELIOS | عند تغيّر الجدول، عبر إشعار webhook من SkyPlanner |
| سجلات العمليات (evidence výrobních operací) | سجلات الوقت وتأكيدات المشغّلين | SkyPlanner → HELIOS | مع كل تأكيد أو كل وردية، إذا اخترت ذلك |
| غير موجودة في HELIOS | مصفوفة أوقات التجهيز، والأدوات كموارد ذات توافر محدود، والمهام التي تتطلب عدة مشغّلين | تُدار في SkyPlanner | تُعدّ خلال مرحلة التهيئة |
أنماط التكامل
1. التحميل الأولي للبيانات الرئيسية. اقرأ الأجزاء المصنّعة وقوائم المواد ومسارات الإنتاج ومراكز العمل والآلات والمهن وموارد الأفراد والتقاويم من عروض TPV. لكل مورد في HELIOS علامة تحدد إدراجه في تخطيط الطاقة الإنتاجية، لذا حدّد لكل مورد ما سيجدوله SkyPlanner. ويمكن تمثيل مركز عمل يضم أربع آلات بمجموعة محطات عمل واحدة أو بأربع محطات عمل.
2. مزامنة الأوامر. اقرأ أوامر الإنتاج مع أجزائها وعملياتها وموادها، إلى جانب أوامر الشراء الصادرة. يعتبر SkyPlanner المواد المطلوبة متاحة في تاريخ تسليم أمر الشراء، ويحدّث المخزون عند تعيين حالة أمر الشراء إلى Delivered. جدوِل أوامر الإنتاج التي أُطلقت للتنفيذ. وتبقى الكميات المخططة في خطة الإنتاج داخل HELIOS حتى تتحول إلى أوامر إنتاج.
3. إعادة كتابة الجدول. عندما يضع المحرّك مهمة في الجدول أو ينقلها، يُطلِق إشعار webhook من SkyPlanner إجراءً خارجيًا على عرض أوامر الإنتاج عبر /api/v1/actions/execute. وهذا الإجراء هو إجراء برمجي في HELIOS يُتفق عليه خلال تحديد النطاق، ويعيّن البدء والانتهاء المخططين لعملية الأمر. ويتحقق HELIOS من صحة التغيير وفق منطقه الداخلي.
4. تأكيدات التنفيذ في أرض المصنع. يسجّل المشغّلون العمل باستخدام SkyPlanner Mobile Confirmations أو Production Timer، وتحافظ سجلات الوقت على تحديث الجدول. يمكنك اختيار ما إذا كانت الأوقات الفعلية تُعاد إلى HELIOS. إذا اخترت ذلك، يسجّلها إجراء خارجي كسجلات عمليات لكل عملية في الأمر. وإن لم تختره، يواصل المشغّلون الإبلاغ عبر أجهزة HELIOS الطرفية، ويقرأ SkyPlanner تلك السجلات.
5. قواعد مسؤولية البيانات وحل التعارضات. وثّقوها قبل بدء التشغيل الفعلي:
| البيانات | النظام المسؤول |
|---|---|
| الأصناف، وقوائم المواد، ومسارات الإنتاج، والكميات، وحالة الأمر | HELIOS |
| تسلسل العمليات وأوقات البدء والانتهاء وتعيين الآلات | SkyPlanner |
| مصفوفة أوقات التهيئة، ومتطلبات الأدوات والمشغّلين، والموارد البديلة | SkyPlanner |
| الورديات وأيام عدم العمل | نظام واحد يُختار عند تحديد النطاق |
| سجلات العمليات وحركات صرف المواد واستلامها | HELIOS؛ تُدخل فيه مباشرةً أو تُرحّل إليه من سجلات الوقت في SkyPlanner |
حدّد نظامًا واحدًا لكتابة تواريخ الأوامر. إذا كان تخطيط الطاقة الإنتاجية في HELIOS أو Nephrite APS لا يزال يكتب التواريخ، فعطّل ذلك للأوامر التي يجدولها SkyPlanner، أو احتفظ بخطة HELIOS للاختبار فقط.
الخطوات المعتادة للمشروع
يكتمل التنفيذ عادةً خلال أسابيع من بدء مرحلة التهيئة. وقبل ذلك، تحقّق من صحة الجدول خلال التجربة المجانية لمدة 30 يومًا، باستخدام مراكز العمل ومسارات الإنتاج وأوامر الإنتاج المفتوحة المصدّرة من HELIOS بصيغة CSV أو Excel.
- مطابقة البيانات. اعتمد جدول المطابقة وقواعد ملكية البيانات ووتيرة المزامنة، وحدّد ما إذا كانت سجلات العمليات ستُعاد إلى HELIOS.
- الوصول إلى HELIOS. جهّز Helios Inuvio Server وحساب مستخدم التكامل وبيانات اعتماد OAuth2 وترخيص REST API. اختبر أولًا على نسخة من قاعدة البيانات.
- التحميل الأولي. الأجزاء المصنّعة، وقوائم المواد، ومسارات الإنتاج، ومراكز العمل، والآلات، والمهن، والتقاويم.
- مزامنة أوامر الإنتاج والشراء. استطلاع دوري مع تصفية النتائج وتقسيمها إلى صفحات وإعادة المحاولة.
- ضبط القيود في SkyPlanner. مصفوفة أوقات التهيئة، والأدوات، وعدد المشغّلين لكل مهمة، والآلات أو الأفراد البدلاء.
- إعادة كتابة الجدول. أنشئ الإجراءات الخارجية للتواريخ المخططة واختبرها، وكذلك إجراءات سجلات العمليات إذا اخترت إعادتها.
- الاختبار المتوازي. شغّلوا SkyPlanner بالتوازي مع الخطة الحالية، وقارنوا التواريخ وصححوا البيانات الرئيسية.
- بدء التشغيل الفعلي. فعّلوا ترحيل البيانات إلى HELIOS بمجرد تطابق البيانات.
ما يجب مراعاته عند التخطيط لتكامل HELIOS
- علامات التخطيط. لا تتوفر بيانات موثوقة عن الطاقة الإنتاجية إلا للموارد المحددة بعلامة لإدراجها في تخطيط الطاقة الإنتاجية. تحقّق من العلامات على مراكز العمل والآلات والمهن وأعمال المقاولة من الباطن قبل التحميل الأول.
- وحدات الوقت. يمكن إدخال أوقات التجهيز والوحدة والإنهاء بالساعات أو الدقائق أو الثواني. حوّل الوحدات عند الاستيراد، وإلا ستكون جميع المدد غير صحيحة.
- الوقت بين العمليات. الوقت الثابت بين العمليات هو وقت انتظار، وليس وقت تشغيل للآلة. مثّله في النموذج كوقت انتظار، لا كطاقة إنتاجية.
- عمليات التعاقد من الباطن (kooperace). يُحتسب وقت النقل في الذهاب والإياب. مثّل أعمال التعاقد من الباطن كخطوات زمنية فقط.
- طرق العرض القابلة للكتابة. تدعم جميع طرق العرض القراءة، لكن بعضها فقط يدعم الإنشاء والتحديث والحذف. يبيّن الطلب GET /browses/list مع عامل التصفية browseCreateImplemented=1 طرق العرض التي تدعم ذلك. أما طرق عرض أوامر الإنتاج فهي للقراءة فقط، لذا تُعاد المواعيد المخططة عبر الإجراء الخارجي المتفق عليه.
من يتولى إعداد التكامل مع HELIOS ودعمه؟
- يتولى فريق SkyPlanner إعداد التكامل خلال مرحلة التهيئة ويدعمه بعد بدء التشغيل الفعلي، ضمن طرق العرض والإجراءات الخارجية المتفق عليها. يستخدم كل مصنع HELIOS بطريقته الخاصة، وهنا يأتي دور الخبرة بهذه التفاصيل.
- يمكن لشريك HELIOS الذي تتعامل معه المشاركة. فهو يعرف بيئة النظام لديك وإجراءاتك المخصصة وتراخيصك، ويمكنه إعداد Helios Inuvio Server والإجراءات الخارجية بالتعاون مع فريق SkyPlanner.
- يمكن لمطوّريك البناء على هذا التكامل باستخدام REST API الخاصة بـ SkyPlanner ورمز API. يكفي رمز API للبدء، ويقدّم فريق SkyPlanner المساعدة عند الحاجة. تتوفر الوثائق في وثائق التكامل مع SkyPlanner.
يبدأ سعر SkyPlanner من 199 € شهريًا، ويشمل 5 محطات عمل، مع فوترة شهرية. يُقدَّم عرض سعر التكامل مسبقًا وفقًا لسير العمل واحتياجاتك، إلى جانب باقتك. اطّلع على الأسعار، وتخطيط الإنتاج مع HELIOS ضمن الطاقة الفعلية للآلات والعاملين، وصفحة HELIOS، ومركز التكامل مع أنظمة ERP. وللتعرّف على أساسيات الجدولة، راجع جدولة الإنتاج.
آراء المصنّعين في SkyPlanner
2 ستُوفَّر كل أسبوع
“نقل SkyPlanner تخطيط الإنتاج لدينا من جداول Excel إلى تحسين الإنتاج في الوقت الفعلي.”
Kalle Kalliomäki، أخصائي سلسلة التوريد
UTU · لوحات التوزيع ومعدات الفصل والتوصيل الكهربائية
يوفّر تخطيط الإنتاج 2 ساعة من وقت العمل كل أسبوع، وتصل قائمة مهام جديدة إلى خط الإنتاج في ثوانٍ.
+90%في كفاءة الإنتاج
“ارتفعت كفاءة الإنتاج بنسبة 90%.”
Abdul Rucyinga، رئيس قسم تقنية المعلومات
Laboratory & Allied · تصنيع الأدوية
ارتفعت كفاءة الإنتاج بنسبة 90%، ويستغرق إعداد خطة محسّنة لثلاثة أشهر تشمل جميع محطات العمل أقل من 30 دقيقة.
بالآلاف (1,000s)أوامر عمل تُجدول تلقائيًا
“أصبحنا نتحكم في الإنتاج بطريقة مختلفة، وارتقى فهمنا للطاقة الإنتاجية إلى مستوى مختلف تمامًا.”
Hannu Ryynänen، الرئيس التنفيذي
Mamec · الخلاطات الصناعية والمضخات والتصنيع التعاقدي عالي التقنية
تُجدول آلاف أوامر العمل تلقائيًا، مع إتاحة رؤية لحظية للإنتاج على مستوى المؤسسة بأكملها.
100%الالتزام بمواعيد التسليم منذ 2021
“يمنحنا SkyPlanner رؤية واضحة للطاقة الإنتاجية، ويجعل نتائج التخطيط قابلة للتوقع.”
Dan Berglund، مدير العمليات والمدير المالي (COO/CFO)
Opes Corporation · الصناعات الكيميائية والغذائية
بلغ الالتزام بمواعيد التسليم 100% طوال فترة استخدام SkyPlanner، منذ 2021.
الأسئلة الشائعة
هل يوفر HELIOS واجهة API لأوامر الإنتاج؟
نعم. يتيح Helios Inuvio Server الوصول عبر REST إلى طرق العرض في HELIOS iNuvio، بما فيها خطة الإنتاج وأوامر الإنتاج وأجزاء الأوامر ومواد الإنتاج وسجلات العمليات. أما بالنسبة إلى HELIOS Nephrite، فيحدد فريق SkyPlanner طريقة التكامل المناسبة لبيئة النظام لديك بالتعاون معك ومع شريك HELIOS، أثناء تحديد النطاق في مرحلة التهيئة.
كيف يلتقط SkyPlanner التغييرات في HELIOS؟
يستعلم SkyPlanner دوريًا عن طرق العرض في HELIOS وفق جدول يُحدَّد لكل مصنع، مع تصفية النتائج لتشمل أوامر الإنتاج المفتوحة والتغييرات الأخيرة. وترسل خطافات الويب الخاصة بـ SkyPlanner تغييرات الجدول فور حدوثها.
كيف تُعاد المواعيد المخططة إلى HELIOS؟
عبر إجراء خارجي على طريقة عرض أوامر الإنتاج، يُنفَّذ باستخدام /api/v1/actions/execute. وهذا الإجراء هو إجراء في HELIOS يُتفق عليه أثناء تحديد النطاق، بحيث يطبّق HELIOS منطقه الخاص على كل تاريخ يتلقاه.
ما آلية المصادقة التي تستخدمها Inuvio REST API؟
تستخدم OAuth2 وفق RFC 6749 عبر /oauth/token، أو الآلية الأقدم الخاصة بالنظام عبر /api/token. أما API الخاصة بـ SkyPlanner فتستخدم رمز API في ترويسة Authorization-Token.
هل ينبغي لشريك HELIOS اقتراح HELIOS APS أم SkyPlanner؟
SkyPlanner، عندما تتغير خطة العميل كثيرًا ويجب أن يظل التخطيط ضمن الطاقة الإنتاجية الفعلية. يعتمد التخطيط في HELIOS على إجراء حسابات لخطة نشطة واحدة، ويمكنه التحول إلى طاقة إنتاجية غير محدودة للوفاء بالمواعيد، مع ترك معالجة التعارضات للمخطِّط (مساعدة HELIOS). يتصل SkyPlanner عبر REST API، ويعيد التخطيط تلقائيًا، ويخطط لتغييرات التجهيز والأدوات وفرق العمل والمواد، ويتيح عددًا غير محدود من المستخدمين، بسعر يبدأ من 199 € شهريًا.
هل يمكننا اختبار SkyPlanner قبل بناء التكامل؟
نعم. تدعم التجربة المجانية لمدة 30 يومًا ما يصل إلى 20 محطة عمل، مع استيراد البيانات من HELIOS بصيغة CSV أو Excel، دون الحاجة إلى بطاقة ائتمان. ابدأ التجربة، أو تواصل مع المبيعات لتحديد نطاق التكامل.
