إنشاء مثال لسير عمل قياسي في Azure Logic Apps أحادي المستأجر باستخدام مدخل Microsoft Azure

ينطبق على: Azure Logic Apps (قياسي)

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

إشعار

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

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

في أثناء التقدم، ستكمل هذه المهام عالية المستوى:

• إنشاء مورد تطبيق منطق قياسي وإضافة سير عمل فارغ ذي حالة.
• إضافة مشغل وإجراء.
• تشغيل سير عمل.
• عرض سجل تشغيل سير العمل ومشغله.
• تمكين Application Insights أو فتحه بعد التوزيع.
• تمكين محفوظات التشغيل لسير العمل عديم الحالة.

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

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

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

• حساب Azure Storage. إذا لم يكن لديك حساب، يمكنك إما إنشاء حساب تخزين مسبقا أو في أثناء إنشاء تطبيق المنطق.

  إشعار

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

• لإنشاء نفس مثال سير العمل في هذا الدليل، تحتاج إلى حساب بريد إلكتروني في Office 365 Outlook يستخدم حساب Microsoft للعمل أو المؤسسة التعليمية لتسجيل الدخول.

  إذا لم يكن لديك حساب Office 365، فيمكنك استخدام أي موصل بريد إلكتروني آخر متوفر يمكنه إرسال رسائل من حساب بريدك الإلكتروني، على سبيل المثال، Outlook.com. إذا كنت تستخدم موصل بريد إلكتروني مختلف، فلا يزال بإمكانك اتباع المثال، والخطوات العامة هي نفسها. ومع ذلك، قد تختلف خياراتك في بعض الطرق. على سبيل المثال، إذا كنت تستخدم موصل Outlook.com، فاستخدم حساب Microsoft الشخصي بدلًا من ذلك لتسجيل الدخول.

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

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

• لنشر مورد تطبيق المنطق القياسي الخاص بك إلى App Service Environment v3 (ASEv3) - خطة Windows فقط، يجب عليك إنشاء مورد البيئة هذا أولا. يمكنك بعد ذلك تحديد هذه البيئة كموقع للتوزيع عند إنشاء مورد تطبيق المنطق الخاص بك. لمزيد من المعلومات، راجع أنواع الموارد والبيئاتوإنشاء بيئة خدمة التطبيقات.

• بدءا من منتصف أكتوبر 2022، تستخدم مهام سير عمل تطبيق المنطق القياسي الجديد في مدخل Microsoft Azure وظائف Azure v4 تلقائيا. طوال نوفمبر 2022، يتم ترحيل مهام سير العمل القياسية الموجودة في مدخل Microsoft Azure تلقائيا إلى Azure Functions v4. ما لم تقم بنشر تطبيقات المنطق القياسية كمشاريع مستندة إلى NuGet أو تثبيت تطبيقات المنطق الخاصة بك بإصدار حزمة معينة، فقد تم تصميم هذه الترقية بحيث لا تتطلب أي إجراء منك ولا يكون لها تأثير على وقت التشغيل. ومع ذلك، إذا كانت الاستثناءات تنطبق عليك، أو لمزيد من المعلومات حول دعم Azure Functions v4، راجع Azure Logic Apps Standard يدعم الآن Azure Functions v4.

أفضل الممارسات والتوصيات

للاستجابة والأداء الأمثل للمصمم، راجع هذه الإرشادات واتبعها:

• لا تستخدم أكثر من 50 إجراءً لكل سير عمل. يؤدي تجاوز هذا العدد من الإجراءات إلى زيادة احتمالية بطء أداء المصمم.

• ضع في اعتبارك تقسيم منطق الأعمال إلى مهام سير عمل متعددة عند الضرورة.

• ليس لديك أكثر من 10-15 مهمة سير عمل لكل مورد تطبيق منطقي.

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

إنشاء مورد logic app قياسي

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

2. في مربع البحث في مدخل Microsoft Azure، أدخل logic apps، وحدد Logic apps.

   

3. في صفحة Logic apps ، حدد Add.

