الاتصال إلى ناقل خدمة Azure من تطبيقات Azure Logic

هل هذه الصفحة مفيدة؟

هل لديك ملاحظات إضافية؟

سيتم إرسال الملاحظات إلى Microsoft: بالضغط على الزر «إرسال»، سيتم استخدام ملاحظاتك لتحسين منتجات Microsoft وخدماتها. نهج الخصوصية.

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

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

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

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

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

• مساحة اسم ناقل الخدمة وكيان المراسلة، مثل قائمة انتظار. إذا لم يكن لديك هذه العناصر، فتعرف على كيفية إنشاء مساحة اسم "ناقل الخدمة" وقائمة انتظار.

• المعرفة الأساسية حول كيفية إنشاء مهام سير عمل التطبيقات المنطقية

• سير عمل التطبيق المنطقي حيث تستخدم مساحة اسم ناقل الخدمة وكيان المراسلة. لبدء سير العمل باستخدام مشغل "ناقل الخدمة"، قم بإنشاء تطبيق منطقي فارغ. لاستخدام إجراء "ناقل الخدمة" في سير العمل، ابدأ سير عمل التطبيق المنطقي باستخدام مشغل آخر، على سبيل المثال، مشغل التكرار.

اعتبارات العمليات ناقل خدمة Azure

حلقات لانهائية

هام

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

الرسائل الكبيرة

يتوفر دعم الرسائل الكبيرة فقط عند استخدام عمليات "ناقل الخدمة" المضمنة مع مهام سير عمل Azure Logic Apps (قياسية) أحادية المستأجر . يمكنك إرسال واستقبال رسائل كبيرة باستخدام المشغلات أو الإجراءات في الإصدار المضمن.

لتلقي رسالة، يمكنك زيادة المهلة عن طريق تغيير الإعداد التالي في ملحق وظائف Azure:

{
   "version": "2.0",
   "extensionBundle": {
      "id": "Microsoft.Azure.Functions.ExtensionBundle.Workflows",
      "version": "[1.*, 2.0.0)"
   },
   "extensions": {
      "serviceBus": {
         "batchOptions": {
            "operationTimeout": "00:15:00"
         }
      }  
   }
}

لإرسال رسالة، يمكنك زيادة المهلة عن طريق إضافة ServiceProviders.ServiceBus.MessageSenderOperationTimeout إعداد التطبيق.

تحقق من الأذونات

تأكد من أن مورد التطبيق المنطقي لديه أذونات للوصول إلى مساحة اسم Service Bus.

1. في مدخل Azure، سجل الدخول باستخدام حساب Azure الخاص بك.

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

   

3. احصل على سلسلة الاتصال لمساحة اسم ناقل الخدمة. تحتاج إلى هذه السلسلة عند توفير معلومات الاتصال في تطبيق المنطق الخاص بك.

   1. في جزء نهج الوصول المشترك ، حدد RootManageSharedAccessKey.

   2. بجانب سلسلة الاتصال الأساسية، حدد زر النسخ. احفظ سلسلة الاتصال لاستخدامها لاحقا.

      

   تلميح

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

إضافة مشغل ناقل الخدمة

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

• الاسم الذي تريد استخدامه للاتصال الجديد

• اسم النظام أو الخادم

• بيانات اعتماد المستخدم أو الحساب

• نوع المصادقة المطلوب استخدامه

1. سجل الدخول إلى مدخل Azure، وافتح تطبيق المنطق الفارغ في مصمم سير العمل.

2. في مربع البحث في البوابة الإلكترونية، أدخل azure service bus. من قائمة المشغلات التي تظهر، حدد المشغل الذي تريده.

   على سبيل المثال، لتشغيل سير عمل التطبيق المنطقي عند إرسال عنصر جديد إلى قائمة انتظار ناقل الخدمة، حدد المشغل عند استلام رسالة في قائمة انتظار (الإكمال التلقائي ).

   

   فيما يلي بعض الاعتبارات عند استخدام مشغل "ناقل الخدمة":

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

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

     ملاحظة

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

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

3. إذا كان المشغل متصلا بمساحة اسم "ناقل الخدمة" لأول مرة، فاتبع هذه الخطوات عندما يطالبك مصمم سير العمل بمعلومات الاتصال.

   1. أدخل اسما لاتصالك، وحدد مساحة اسم ناقل الخدمة.

      

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

   2. حدد سياسة ناقل الخدمة الخاصة بك، وحدد إنشاء.

      

   3. حدد كيان المراسلة الذي تريده، مثل قائمة انتظار أو موضوع. على سبيل المثال، حدد قائمة انتظار ناقل الخدمة.

      

4. قدم المعلومات اللازمة للمشغلات التي اخترتها. لإضافة خصائص أخرى متوفرة إلى الإجراء، افتح القائمة إضافة معلمات جديدة ، وحدد الخصائص التي تريدها.

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

   

   لمزيد من المعلومات حول المشغلات والخصائص المتوفرة، راجع الصفحة المرجعية للموصل.

5. استمر في إنشاء سير عمل التطبيق المنطقي عن طريق إضافة الإجراءات التي تريدها.

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

إضافة إجراء ناقل الخدمة

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

• الاسم الذي تريد استخدامه للاتصال الجديد

• اسم النظام أو الخادم

• بيانات اعتماد المستخدم أو الحساب

• نوع المصادقة المطلوب استخدامه

1. في مدخل Azure، افتح تطبيقك المنطقي في مصمم سير العمل.

2. ضمن الخطوة التي تريد إضافة إجراء إليها، حدد خطوة جديدة.

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

3. ضمن اختيار إجراء، في مربع البحث، أدخل azure service bus. من قائمة الإجراءات التي تظهر، حدد الإجراء الذي تريده.

   على سبيل المثال، حدد الإجراء إرسال رسالة .

   

4. إذا كان الإجراء الخاص بك متصلا بمساحة اسم "ناقل الخدمة" لأول مرة، فاتبع هذه الخطوات عندما يطالبك مصمم سير العمل بمعلومات الاتصال.

   1. أدخل اسما لاتصالك، وحدد مساحة اسم ناقل الخدمة.

      

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

   2. حدد سياسة ناقل الخدمة الخاصة بك، وحدد إنشاء.

      

   3. حدد كيان المراسلة الذي تريده، مثل قائمة انتظار أو موضوع. على سبيل المثال، حدد قائمة انتظار ناقل الخدمة.

      

5. قدم التفاصيل اللازمة للإجراء الذي اخترته. لإضافة خصائص أخرى متوفرة إلى الإجراء، افتح القائمة إضافة معلمات جديدة ، وحدد الخصائص التي تريدها.

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

   

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

6. استمر في إنشاء سير عمل التطبيق المنطقي عن طريق إضافة أي إجراءات أخرى تريدها.

   على سبيل المثال، يمكنك إضافة إجراء يرسل بريدا إلكترونيا لتأكيد إرسال رسالتك.

7. حفظ تطبيق المنطق الخاص بك. في شريط أدوات المصمم، حدد "Save" .

إرسال رسائل مترابطة بالترتيب

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

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

التأخير في التحديثات على تطبيقك المنطقي الذي يدخل حيز التنفيذ

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

مرجع الموصل

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

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

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

• تعرف على موصلات تطبيقات Azure Logic الأخرى