دليل تكامل Epicor Kinetic لجدولة الإنتاج باستخدام SkyPlanner APS

توضح Epicor: “All Kinetic services, including business objects, processes, reports, BAQs, and Epicor Functions, are accessible through REST endpoints.” (يمكن الوصول إلى جميع خدمات Kinetic، بما فيها كائنات الأعمال والعمليات والتقارير وBAQs وEpicor Functions، عبر نقاط نهاية REST.) يعتمد تكامل الجدولة على أربع تقنيات من Epicor:

1. Kinetic REST API v2 (OData v4). تُتاح كائنات الأعمال على هيئة خدمات تحمل أسماء بالنمط Erp.BO.<Name>Svc. والمسار المعتاد هو /api/v2/odata/{Company}/Erp.BO.{Svc}/{EntitySet}. لا يزال REST v1 متاحًا، لكنه إصدار قديم، لذا اعتمد على v2 في بناء التكامل. تحقّق من مجموعات الكيانات والأساليب المتاحة لإصدارك في REST Help على المسار /api/help/v2/.
2. استعلامات Business Activity Queries (BAQ) عبر REST. يُتاح استعلام BAQ على المسار /api/v2/odata/{Company}/BaqSvc/{BAQ}/Data. وهذا هو المسار العملي لقراءة مستخرجات بيانات التخطيط التي تجمع JobHead وJobOper وJobMtl وPartWhse وPORel في استدعاء واحد (مثال من مجتمع المستخدمين).
3. Epicor Functions (EFx). دوال تُنفَّذ على الخادم ويمكن استدعاؤها على المسار /api/v2/efx/{Company}/{Library}/{Function}. تذكر Epicor أنها “can be triggered from multiple entry points, including BPMs, REST services, schedules, and application events.” (يمكن تشغيلها من نقاط دخول متعددة، منها BPMs وخدمات REST والمهام المجدولة وأحداث التطبيق).
4. توجيهات BPM. تُفعّل Method and Data Directives عند تغيير أمر إنتاج أو عملية، ويمكنها استدعاء دالة ترسل البيانات إلى خارج النظام.

بالنسبة إلى الملفات، تتولى DMT الاستيراد إلى النظام، وتتولى عمليات تصدير BAQ استخراج البيانات منه. وتوفر Epicor أيضاً Epicor Automation Studio، الذي تصفه بأنه “a low-code app for integration-led automations” (تطبيق قليل البرمجة لأتمتة الإجراءات القائمة على التكامل). تجنبوا الوصول المباشر إلى قاعدة البيانات: تعمل REST وBAQs والدوال بالطريقة نفسها في البيئة المحلية وعلى Kinetic Cloud.

لا توثّق Epicor واجهة API عامة لإرسال إشعارات webhook إلى الخارج، لذا تصل تغييرات Kinetic إلى SkyPlanner بإحدى طريقتين:

• استجابةً للأحداث. يستدعي توجيه BPM Data Directive على JobHead أو JobOper إحدى دوال Epicor Function، فتُرسل الدالة أمر الإنتاج الذي تغيّر إلى واجهة REST API الخاصة بـSkyPlanner.
• الاستعلام الدوري المجدول. يُشغّل استعلام BAQ يرشّح البيانات حسب تاريخ التغيير كل بضع دقائق أو كل ساعة. هذا النهج أبسط من حيث الإدارة والتعافي من الأعطال.

وفي الاتجاه الآخر، يدفع SkyPlanner تغييرات الحالة والجدول عبر إشعارات webhook الخاصة به. تتلقاها البرمجيات الوسيطة لديكم أو نقطة نهاية EFx، ثم تكتبها إلى Kinetic.

1. التحميل الأولي للبيانات الرئيسية. اقرأ بيانات الأصناف ومجموعات الموارد والموارد والقدرات والتقاويم والموظفين. أنشئ محطات العمل في SkyPlanner انطلاقًا من موارد Kinetic، ومجموعات محطات العمل انطلاقًا من مجموعات الموارد. قسّم نتائج القراءة الكبيرة إلى صفحات باستخدام $top و$skip، أو اسحب البيانات بالجملة عبر استعلام BAQ.