4. في صفحة Create Logic App، في علامة التبويب Basics، قم بتوفير المعلومات الأساسية التالية حول تطبيق المنطق الخاص بك:

   الخاصية	المطلوب	قيمة	‏‏الوصف
   الاشتراك	‏‏نعم‬	<"Azure-subscription-name">	اسم اشتراك Azure خاصتك.
   مجموعة الموارد	‏‏نعم‬	<اسم مجموعة الموارد>	مجموعة موارد Azure حيث تقوم بإنشاء تطبيق المنطق والموارد ذات الصلة. يجب أن يكون هذا الاسم فريدًا عبر المناطق ويمكن أن يحتوي فقط على أحرف وأرقام وواصلات (-) وتسطير سفلي (_) وأقواس (()) ونقاط (.). ينشئ هذا المثال مجموعة موارد تسمى Fabrikam-Workflows-RG.
   إدخال اسم التطبيق	‏‏نعم‬	<"logic-app-name">	اسم مورد تطبيق المنطق الخاص بك، والذي يجب أن يكون فريدا عبر المناطق ويمكن أن يحتوي فقط على أحرف وأرقام وواصلات (-) والتسطير السفلي (_) والأقواس (()) والنقاط (.). ملاحظة: يحصل اسم تطبيق المنطق الخاص بك تلقائيا على اللاحقة، .azurewebsites.net، لأن مورد تطبيق المنطق القياسي مدعوم بوقت تشغيل Azure Logic Apps أحادي المستأجر، والذي يستخدم نموذج قابلية توسعة Azure Functions ويتم استضافته كملحق في وقت تشغيل Azure Functions. تستخدم Azure Functions نفس اصطلاح تسمية التطبيق. ينشئ هذا المثال تطبيقًا منطقيًا يسمى Fabrikam-Workflows.

5. قبل متابعة إجراء التحديدات، انتقل إلى قسم الخطة. بالنسبة لنوع الخطة، حدد قياسي بحيث يمكنك عرض الإعدادات التي تنطبق فقط على نوع "logic app" المستند إلى الخطة القياسية.

   تحدد خاصية نوع الخطة خطة الاستضافة ونموذج الفوترة لاستخدامها مع "logic app" الخاص بك. لمزيد من المعلومات، راجع خطط الاستضافة طبقات التسعير.

   نوع الخطة	‏‏الوصف
   قياسي	نوع التطبيق المنطقي هذا هو التحديد الافتراضي. يتم تشغيل مهام سير العمل في Azure Logic Apps أحادية المستأجر وتستخدم نموذج الفوترة القياسي.
   الاستهلاك	يعمل نوع التطبيق المنطقي هذا وسير العمل في تطبيقات Azure Logic Apps العمومية متعددة المستأجرين ويستخدم نموذج فوترة الاستهلاك.

   الخاصية	المطلوب	قيمة	‏‏الوصف
   خطة Windows	‏‏نعم‬	<اسم الخطة>	اسم الخطة المراد استخدامها. إما تحديد اسم خطة موجود أو توفير اسم لخطة جديدة. يستخدم هذا المثال الاسم My-App-Service-Plan. ملاحظة: يتم دعم خطة App Service المستندة إلى Windows فقط. لا تستخدم خطة App Service المستندة إلى Linux.
   خطة التسعير	‏‏نعم‬	<مستوى التسعير⁧>	مستوى التسعير الذي يجب استخدامه لتطبيق المنطق وسير العمل. يؤثر اختيارك على التسعير والحوسبة والذاكرة والتخزين التي يستخدمها تطبيق المنطق وسير العمل. لمزيد من المعلومات، راجع خطط الاستضافة طبقات التسعير.

