الاتصال إلى ناقل خدمة Azure من مهام سير العمل في Azure Logic Apps
ينطبق على: Azure Logic Apps (الاستهلاك + قياسي)
يوضح هذا الدليل كيفية الوصول إلى ناقل خدمة Azure من سير عمل في Azure Logic Apps باستخدام موصل ناقل خدمة Microsoft Azure. يمكنك بعد ذلك إنشاء مهام سير عمل تلقائية يتم تشغيلها عند تشغيلها بواسطة الأحداث في ناقل خدمة أو تشغيل إجراءات لإدارة عناصر ناقل الخدمة، على سبيل المثال:
- مراقبة عند وصول الرسائل (الإكمال التلقائي) أو تلقيها (قفل خاطف) في قوائم الانتظار والموضوعات واشتراكات الموضوع.
- إرسال الرسائل.
- إنشاء اشتراكات الموضوع وحذفها.
- إدارة الرسائل في قوائم الانتظار واشتراكات المواضيع، على سبيل المثال، الحصول على الرسائل والحصول عليها وتأجيلها وإكمالها وتأجيلها وتركها والرسائل غير المستخدمة.
- تجديد التأمينات على الرسائل والجلسات في قوائم الانتظار واشتراكات الموضوع.
- أغلق جلسات العمل في قوائم الانتظار والموضوعات.
يمكنك استخدام المشغلات التي تحصل على استجابات من ناقل خدمة Azure وتجعل الإخراج متاحا للإجراءات الأخرى في مهام سير العمل الخاصة بك. يمكنك أيضا الحصول على إجراءات أخرى تستخدم الإخراج من إجراءات ناقل خدمة Microsoft Azure.
مرجع تقني الاتصال أو
يحتوي موصل ناقل خدمة Microsoft Azure على إصدارات مختلفة، استنادا إلى نوع سير عمل التطبيق المنطقي وبيئة المضيف.
| تطبيق المنطق | البيئة | إصدار الاتصال or |
|---|---|---|
| الاستهلاك | تطبيقات Azure Logic Apps متعددة المستأجرين | موصل مدار (فئة قياسية). لمزيد من المعلومات، راجع الوثائق التالية: - مرجع الموصل المدار لناقل خدمة Microsoft Azure - الموصلات المُدارة Azure Logic Apps |
| الاستهلاك | بيئة خدمة التكامل (ISE) | الموصل المدار (الفئة القياسية) وإصدار ISE، الذي له حدود رسائل مختلفة عن الفئة القياسية. لمزيد من المعلومات، راجع الوثائق التالية: - مرجع الموصل المدار لناقل خدمة Microsoft Azure - حدود رسائل ISE - الموصلات المُدارة Azure Logic Apps |
| قياسي | تطبيقات Azure Logic للمستأجر الفردي وبيئة خدمة التطبيقات الإصدار 3 (خطط Windows فقط) | الموصل المدار (مستضاف من Azure) والموصل المضمن، والذي يستند إلى موفر الخدمة. عادة ما يوفر الإصدار المضمن أداء أفضل وقدرات وتسعير وما إلى ذلك. ملاحظة: تتبع مشغلات الموصل المضمنة لناقل خدمة Microsoft Azure نمط مشغل الاستقصاء، مما يعني أن المشغل يتحقق باستمرار من الرسائل في قائمة الانتظار أو اشتراك الموضوع. لمزيد من المعلومات، راجع الوثائق التالية: - مرجع الموصل المدار لناقل خدمة Microsoft Azure - عمليات الموصل المضمنة لناقل خدمة Microsoft Azure - الموصلات المُضمّنة في Azure Logic Apps |
المتطلبات الأساسية
حساب واشتراك Azure. إذا لم يكن لديك اشتراك، فقم بالتسجيل للحصول على حساب Azure مجاني.
مساحة اسم ناقل خدمة Microsoft Azure وكيان المراسلة، مثل قائمة انتظار. لمعرفة مزيد من المعلومات، راجع الوثائق التالية:
سير عمل التطبيق المنطقي حيث تتصل بمساحة اسم ناقل خدمة Microsoft Azure وكيان المراسلة. لبدء سير العمل باستخدام مشغل ناقل خدمة Microsoft Azure، يجب أن تبدأ بسير عمل فارغ. لاستخدام إجراء ناقل خدمة Microsoft Azure في سير العمل، ابدأ سير العمل بأي مشغل.
إذا كان مورد تطبيق المنطق يستخدم هوية مدارة لمصادقة الوصول إلى مساحة اسم ناقل خدمة Microsoft Azure وكيان المراسلة، فتأكد من تعيين أذونات الدور على المستويات المقابلة. على سبيل المثال، للوصول إلى قائمة انتظار، تتطلب الهوية المدارة دورا يحتوي على الأذونات اللازمة لقائمة الانتظار هذه.
يجب أن يستخدم كل مورد تطبيق منطقي هوية مدارة واحدة فقط، حتى إذا كان سير عمل التطبيق المنطقي يصل إلى كيانات مراسلة مختلفة.
يجب أن تستخدم كل هوية مدارة تصل إلى اشتراك قائمة انتظار أو موضوع اتصال واجهة برمجة تطبيقات ناقل خدمة Microsoft Azure الخاص بها.
يجب أن تستخدم عمليات ناقل الخدمة التي تتبادل الرسائل مع كيانات مراسلة مختلفة وتتطلب أذونات مختلفة اتصالات واجهة برمجة تطبيقات ناقل خدمة Microsoft Azure الخاصة بها.
لمزيد من المعلومات حول الهويات المدارة، راجع مصادقة الوصول إلى موارد Azure باستخدام الهويات المدارة في Azure Logic Apps.
بشكل افتراضي، تكون عمليات الموصل المضمنة في ناقل خدمة Microsoft Azure عديمة الحالة. لتشغيل هذه العمليات في الوضع المناسب، راجع تمكين الوضع ذي الحالة للموصلات المضمنة عديمة الحالة.
اعتبارات العمليات ناقل خدمة Azure
حلقات لانهائية
هام
كن حذرًا عند تحديد كل من المشغل والإجراء الذي له نفس نوع الموصل واستخدامهما للعمل مع نفس الكيان، مثل قائمة انتظار المراسلة أو اشتراك الموضوع. يمكن لهذه المجموعة إنشاء حلقة لا نهائية، ما يؤدي إلى تطبيق منطقي لا ينتهي أبدًا.
الحد من الجلسات المحفوظة في ذاكرة التخزين المؤقت للموصل
لكل كيان مراسلة لناقل خدمة Microsoft Azure، مثل اشتراك أو موضوع، يمكن لموصل ناقل خدمة Microsoft Azure حفظ ما يصل إلى 1500 جلسة عمل فريدة في كل مرة إلى ذاكرة التخزين المؤقت للموصل. إذا تجاوز عدد الجلسات هذا الحد، تتم إزالة الجلسات القديمة من ذاكرة التخزين المؤقت. لمزيد من المعلومات، راجع جلسات عمل الرسائل.
إرسال رسائل مرتبطة بالترتيب
عندما تحتاج إلى إرسال رسائل ذات صلة بترتيب معين، يمكنك إنشاء سير عمل باستخدام موصل ناقل خدمة Microsoft Azure ونمط القافلة التسلسلي. تحتوي الرسائل المرتبطة على خاصية تحدد العلاقة بين هذه الرسائل، مثل معرف جلسة العمل في ناقل خدمة Azure.
عند إنشاء سير عمل تطبيق منطق الاستهلاك، يمكنك تحديد التسليم المترابط بالترتيب باستخدام قالب جلسات ناقل الخدمة، والذي ينفذ نمط القافلة التسلسلية. لمزيد من المعلومات، راجع إرسال الرسائل ذات الصلة بالترتيب.
دعم الرسائل الكبيرة
يتوفر دعم الرسائل الكبيرة فقط لسير العمل القياسي عند استخدام عمليات الموصل المضمنة لناقل خدمة Microsoft Azure. على سبيل المثال، يمكنك تلقي ورسائل كبيرة باستخدام المشغلات والإجراءات المضمنة على التوالي.
بالنسبة للموصل المدار لناقل خدمة Microsoft Azure، يقتصر الحد الأقصى لحجم الرسالة على 1 ميغابايت، حتى عند استخدام مساحة اسم ناقل خدمة Microsoft Azure من المستوى المتميز.
زيادة المهلة لتلقي الرسائل وإرسالها
في مهام سير العمل القياسية التي تستخدم العمليات المضمنة لناقل خدمة Microsoft Azure، يمكنك زيادة المهلة لتلقي الرسائل وإرسالها. على سبيل المثال، لزيادة المهلة لتلقي رسالة، قم بتغيير الإعداد التالي في ملحق Azure Functions:
{
"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.
مشغلات الموصل المدارة لناقل خدمة Microsoft Azure
بالنسبة للموصل المدار لناقل خدمة Microsoft Azure، جميع المشغلات هي استقصاء طويل. يعالج نوع المشغل هذا جميع الرسائل ثم ينتظر 30 ثانية حتى تظهر المزيد من الرسائل في قائمة الانتظار أو اشتراك الموضوع. إذا لم تظهر أي رسائل في 30 ثانية، يتم تخطي تشغيل المشغل. وإلا، يستمر المشغل في قراءة الرسائل حتى يكون اشتراك قائمة الانتظار أو الموضوع فارغا. يستند استقصاء المشغل التالي إلى الفاصل الزمني للتكرار المحدد في خصائص المشغل.
يمكن لبعض المشغلات، مثل عند وصول رسالة واحدة أو أكثر إلى مشغل قائمة انتظار (إكمال تلقائي)، إرجاع رسالة واحدة أو أكثر. عندما يتم تشغيل هذه المشغلات، فإنها ترجع بين رسالة واحدة وعدد الرسائل المحددة بواسطة خاصية الحد الأقصى لعدد الرسائل الخاصة بالمشغل.
إشعار
يكمل مشغل الإكمال التلقائي رسالة تلقائيا، ولكن لا يحدث الإكمال إلا عند الاستدعاء التالي لناقل خدمة Microsoft Azure. يمكن أن يؤثر هذا السلوك على تصميم سير العمل. على سبيل المثال، تجنب تغيير التزامن على مشغل الإكمال التلقائي لأن هذا التغيير قد يؤدي إلى رسائل مكررة إذا دخل سير العمل في حالة تقييد. يؤدي تغيير عنصر تحكم التزامن إلى إنشاء الشروط التالية:
يتم تخطي المشغلات المقيدة مع التعليمات البرمجية
WorkflowRunInProgress.لن يتم تشغيل عملية الإكمال.
يحدث تشغيل المشغل التالي بعد الفاصل الزمني للاستقصاء.
يجب عليك تعيين مدة تأمين ناقل الخدمة إلى قيمة أطول من الفاصل الزمني للاستقصاء. ومع ذلك، على الرغم من هذا الإعداد، قد لا تكتمل الرسالة إذا بقي سير العمل في حالة تقييد في الفاصل الزمني التالي للاستقصاء.
ومع ذلك، إذا قمت بتشغيل إعداد التزامن لمشغل ناقل خدمة Microsoft Azure، فإن القيمة الافتراضية للخاصية
maximumWaitingRunsهي 10. استنادا إلى إعداد مدة تأمين كيان ناقل خدمة Microsoft Azure ومدة التشغيل لسير العمل الخاص بك، قد تكون هذه القيمة الافتراضية كبيرة جدا وقد تتسبب في استثناء "تأمين مفقود". للعثور على القيمة المثلى للسيناريو الخاص بك، ابدأ الاختبار بقيمة 1 أو 2 للخاصيةmaximumWaitingRuns. لتغيير الحد الأقصى لقيمة عمليات تشغيل الانتظار، راجع تغيير حد عمليات تشغيل الانتظار.
مشغلات الموصل المضمنة لناقل خدمة Microsoft Azure
حاليا، تتم مشاركة إعدادات التكوين للمشغل المضمن لناقل خدمة Microsoft Azure بين ملحق مضيف Azure Functions، والذي يتم تعريفه في ملف host.json للتطبيق المنطقي، وإعدادات المشغل المحددة في سير عمل تطبيق المنطق، والتي يمكنك إعدادها إما من خلال طريقة عرض المصمم أو التعليمات البرمجية. يغطي هذا القسم موقعي الإعدادات.
في مهام سير العمل القياسية، يمكن لبعض المشغلات، مثل عند توفر الرسائل في مشغل قائمة انتظار ، إرجاع رسالة واحدة أو أكثر. عندما يتم تشغيل هذه المشغلات، فإنها ترجع بين رسالة واحدة وعدد الرسائل. بالنسبة لهذا النوع من المشغلات وحيث لا يتم دعم المعلمة الحد الأقصى لعدد الرسائل، لا يزال بإمكانك التحكم في عدد الرسائل المستلمة باستخدام الخاصية maxMessageBatchSize في ملف host.json . للعثور على هذا الملف، راجع تحرير إعدادات المضيف والتطبيق لتطبيقات المنطق القياسية.
"extensions": { "serviceBus": { "maxMessageBatchSize": 25 } }يمكنك أيضا تمكين التزامن على مشغل ناقل خدمة Microsoft Azure، إما من خلال المصمم أو في التعليمات البرمجية:
"runtimeConfiguration": { "concurrency": { "runs": 100 } }عند إعداد التزامن باستخدام دفعة، احتفظ بعدد عمليات التشغيل المتزامنة أكبر من الحجم الإجمالي للدفعة. وبهذه الطريقة، لا تنتقل الرسائل المقروءة إلى حالة انتظار ويتم التقاطها دائما عند قراءتها. في بعض الحالات، يمكن أن يكون للمشغل ما يصل إلى ضعف حجم الدفعة.
إذا قمت بتمكين التزامن، يتم تقليل حد SplitOn إلى 100 عنصر. هذا السلوك صحيح لجميع المشغلات، وليس فقط مشغل ناقل خدمة Microsoft Azure. تأكد من أن حجم الدفعة المحدد أقل من هذا الحد على أي مشغل حيث تقوم بتمكين التزامن.
توجد بعض السيناريوهات حيث يمكن أن يتجاوز المشغل إعدادات التزامن. بدلا من فشل هذه التشغيلات، يقوم Azure Logic Apps بقوائم الانتظار في حالة انتظار حتى يمكن بدء تشغيلها. يتحكم إعداد maximumWaitingRuns في عدد عمليات التشغيل المسموح بها في حالة الانتظار:
"runtimeConfiguration": { "concurrency": { "runs": 100, "maximumWaitingRuns": 50 } }باستخدام مشغل ناقل خدمة Microsoft Azure، تأكد من اختبار هذه التغييرات بعناية بحيث لا ينتظر التشغيل لفترة أطول من مهلة تأمين الرسالة. لمزيد من المعلومات حول القيم الافتراضية، راجع حدود التزامن وإلغاء الإرسال في دفعات هنا.
إذا قمت بتمكين التزامن، فهناك تأخير 30 ثانية بين قراءات الدفعات، بشكل افتراضي. يؤدي هذا التأخير إلى إبطاء المشغل لتحقيق الأهداف التالية:
تقليل عدد استدعاءات التخزين المرسلة للتحقق من عدد عمليات التشغيل التي يجب تطبيق التزامن عليها.
محاكاة سلوك مشغل الموصل المدار لناقل خدمة Microsoft Azure، والذي يحتوي على استقصاء لمدة 30 ثانية عند عدم العثور على رسائل.
يمكنك تغيير هذا التأخير، ولكن تأكد من اختبار أي تغييرات على القيمة الافتراضية بعناية:
"workflow": { "settings": { "Runtime.ServiceProviders.FunctionTriggers.DynamicListenerEnableDisableInterval": "00:00:30" } }
الخطوة 1: التحقق من الوصول إلى مساحة اسم ناقل خدمة Microsoft Azure
للتأكد من أن مورد تطبيق المنطق الخاص بك لديه أذونات للوصول إلى مساحة اسم ناقل خدمة Microsoft Azure، استخدم الخطوات التالية:
في مدخل Microsoft Azure، افتح مساحة اسم ناقل خدمة Microsoft Azure.
في قائمة مساحة الاسم، ضمن Settings، حدد Shared access policies. ضمن المطالبات، تحقق من أن لديك إدارة الأذونات لمساحة الاسم هذه.
الخطوة 2: الحصول على متطلبات مصادقة الاتصال
لاحقا، عند إضافة مشغل ناقل خدمة Microsoft Azure أو إجراء للمرة الأولى، تتم مطالبتك بمعلومات الاتصال، بما في ذلك نوع مصادقة الاتصال. استنادا إلى نوع سير عمل التطبيق المنطقي وإصدار موصل ناقل خدمة Microsoft Azure ونوع المصادقة المحدد، ستحتاج إلى العناصر التالية:
مصادقة الموصل المدارة (الاستهلاك وسير العمل القياسي)
| نوع المصادقة | المعلومات المطلوبة |
|---|---|
| مفتاح الاختصار | سلسلة الاتصال لمساحة اسم ناقل خدمة Microsoft Azure. لمزيد من المعلومات، راجع الحصول على سلسلة الاتصال لمساحة اسم ناقل خدمة Microsoft Azure |
| Microsoft Entra متكامل | عنوان URL لنقطة النهاية لمساحة اسم ناقل خدمة Microsoft Azure. لمزيد من المعلومات، راجع الحصول على عنوان URL لنقطة النهاية لمساحة اسم ناقل خدمة Microsoft Azure. |
| الهوية المدارة لتطبيقات المنطق | عنوان URL لنقطة النهاية لمساحة اسم ناقل خدمة Microsoft Azure. لمزيد من المعلومات، راجع الحصول على عنوان URL لنقطة النهاية لمساحة اسم ناقل خدمة Microsoft Azure. |
مصادقة الموصل المضمنة (مهام سير العمل القياسية فقط)
| نوع المصادقة | المعلومات المطلوبة |
|---|---|
| سلسلة الاتصال | سلسلة الاتصال لمساحة اسم ناقل خدمة Microsoft Azure. لمزيد من المعلومات، راجع الحصول على سلسلة الاتصال لمساحة اسم ناقل خدمة Microsoft Azure |
| خدمات مجال Active Directory Open Authorization | - الاسم المؤهل بالكامل لمساحة اسم ناقل خدمة Microsoft Azure، على سبيل المثال، <your-Service-Bus-namespace.servicebus.windows.net.> لمزيد من المعلومات، راجع الحصول على اسم مؤهل بالكامل لمساحة اسم ناقل خدمة Microsoft Azure. بالنسبة لقيم الخاصية الأخرى، راجع Microsoft Entra ID Open Authentication. |
| الهوية المدارة | الاسم المؤهل بالكامل لمساحة اسم ناقل خدمة Microsoft Azure، على سبيل المثال، <your-Service-Bus-namespace.servicebus.windows.net.> لمزيد من المعلومات، راجع الحصول على اسم مؤهل بالكامل لمساحة اسم ناقل خدمة Microsoft Azure. |
الحصول على سلسلة الاتصال لمساحة اسم ناقل خدمة Microsoft Azure
لإنشاء اتصال عند إضافة مشغل أو إجراء ناقل خدمة Microsoft Azure، يجب أن يكون لديك سلسلة الاتصال لمساحة اسم ناقل خدمة Microsoft Azure. يبدأ سلسلة الاتصال ببادئة sb://.
في مدخل Microsoft Azure، افتح مساحة اسم ناقل خدمة Microsoft Azure.
في قائمة مساحة الاسم، ضمن Settings، حدد Shared access policies.
في جزء Shared access policies ، حدد RootManageSharedAccessKey.
بجوار سلسلة الاتصال الأساسي أو الثانوي، حدد زر النسخ.
إشعار
للتحقق من أن السلسلة لمساحة الاسم، وليس كيان مراسلة محدد، ابحث في سلسلة الاتصال عن المعلمة
EntityPath. إذا وجدت هذه المعلمة، فإن سلسلة الاتصال خاص بكيان معين، وليس السلسلة الصحيحة لاستخدامها مع سير العمل الخاص بك.احفظ سلسلة الاتصال لاستخدامها لاحقًا.
الحصول على عنوان URL لنقطة النهاية لمساحة اسم ناقل خدمة Microsoft Azure
إذا كنت تستخدم موصل ناقل خدمة Microsoft Azure المدار، فأنت بحاجة إلى عنوان URL لنقطة النهاية هذا إذا حددت إما نوع المصادقة ل Microsoft Entra المتكامل أو Logic Apps Managed Identity. يبدأ عنوان URL لنقطة النهاية ببادئة sb:// .
في مدخل Microsoft Azure، افتح مساحة اسم ناقل خدمة Microsoft Azure.
في قائمة مساحة الاسم، ضمن الإعدادات، حدد خصائص.
ضمن Properties، بجوار نقطة نهاية ناقل الخدمة، انسخ عنوان URL لنقطة النهاية، واحفظه للاستخدام لاحقا عندما يتعين عليك توفير عنوان URL لنقطة نهاية ناقل الخدمة.
الحصول على اسم مؤهل بالكامل لمساحة اسم ناقل خدمة Microsoft Azure
في مدخل Microsoft Azure، افتح مساحة اسم ناقل خدمة Microsoft Azure.
في قائمة مساحة الاسم، حدد Overview.
في جزء Overview، ابحث عن خاصية Host name وانسخ الاسم المؤهل بالكامل، والذي يبدو مثل< your-Service-Bus-namespace.servicebus.windows.net.>
الخطوة 3: الخيار 1 - إضافة مشغل ناقل خدمة Microsoft Azure
تستخدم الخطوات التالية مدخل Microsoft Azure، ولكن مع ملحق Azure Logic Apps المناسب، يمكنك أيضا استخدام الأدوات التالية لإنشاء مهام سير عمل التطبيق المنطقي:
سير عمل تطبيق منطق الاستهلاك: Visual Studio أو Visual Studio Code
سير عمل تطبيق المنطق القياسي: Visual Studio Code
في مدخل Microsoft Azure، افتح مورد تطبيق Consumption logic مع سير عمل فارغ في المصمم.
في المصمم، اتبع هذه الخطوات العامة لإضافة مشغل ناقل خدمة Azure الذي تريده.
يستمر هذا المثال مع المشغل المسمى When a message is received in a queue (auto-complete).
إذا طلب منك ذلك، فوفر المعلومات التالية لاتصالك. عند الانتهاء، حدد إنشاء.
الخاصية المطلوب الوصف اسم الاتصال نعم اسم لاتصالك نوع المصادقة نعم نوع المصادقة التي يجب استخدامها للوصول إلى مساحة اسم ناقل خدمة Microsoft Azure. لمزيد من المعلومات، راجع مصادقة الموصل المدارة. سلسلة الاتصال نعم سلسلة الاتصال التي قمت بنسخها وحفظها مسبقا. على سبيل المثال، يستخدم هذا الاتصال مصادقة مفتاح الوصول ويوفر سلسلة الاتصال لمساحة اسم ناقل خدمة Microsoft Azure:
بعد ظهور مربع معلومات المشغل، قم بتوفير المعلومات الضرورية، على سبيل المثال:
الخاصية المطلوب الوصف اسم قائمة الانتظار نعم قائمة الانتظار المحددة للوصول إليها نوع قائمة الانتظار لا نوع قائمة الانتظار المحددة كم مرة تريد التحقق من وجود عناصر؟ نعم الفاصل الزمني للاستقصاء وتكرار التحقق من قائمة الانتظار بحثا عن العناصر 
لإضافة أي خصائص متوفرة أخرى إلى المشغل، افتح قائمة إضافة معلمات جديدة، وحدد الخصائص التي تريدها.
أضف أي إجراءات يحتاجها سير العمل.
على سبيل المثال، يمكنك إضافة إجراء يرسل بريدا إلكترونيا عند وصول رسالة جديدة. عندما يتحقق المشغل من قائمة الانتظار ويعثر على رسالة جديدة، يقوم سير العمل بتشغيل الإجراءات المحددة للرسالة التي تم العثور عليها.
عند الانتهاء، احفظ سير العمل الخاص بك. في شريط أدوات المصمم، حدد "Save".
الخطوة 3: الخيار 2 - إضافة إجراء ناقل خدمة Microsoft Azure
تستخدم الخطوات التالية مدخل Microsoft Azure، ولكن مع ملحق Azure Logic Apps المناسب، يمكنك أيضا استخدام الأدوات التالية لإنشاء مهام سير عمل التطبيق المنطقي:
سير عمل تطبيق منطق الاستهلاك: Visual Studio أو Visual Studio Code
سير عمل تطبيق المنطق القياسي: Visual Studio Code
في مدخل Microsoft Azure، افتح تطبيق منطق الاستهلاك وسير العمل في المصمم.
في المصمم، اتبع هذه الخطوات العامة لإضافة الإجراء ناقل خدمة Azure الذي تريده.
يستمر هذا المثال مع إجراء إرسال رسالة .
إذا طلب منك ذلك، فوفر المعلومات التالية لاتصالك. عند الانتهاء، حدد إنشاء.
الخاصية المطلوب الوصف اسم الاتصال نعم اسم لاتصالك نوع المصادقة نعم نوع المصادقة التي يجب استخدامها للوصول إلى مساحة اسم ناقل خدمة Microsoft Azure. لمزيد من المعلومات، راجع مصادقة الموصل المدارة. سلسلة الاتصال نعم سلسلة الاتصال التي قمت بنسخها وحفظها مسبقا. على سبيل المثال، يستخدم هذا الاتصال مصادقة مفتاح الوصول ويوفر سلسلة الاتصال لمساحة اسم ناقل خدمة Microsoft Azure:
بعد ظهور مربع معلومات الإجراء، قم بتوفير المعلومات الضرورية، على سبيل المثال:
الخاصية المطلوب الوصف اسم قائمة الانتظار/الموضوع نعم قائمة الانتظار المحددة أو وجهة الموضوع لإرسال الرسالة معرف جلسة العمل لا معرف جلسة العمل في حالة إرسال الرسالة إلى قائمة انتظار أو موضوع مدرك لجلسة العمل خصائص النظام لا - بلا
- تفاصيل التشغيل: أضف معلومات خاصية بيانات التعريف حول التشغيل كخصائص مخصصة في الرسالة.
لإضافة أي خصائص متوفرة أخرى إلى الإجراء، افتح قائمة إضافة معلمات جديدة، وحدد الخصائص التي تريدها.
أضف أي إجراءات أخرى يحتاجها سير العمل.
على سبيل المثال، يمكنك إضافة إجراء يرسل بريدا إلكترونيا لتأكيد إرسال رسالتك.
عند الانتهاء، احفظ سير العمل الخاص بك. في شريط أدوات المصمم، حدد "Save".
إعدادات تطبيق موصل ناقل خدمة Microsoft Azure المضمنة
في مورد تطبيق المنطق القياسي، يتضمن موصل ناقل خدمة Microsoft Azure المضمن إعدادات التطبيق التي تتحكم في حدود مختلفة، مثل مهلة إرسال الرسائل وعدد مرسلي الرسائل لكل ذاكرة أساسية للمعالج في تجمع الرسائل. لمزيد من المعلومات، راجع مرجع إعدادات التطبيق - local.settings.json.
قراءة الرسائل من قوائم الانتظار غير المستخدمة مع مشغلات ناقل خدمة Microsoft Azure المضمنة
في مهام سير العمل القياسية، لقراءة رسالة من قائمة انتظار غير مستخدمة في قائمة انتظار أو اشتراك موضوع، اتبع الخطوات التالية باستخدام المشغلات المحددة:
في سير العمل الفارغ، استنادا إلى السيناريو الخاص بك، أضف مشغل الموصل المضمن لناقل خدمة Microsoft Azure المسمى When messages are available in a queue or When a message are available in a topic subscription (peek-lock).
في المشغل، قم بتعيين قيم المعلمات التالية لتحديد قائمة الانتظار أو قائمة الانتظار الافتراضية للاشتراك في الموضوع، والتي يمكنك الوصول إليها مثل أي قائمة انتظار أخرى:
عندما تتوفر الرسائل في مشغل قائمة انتظار : قم بتعيين معلمة اسم قائمة الانتظار إلى اسم قائمة الانتظار/$deadletterqueue.
عندما تتوفر رسالة في مشغل اشتراك موضوع (peek-lock): قم بتعيين المعلمة Topic name إلى topicname/Subscriptions/subscriptionname/$deadletterqueue.
لمزيد من المعلومات، راجع نظرة عامة على قوائم الانتظار غير المستخدمة لناقل خدمة Microsoft Azure.
استكشاف الأخطاء وإصلاحها
التأخيرات في التحديثات الخاصة بسير العمل الخاص بك سارية المفعول
إذا كان الفاصل الزمني للاستقصاء لمشغل ناقل خدمة Microsoft Azure صغيرا، مثل 10 ثوان، فقد لا تسري التحديثات على سير العمل لمدة تصل إلى 10 دقائق. لحل هذه المشكلة، يمكنك تعطيل مورد تطبيق المنطق، وإجراء التغييرات، ثم تمكين مورد تطبيق المنطق مرة أخرى.
لا تتوفر جلسة عمل
في بعض الأحيان، تنتج عمليات مثل إكمال رسالة أو تجديد جلسة عمل الخطأ التالي:
{
"status": 400,
"message": "No session available to complete the message with the lock token 'ce440818-f26f-4a04-aca8-555555555555'. clientRequestId: facae905-9ba4-44f4-a42a-888888888888",
"error": {
"message": "No session available to complete the message with the lock token 'ce440818-f26f-4a04-aca8-555555555555'."
}
}
يستخدم موصل ناقل خدمة Microsoft Azure ذاكرة التخزين المؤقت في الذاكرة لدعم جميع العمليات المقترنة بجلسات العمل. يتم تخزين جهاز استقبال رسالة ناقل خدمة Microsoft Azure مؤقتا في ذاكرة مثيل الدور (الجهاز الظاهري) الذي يتلقى الرسائل. لمعالجة جميع الطلبات، يتم توجيه جميع الاستدعاءات للاتصال إلى نفس مثيل الدور هذا. هذا السلوك مطلوب لأن جميع عمليات ناقل خدمة Microsoft Azure في جلسة تتطلب نفس المتلقي الذي يتلقى الرسائل لجلسة عمل معينة.
توجد فرصة أن الطلبات قد لا يتم توجيهها إلى نفس مثيل الدور، لأسباب مثل تحديث البنية الأساسية ونشر الموصل وما إلى ذلك. إذا حدث هذا الحدث، تفشل الطلبات لأن المتلقي الذي ينفذ العمليات في جلسة العمل غير متوفر في مثيل الدور الذي يخدم الطلب.
طالما أن هذا الخطأ يحدث أحيانا فقط، فمن المتوقع حدوث الخطأ. عند حدوث الخطأ، لا يزال يتم الاحتفاظ بالرسالة في ناقل الخدمة. يحاول المشغل أو تشغيل سير العمل التالي معالجة الرسالة مرة أخرى.