واجهة معدات معالجة المواد (MHAX)

يمكنك استخدام واجهة معدات معالجة المواد ‏(MHAX) لتوصيل أنظمة معالجة المواد المادية الخارجية (MH) بمستودع تتم إدارته بواسطة عمليات إدارة المستودعات (WMS) في Microsoft Dynamics 365 Supply Chain Management. يتكون السطح البيني بين نظامي WMS وMH من قائمتين: أحدهما للأحداث الصادرة (WMS إلى MH) والآخر للأحداث الواردة (MH إلى WMS). يُنشئ نظام WMS أحداثًا صادرة بناءً على خطوط العمل التي تم إنشاؤها أثناء عمليات إنشاء وتنفيذ العمل المختلفة. يقوم نظام MH بعد ذلك باستطلاع نظام WMS بانتظام للأحداث الجديدة ومعالجة الاستجابات. بعد انتهاء نظام MH من معالجة الأحداث وفقًا لتعليمات العمل، فإنه يرسل الأحداث الواردة، مثل إكمال خط العمل والانتقاء القصير.

هام

من خلال تمكين هذه الميزة، قد تتم مشاركة بياناتك مع خدمات الجهات الخارجية التي تحددها. أنت تتحكم في البيانات التي تتم مشاركتها مع الجهة الخارجية (إن وجدت). استخدامك لخدمات الطرف الثالث هو مسؤوليتك ويخضع للشروط المتفق عليها بينك وبين الطرف الثالث. خصوصيتك تهمنا. لمعرفه المزيد، اقرأ بيان الخصوصية.

يوضح الرسم التوضيحي التالي العناصر المختلفة والترتيب الذي تحدث به العمليات عند استخدام تكامل MHAX.

فيما يلي شرح للتفاعلات الموضحة في الرسم التوضيحي السابق:

1. أثناء إنشاء العمل أو تنفيذ العمل، يتم إنشاء الأحداث الصادرة في قائمة انتظار الصادر.
2. يتصل جهاز MH بخدمة معدات MH، ويستطلع أي أحداث جديدة ذات صلة به، ويعالج تلك الأحداث.
3. عندما يكون جهاز MH جاهزًا للإبلاغ، فإنه يتصل بالخدمة مرة أخرى ويقدم الأحداث الواردة. تتم معالجة هذه الأحداث على الفور بواسطة معالج قائمة الانتظار.
4. استنادًا إلى بيانات الأحداث الواردة، قد يقوم معالج قائمة الانتظار بتشغيل العمل الحالي أو تعديله أو إنشاء عمل جديد.

تشغيل ميزة MHAX

قبل أن تتمكن من استخدام ميزة MHAX، يجب عليك تشغيل كل من ميزتها ومفتاح التكوين الخاص بها.

1. إذا كنت تستخدم الإصدار 10.0.28 من Supply Chain Management أو إصدار أقدم، فقم بالخطوات التالية:
   1. انتقل إلى إدارة النظام > مساحات العمل > إدارة الميزات.
   2. في مساحة عمل إدارة الميزات، قم بتشغيل الميزة المسماة واجهة معدات معالجة المواد. (اعتبارًا من Supply Chain Management 10.0.29 ، هذه الميزة إلزامية ولا يمكن إيقاف تشغيلها.)
2. وضع النظام في وضع الصيانة كما هو موضح في وضع الصيانة.
3. انتقل إلى إدارة النظام > الإعداد > تكوين الترخيص.
4. قم بتوسيع التجارة > إدارة المستودعات والنقل، ثم حدد خانة الاختيار واجهة معدات معالجة المواد.
5. إيقاف تشغيل وضع الصيانة كما هو موضح في وضع الصيانة.

تعيين معلمات MHAX

يجب تعيين بعض المعلمات العامة في صفحة معلمات واجهه معدات معالجة المواد لتكوين الميزة.

1. انتقل إلى واجهة معدات معالجة المواد > الإعداد > معلمات واجهة معدات معالجة المواد.