6. الآن استمر في إجراء التحديدات التالية:

   الخاصية	المطلوب	قيمة	‏‏الوصف
   نشر	‏‏نعم‬	سير العمل	يظهر هذا الخيار ويطبق فقط عند تعيين نوع الخطة إلى نوع تطبيق المنطق القياسي. بشكل افتراضي، يتم تعيين هذا الخيار إلى سير العمل وإنشاء مورد تطبيق منطقي فارغ حيث تقوم بإضافة سير العمل الأول. ملاحظة: حاليا، يتطلب خيار Docker Containerموقعًا مخصصًا على مجموعة Kubernetes الممكنة في Azure Arc، والتي يمكنك استخدامها مع Logic Apps الممكنة في Azure Arc (قياسي). يجب أن تكون مواقع الموارد لتطبيق المنطق والموقع المخصص والكتلة هي نفسها.
   المنطقة	‏‏نعم‬	<تحديد منطقة Azure>	منطقة مركز بيانات Azure لاستخدامها لتخزين معلومات تطبيقك. ينشر هذا المثال نموذج تطبيق المنطق إلى منطقة غرب الولايات المتحدة في Azure. - إذا اخترت Docker Container مسبقًا، فحدد موقعك المخصص من قائمة Region. - إذا كنت ترغب في نشر التطبيق الخاص بك إلى مورد App Service Environment v3 موجود، يمكنك تحديد تلك البيئة من قائمة Region.

   إشعار

   إذا حددت منطقة Azure تدعم تكرار منطقة التوفر، يتم تمكين قسم تكرار المنطقة. يوفر هذا القسم خيار تمكين تكرار منطقة التوفر لـ "logic app" الخاص بك. ومع ذلك، لا تتضمن مناطق Azure المدعومة حالياً غرب الولايات المتحدة، لذلك يمكنك تجاهل هذا القسم لهذا المثال. لمزيد من المعلومات، راجع حماية "logic apps" من حالات فشل المنطقة مع مناطق التكرار والتوفر في المنطقة.

   عند الانتهاء، تبدو إعداداتك مشابهة للمثال التالي:

   

7. في علامة التبويب Hosting، قم بتوفير المعلومات التالية حول حل التخزين وخطة الاستضافة لاستخدامها لتطبيق المنطق الخاص بك.

   الخاصية	المطلوب	قيمة	‏‏الوصف
   نوع التخزين	‏‏نعم‬	- تخزين Azure - تخزين SQL وAzure	نوع التخزين الذي تريد استخدامه للبيانات والبيانات المتعلقة بسير العمل. - للنشر فقط في Azure، حدد Azure Storage. - لاستخدام SQL كمساحة تخزين أساسية وAzure Storage كمساحة تخزين ثانوية، حدد SQL وAzure Storage، وراجع إعداد تخزين قاعدة بيانات SQL لتطبيقات المنطق القياسية في تطبيقات Azure Logic Apps أحادية المستأجر. ملاحظة: إذا كنت تقوم بالنشر في منطقة Azure، فلا تزال بحاجة إلى حساب تخزين Azure، والذي يستخدم لإكمال الاستضافة لمرة واحدة لتكوين تطبيق المنطق على النظام الأساسي Azure Logic Apps. يتم تخزين حالة سير العمل ومحفوظات التشغيل والبيانات الاصطناعية الأخرى لوقت التشغيل في قاعدة بيانات SQL. بالنسبة إلى عمليات التوزيع إلى موقع مخصص مستضاف على مجموعة Azure Arc، تحتاج فقط SQL كموفر تخزين.
   حساب التخزين	‏‏نعم‬	<اسم حساب تخزين Azure>	حساب Azure Storage لاستخدامه لمعاملات التخزين. يجب أن يكون اسم المورد هذا فريدًا عبر المناطق وأن يحتوي على 3-24 حرفًا بأرقام وأحرف صغيرة فقط. إما تحديد حساب موجود أو إنشاء حساب جديد. ينشئ هذا المثال حساب تخزين باسم mystorageacct.

8. في علامة التبويب Networking ، يمكنك ترك الخيارات الافتراضية لهذا المثال.

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

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

   لتمكين تطبيق المنطق الخاص بك من الوصول إلى نقاط النهاية في شبكة ظاهرية، تأكد من تحديد الخيار المناسب:

   تمكين حقن الشبكة	سلوك
   في	يمكن أن تتواصل مهام سير عمل التطبيق المنطقي بشكل خاص وآمن مع نقاط النهاية في الشبكة الظاهرية.
   قباله	لا يمكن لسير عمل تطبيق المنطق الاتصال بنقاط النهاية في الشبكة الظاهرية.

