التكاملات / ERP / proALPHA ERP
دليل تكامل proALPHA لجدولة الإنتاج باستخدام SkyPlanner APS
يوضح دليل تكامل Proalpha هذا للشركاء وفرق تقنية المعلومات كيفية ربط Proalpha ERP بـ SkyPlanner APS. ويتكامل SkyPlanner مع Proalpha في كلا الاتجاهين:
- تُستورد بيانات القطع وأوامر الإنتاج بعملياتها والموارد والتقاويم والمخزون وأوامر الشراء.
- تُعاد مواعيد البدء والانتهاء المخططة لكل عملية عبر setWorkOrderOperationDates.
- تُعاد تغييرات الموارد عبر changeWorkOrderOperationResource.
- تُعاد تأكيدات المشغّلين عبر operationDataEntry.
- يرسل SkyPlanner تغييرات الجدول فور حدوثها عبر webhooks.
يضبط فريق SkyPlanner التكامل ليتوافق مع إعدادات Proalpha لديك خلال مرحلة التهيئة، ويواصل دعمه بعد بدء التشغيل الفعلي. هذا الدليل موجّه للشركاء والمطورين الراغبين في المشاركة، أو في بناء التكامل بأنفسهم باستخدام REST API الموثّقة من SkyPlanner (مرجع API).
واجهات Proalpha
يعمل Proalpha ERP على Progress OpenEdge، ومع الإصدار 9 انتقلت المنصة إلى OpenEdge 12. (Proalpha) وهناك أربع واجهات تهمّ جدولة الإنتاج.
- Proalpha ERP REST APIs. تعرض بوابة Proalpha API Portal العامة 108 مواصفات OpenAPI 3.0 ضمن
api/web/v1. وهي المسار المستخدم لإعادة كتابة البيانات، وكذلك لقراءة بيانات القطع والمخزون. - Integration Workbench (INWB). تصف Proalpha منصة INWB بأنها “is a central platform which connects different IT systems, machines, sites” (منصة مركزية تربط أنظمة تقنية المعلومات والآلات والمواقع المختلفة)، وأنها “converts the data into the format of the target system.” (تحوّل البيانات إلى تنسيق النظام المستهدف). (Proalpha) وتستقبل رسائل pAX عبر
POST /api/web/v1/inwb/message. استخدمها لتبادل أوامر الإنتاج من Proalpha وإليه. - Proalpha Integration Platform. أُعلن عن هذه المنصة في أبريل 2026، وهي تعتمد على n8n، و”will be available to customers either on-premises or in the cloud.” (ستكون متاحة للعملاء محليًا أو في السحابة). وتقول Proalpha إنها “will rely on an API-centric reference architecture and REST interfaces.” (ستعتمد على بنية مرجعية تتمحور حول API وواجهات REST). (Proalpha)
- EDI وتصدير الملفات. تتعامل INWB مع تنسيقات الملفات الخاصة بكل قطاع، ويكفي تصدير الملفات لتجربة SkyPlanner.
نقاط نهاية الإنتاج
| واجهة Proalpha API | نقطة النهاية | الاستخدام في التكامل |
|---|---|---|
| Production Workorder Operation Dates API V1 | POST /api/web/v1/pps/prod/setWorkOrderOperationDates | مواعيد البدء والانتهاء المخططة لكل عملية (guid, startTimePoint, endTimePoint) |
| Production Workorder Operation Resource API V1 | POST /api/web/v1/pps/prod/changeWorkOrderOperationResource | المورد الذي اختارته الجدولة (guid, resourceGUID) |
| Production Workorder Operation API V1 | POST /api/web/v1/pps/prod/operationDataEntry/{combined, setup, process} | التأكيدات: postingQty, scrapQty, finishOperation, employeeID, resourceTime |
| Part API | GET/POST /api/web/v1/master/part | القطع مع الحقول partNumber, partType, quantityUnitCode |
| Material API V1 | GET /api/web/v1/mawi/MRPArea/{mrpAreaGuid}/part/{partGuid}/stock | المخزون حسب منطقة MRP |
المصادقة
تستخدم مواصفات Proalpha المنشورة مصادقة HTTP Basic. وتختلف نقاط النهاية بحسب البيئة، وتأخذ الصيغة {schema}://{host}:{port}/api/web/v1/...، على خادم Proalpha لديك أو على Proalpha Cloud. أنشئ حساب مستخدم تقنيًا مخصصًا بصلاحيات تقتصر على الكائنات الواردة في جدول ربط البيانات. ونسّق مع فريق تقنية المعلومات لإتاحة الوصول عبر الشبكة من سحابة SkyPlanner إلى نقطة النهاية تلك.
أما في SkyPlanner، فتستخدم REST API رمز API للمصادقة (SkyPlanner Settings > API)، وهي موثّقة في Swagger/OpenAPI. يكفي رمز API للبدء. ويشرح دليل التكامل التطبيقي كيفية إجراء الاستدعاءات الأولى.
الأحداث والاستعلام الدوري
لا تعرض بوابة Proalpha API Portal أي واجهة API للاشتراك في webhooks. وتصل التغييرات الصادرة عبر:
- تدفق رسائل INWB يرسل أوامر الإنتاج الجديدة والمعدّلة مع عملياتها
- سير عمل n8n على Proalpha Integration Platform
- استعلامات دورية مجدولة عن المخزون عبر Material API
يرسل SkyPlanner إشعارات webhooks عند تغيّر الحالة أو الجدول، لذا تُعاد كتابة البيانات في Proalpha استجابةً للأحداث.
ربط البيانات
| كائن Proalpha أو واجهة API | كائن SkyPlanner | الاتجاه | وتيرة التحديث |
|---|---|---|---|
| Part (Part API) | المنتجات والمواد | Proalpha → SkyPlanner | تحميل أولي، ثم عند حدوث تغيير |
| نموذج عمليات المنتج: process وactivities؛ بنود BOM لأمر الإنتاج | هيكل المنتج والمنتجات الفرعية وخطوات العملية | Proalpha → SkyPlanner | تحميل أولي، ثم عند حدوث تغيير |
| أمر الإنتاج (Fertigungsauftrag) مع الكمية والموعد المطلوب | الأمر والمهام مع الموعد المطلوب والأولوية | Proalpha → SkyPlanner | إرسال عبر INWB أو n8n، أو كل بضع دقائق |
| عمليات أمر الإنتاج: targetSetupTime, targetProcessTime, resource | خطوات العملية مع أوقات التهيئة والمدد | Proalpha → SkyPlanner | مع أمر الإنتاج |
| الموارد ومجموعات الموارد ومجموعات الموارد البديلة | محطات العمل ومجموعات محطات العمل ومحطات العمل البديلة | Proalpha → SkyPlanner | تحميل أولي |
| الفترات في تقويم المورد مع intensity وoverloadIntensity | الورديات وكفاءة محطات العمل | Proalpha → SkyPlanner | تحميل أولي؛ ثم تحديث يومي أو إدارة البيانات في SkyPlanner |
| المخزون حسب منطقة MRP | مخزون المواد | Proalpha → SkyPlanner | كل ساعة أو قبل كل تشغيل للجدولة |
| أوامر الشراء مع تاريخ التسليم | المواد الواردة في تاريخ تسليمها | Proalpha → SkyPlanner | كل ساعة أو قبل كل تشغيل للجدولة |
| setWorkOrderOperationDates | مواعيد البدء والانتهاء المجدولة لكل عملية | SkyPlanner → Proalpha | عند تغيّر الجدول، عبر webhook من SkyPlanner |
| changeWorkOrderOperationResource | محطة العمل التي اختارها المحرك | SkyPlanner → Proalpha | عند تغيّر الجدول |
| operationDataEntry (setup, process, combined) | سجلات الوقت والكميات من Mobile Confirmations | SkyPlanner → Proalpha | مع كل تأكيد أو كل وردية |
| قواعد الجدولة في SkyPlanner | مصفوفة أوقات التهيئة والانتقال، والأدوات بوصفها موارد محدودة السعة، وأعداد المشغّلين | تُدار في SkyPlanner | تُضبط خلال مرحلة التهيئة |
أنماط التكامل
1. التحميل الأولي للبيانات الرئيسية. اقرأ بيانات القطع عبر Part API، وحمّل الموارد ومجموعات الموارد والتقاويم مرة واحدة عبر INWB أو ملف مُصدَّر. حدّد بعناية محطة العمل في SkyPlanner التي تقابل كل مورد في Proalpha. وتتحول مجموعات الموارد البديلة إلى محطات عمل بديلة.
2. مزامنة الأوامر. يرسل تدفق رسائل INWB أو سير عمل n8n أوامر الإنتاج المفتوحة مع عملياتها والأوقات المستهدفة والموارد. تُجلب بيانات المخزون من Material API لكل منطقة MRP، وأوامر الشراء المفتوحة عبر INWB. يعتبر SkyPlanner المواد المطلوبة متاحة في تاريخ تسليم أمر الشراء، ويحدّث المخزون عند تعيين حالة الأمر إلى Delivered.
3. إعادة كتابة الجدول في النظام. لكل عملية جدْولها المحرك أو غيّر موعدها، يستدعي التكامل setWorkOrderOperationDates مع معرّف العملية guid ووقتَي البدء والانتهاء. وإذا اختار المحرك موردًا آخر، يتبع ذلك استدعاء changeWorkOrderOperationResource.
4. تأكيدات التنفيذ في المصنع. يسجّل المشغّلون العمل باستخدام SkyPlanner Mobile Confirmations أو Production Timer. تحافظ سجلات الوقت على تحديث الجدول وتُرحَّل إلى Proalpha عبر operationDataEntry. إذا كان مصنعك يسجّل التأكيدات بالفعل على أجهزة PDC، فاكتفِ بقناة واحدة لتجنّب الترحيل المكرر.
5. قواعد المسؤولية عن البيانات وحل التعارضات. وثّق هذه القواعد قبل بدء التشغيل الفعلي:
| البيانات | النظام المسؤول |
|---|---|
| الأصناف، ونماذج العمليات، والكميات، وحالة أمر الإنتاج | Proalpha |
| تسلسل العمليات، وأوقات البدء والانتهاء، وتخصيص الموارد | SkyPlanner |
| مصفوفة أوقات التجهيز، والأدوات، وأعداد المشغّلين | SkyPlanner |
| الورديات والغياب | نظام واحد يُختار أثناء تحديد النطاق |
| التأكيدات وترحيل حركات المخزون | Proalpha، ويتلقى البيانات من سجلات الوقت في SkyPlanner أو من PDC |
إذا كان Proalpha APS أو Feinplanung مفعّلًا، فحدّد النظام المسؤول عن مواعيد العمليات. عندما يكتب نظاما تخطيط المواعيد نفسها، يطمس كل منهما تعديلات الآخر. ومع Autopilot، يعيد SkyPlanner الجدولة تلقائيًا عند حدوث تغييرات في الإنتاج.
خطوات المشروع المعتادة
يكتمل التنفيذ عادةً خلال أسابيع من بدء التهيئة للاستخدام. وقبل ذلك، يمكنك استخدام بياناتك الخاصة في التجربة المجانية لمدة 30 يومًا. صدّر أوامر الإنتاج المفتوحة والعمليات والموارد من Proalpha إلى CSV أو Excel، ثم استوردها وتحقّق من صحة الجدول.
- ورشة مطابقة البيانات. اتفق مع شريك Proalpha على جدول المطابقة وقواعد المسؤولية عن البيانات ودورية المزامنة وقناة التأكيدات.
- إعداد الواجهات. فعّل واجهات REST API وتدفقات INWB، وأنشئ حساب المستخدم التقني وأتح الوصول عبر الشبكة. ابدأ ببيئة الاختبار، ثم انتقل إلى بيئة الإنتاج.
- التحميل الأولي. الأصناف والموارد ومجموعات الموارد والتقاويم.
- مزامنة الأوامر والمخزون وأوامر الشراء. إرسال أوامر الإنتاج عبر INWB أو n8n، والاستعلام الدوري عن المخزون، مع إعادة المحاولة عند الإخفاق.
- إعداد القيود في SkyPlanner. مصفوفة أوقات التجهيز، والأدوات، وأعداد المشغّلين، ومحطات العمل البديلة.
- إعادة كتابة الجدول في النظام. استخدام setWorkOrderOperationDates وchangeWorkOrderOperationResource، وإضافة operationDataEntry في هذه المرحلة.
- التشغيل المتوازي. قارن مواعيد SkyPlanner بالخطة الحالية وصحّح البيانات الرئيسية.
- بدء التشغيل الفعلي. فعّل إعادة الكتابة في النظام بمجرد تطابق البيانات.
ما يجب مراعاته عند التخطيط للتكامل مع Proalpha
- لا يوجد كائن لمسار الإنتاج. يعتمد Proalpha في التخطيط على نماذج عمليات المنتجات. الأدوات المنقولة من مشاريع SAP أو Business Central تبحث عن مسارات الإنتاج، فتفوتها بيانات. اقرأ العمليات وبنود BOM من أمر الإنتاج.
- كثافة فترات التقويم. تتضمن فترات التقويم الحقلين intensity وoverloadIntensity. حوّل قيمهما إلى ورديات وكفاءات في SkyPlanner بدلًا من نسخ الساعات كما هي.
- وحدات القياس. تحقّق من quantityUnitCode، ومن كون وقت التهيئة المستهدف محسوبًا لكل أمر أم لكل قطعة. فالوحدات الخاطئة تؤدي إلى حساب جميع المدد بصورة غير صحيحة.
- نقاط نهاية مستضافة لدى العميل. تعمل طبقة REST على خادم Proalpha لديك. وتتوقف بداية المشروع على جاهزية جدران الحماية والمنافذ والشهادات، لذا جهّزها وأتح الوصول مبكرًا.
- الإصدار المستخدم. تحقّق مع شريكك من واجهات REST API التي يتيحها إصدار Proalpha لديك قبل اعتماد مطابقة البيانات.
- وثائق تتطلب تسجيل الدخول. تتوفر مساعدة Proalpha عبر الإنترنت من خلال Documentation Portal. تحقّق من أسماء الحقول مع شريكك بدلًا من تخمينها.
التكامل مع Proalpha: من يتولى إعداده ودعمه؟
- يتولى فريق SkyPlanner إعداد التكامل خلال التهيئة للاستخدام، ويدعمه بعد بدء التشغيل الفعلي. تختلف بنية البيانات والعمليات من تثبيت Proalpha إلى آخر، وهنا يأتي دور هذه الخبرة.
- يمكن لشريك Proalpha المشاركة. فهو يعرف نماذج عملياتك وتدفقات INWB والإصدار المستخدم، ويمكنه إعداد الوصول إلى API. ويوفر SkyPlanner واجهة REST API ووثائق Swagger/OpenAPI وإشعارات webhooks.
- يمكن لمطوّريك تطوير التكامل باستخدام واجهة REST API نفسها ورمز API. ويقدّم فريق SkyPlanner المساعدة عند الحاجة. وثائق المنتج متاحة للجميع في وثائق SkyPlanner.
يبدأ سعر SkyPlanner من 199 € شهريًا، ويشمل 5 محطات عمل، مع فوترة شهرية. ويُقدَّم لك عرض سعر التكامل مسبقًا وفقًا لعملياتك واحتياجاتك، إلى جانب باقتك، لتعرف التكلفة الكاملة قبل البدء. تعرّف على طريقة تخطيط الطاقة الإنتاجية في Proalpha في مقال هل يدعم proALPHA تخطيط الإنتاج ضمن الطاقة الفعلية للآلات والعاملين؟، واطّلع على النظرة العامة في صفحة proALPHA، وعلى الأنظمة الأخرى في مركز تكاملات ERP.
آراء المصنّعين في SkyPlanner
2 ساعةمن الوقت الموفَّر كل أسبوع
“نقل SkyPlanner تخطيط الإنتاج لدينا من جداول Excel إلى تحسين الإنتاج في الوقت الفعلي.”
Kalle Kalliomäki، اختصاصي سلسلة الإمداد
UTU · لوحات التوزيع ومعدات الفصل والتوصيل الكهربائية
يوفّر تخطيط الإنتاج 2 ساعة من وقت العمل كل أسبوع، وتصل قائمة مهام جديدة إلى خط الإنتاج في ثوانٍ.
+90%في كفاءة الإنتاج
“ارتفعت كفاءة الإنتاج بنسبة 90%.”
Abdul Rucyinga، رئيس قسم تقنية المعلومات
Laboratory & Allied · تصنيع الأدوية
ارتفعت كفاءة الإنتاج بنسبة 90%، ويستغرق إعداد خطة محسّنة لثلاثة أشهر تشمل جميع محطات العمل أقل من 30 دقيقة.
99.2%الالتزام بمواعيد التسليم
“أتاح لنا SkyPlanner رؤية أوضح لتحديد الاختناقات، وجعل إدارة الإنتاج أكثر وضوحًا.”
Toni Tuori، مدير الإنتاج
Piristeel · أنظمة السلامة على الأسطح وتصريف مياه الأمطار
بلغ الالتزام بمواعيد التسليم 99.2% هذا العام، وتوفّر الجدولة ما يصل إلى أربع ساعات من وقت العمل يوميًا.
توقفات أقلبسبب نقص المواد
“تكمن قيمة SkyPlanner لنا في أنه أداة فعّالة في الاستخدام اليومي، ولا سيما في تحديد مواعيد التسليم.”
Tommi Männistö، مدير تخطيط الإنتاج
Eskomatic · التشغيل الميكانيكي للغير
تتيح جدولة الأحمال تلقائيًا تحديد مواعيد تسليم أدق، وقد انخفضت توقفات الإنتاج الناجمة عن نقص المواد انخفاضًا حادًا.
الأسئلة الشائعة
ما واجهات Proalpha التي يستخدمها التكامل؟
يستخدم واجهات REST API في Proalpha لبيانات الأصناف والمخزون، ولإعادة كتابة المواعيد والموارد والتأكيدات في النظام. وتنقل تدفقات رسائل INWB أو Integration Platform القائمة على n8n أوامر الإنتاج مع عملياتها. أما الملفات المصدّرة فتُستخدم للتجربة ولتحميل كميات كبيرة من البيانات.
أين تُسجَّل المواعيد المخططة في Proalpha؟
تُسجَّل في عملية أمر الإنتاج عبر setWorkOrderOperationDates، مع تحديد وقتَي البدء والانتهاء. وإذا نقل المحرك المهمة إلى آلة أخرى، يُحدَّث المورد عبر changeWorkOrderOperationResource.
هل يدعم Proalpha إشعارات webhooks؟
لا تُدرج Proalpha API Portal أي واجهة API للاشتراك في إشعارات webhooks. تصل التغييرات إلى SkyPlanner عبر تدفقات رسائل INWB أو مسارات عمل n8n أو الاستعلام الدوري. وتتيح إشعارات webhooks الخاصة بـSkyPlanner إعادة الكتابة في النظام استجابةً للأحداث.
هل يمكن ترحيل تأكيدات المشغّلين إلى Proalpha؟
نعم. تُرحَّل سجلات الوقت من SkyPlanner Mobile Confirmations عبر operationDataEntry، مع الكمية ووقت الموظف ووقت المورد. اكتفِ بقناة تأكيد واحدة إذا كانت أجهزة PDC مستخدمة أيضًا.
هل نحتاج إلى Proalpha APS، وماذا لو كنا نستخدمه بالفعل؟
لا تحتاج إليه. يتولى SkyPlanner تخطيط الإنتاج بنفسه انطلاقًا من أوامر الإنتاج والعمليات والموارد لديك، ويُنشئ جدولًا يراعي الطاقة الفعلية للآلات والعاملين، ويحافظ Autopilot على تحديثه. إذا كان Proalpha APS مفعّلًا، فحدّد أثناء تحديد النطاق النظام المسؤول عن مواعيد العمليات. عندئذٍ يكتب SkyPlanner المواعيد التي يتولى مسؤوليتها فقط، فلا تطمس أيٌّ من الخطتين تعديلات الأخرى أبدًا.
هل يمكننا تجربة SkyPlanner قبل إنشاء التكامل؟
نعم. تدعم التجربة المجانية لمدة 30 يومًا ما يصل إلى 20 محطة عمل، باستخدام ملف CSV أو Excel تُصدّر إليه أوامر الإنتاج لديك، ولا تحتاج إلى بطاقة ائتمان. ابدأ التجربة، أو تواصل مع المبيعات لتحديد نطاق التكامل.