2. على علامة التبويب عام، عيّن الحقول التالية:

   • تعيينات المستخدمين – تعيين مستخدمي النظام إلى عمال المستودعات المرتبطين بهم. يتم استخدام مستخدمي النظام للاتصال بخدمة قائمة الانتظار الواردة. سيتم تعيين العمال المختارين لعمليات العمل (الانتقاء والوضع) التي تتم معالجتها من خلال قائمة الانتظار الواردة. سيتم تنفيذ عمليات العمل في المستودع الافتراضي لكل عامل.
   • تمكين معرف الرسالة الواردة – عند تعيين هذا الخيار إلى نعم، إذا تم استلام معرّف رسالة واردة مكرر، فسيتم رفض الرسالة، وستشير رسالة خطأ إلى أن الرسالة موجودة بالفعل. عند تعيين هذا الخيار إلى لا، سيتم السماح بتكرار معرفات الرسائل الواردة.
   • تمكين الإنشاء اليدوي للرسائل الواردة – عند تعيين هذا الخيار إلى نعم، يمكنك محاكاة الرسائل الواردة عن طريق إنشاء سجل مباشرة من صفحة قائمة الانتظار الواردة.

3. في علامة التبويب التسلسلات الرقمية، حدد التسلسلات الرقمية على مستوى النظام التي يجب استخدامها لإنشاء معرفات فريدة لعناصر قائمة الانتظار الواردة وعناصر قائمة الانتظار الصادرة وأزواج خطوط العمل.

الأحداث الصادرة

في نقاط محددة أثناء إنشاء العمل أو تنفيذ العمل، يحدد النظام ما إذا كان يجب إنشاء أحداث صادرة لإرسالها إلى نظام MH. إذا تم تكوين اشتراك لنقطة معينة أثناء معالجة المستودع، فسيقوم النظام بإنشاء الحدث وفقًا لإعداد الاشتراك.

بنية الأحداث الصادرة

يتم تعريف كل حدث صادر بشكل فريد من خلال معرف قائمة انتظار صادرة. يحدد نوع الحركة الصادرة نوع الحدث. ويتم أيضا تسجيل المستودع ومعرف الاشتراك الذي قام بإنشاء الحدث في الحدث

لنقل البيانات إلى نظام MH، يحتوي الحدث الصادر على 10 حقول للبيانات (data01 خلال data10). تحتوي حقول البيانات هذه علي تعيين واحد إلى واحد (1:1) لحقول قاعده البيانات الموجودة. وعلي وجه التحديد، يتم استخراجها من الحقول في سطر العمل وجداول رؤوس العمل. يمكن تحديد الحقول بحريه. يتم إعدادها عندما تقوم بإنشاء الاشتراك.

بالاضافه إلى حقول البيانات 10 التي يكون لها تعيين 1:1 لحقول قاعده بيانات موجودة، يمكن ان يحتوي الحدث علي حقل بيانات إضافي يعرف باسم حمل العمل. يتم إنشاء محتويات هذا الحقل بواسطة كود X++ مخصص والذي يعرف باسم منشئ الحمولة. يتم إعداد أي منشئ حمولة يجب استخدامه في الاشتراك.

للتأكد من أن نظام MH يتلقى كل معرف قائمة الانتظار الصادرة مرة واحدة فقط، يتم استخدام حقل الحالة لتحديد ما إذا كان الحدث جاهزًا لإرساله إلى نظام معالجة المواد الخارجي (Ready الحالة) أو تم إرسالها بالفعل (ارسال الحالة).

اشتراكات قائمة الانتظار الصادرة

قبل إنشاء أي أحداث، يجب إعداد اشتراك لإخبار ميزة MHAX بما إذا كان سيتم إنشاء أحداث وكيفية إنشاءها. يتم تمييز الأحداث التي تم إنشاؤها بواسطة معرف الاشتراك. لذلك، يمكن أن تتصل أنظمة MH المتعددة بنفس نظام WMS مع الاحتفاظ بأحداثها منفصلة. عندما يتم استقصاء خدمة MHAX للأحداث الجديدة، يكون الاشتراك أحد الخيارات المتاحة لاسترداد الأحداث.

لإنشاء اشتراك، انتقل إلى واجهة معدات معالجة المواد > الإعداد > الاشتراكات. بالنسبة لكل اشتراك، تتوفر المعلمات التالية:

• معرف الاشتراك - اسم فريد يحدد الاشتراك.
• الوصف – وصف النص الحر للاشتراك.
• المستودع – المستودعات المحددة التي يجب تصفيه الأحداث وفقًا لها.
• نوع الحركة الصادرة – نوع الأحداث التي يجب أن يحتويها الاشتراك.
• منشئ الحمولة – ملحق الكود الاختياري الذي يمكنه إدخال معلومات اضافيه في حقل الحمولة الخاص بالحدث الصادر.

يمكن ان يرتبط الاستعلام بكل اشتراك. يعمل هذا الاستعلام علي تصفيه خطوط العمل والرؤوس لتحديد العمل الذي سيستخدم الاشتراك لإنشاء الاحداث. لإضافة استعلام إلى اشتراك، حدد خانة الاختيار تشغيل الاستعلام للاشتراك ذي الصلة على صفحة الاشتراكات، ثم حدد تحرير الاستعلام في جزء الإجراءات. يظهر محرر استعلام Supply Chain Management القياسي.

بالاضافه إلى ذلك، يتضمن الاشتراك خطة اشتراك يقوم بتعيين الحقول من رأس العمل أو سطر العمل إلى بعض أو كل حقول البيانات العشرة المجانية للحدث الصادر، كما هو مطلوب. لإرجاع المعلومات إلى خدمة MHAX، ستقوم عادةً بتضمين معرف سجل سطر العمل أو ملف معرف زوج خط العمل. (معرف زوج خط العمل هو خاصية جديدة تمكن النظام من استخدام أمر إرجاع واحد لمعالجة سطور الانتقاء والوضع.) وتعتمد الحقول المتبقية على حالة الاستخدام. يتم توفير بعض الامثله لاحقا في هذا المقال.

لإعداد خريطة اشتراك، حدد الاشتراك المناسب في صفحة الاشتراكات، ثم حدد مخطط الاشتراك في جزء الإجراءات. في مربع الحوار مخطط الاشتراك الذي يظهر، يمكنك تعيين جدول وحقل لكل حقل من حقول البيانات المتوفرة كما هو مطلوب.

أنواع الأحداث الصادرة

يصف هذا القسم العديد من أنواع الأحداث المتوفرة. (تُعرف أنواع الأحداث أيضًا باسم أنواع الحركات.) كما يوضح أيضًا متى يتم إنشاء كل نوع من الأحداث في نظام WMS.

أحداث إنشاء العمل (WorkCreation)

يتم إنشاء احداث إنشاء العمل بعد إنشاء العمل بواسطة التطبيق. ينطبق هذا السلوك على معظم أنواع عمليات إنشاء العمل، وعلى الأخص إنشاء أعمال الانتقاء والتزويد. وبشكل عام، إذا تم إنشاء عمل في حالة مفتوحة، مما يشير إلى أن العمل جاهز ليتم تشغيله بواسطة عامل، سيتم إنشاء حدث إنشاء العمل. بالإضافة إلى ذلك، سيتم إنشاء أحداث إنشاء العمل لأعمال الحركة الأساسية (وليس الحركة حسب عمل القالب)، على الرغم من أن هذا العمل لم يتم إنشاؤه كعمل مفتوح.

الاستثناء المهم لهذا السلوك هو حساب الدورة التي لا يتم دعمها حاليا. تعد عمليات جرد المخزون في نظام MH خارج نطاق MHAX، ويجب استيراد نتائج الجرد إلى دفتر يومية جرد المخزون.

بعد إنشاء العمل، تقوم خدمة MHAX بمعالجة بنود العمل التي تم إنشاؤها وتعيين معرف زوج خط العمل لجميع بنود العمل التي تم إنشاؤها لكل رأس عمل. الهدف هو تجميع جميع سطور الانتقاء مع وضعيات متتالية تحت معرّف زوج خط عمل واحد. (تتوافق المجموعات مع أزواج انتقاء / وضع في قوالب العمل.) بهذه الطريقة، يمكن استخدام معرّف واحد للإبلاغ عن اكتمال العمل لجميع سطور الانتقاء والوضع ذات الصلة. تبدأ عملية التجميع بالسطر الأول ثم تستمر بنفس المعرف حتى تواجه زوجًا متتاليًا من خطوط العمل الموضحة / المنتقاة. يتم تعيين المعرف قيد التشغيل إلى سطر الإدخال الخاص بهذا الزوج. يتم بعد ذلك استخدام معرف جديد لخط الاختيار للزوج فصاعدًا. وتستمر هذه العملية حتى تتم معالجه كافة البنود التي تنتمي إلى راس العمل.