9. إذا كانت إعدادات الإنشاء والنشر تدعم استخدام Application Insights، يمكنك تمكين تسجيل التشخيصات وتتبعها بشكل اختياري لسير عمل تطبيق المنطق.

   1. في علامة التبويب Monitoring، ضمن Application Insights، قم بتعيين Enable Application Insights إلى Yes إذا لم يكن محددًا بالفعل.

   2. بالنسبة إلى إعداد Application Insights، حدد مثيل Application Insights موجود، أو إذا كنت تريد إنشاء مثيل جديد، فحدد إنشاء جديد وقم بتوفير الاسم الذي تريد استخدامه.

10. بعد أن يتحقق Azure من صحة إعدادات تطبيق المنطق، في علامة التبويب Review + create، حدد Create، على سبيل المثال:

    

    إشعار

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

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

11. في صفحة اكتمال النشر، حدد الانتقال إلى المورد بحيث يمكنك إضافة سير عمل فارغ.

    

إضافة سير عمل فارغ

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

1. بعد فتح Azure للمورد، في قائمة مورد تطبيق المنطق، حدد Workflows. في شريط أدوات Workflows، حدد Add.

   

2. بعد فتح جزء "New workflow"، قم بتوفير اسم لسير العمل، وحدد نوع الحالة، إما Stateful أو Stateless. عند الانتهاء، حدد إنشاء.

   يضيف هذا المثال سير عمل فارغا ذو حالة مسمى Stateful-Workflow. بشكل افتراضي، يتم تمكين سير العمل ولكنه لا يفعل أي شيء حتى تضيف مشغلاً وإجراءات.

   

3. من قائمة سير العمل، حدد سير العمل الفارغ ذي الحالة.

4. في قائمة سير العمل، ضمن Developer، حدد Designer.

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

لذلك ستقوم الآن بإضافة مشغل يبدأ سير العمل الخاص بك.

إضافة مشغل

يبدأ سير العمل المثال هذا بمشغل الطلب المضمن المسمى عند تلقي طلب HTTP. ينشئ هذا المشغل نقطة نهاية يمكن للخدمات الأخرى أو مهام سير عمل تطبيق المنطق الاتصال بها والانتظار حتى تصل تلك المكالمات أو الطلبات الواردة. يتم تشغيل العمليات المضمنة بشكل أصلي ومباشر ضمن وقت تشغيل Azure Logic Apps.

1. على مصمم سير العمل، تأكد من أن سير العمل الفارغ مفتوح ومن تحديد مطالبة إضافة مشغل على سطح المصمم.

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

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

   

3. احفظ سير العمل الخاص بك. في شريط أدوات المصمم، حدد "Save".

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

إضافة إجراء

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

1. على المصمم، ضمن المشغل الذي أضفته، حدد علامة الجمع (+) >إضافة إجراء.

   يفتح جزء Add an action بحيث يمكنك تحديد الإجراء التالي.

2. باستخدام office، أرسل بريدا إلكترونيا كمصطلح بحث، اتبع هذه الخطوات لإضافة إجراء Office 365 Outlook المسمى إرسال بريد إلكتروني (V2) إلى سير العمل.

3. في جزء معلومات الإجراء، في علامة التبويب إنشاء الاتصال ion، حدد تسجيل الدخول حتى تتمكن من إنشاء اتصال بحساب بريدك الإلكتروني.

   

