الاتصال إلى خادم IBM MQ من سير عمل في تطبيقات Azure Logic

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

يتضمن هذا الموصل عميل Microsoft MQ يتصل بخادم MQ بعيد عبر شبكة TCP/IP. يمكنك الاتصال بإصدارات IBM WebSphere MQ التالية:

  • MQ 7.5
  • MQ 8.0
  • MQ 9.0 و 9.1 و 9.2

العمليات المتاحة

  • تطبيق منطق الاستهلاك: يمكنك الاتصال بخادم MQ فقط باستخدام موصل MQ المدار . يوفر هذا الموصل إجراءات فقط ، بدون مشغلات.

  • تطبيق المنطق القياسي: يمكنك الاتصال بخادم MQ إما باستخدام موصل MQ المدار ، والذي يتضمن الإجراءات فقط ، أو عمليات MQ المضمنة ، والتي تتضمن المشغلات والإجراءات .

لمزيد من المعلومات حول الفرق بين الموصل المدار والعمليات المضمنة، راجع المصطلحات الأساسية في التطبيقات المنطقية.

توضح القائمة التالية فقط بعض العمليات المدارة المتوفرة ل MQ:

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

بالنسبة لجميع عمليات الموصل المدارة والمعلومات الفنية الأخرى، مثل الخصائص والحدود وما إلى ذلك، راجع الصفحة المرجعية لموصل MQ.

التقييدات

  • لا يدعم موصل MQ الرسائل المجزأة.

  • لا يستخدم موصل MQ حقل التنسيق في الرسالة ولا يقوم بإجراء أي تحويلات لمجموعة الأحرف. يضع الموصل فقط أي بيانات تظهر في حقل الرسالة في رسالة JSON ويرسل الرسالة على طول.

المتطلبات الأساسية

  • حساب Azure والاشتراك إذا لم يكن لديك اشتراك، فقم بالتسجيل للحصول على حساب Azure مجاني.

  • إذا كنت تستخدم خادم MQ محليا، فقم بتثبيت بوابة البيانات المحلية على خادم داخل شبكتك. لكي يعمل موصل MQ ، يجب أيضا تثبيت الخادم الذي يحتوي على بوابة البيانات المحلية .NET Framework 4.6.

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

    ملاحظة

    لا تحتاج إلى البوابة في السيناريوهات التالية:

    • ستستخدم العمليات المضمنة ، وليس الموصل المدار.
    • خادم MQ الخاص بك متاح للجمهور أو متوفر في Azure.
  • سير عمل التطبيق المنطقي حيث تريد الوصول إلى خادم MQ. يجب أن يكون لمورد التطبيق المنطقي نفس موقع مورد البوابة في Azure.

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

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

إنشاء اتصال MQ

عند إضافة إجراء MQ لأول مرة، تتم مطالبتك بإنشاء اتصال بخادم MQ.

ملاحظة

يدعم موصل MQ حاليا مصادقة الخادم فقط، وليس مصادقة العميل. لمزيد من المعلومات، راجع مشاكل الاتصال والمصادقة.

  1. إذا كنت تتصل بخادم MQ محلي، فحدد الاتصال عبر بوابة البيانات المحلية.

  2. قم بتوفير معلومات الاتصال لخادم MQ الخاص بك.

    الخاصية On-premises or Azure الوصف
    البوابات النموذج المحلي فقط حدد الاتصال عبر بوابة البيانات المحلية.
    ⁩اسم الاتصال⁧ ⁧⁩كلاهما⁧⁩ الاسم المطلوب استخدامه للاتصال
    الخادم ⁧⁩كلاهما⁧⁩ أي من القيم التالية:

    - اسم مضيف خادم MQ
    - عنوان IP متبوعا بنقطتين ورقم المنفذ

    اسم مدير قائمة الانتظار ⁧⁩كلاهما⁧⁩ إدارة قائمة الانتظار التي تريد استخدامها
    اسم القناة ⁧⁩كلاهما⁧⁩ قناة الاتصال بمدير قائمة الانتظار
    اسم قائمة الانتظار الافتراضي ⁧⁩كلاهما⁧⁩ الاسم الافتراضي لقائمة الانتظار
    الاتصال كما ⁧⁩كلاهما⁧⁩ اسم المستخدم للاتصال بخادم MQ
    ⁩اسم المستخدم⁧ ⁧⁩كلاهما⁧⁩ بيانات اعتماد اسم المستخدم الخاص بك
    كلمة المرور ⁧⁩كلاهما⁧⁩ بيانات اعتماد كلمة المرور الخاصة بك
    تمكين SSL؟ النموذج المحلي فقط استخدام أمان طبقة النقل (TLS) أو طبقة المقابس الآمنة (SSL)
    البوابة - الاشتراك النموذج المحلي فقط اشتراك Azure المقترن بمورد البوابة في Azure
    البوابة - بوابة الاتصال النموذج المحلي فقط مورد البوابة المطلوب استخدامه

    على سبيل المثال:

    Screenshot showing the managed MQ connection details.

  3. عند الانتهاء، حدد "Create" .