2. مزامنة الطلبات. أرسل أوامر الإنتاج الصادرة للتنفيذ والمثبّتة مع عملياتها وموادها. اسحب شجرة أمر الإنتاج باستخدام GetDatasetForTree أو استعلام BAQ، لا كيانًا تلو الآخر. أبقِ أوامر MRP غير المثبّتة في Kinetic إلى أن تُثبَّت. زامِن دفعات أوامر الشراء المفتوحة مع تواريخ استحقاقها بالتوازي مع قراءة المخزون. يعتبر SkyPlanner المواد المطلوبة متاحة في تاريخ التسليم، ويحدّث المخزون عند تعيين حالة أمر الشراء إلى Delivered. وبذلك تراعي الجدولة المخزون والمشتريات الواردة معًا.

3. إعادة كتابة الجدول في Kinetic. يرسل webhook الخاص بـSkyPlanner موعدَي البدء والانتهاء المخططين ومحطة العمل لكل عملية إلى نقطة نهاية EFx (/api/v2/efx/{Company}/{Library}/{Function}). وتكتب الدالة البيانات عبر محرك الجدولة في Kinetic، وهو كائن الأعمال نفسه الذي تعتمد عليه الجدولة في Job Entry ولوحات الجدولة (مثال من مجتمع المستخدمين):

1. ينشئ ScheduleEngine.GetNewParamsForJob مجموعة البيانات التي يحتاجها محرك الجدولة لأمر الإنتاج.
2. تضبط الدالة رقم أمر الإنتاج وتسلسلَي التجميع والعملية وتاريخ البدء المخطط ووقته، ثم تستدعي ScheduleEngine.MoveJobItem.
3. عندما يُسنِد SkyPlanner العملية إلى مورد آخر في المجموعة، ينقلها إليه ScheduleEngine.ChangeResource. أما استخدام MoveJobItem وحده فيُبقي المورد الافتراضي للمجموعة.
4. تُفعّل الدالة قفل الجدولة لأمر الإنتاج (JobHead.SchedLocked، وهو خيار Lock في Job Entry)، لكي يُبقي Global Scheduling التواريخ التي حدّدها SkyPlanner.

إن جمع هذه الاستدعاءات في دالة Epicor Function واحدة يضمن تنفيذ الكتابة لكل أمر إنتاج كوحدة لا تتجزأ، ويتيح لك إضافة قواعد التحقق الخاصة بك. وإذا كان الموقع يفضّل عدم استخدام دالة مخصّصة، فيمكن تنفيذ التسلسل نفسه باستدعاءات REST مباشرة إلى Erp.BO.ScheduleEngineSvc. لا تكتب أبدًا في ResourceTimeUsed أو حقول التاريخ في JobOper مباشرةً؛ فهذا يتجاوز المحرك ويُفقد التخصيصات على لوحات الجدولة اتساقها.

4. تأكيدات التنفيذ في المصنع. يسجّل المشغّلون العمل في SkyPlanner باستخدام Mobile Confirmations أو Production Timer أو Quick Log Mode. ويتحوّل كل سجل وقت مغلق إلى سجل عمل في Kinetic عبر Erp.BO.LaborSvc: باستخدام StartActivity وEndActivityByEmp للنشاط الجاري، أو Labors مع Update للإدخالات المسجّلة بعد التنفيذ. إذا كان موقعك يشترط الموافقة، فأدرِج submitForApproval في مسار التكامل ونطاق الصلاحيات.

5. قواعد ملكية البيانات ومعالجة التعارضات. وثّقوها قبل بدء التشغيل الفعلي:

تُفعّل خاصية قفل الجدولة لأوامر الإنتاج التي يجدولها SkyPlanner، فلا تغيّر Global Scheduling مواعيدها. أبقوا جدولة Kinetic للموارد التي لا يتولى SkyPlanner جدولتها.

يكتمل التنفيذ عادةً خلال أسابيع من بدء مرحلة التهيئة. ويشمل مشروع Kinetic ما يلي:

1. تجربة لمدة 30 يوماً باستخدام أوامر الإنتاج والعمليات والموارد المصدّرة بصيغة CSV أو Excel، قبل البدء بأي تطوير.
2. مفتاح API، ونطاق وصول، وحساب مستخدم مخصص للتكامل، واستعلامات BAQ التي يقرأها التكامل.
3. مطابقة البيانات الرئيسية: ربط القدرات ومجموعات الموارد والموارد وتقاويم العمل والموظفين بما يقابلها من محطات عمل ومجموعات وورديات وأفراد في SkyPlanner.
4. التحميل الأولي للأصناف وطرق التصنيع (BOM والعمليات) والموارد.
5. مزامنة أوامر الإنتاج وأوامر الشراء (تواريخ استحقاق PORel)، إلى جانب مخزون PartWhse.
6. إعادة كتابة مواعيد العمليات المخططة في Kinetic عبر ScheduleEngineSvc (MoveJobItem, ChangeResource) ضمن دالة Epicor Function، مع تفعيل قفل أمر الإنتاج.
7. ترحيل تأكيدات التنفيذ في المصنع كسجلات عمل عبر LaborSvc.
8. الاختبار بالتوازي مع جدول Kinetic الحالي، ثم بدء التشغيل الفعلي.

لا يستخدم مصنعان Kinetic بالطريقة نفسها. فتختلف من موقع إلى آخر مسارات الإنتاج القائمة على القدرات، وتقاويم مجموعات الموارد، وتصميم استعلامات BAQ، وتوجيهات BPM، وأساليب إعادة الكتابة الخاصة بكل إصدار. وضبط هذه العناصر على نحو صحيح هو ما يصنع الفارق بين جدول يثق به المخططون وجدول يضطرون إلى إعادة العمل عليه.

1. يتولى فريق SkyPlanner إعداده خلال مرحلة التهيئة ودعمه بعد بدء التشغيل الفعلي. يطابق الفريق مواردكم وأوامر الإنتاج ودفعات أوامر الشراء، ويعدّ قراءات BAQ ومشغّلات BPM ودالة إعادة الكتابة. ويربط واجهة REST API وإشعارات webhook في SkyPlanner بـKinetic REST v2. ويستمر الدعم عند تغيير استعلامات BAQ أو توجيهات BPM أو إصدار Kinetic لديكم.
2. شريك Epicor الذي تتعاملون معه. يستطيع الشركاء الذين يطوّرون بالفعل استعلامات BAQ وتوجيهات BPM وEpicor Functions العمل باستخدام واجهة REST API الموثقة نفسها من SkyPlanner، التي تقرأ وتكتب الأوامر والمنتجات والمواد وخطوات التصنيع وسجلات الوقت.
3. مطوّروكم الداخليون. تستطيع فرقكم ذات الخبرة في Kinetic REST تطوير التكامل مباشرةً، أو باستخدام Automation Studio إذا كنتم تستخدمونه. يكفي مفتاح API من SkyPlanner للبدء (دليل التكامل التعليمي)، ويساعدكم فريق SkyPlanner عند الحاجة. وتوثيق المنتج متاح للجميع في وثائق SkyPlanner.

يُستخدم النمط نفسه القائم على API وإشعارات webhook في التشغيل الفعلي مع أنظمة ERP أخرى، مثل UTU. وفي Laboratory & Allied، أنجز فريق تقنية المعلومات الداخلي معظم تكامل SAP Business One بنفسه، بمساعدة SkyPlanner.

تبدأ جميع المسارات بالطريقة نفسها: استخدموا أولاً التجربة المجانية لمدة 30 يوماً مع بيانات مستوردة بصيغة CSV، وتحققوا من ملاءمة الجدول، ثم طوّروا التكامل. تبدأ الأسعار من 199 € شهرياً وتشمل 5 محطات عمل، مع فوترة شهرية وإمكانية الإلغاء في أي وقت. يُقدَّم عرض سعر التكامل مسبقاً وفقاً لعملياتكم واحتياجاتكم، إلى جانب باقتكم، لتعرفوا التكلفة الكاملة قبل البدء.