4. عندما تتم مطالبتك بالوصول إلى حساب بريدك الإلكتروني، سجل الدخول باستخدام بيانات اعتماد حسابك.

   إشعار

   إذا تلقيت رسالة الخطأ، "فشل مع الخطأ: 'المستعرض مغلق.'. يرجى تسجيل الدخول مرة أخرى"، تحقق مما إذا كان المستعرض يحظر ملفات تعريف الارتباط التابعة لجهات خارجية. إذا تم حظر ملفات تعريف الارتباط هذه، فحاول إضافة https://portal.azure.com إلى قائمة المواقع التي يمكنها استخدام ملفات تعريف الارتباط. إذا كنت تستخدم وضع التصفح المتخفي، فتأكد من عدم حظر ملفات تعريف الارتباط التابعة لجهة خارجية في أثناء العمل في هذا الوضع.

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

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

5. في جزء معلومات الإجراء، في علامة التبويب Parameters ، قم بتوفير المعلومات المطلوبة للإجراء، على سبيل المثال:

   

   الخاصية	المطلوب	قيمة	‏‏الوصف
   إلى	‏‏نعم‬	<your-email-address>	مستلم البريد الإلكتروني، والذي يمكن أن يكون عنوان بريدك الإلكتروني لأغراض الاختبار. يستخدم هذا المثال البريد الإلكتروني الوهمي، sophiaowen@fabrikam.com.
   الموضوع	‏‏نعم‬	رسالة بريد إلكتروني من مثال سير العمل	عنوان البريد الإلكتروني
   نص الرسالة	‏‏نعم‬	مرحبا من مثال سير العمل الخاص بك!	محتوى نص البريد الإلكتروني

   إشعار

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

6. احفظ سير العمل الخاص بك. في شريط أدوات المصمم، حدد "Save".

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

   وإلا، لاختبار سير العمل الخاص بك، قم بالتشغيل يدويًا.

حذف العناصر من المصمم

لحذف عنصر في سير العمل من المصمم، اتبع أيا من الخطوات التالية:

• حدد العنصر، وافتح القائمة المختصرة للعنصر (Shift+F10)، وحدد حذف. للتأكيد، حدد «OK».

• حدد العنصر، واضغط على مفتاح الحذف. للتأكيد، حدد «OK».

• حدد العنصر بحيث يفتح جزء المعلومات لهذا العنصر. في الزاوية العلوية اليسرى من الجزء، افتح قائمة علامات الحذف (...)، وحدد حذف. للتأكيد، حدد «OK».

  

  تلميح

  إذا لم تكن قائمة علامات الحذف مرئية، فقم بتوسيع نافذة المستعرض بحيث يعرض جزء المعلومات زر علامات الحذف (...) في الزاوية العلوية اليسرى.

البحث عن أسماء المجالات للوصول إلى جدار الحماية

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

للعثور على عناوين IP الواردة والصادرة المستخدمة من قبل تطبيق المنطق ومهام سير العمل، اتبع الخطوات التالية:

1. في قائمة logic app، ضمن الإعدادات، حدد Networking (معاينة).

2. في صفحة الشبكات، ابحث عن قسمي نسبة استخدام الشبكة الواردة ونسبة استخدام الشبكة الصادرة وراجعهما.

للعثور على أسماء المجالات المؤهلة بالكامل (FQDNs) للاتصالات، اتبع الخطوات التالية:

1. في قائمة logic app، ضمن Workflows، حدد Connections. في علامة التبويب API Connections، حدد اسم مورد الاتصال، على سبيل المثال:

   

2. قم بتوسيع المستعرض الخاص بك على نطاق كاف بحيث عندما تظهر طريقة عرض JSON في الزاوية العلوية اليسرى للمستعرض، حدد JSON View.

   

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

   

4. لكل اتصال، كرر الخطوات ذات الصلة.

تشغيل مسار العمل

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

1. في مصمم سير العمل، حدد مشغل الطلب المسمى عند تلقي طلب HTTP.