إضافة إجراء MQ

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

  1. في مصمم التطبيقات المنطقية، افتح سير العمل، إن لم يكن مفتوحا بالفعل.

  2. ضمن المشغل أو إجراء آخر، أضف خطوة جديدة.

    لإضافة خطوة بين الخطوات الموجودة، حرك الماوس فوق السهم. حدد علامة الجمع (+) التي تظهر، ثم حدد إضافة إجراء.

  3. في مربع البحث عن العملية، أدخل mq. من قائمة الإجراءات، حدد الإجراء المسمى استعراض الرسالة.

  4. إذا تمت مطالبتك بإنشاء اتصال بخادم MQ، فقم بتوفير معلومات الاتصال المطلوبة.

  5. في الإجراء، قم بتوفير قيم الخاصية التي يحتاجها الإجراء.

    لمزيد من الخصائص، افتح القائمة إضافة معلمات جديدة ، وحدد الخصائص التي تريد إضافتها.

  6. عند الانتهاء، على شريط أدوات المصمم، حدد Save.

  7. لاختبار سير العمل، على شريط أدوات المصمم، حدد تشغيل.

    بعد انتهاء التشغيل، يعرض المصمم محفوظات تشغيل سير العمل مع حالة الخطوة.

  8. لمراجعة المدخلات والمخرجات لكل خطوة تم تشغيلها (لم يتم تخطيها)، قم بتوسيع الخطوة أو تحديدها.

    • لمراجعة المزيد من تفاصيل الإدخال، حدد إظهار المدخلات الأولية.
    • لمراجعة المزيد من تفاصيل المخرجات، حدد إظهار المخرجات الأولية. إذا قمت بتعيين IncludeInfo إلى true، تضمين المزيد من المخرجات.

استكشاف المشاكل وإصلاحها

حالات الفشل في استعراض الإجراءات أو تلقيها

إذا قمت بتشغيل إجراء استعراض أو تلقي على قائمة انتظار فارغة، يفشل الإجراء مع مخرجات الرأس التالية:

MQ

مشاكل الاتصال والمصادقة

عندما يحاول سير العمل الاتصال بخادم MQ المحلي، قد يظهر لك هذا الخطأ:

"MQ: Could not Connect the Queue Manager '<queue-manager-name>': The Server was expecting an SSL connection."

  • إذا كنت تستخدم موصل MQ مباشرة في Azure، فيجب على خادم MQ استخدام شهادة صادرة عن مرجع مصدق موثوق به.

  • يتطلب خادم MQ تحديد مواصفات التشفير لاستخدامها مع اتصالات TLS. ومع ذلك ، لأغراض الأمان ولتضمين أفضل مجموعات الأمان ، يرسل نظام التشغيل Windows مجموعة من مواصفات التشفير المدعومة.

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

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

مرجع الموصل

بالنسبة لجميع العمليات في الموصل المدار والمعلومات الفنية الأخرى، مثل الخصائص والحدود وما إلى ذلك، راجع الصفحة المرجعية لموصل MQ.

الخطوات التالية