كميزة خاصة لأحداث إنشاء العمل، إذا تم تعيين خيار الموجة المحظورة إلى نعم على رأس العمل، الأحداث التي تم إنشاؤها سيكون بحالة محظورة بدلاً من الوضع المعتاد لـ جاهز الذي يتم استخدامه لإرساله إلى نظام MH. تشير علامة الموجة المحظورة في رأس العمل إلى أن رأس العمل ليس جاهزًا بعد لتشغيل العمال، ربما بسبب أعمال التزويد غير المكتملة. عند مسح علامة الموجة المحظورة، الأحداث التي تم إنشاؤها بالفعل غير محظورة ومتاحة لنظام MH لاستردادها من قائمة الانتظار.

أحداث بدء العمل (WorkInitiation)

يتم تشغيل أحداث بدء العمل عندما تتغير حالة العمل من مفتوح إلى قيد المعالجة أثناء تحديث العمل.

أحداث بدء العمل (WorkInitiation)

يتم تشغيل أحداث إكمال العمل عندما تتغير حالة العمل من قيد المعالجة إلى مغلق أثناء تحديث العمل.

أحداث إلغاء العمل (WorkCancel)

يتم تشغيل أحداث إلغاء العمل عندما تتغير حالة العمل من أي حالة أخرى إلى جانب تم الإلغاء إلى تم الإلغاء أثناء تحديث العمل. بالاضافه إلى ذلك، يتم حذف كافة الاحداث الأخرى المرتبطة براس العمل من قائمه الانتظار لكافة الاشتراكات. بهذه الطريقة، يتم منع الانظمه الخارجية من معالجه الاحداث غير المطلوبة.

أحداث إكمال الانتقاء/البيع (PickCompletion/PutCompletion)

يتم تشغيل أحداث إكمال الانتقاء/الوضع عندما تتغير حالة سطر الانتقاء / الوضع من قيد المعالجة إلى مغلق أثناء تحديث بند العمل.

مراقبة قائمة الانتظار الصادرة

لمراجعة قائمة الانتظار الصادرة، انتقل إلى واجهة معدات معالجة المواد > شائع > قائمة الانتظار الصادرة. تسرد صفحة قائمة الانتظار الصادرة كل عنصر قائمة انتظار صادرة وحالتها. حدد عنصر قائمه انتظار لعرض التفاصيل الخاصة به. تشتمل هذه التفاصيل علي نوع حركه الصنف والاشتراك الذي تم استخدامه والقيم الخاصة بكل حقل من حقول البيانات ( data01 من خلال data10) والحمولة.

تنظيف قائمة الانتظار الصادرة

في النهاية، ستبدا قائمه الانتظار الصادرة بان تصبح ممتلئة لعناصر قائمه الانتظار التي تم إرسالها بالفعل. لإزالة هذه العناصر، انتقل إلى واجهة معدات معالجة المواد >المهام الدورية >تنظيف > تنظيف قائمة الانتظار الصادرة.

الأحداث الواردة

يصف هذا القسم الأنواع المختلفة من الأحداث الواردة التي يمكن لنظام MH إبلاغها إلى نظام WMS. كما يوضح أيضًا أنه يجب توفير البيانات بواسطة نظام MH، وما يفعله كل حدث وارد في نظام WMS.

بنية الأحداث الواردة

عند إرسال حدث وارد، يجب على النظام الخارجي توفير نوع المعاملة الواردة مع ما يصل إلى 10 معلمات (data01 من خلال data10). يمكن أن يتأكد التحقق الاختياري من أن خدمة MHAX لم تتلق نفس الحدث الوارد أكثر من مرة. لتمكين هذا التحقق من الصحة، يجب أن يكون لكل حدث وارد معرف رسالة فريد. إذا تم استلام معرف رسالة مكرر، وإذا تم تعيين خيار تمكين معرف الرسالة الواردة إلى نعم في صفحة معلمات واجهة معدات معالجة المواد، فسيتم رفض الرسالة. ستشير رسالة خطأ إلى أن الرسالة موجودة بالفعل.