2. بعد فتح جزء المعلومات، في علامة التبويب Parameters ، ابحث عن خاصية HTTP POST URL . لنسخ عنوان URL الذي تم إنشاؤه، حدد نسخ عنوان URL (أيقونة نسخ الملف)، واحفظ عنوان URL في مكان آخر في الوقت الحالي. يتبع عنوان URL هذا التنسيق:

   https://<*logic-app-name*>.azurewebsites.net:443/api/<*workflow-name*>/triggers/manual/invoke?api-version=2020-05-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=<*shared-access-signature*>

   

   على سبيل المثال، يبدو عنوان URL كما يلي:

   https://fabrikam-workflows.azurewebsites.net:443/api/Fabrikam-Stateful-Workflow/triggers/manual/invoke?api-version=2020-05-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=xxxxxXXXXxxxxxXXXXxxxXXXXxxxxXXXX

   تلميح

   يمكنك أيضًا العثور على عنوان URL لنقطة النهاية في جزء نظرة عامة على تطبيق المنطق في خاصية عنوان URL لسير العمل.

   1. في قائمة الموارد، حدد Overview.
   2. في جزء Overview، ابحث عن خاصية Workflow URL.
   3. لنسخ عنوان URL لنقطة النهاية، حرك المؤشر فوق نهاية نص عنوان URL لنقطة النهاية، وحدد نسخ إلى الحافظة (أيقونة ملف النسخ).

3. لاختبار عنوان URL عن طريق إرسال طلب، افتح Postman أو الأداة المفضلة لديك لإنشاء الطلبات وإرسالها.

   يستمر هذا المثال باستخدام Postman. لمزيد من المعلومات، راجع Postman Getting Started.

   1. في شريط أدوات Postman، حدد New.

      

   2. في جزء إنشاء جديد، ضمن كتل الإنشاء، حدد طلب.

   3. في نافذة حفظ الطلب ، ضمن اسم الطلب، قم بتوفير اسم للطلب، على سبيل المثال، اختبار مشغل سير العمل.

   4. ضمن تحديد مجموعة أو مجلد للحفظ إليه، حدد إنشاء مجموعة.

   5. ضمن All Collections، قم بتوفير اسم للمجموعة لإنشاء لتنظيم طلباتك، واضغط على Enter، وحدد Save to<collection-name>. يستخدم هذا المثال طلبات Logic Apps كاسم المجموعة.

      في تطبيق Postman، يفتح جزء الطلب بحيث يمكنك إرسال طلب إلى عنوان URL لنقطة النهاية لمشغل الطلب.

      

   6. في جزء الطلب، في مربع العنوان الموجود بجانب قائمة الأساليب، والتي تعرض حاليًا GET كأسلوب الطلب الافتراضي، الصق عنوان URL الذي نسخته مسبقًا، وحدد إرسال.

      

      عند تشغيل المشغل، يتم تشغيل سير عمل المثال وإرسال بريد إلكتروني يبدو مشابهًا لهذا المثال:

      

مراجعة محفوظات تشغيل سير العمل

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

بالنسبة لسير العمل هذا المثال، تبدو محفوظات تشغيل سير العمل مشابهة للعينة التالية:

مراجعة محفوظات المشغلات

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

إعادة إرسال تشغيل سير العمل بنفس المدخلات

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

تمكين محفوظات التشغيل لسير العمل عديم الحالة

لتصحيح أخطاء سير عمل عديم الحالة بسهولة أكبر، يمكنك تمكين محفوظات التشغيل لسير العمل هذا، ثم تعطيل محفوظات التشغيل عند الانتهاء. اتبع هذه الخطوات لمدخل Microsoft Azure، أو إذا كنت تعمل في Visual Studio Code، فشاهد إنشاء مهام سير عمل ذات حالة وبدون حالة في Visual Studio Code.

1. في مدخل Microsoft Azure، افتح مورد تطبيق المنطق القياسي.

2. في قائمة logic app، ضمن الإعدادات، حدد تكوين.

3. في علامة التبويب Application settings، حدد + New application setting.

4. في جزء Add/Edit application setting، في المربع Name، أدخل اسم خيار العملية هذا:

   مهام سير العمل. {yourWorkflowName}. عمليات التشغيل

5. في مربع القيمة ، أدخل القيمة التالية: WithStatelessRunHistory

   

6. لإنهاء هذه المهمة، حدد موافق. في شريط أدوات جزء التكوين، حدد حفظ.

