التكاملات / ERP / Microsoft Dynamics 365 Supply Chain Management
دليل تكامل Dynamics 365 Supply Chain Management لجدولة الإنتاج باستخدام SkyPlanner APS
يوضح دليل تكامل Dynamics 365 Supply Chain Management هذا للشركاء وفرق تقنية المعلومات كيفية ربط Microsoft Dynamics 365 Supply Chain Management بـ SkyPlanner APS. يتكامل SkyPlanner مع Dynamics 365 Supply Chain Management في الاتجاهين باستخدام كيانات البيانات القياسية فيه:
- تُستورد أوامر الإنتاج وعمليات المسار ومهام المسار وبنود BOM والموارد والتقويمات والمنتجات التي تم إصدارها والمخزون الفعلي وبنود أوامر الشراء.
- تُعاد أوقات البدء والانتهاء المجدولة والمورد المختار إلى أمر الإنتاج وعمليات المسار التابعة له.
- تُعاد ساعات المشغّلين والكميات عبر دفتر يومية بطاقة المسار.
- تُرسل آليات webhooks في SkyPlanner تغييرات الجدول فور حدوثها.
يضبط فريق SkyPlanner التكامل بما يتناسب مع إعدادات Supply Chain Management لديك أثناء التهيئة، ويواصل دعمه بعد بدء التشغيل الفعلي. هذا الدليل موجّه للشركاء والمطوّرين الراغبين في المشاركة أو في بناء حلول بأنفسهم باستخدام REST API الموثّقة من SkyPlanner (مرجع API).
خيارات التكامل مع Dynamics 365 SCM
يتيح Supply Chain Management الوصول إلى بياناته عبر كيانات البيانات. وهناك أربعة خيارات تهم جدولة الإنتاج:
- نقطة نهاية OData v4 REST. تتيح
[Your organization's root URL]/dataالوصول إلى كل كيان بيانات يحمل العلامة IsPublic، مع دعم كامل للإنشاء والقراءة والتحديث والحذف. وتدعم$filterو$countو$orderbyو$skipو$topو$selectو$expandمن المستوى الأول. يتحكم الخادم في تقسيم النتائج إلى صفحات، بحد أقصى 10,000 سجل، ويمكن للطلبات المجمّعة تجميع عمليات الكتابة في مجموعات تغييرات. تعمل OData بصورة متزامنة. (المصدر) - Batch data API. تنقل Data management package REST API والتكاملات المتكررة كميات كبيرة من البيانات بصورة غير متزامنة. وتذكر Microsoft: “If the volume is more than a few hundred thousand records, use the batch data API.” (إذا تجاوز حجم البيانات بضع مئات الآلاف من السجلات، فاستخدم batch data API.) وهي أيضًا واجهة API المدعومة في البيئات المحلية. (المصدر)
- أحداث الأعمال. تنشر تطبيقات Finance and operations أحداث الأعمال إلى Azure Service Bus أو Event Grid أو نقاط نهاية HTTPS أو Power Automate. (المصدر)
- الخدمات المخصّصة وإجراءات OData. تنفّذ خدمات X++ المخصّصة وإجراءات OData المرتبطة منطق الأعمال عند الطلب.
يستخدم تكامل SkyPlanner نقطة نهاية OData لنقل البيانات اليومي، وbatch data API للتحميل الأولي عند نقل كميات كبيرة من البيانات. ولا يُثبَّت أي شيء داخل Supply Chain Management.
المصادقة
سجّل تطبيقًا في Microsoft Entra ID باستخدام كيان خدمة (service principal). وفي Supply Chain Management، اربط هذا التطبيق بمستخدم لديه أدوار الأمان التي يحتاجها التكامل. يقرأ التكامل بيانات الإنتاج والموارد والمخزون، ويكتب بيانات جدولة أوامر الإنتاج ودفاتر اليومية. وتُطلب الرموز من Entra ID باستخدام بيانات اعتماد العميل.
تحدد قاعدتان البيانات التي يمكن للتكامل الوصول إليها:
- الكيانات القانونية. تُرجع OData بيانات الشركة الافتراضية ما لم يتضمن الطلب
?cross-company=true. وتستخدم المصانع متعددة المواقعdataAreaIdلتصفية البيانات. - الأسماء العامة. أسماء الكيانات الواردة أدناه هي الأسماء المستخدمة في إدارة البيانات. وقد تختلف عنها أسماء مجموعات OData العامة، لذا استخرجها من
/data/$metadataفي بيئتك.
أما في SkyPlanner، فتستخدم واجهة REST API رمز API للمصادقة (SkyPlanner Settings > API)، وهي موثّقة بصيغة Swagger/OpenAPI. يشرح دليل التكامل التعليمي كيفية إجراء الاستدعاءات الأولى.
ربط البيانات
| كيان D365 SCM | كائن SkyPlanner | الاتجاه | وتيرة المزامنة |
|---|---|---|---|
| المنتجات التي تم إصدارها (ItemNumber) | المنتجات والمواد | SCM → SkyPlanner | تحميل أولي، ثم التغييرات فقط |
| بنود BOM للإنتاج (ProdProductionOrderBillOfMaterialsLineEntity)، وبنود BOM | بنية المنتج ومواد كل أمر | SCM → SkyPlanner | مع كل مزامنة للأوامر |
| المسار وإصداراته وعملياته وخصائص العمليات (RouteOperationPropertiesV2Entity) | خطوات العملية مع أوقات الإعداد والتشغيل | SCM → SkyPlanner | تحميل أولي، ثم عند التغيير |
| الموارد (OpResOperationsResourceEntity) ومجموعات الموارد وقدراتها | محطات العمل ومجموعاتها ومعدلات الكفاءة | SCM → SkyPlanner | تحميل أولي، ونادرًا بعد ذلك |
| تقويمات أوقات العمل وأيام التقويم وفتراته الزمنية وتعيينات التقويمات | الورديات | SCM → SkyPlanner | يوميًا، أو تُدار الورديات في SkyPlanner |
| رؤوس أوامر الإنتاج (ProdProductionOrderHeaderEntity) | الأوامر مع تواريخ استحقاقها وحالتها | SCM → SkyPlanner | كل بضع دقائق أو عند وقوع حدث أعمال |
| عمليات المسار (ProdProductionOrderRouteOperationEntity) ومهام المسار (ProdProductionOrderRouteJobEntity) | المهام مع مددها والموارد المطلوبة لها | SCM → SkyPlanner | مع كل مزامنة للأوامر |
| المخزون الفعلي | أرصدة المخزون | SCM → SkyPlanner | كل ساعة أو عند تشغيل الجدولة |
| بنود أوامر الشراء مع تاريخ التسليم | المواد الواردة؛ يُحدَّث المخزون عند تعيين حالة أمر الشراء إلى Delivered | SCM → SkyPlanner | كل ساعة أو عند تشغيل الجدولة |
| تاريخ ووقت البدء والانتهاء المجدولان ومورد العمليات لكل عملية مسار | البداية والنهاية المخططتان ومحطة العمل لكل عملية | SkyPlanner → SCM | عند تغيير الجدول، عبر webhook من SkyPlanner |
| دفتر يومية بطاقة المسار (ProdRouteCardProductionJournalEntryEntity: RegisteredHours, ReportedGoodInventoryQuantity) | سجلات الوقت والكميات | SkyPlanner → SCM | مع كل تأكيد أو كل وردية، إذا اختير هذا الخيار |
| إعداد القيود في SkyPlanner | مصفوفة أوقات الإعداد، والأدوات كموارد محدودة السعة، وأعداد المشغّلين، والموارد البديلة | تُدار في SkyPlanner | تُضبط أثناء التهيئة |
أنماط التكامل
1. التحميل الأولي للبيانات الرئيسية. حمّل الموارد ومجموعات الموارد والتقويمات والمنتجات التي تم إصدارها والمسارات وقوائم BOM. استخدم batch data API عندما تصل الأحجام إلى مئات الآلاف من السجلات، وتقسيم الصفحات في OData فيما عدا ذلك. اربط كل مورد في SCM بمحطة عمل في SkyPlanner. ولا تكتفِ بربط مجموعات الموارد: فجدولة العمليات تحجز المجموعات، لكن التنفيذ في المصنع يتم على الموارد نفسها.
2. مزامنة الأوامر. اقرأ أوامر الإنتاج المثبّتة التي تقع حالاتها ضمن مسؤولية SkyPlanner، وعادةً ما تكون Scheduled وReleased، مع عمليات مساراتها ومهامها وبنود BOM. واقرأ أيضًا بنود أوامر الشراء المفتوحة. يعتبر SkyPlanner المواد المطلوبة متاحة في تاريخ تسليم أمر الشراء، ويحدّث المخزون عند تعيين حالة أمر الشراء إلى Delivered.
استبعد أوامر الإنتاج المخططة ما لم تكن مشمولة صراحةً في النطاق. إذ يعيد Planning Optimization إنشاءها في كل تشغيل.
3. إرسال نتائج الجدولة إلى SCM. لكل عملية وضعها محرك الجدولة في الجدول أو غيّر موعدها، يكتب SkyPlanner تاريخ ووقت البدء والانتهاء المجدولين ومورد العمليات في عملية المسار، مستخدمًا أسماء الحقول الواردة في /data/$metadata في بيئتك. وتُرسل التغييرات ضمن مجموعات تغييرات في طلبات OData المجمّعة، لتُطبَّق نتائج كل تشغيل للجدولة كتحديث واحد متّسق.
4. تأكيدات العمل في المصنع. يسجّل المشغّلون العمل باستخدام SkyPlanner Mobile Confirmations أو Production Timer، وتُبقي سجلات الوقت الجدول محدّثًا. ويمكن إعادة الساعات وكميات الإنتاج السليم كبنود في دفتر يومية بطاقة المسار. أما Report as finished فيبقى في النظام الذي تنفّذه فيه حاليًا، سواء في SCM أو Production floor execution.
اختر قناة واحدة لكل عملية ترحيل. فتسجيل الساعات نفسها من SkyPlanner ومن Production floor execution يؤدي إلى تكرارها.
5. قواعد المسؤولية والتعارض. وثّقها قبل بدء التشغيل الفعلي:
| البيانات | النظام المسؤول |
|---|---|
| المنتجات وقوائم BOM والمسارات والكميات وحالة الأمر وحساب التكاليف | Supply Chain Management |
| أوامر الإنتاج المخططة | Planning Optimization |
| تسلسل العمليات والبداية والنهاية المجدولتان وتعيين الموارد | SkyPlanner |
| مصفوفة أوقات الإعداد والأدوات وأعداد المشغّلين والموارد البديلة | SkyPlanner |
| الورديات والغياب | نظام واحد يُختار أثناء تحديد النطاق |
| ترحيل الساعات وكميات الإنتاج | Supply Chain Management، استنادًا إلى سجلات الوقت في SkyPlanner إذا اختير هذا الخيار |
المصدر الرئيسي للتعارض هو جدولة المهام داخل SCM نفسه. فإذا أعاد المخطِّط جدولة أمر في SCM، تحل المواعيد الجديدة محل مواعيد SkyPlanner. استخدم IsProductionOrderSchedulingLocked في رأس أمر الإنتاج للأوامر التي يتولى SkyPlanner جدولتها. تعامل مع أي أمر عُدِّل في SCM باعتباره إصدارًا جديدًا وأعِد مزامنته. ويعيد Autopilot الجدولة تلقائيًا عند تغيّر الإنتاج.
ما الذي يشمله المشروع؟
يكتمل التنفيذ عادةً خلال أسابيع من بدء التهيئة. وقبل ذلك، يمكنك استخدام بياناتك في التجربة المجانية لمدة 30 يومًا. صدِّر الموارد ومسارات الإنتاج وأوامر الإنتاج المفتوحة باستخدام مشروع تصدير في إدارة البيانات أو إضافة Excel، ثم استوردها بصيغة CSV أو Excel وتحقّق من صحة الجدول.
- تحديد النطاق. حدِّد جدول ربط البيانات، وحالات الأوامر التي يتولى SkyPlanner جدولتها، وتواتر المزامنة، وقناة الترحيل.
- الوصول. سجِّل تطبيق Entra ID واربطه بمستخدم SCM ذي أدوار تمنحه الحد الأدنى من الصلاحيات، وتحقّق من أسماء الكيانات العامة في
/data/$metadata. ابدأ ببيئة الاختبار، ثم انتقل إلى بيئة الإنتاج. - التحميل الأولي. الموارد والتقويمات والمنتجات التي تم إصدارها ومسارات الإنتاج وقوائم المواد (BOM).
- مزامنة الأوامر وأوامر الشراء. استعلم دوريًا عن السجلات المعدَّلة باستخدام
$filter، مع الاستعانة بأحداث الأعمال إن كانت متاحة في كتالوجك. - إعداد القيود في SkyPlanner. مصفوفة أزمنة التجهيز، والأدوات، وأعداد المشغّلين، والآلات أو العاملون البدلاء.
- إرسال نتائج الجدولة إلى SCM. تحديث عمليات مسارات الإنتاج على دفعات، وقفل الجدولة للأوامر التي يتولى SkyPlanner جدولتها.
- الاختبار بالتوازي. شغِّل SkyPlanner بالتوازي مع الخطة الحالية، وقارن المواعيد، وصحِّح البيانات الرئيسية.
- بدء التشغيل الفعلي. فعِّل إرسال نتائج الجدولة إلى النظام بعد التأكد من تطابق البيانات.
ما الذي يجب مراعاته عند التكامل مع Dynamics 365 SCM؟
- تجنّب احتساب تأثير الكفاءة مرتين. يحتسب SCM الوقت وفق المعادلة “Scheduling time = Time x 100 / Efficiency percentage.” (وقت الجدولة يساوي الوقت مقسومًا على الكفاءة بعد تحويل نسبتها المئوية إلى عدد عشري). اربط الكفاءة بكفاءة محطة العمل في SkyPlanner مرة واحدة، ولا تطبّقها مجددًا على أوقات سبق تعديلها.
- التقويمات مرتبطة بمجموعات الموارد. اقرأ تعيين التقويم لكل مجموعة موارد ولكل مورد، وإلا أصبحت حسابات الطاقة الإنتاجية غير دقيقة.
- جدولة العمليات مقابل جدولة المهام. الأوامر التي تُجدول باستخدام جدولة العمليات لا تتضمن أوقات بدء وانتهاء ولا موردًا محددًا. زامِن عمليات مسارات الإنتاج ومتطلبات الموارد، لا التواريخ وحدها.
- إعدادات الطاقة المحدودة. قد يحمِّل SCM الموارد فوق طاقتها إذا كان الحقل Finite capacity مضبوطًا على No. اضبط SkyPlanner بحيث تراعي الجدولة الحدود الفعلية لكل قيد.
- 32 موردًا لكل عملية. يضع SCM حدًا أقصى لجدولة المهام يبلغ 32 موردًا لكل عملية. أما في SkyPlanner، فتُحدَّد البدائل ضمن مجموعات محطات العمل ومحطات العمل البديلة.
- تقسيم النتائج وحجم البيانات. يقسِّم OData النتائج إلى صفحات تضم كل منها 10,000 سجل، ويدعم توسيع العلاقات إلى مستوى واحد. استخدم batch data API عند تحميل كميات كبيرة من البيانات للمرة الأولى.
- الكيانات القانونية. من دون
cross-company=trueوعوامل التصفيةdataAreaId، لن تُزامَن إلا الشركة الافتراضية في المصنع الذي يعمل ضمن عدة شركات.
من يتولى إعداد التكامل؟
يشمل العمل ربط البيانات بما يتوافق مع مسارات الإنتاج والموارد وإعدادات SCM لديك، إلى جانب إعداد القيود في SkyPlanner: مصفوفة أزمنة التجهيز، والأدوات، وأعداد المشغّلين، والموارد البديلة.
- يتولى فريق SkyPlanner إعداد التكامل أثناء التهيئة ودعمه بعد بدء التشغيل الفعلي، ويشمل ذلك جانب SkyPlanner وكيانات بيانات SCM المتفق عليها. تختلف طريقة استخدام D365 SCM من مصنع إلى آخر، وهنا يأتي دور الخبرة بهذه الاختلافات.
- يمكن لشريك Dynamics لديك المشاركة. فهو يعرف إعداداتك وامتداداتك وأدوار الأمان لديك، ويمكنه إعداد تطبيق Entra ID وصلاحيات الوصول إلى الكيانات. ويوفّر SkyPlanner واجهة REST API ووثائق Swagger/OpenAPI وإشعارات webhooks.
- يمكن لمطوّريك البناء على التكامل باستخدام واجهة REST API الموثَّقة نفسها ورمز API. يكفي رمز API للبدء، ويقدّم فريق SkyPlanner المساعدة عند الحاجة.
بعد الربط، يجدول محرّك Arcturus العمل استنادًا إلى البيانات الآنية لأوامر الإنتاج في SCM، وتُكتب المواعيد المجدولة في عمليات مسارات الإنتاج. يبدأ سعر SkyPlanner من 199 € شهريًا، ويشمل 5 محطات عمل، مع فوترة شهرية. ويُقدَّم عرض سعر التكامل مسبقًا وفقًا لإجراءات العمل لديك واحتياجاتك، إلى جانب عرض سعر باقتك، لتعرف التكلفة الكاملة قبل البدء.
للمقارنة مع إمكانات التخطيط المدمجة في SCM، راجع صفحة تخطيط الإنتاج في Dynamics 365 SCM ضمن الطاقة الفعلية للآلات والعاملين. تجد نظرة عامة في صفحة Dynamics 365 SCM، وأنظمة ERP الأخرى في مركز تكاملات ERP.
آراء المصنّعين في SkyPlanner
2 ساعةمن التوفير كل أسبوع
“نقل SkyPlanner تخطيط الإنتاج لدينا من جداول Excel إلى تحسين الإنتاج في الوقت الفعلي.”
كالي كاليومَكي، أخصائي سلسلة الإمداد
UTU · لوحات التوزيع ومعدات الفصل والتوصيل الكهربائية
يوفّر تخطيط الإنتاج 2 ساعة من وقت العمل كل أسبوع، وتصل قائمة العمل الجديدة إلى خط الإنتاج في ثوانٍ.
+90%في كفاءة الإنتاج
“ارتفعت كفاءة الإنتاج بنسبة 90%.”
عبدول روسيينغا، رئيس قسم تقنية المعلومات
Laboratory & Allied · صناعة الأدوية
ارتفعت كفاءة الإنتاج بنسبة 90%، ويستغرق إعداد خطة محسَّنة لثلاثة أشهر تشمل جميع محطات العمل أقل من 30 دقيقة.
100%التزام بمواعيد التسليم منذ 2021
“يمنحنا SkyPlanner رؤية واضحة للطاقة الإنتاجية ويجعل نتائج التخطيط قابلة للتوقّع.”
دان بيرغلوند، COO/CFO
Opes Corporation · الصناعات الكيميائية والغذائية
بلغ الالتزام بمواعيد التسليم 100% طوال فترة استخدام SkyPlanner، منذ 2021.
1,000sمن أوامر العمل تُجدول تلقائيًا
“أصبحنا نتحكّم في الإنتاج بطريقة مختلفة، وانتقل فهمنا للطاقة الإنتاجية إلى مستوى مختلف تمامًا.”
هانو ريونانن، الرئيس التنفيذي
Mamec · الخلاطات الصناعية والمضخات والتصنيع التعاقدي عالي التقنية
تُجدول آلاف أوامر العمل تلقائيًا، مع إتاحة رؤية للإنتاج في الوقت الفعلي لجميع أقسام المؤسسة.
الأسئلة الشائعة
أي واجهة API في D365 SCM يستخدمها التكامل؟
يستخدم نقطة نهاية OData v4 REST على المسار /data، التي تتيح جميع كيانات البيانات العامة مع دعم كامل للإنشاء والقراءة والتحديث والحذف. وتُستخدم واجهة API لمعالجة البيانات على دفعات عند تحميل كميات كبيرة من البيانات للمرة الأولى. وتوفّر أحداث الأعمال مشغّلات شبه فورية إن كانت متاحة في كتالوجك.
هل نحتاج إلى تثبيت أي شيء في Supply Chain Management؟
لا. يستخدم التكامل كيانات البيانات القياسية عبر OData. يسجِّل المسؤول لديك تطبيق Microsoft Entra ID ويربطه بمستخدم SCM لديه الأدوار المطلوبة.
كيف تُنقل المواعيد المجدولة إلى Supply Chain Management؟
يكتب SkyPlanner تاريخ ووقت البدء والانتهاء المجدولين والمورد المخصَّص للعملية في عمليات مسار أمر الإنتاج، باستخدام مجموعات تغييرات دفعية في OData. وتُحمى الأوامر التي يتولى SkyPlanner جدولتها باستخدام IsProductionOrderSchedulingLocked.
لماذا نربط SkyPlanner بدلًا من ضبط جدولة المهام في SCM؟
يراعي Planning Optimization الطاقة الإنتاجية الفعلية ضمن الأفق الزمني المحدد للطاقة المحدودة فقط، ويفترض طاقة غير محدودة خارج هذا الأفق (المصدر). وتجدول وظيفة جدولة المهام في SCM أمر إنتاج واحدًا في كل مرة مع مراعاة الطاقة المحجوزة مسبقًا، مع احتساب التجهيز كوقت ضمن العملية (المصدر). كما تنصح Microsoft بعدم استخدام التخطيط الرئيسي المقيَّد بالطاقة الفعلية عندما تؤدي الورديات إلى تغيّر الطاقة المتاحة (المصدر). يجدول SkyPlanner جميع الأوامر المثبَّتة معًا باستخدام مصفوفة أزمنة التجهيز، ويعيد Autopilot التخطيط تلقائيًا مع كل تغيير مؤثر. ويتولى فريق SkyPlanner إعداد التكامل ثنائي الاتجاه ودعمه، ويمكن لشريك Dynamics لديك تولّي مسؤولية جانب SCM.
هل ينبغي أن يجدول SkyPlanner أوامر الإنتاج المخطَّطة؟
ليس عادةً. يعيد Planning Optimization إنشاء أوامر الإنتاج المخطَّطة في كل تشغيل. ويجدول SkyPlanner أوامر الإنتاج المثبَّتة التي تكون في الحالات المتفق عليها أثناء تحديد النطاق.
هل يعمل التكامل مع Supply Chain Management المستضاف محليًا؟
في عمليات النشر المحلية، يعمل التكامل عبر واجهة API لمعالجة البيانات على دفعات، وهي واجهة تدعمها Microsoft في هذه البيئة. ويستخدم جانب SkyPlanner واجهة REST API نفسها في الحالتين، وتُؤكَّد طريقة الربط أثناء تحديد النطاق.
هل يمكننا تجربة SkyPlanner قبل بناء التكامل؟
نعم. تدعم التجربة المجانية لمدة 30 يومًا ما يصل إلى 20 محطة عمل، مع استيراد البيانات من Supply Chain Management بصيغة CSV أو Excel، ولا تتطلب بطاقة ائتمان. ابدأ التجربة أو تواصل مع المبيعات لتحديد نطاق التكامل.
