إنشاء إجراءات تبديل تتحكم في إجراءات سير العمل استنادًا إلى قيم محددة في Azure Logic Apps

التطبيق على:Azure Logic Apps (Consumption)

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

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

تلميح

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

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

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

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

    1. عند إضافة الإجراء لإرسال البريد الإلكتروني، ابحث عن هذا الإجراء وحدده بدلاً من ذلك: إرسال بريد إلكتروني للموافقة

      Select

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

      Enter email details

إضافة إجراء تبديل

  1. على سبيل المثال، أضف إجراء تبديل في نهاية نموذج سير العمل. بعد الخطوة الأخيرة، اختر خطوة جديدة.

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

  2. في مربع البحث، أدخل "تبديل" كعامل تصفية. حدد هذا الإجراء: Switch - Control

    Add switch

    يظهر إجراء تبديل بحالة واحدة وحالة افتراضية. بشكل افتراضي، يتطلب إجراء التبديل حالة واحدة على الأقل بالإضافة إلى الحالة الافتراضية.

    Empty default switch action

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

    Select

  4. لمعالجة الحالات التي يحدد فيها الموافق Approve أو Reject، أضف حالة أخرى بين الحالة والإعداد الافتراضي.

    Add another case

  5. أضف هذه الإجراءات إلى الحالات المقابلة:

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

    Finished switch action

  6. حفظ تطبيق المنطق الخاص بك.

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

تعريف JSON

الآن، وبعد أن قمت بإنشاء تطبيق منطقي باستخدام إجراء تبديل، لننظر إلى تعريف التعليمات البرمجية عالي المستوى خلف إجراء التبديل.

"Switch": {
   "type": "Switch",
   "expression": "@body('Send_approval_email')?['SelectedOption']",
   "cases": {
      "Case": {
         "actions": {
           "Send_an_email": {}
         },
         "case" : "Approve"
      },
      "Case_2": {
         "actions": {
           "Send_an_email_2": {}
         },
         "case": "Reject"
      }
   },
   "default": {
      "actions": {}
   },
   "runAfter": {
      "Send_approval_email": [
         "Succeeded"
      ]
   }
}
تسمية ‏‏الوصف
"Switch" اسم إجراء التبديل، الذي يمكنك إعادة تسميته لسهولة القراءة
"type": "Switch" تحديد أن الإجراء هو إجراء تبديل
"expression" في هذا المثال، يحدد خيار الموافق المحدد الذي يتم تقييمه مقابل كل حالة، كما هو معلن لاحقًا في التعريف
"cases" يحدد أي عدد من الحالات. لكل حالة، "Case_*" هو الاسم الافتراضي لتلك الحالة، والذي يمكنك إعادة تسميته لقابلية القراءة
"case" يحدد قيمة الحالة، والتي يجب أن تكون قيمة ثابتة وفريدة يستخدمها إجراء التبديل للمقارنة. إذا لم تتطابق أي حالات مع نتيجة تعبير التبديل، يتم تشغيل الإجراءات في القسم "default".

الحصول على الدعم

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