7. لتعطيل محفوظات التشغيل عند الانتهاء، قم إما بتعيين الخاصية المسماة Workflows.{your-workflow-name}. OperationOptions إلى None، أو احذف الخاصية وقيمتها.

تمكين Application Insights أو فتحه بعد التوزيع

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

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

تمكين Application Insights على تطبيق منطق منشور

1. في مدخل Microsoft Azure، ابحث عن تطبيق المنطق المنشور.

2. في قائمة logic app، ضمن الإعدادات، حدد Application Insights.

3. في جزء Application Insights ، حدد تشغيل Application Insights.

4. بعد تحديث الجزء، في الأسفل، حدد Apply>Yes.

5. في جزء Application Insights ، حدد View Application Insights data.

   بعد فتح لوحة معلومات Application Insights، يمكنك مراجعة المقاييس أو السجلات لسير عمل التطبيق المنطقي. على سبيل المثال، للمخطط أو الاستعلام عن البيانات، في قائمة مورد Application Insights، ضمن Monitoring، حدد Metrics أو Logs.

فتح Application Insights

1. في مدخل Microsoft Azure، ابحث عن تطبيق المنطق المنشور.

2. في قائمة logic app، ضمن الإعدادات، حدد Application Insights.

3. في جزء Application Insights ، حدد View Application Insights data.

   بعد فتح لوحة معلومات Application Insights، يمكنك مراجعة المقاييس أو السجلات لسير عمل التطبيق المنطقي. على سبيل المثال، للمخطط أو الاستعلام عن البيانات، في قائمة مورد Application Insights، ضمن Monitoring، حدد Metrics أو Logs.

عرض الاتصالات

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

إيقاف موارد تطبيق المنطق أو بدء تشغيلها

اتبع الخطوات الواردة في تعطيل تطبيقات المنطق أو تمكينها.

استكشاف المشكلات والأخطاء وإصلاحها

المشغلات والإجراءات الجديدة مفقودة من منتقي المصمم لسير العمل الذي تم إنشاؤه مسبقًا

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

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

إشعار

ينطبق هذا الحل المحدد فقط على موارد تطبيق المنطق القياسي التي تقوم بإنشائها باستخدام مدخل Microsoft Azure، وليس تطبيقات المنطق التي تقوم بإنشائها ونشرها باستخدام Visual Studio Code وملحق Azure Logic Apps (Standard). راجع المشغلات والإجراءات المدعومة مفقودة من المصمم في Visual Studio Code.

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

   1. من قائمة تطبيقك المنطقي، اختر Overview.

   2. في شريط أدوات جزء النظرة العامة، حدد إيقاف.

2. في قائمة تطبيق المنطق، ضمن أدوات التطوير، حدد أدوات متقدمة.

3. في جزء Advanced Tools، حدد Go، الذي يفتح بيئة Kudu لتطبيق المنطق الخاص بك.

4. في شريط أدوات Kudu، افتح قائمة وحدة تحكم تتبع الأخطاء، وحدد CMD.

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

5. استعرض وصولًا إلى المجلد التالي، الذي يحتوي على مجلدات تم إصدارها للحزمة الموجودة:

   ...\home\data\Functions\ExtensionBundles\Microsoft.Azure.Functions.ExtensionBundle.Workflows

6. احذف مجلد الإصدار الخاص بالحزمة الموجودة. في نافذة وحدة التحكم، يمكنك تشغيل هذا الأمر حيث يمكنك استبدال {bundle-version} بالإصدار الموجود:

   rm -rf {bundle-version}

   على سبيل المثال: rm -rf 1.1.3

   تلميح

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

7. في مدخل Microsoft Azure، ارجع إلى صفحة نظرة عامة على تطبيق المنطق، وحدد إعادة التشغيل.

   يحصل المدخل تلقائيًا على أحدث حزمة ويستخدمها.

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

• مراقبة حالة تشغيل سير العمل، ومراجعة المشغل ومحفوظات تشغيل سير العمل، وإعداد التنبيهات في Azure Logic Apps