بالإضافة إلى حقول البيانات الواردة، يقوم النظام بتعيين معرف فريد لقائمة انتظار واردة للحدث.

أنواع الأحداث الواردة

يصف هذا القسم أنواع الأحداث الواردة (أنواع المعاملات) المدعومة والبيانات التي يجب توفيرها للأحداث المراد معالجتها.

أحداث تأكيد العمل (WorkConfirm)

تتطلب أحداث تأكيد العمل أن تتضمن حقول البيانات الواردة المعلومات التالية:

• data01 – معرف زوج خط العمل.

• data02 – معرف سجل خط العمل (قيمة RecId).

  إشعار

  إن حقل data01أو حقل data02 يجب أن يكون موجودًا.

• data03 – معرف لوح الترخيص الذي سيتم الانتقاء منه.

• data04 – معرف لوحة الترخيص الهدف لرأس العمل.

إذا تم توفير معرف زوج خط العمل، فكل ما عليك هو اختيار خطوط العمل أو وضعها أو تخصيصها التي تم تمييزها بواسطة معرف زوج خط العمل، والتي لها حالة مفتوح أو قيد المعالجة، فإنه يتم تشغيلها في تسلسل. في حاله توفير معرف سجل بند عمل (قيمة RecId)، فيجب ان يكون بند العمل عبارة عن انتقاء أو وضع أو بند عمل مخصص بالحالة مفتوح أو قيد المعالجة.

اختر بنودًا من المواقع التي تتحكم فيها لوحة الترخيص تتطلب أن يحدد data03 لوحة الترخيص التي يجب أن يتم الانتقاء منها، بغض النظر عما إذا كانت الخطوط مميزة بمعرف سجل سطر العمل أو معرف زوج خط العمل. يجب أن يحدد الحقل data04 لوحه الترخيص الهدف الخاصة براس العمل للانتقاء.

لا تقبل البنود الموضوعة معلومات إضافية. يتم تشغيلها بناءً على موقع بند العمل الحالي ولوحة ترخيص العمل المستهدفة فقط. إذا كان يجب تنفيذ الوضع في موقع مختلف، فقم بتغيير موقع خط العمل كما هو موضح في قسم تجاوز الأحداث لاحقًا في هذا المقال.

لا تتطلب بنود العمل المخصصة أو تدعم أي معلومات إضافية في الحدث الوارد.

أحداث الاختيار القصير (ShortPick)

تتطلب أحداث الانتقاء القصيرة أن تتضمن حقول البيانات الواردة المعلومات التالية:

• data02 – معرف سجل العمل (قيمة RecId).
• data03 – معرف لوح الترخيص الذي سيتم الانتقاء منه.
• data04 – الكمية المُراد انتقاؤها.
• data05 - رمز استثناء الانتقاء القصير المرتبط بسجل استثناء العمل حيث تكون قيمة نوع الاستثناء هي انتقاء قصير.
• data06 – معرف لوحة الترخيص الهدف لرأس العمل. يمكن ترك هذا المعرف فارغا عند إعداده ليتم إنشاؤه تلقائيا.

ملاحظة

لا يتم استخدام حقل data01 لأحداث انتقاء قصيرة.

يشبه هذا الحدث حدث تأكيد العمل، ولكنه ينطبق فقط على بنود الانتقاء.

تجاوز الأحداث (تجاوز)

تتطلب أحداث التجاوز أن تتضمن حقول البيانات الواردة المعلومات التالية:

• data01 – معرف سجل العمل (قيمة RecId).
• data02 – معرف الموقع الجديد.

يجب أن يكون لبند العمل حالة إما مفتوح أو قيد المعالجة، ويجب أن يكون الموقع الجديد موجودًا.

أحداث استلام لوحة الترخيص (LPreceipt)

تتطلب أحداث إيصال لوحة الترخيص أن تتضمن حقول البيانات الواردة المعلومات التالية:

• data01 – معرّف لوحة الترخيص الواردة للاستلام.

ينفذ النظام عملية استلام لوحة الترخيص، بناءً على لوحة الترخيص التي تم تمريرها كقيمة لحقل data01.

مراقبة قائمة الانتظار الواردة

لمراجعة قائمة الانتظار الواردة، انتقل إلى واجهة معدات معالجة المواد > شائع > قائمة الانتظار الواردة. تسرد صفحة قائمة الانتظار الواردة كل عنصر قائمة انتظار واردة وحالتها. حدد عنصر قائمه انتظار لعرض التفاصيل الخاصة به. تتضمن هذه التفاصيل نوع حركة العنصر ومعرف الرسالة والقيم لكل حقل بيانات (data01 من خلال data10).

في حالة حدوث خطأ أو نوع آخر من عناصر السجل أثناء معالجة الأحداث الواردة، يمكنك فحص السجل عن طريق تحديد سجل الأخطاء في جزء الإجراءات.

معالجة الأحداث الواردة

تتم كتابة الأحداث الواردة أولاً في قاعدة البيانات، ثم يتم تشغيلها على الفور (بشكل متزامن). في حالة حدوث خطأ أثناء المعالجة، يستمر كتابة الحدث في قائمة الانتظار، ولكن يتم تعيين الحالة على به أخطاء. تقوم خدمة MHAX بإرجاع رسالة خطأ إلى نظام MH وتخزين سجل الأخطاء في سجل الأحداث الواردة للتحقيق في وقت لاحق.

الأحداث التي بحالة به أخطاء يمكن إعادة معالجتها لاحقًا إذا تم إصلاح حالة الخطأ. لإعادة معالجتها، اتبع إحدى الخطوات التالية:

• انتقل إلى واجهة معدات مالجة المواد > شائع > قائمة الانتظار الواردة. حدد قائمة الانتظار الواردة المناسبة، ثم حدد إعادة المعالجة في جزء الإجراءات.
• انتقل إلى واجهة معدات معالجة المواد > شائع > إعادة معالجة قائمة الانتظار الواردة التي بها أخطاء. يظهر مربع حوار وظيفة الدُفعات القياسية. هناك، يمكنك إعداد عامل تصفية السجل، وجدولة أو تشغيل وظيفة مجمعة لإعادة معالجة قائمة الانتظار.

يتم تشغيل جميع عمليات العمل (الانتقاء والوضع) باستخدام العامل الذي تم تحديده في حقل معرف المستخدم في صفحة معلمات واجهة معدات معالجة المواد.

تنظيف قائمة الانتظار الواردة

في النهاية، ستبدا قائمه الانتظار الواردة بان تصبح ممتلئة لعناصر قائمه الانتظار التي تمت معالجتها بالفعل. لإزالة هذه العناصر، انتقل إلى واجهة معدات معالجة المواد >المهام الدورية >تنظيف > تنظيف قائمة الانتظار الواردة.

احصل على نظرة عامة سريعة باستخدام مدير قائمة الانتظار

للحصول على نظرة عامة سريعة على جميع الأنشطة المتعلقة بقوائم الانتظار الواردة والصادرة، انتقل إلى واجهة معدات معالجة المواد > مساحات العمل > مدير قائمة الانتظار. توفر صفحة مدير قوائم الانتظار مجموعة من علامات التبويب والتجانبات التي يمكنك استخدامها لمراقبة واستكشاف قوائم الانتظار الخاصة بك. كما توفر روابط مفيدة لمعظم الصفحات الأخرى المذكورة في هذا المقال.

الاتصال بخدمة MHAX

يتم تنفيذ MHAX كخدمة مخصصة. وبالتالي، يمكن الوصول إليه عبر مكالمات SOAP وREST. فيما يلي عناوين نقاط نهاية SOAP وREST:

• SOAP:https://base_environment_URL/soap/services/WMHEServices
• REST:https://base_environment_URL/api/services/WMHEServices/WMHEService

استرداد الرسائل من قائمة الانتظار الصادرة

لاسترداد الرسائل من قائمة الانتظار الصادرة، استخدم إحدى الطريقتين التاليتين:

• استخدم readOutboundSubscriptionQueue لاسترداد الأحداث المستندة إلى معرف الاشتراك.
• استخدم readOutboundWarehouseQueue لاسترداد الأحداث المستندة إلى نوع الحدث ومعرف المستودع عبر الاشتراكات المتعددة.