البرنامج التعليمي: إنشاء مهام سير عمل التنفيذ التلقائي قائمة على الجدول الزمني باستخدام Azure Logic Apps

وينطبق ذلك على: Azure Logic Apps (الاستهلاك)

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

في هذا البرنامج التعليمي، تتعلم كيفية:

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

عند الانتهاء، يبدو سير العمل مشابهاً للمثال التالي عالي المستوى:

Screenshot that shows the high-level overview for an example logic app workflow.

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

إنشاء سير عمل تطبيق منطق الاستهلاك

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

  2. في صفحة Azure الرئيسية، حدد Create a resource.

  3. في قائمة Azure Marketplace، حدد Integration>Logic App.

    Screenshot that shows Azure Marketplace menu with

  4. في جزء Create Logic App، في علامة التبويب Basics، قم بتوفير المعلومات التالية حول مورد تطبيق المنطق الخاص بك.

    لقطة شاشة تعرض مدخل Microsoft Azure وجزء إنشاء التطبيق المنطقي ومعلومات عن مورد تطبيق المنطق الجديد.

    الخاصية مطلوب القيمة الوصف
    الاشتراك نعم <"Azure-subscription-name"> اسم اشتراك Azure خاصتك. يستخدم هذا المثال الدفع أولًا بأول.
    مجموعة الموارد نعم LA-TravelTime-RG مجموعة موارد Azure حيث تقوم بإنشاء مورد تطبيق المنطق والموارد ذات الصلة. يجب أن يكون هذا الاسم فريدًا عبر المناطق ويمكن أن يحتوي فقط على أحرف وأرقام وواصلات (-) وتسطير سفلي (_) وأقواس (()()) ونقاط (.).
    الاسم نعم LA-TravelTime اسم مورد تطبيق المنطق الذي يجب أن يكون فريداً عبر المناطق ويمكن أن يحتوي فقط على أحرف، وأرقام، وواصلات (-) وتسطير سفلي (_) وأقواس ((، )) ونقاط (.).
  5. قبل متابعة إجراء التحديدات، انتقل إلى قسم الخطة. بالنسبة إلى نوع الخطة، حدد Consumption لإظهار إعدادات سير عمل تطبيق منطق الاستهلاك فقط، والذي يعمل في تطبيقات Azure Logic Apps متعددة المستأجرين.

    تحدد الخاصية Plan type أيضًا نوع نموذج الفوترة المراد استخدامه.

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

    الخاصية مطلوب القيمة الوصف
    المنطقة نعم ⁩غرب الولايات المتحدة⁧ منطقة مركز بيانات Azure لتخزين معلومات تطبيقك. ينشر هذا المثال نموذج تطبيق المنطق إلى منطقة غرب الولايات المتحدة في Azure.

    ملاحظة:إذا كان اشتراكك مقترنًا ببيئة خدمة تكامل، فإن هذه القائمة تتضمن تلك البيئات.
    ⁩تمكين تحليلات السجلات⁧ نعم لا يظهر هذا الخيار وينطبق فقط عند تحديد نوع التطبيق المنطقي الاستهلاك. يمكنك تغيير هذا الخيار فقط عندما ترغب في تمكين تسجيل التشخيص. في هذا البرنامج التعليمي، احتفظ بالتحديد الافتراضي.
  7. عندما تنتهي، حدد "Review + create". بعد أن يتحقق Azure من صحة المعلومات حول مورد تطبيق المنطق، حدد Create.

  8. بعد أن ينشر Azure تطبيقك، حدد Go to resource.

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

  9. مرر لأسفل بعد مقطع الفيديو وأقسام المشغلات الشائعة إلى قسم Templates، وحدد Blank Logic App.

    لقطة شاشة تعرض جزء اختيار نموذج سير العمل مع تحديد

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

إضافة مشغل التكرار

  1. في مصمم سير العمل، ضمن مربع البحث، حدد ⁧⁩مدمج⁧⁩.

  2. في مربع البحث، أدخل recurrence، وحدد المشغل المسمى Recurrence.

    لقطة شاشة تعرض مدخل Microsoft Azure ومصمم سير العمل ومربع البحث مع إدخال

  3. في شكل التكرار، حدد زر ellipses ( ... )، ثم حدد Rename. أعد تسمية المشغل بهذا الوصف: Check travel time every weekday morning

    Screenshot that shows the ellipses button selected, the

  4. داخل المشغل، قم بتغيير هذه الخصائص كما هو موضح ومبين هنا.

    Screenshot that shows the changes to the trigger's interval and frequency.

    الخاصية مطلوب القيمة الوصف
    الفاصل نعم 1 عدد الفواصل الزمنية التي يجب الانتظار بين عمليات الفحص
    التكرار نعم أسبوع وحدة الوقت التي يجب استخدامها لتكرار
  5. ضمن Interval وFrequency، افتح قائمة Add new parameter، وحدد هذه الخصائص لإضافتها إلى المشغل.

    • في هذه الأيام
    • في هذه الساعات
    • في هذه الدقائق

    Screenshot that shows the opened

  6. الآن تعيين قيم خصائص إضافية كما هو موضح ومبين هنا.

    Screenshot that shows the additional properties set to the values as described in the following table.

    الخاصية القيمة الوصف
    في هذه الأيام الاثنين والثلاثاء والأربعاء والخميس والجمعة هذا الإعداد متاح فقط عند تعيين Frequency على Week.
    في هذه الساعات 7, 8, 9 هذا الإعداد متاح فقط عند تعيين التكرار على أسبوع أو يوم. لهذه التكرارات، حدد ساعات اليوم. يعمل هذا المثال عند العلامات 7 و8 و9 ساعة.
    في هذه الدقائق 0, 15, 30, 45 هذا الإعداد متاح فقط عند تعيين التكرار على أسبوع أو يوم. لهذا التكرار، حدد دقائق اليوم. يبدأ هذا المثال عند علامة ساعة الصفر ويتم تشغيله كل 15 دقيقة.

    هذا المشغل حرائق كل يوم من أيام الأسبوع، كل 15 دقيقة، بدءاً من الساعة 7:00 صباحاً وتنتهي في الساعة 9:45 صباحاً. يعرض مربع Preview جدول التكرار. لمزيد من المعلومات، راجع جدولة المهام ومهام سير العمل و إجراءات ومشغلات سير العمل.

  7. لإخفاء تفاصيل المشغل في الوقت الحالي، قم بطي الشكل بالنقر داخل شريط عنوان الشكل.

    Screenshot that shows the collapsed trigger shape.

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

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

الحصول على وقت السفر لمسار

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

  1. في مصمم سير العمل، ضمن مشغل التكرار، حدد New step.

  2. ضمن Choose an operation، حدد Standard. في مربع البحث، أدخل bing maps، وحدد الإجراء المسمى Get route.

    Screenshot that shows the

  3. إذا لم يكن لديك اتصال خرائط Bing، يطلب منك إنشاء اتصال. قدم تفاصيل الاتصال كما هو موضح، ثم حدد Create.

    Screenshot that shows the Bing Maps connection box with the specified connection name and Bing Maps API key.

    الخاصية مطلوب القيمة الوصف
    اسم الاتصال نعم BingMapsConnection ضع اسمًا لاتصالك. هذا المثال يستخدم BingMapsConnection.
    مفتاح API نعم <Bing-Maps-API-key> أدخل مفتاح API لخرائط Bing الذي تلقيته سابقاً. إذا لم يكن لديك مفتاح لخرائط Bing، فتعرف على كيفية الحصول على مفتاح.
  4. أعد تسمية الإجراء بهذا الوصف: Get route and travel time with traffic.

  5. في الإجراء، افتح Add new parameter list، وحدد هذه الخصائص.

    • تحسين
    • وحدة المسافة
    • وضع السفر

    Screenshot that shows the

  6. الآن أدخل قيم الخصائص المعروضة والمبينة هنا.

    Screenshot that shows additional property values for the

    الخاصية مطلوب القيمة الوصف
    Waypoint 1 نعم <موقع البدء> أصل مسارك. يحدد هذا المثال مثال بدء العنوان.
    Waypoint 2 نعم <end-location> وجهة مسارك. يحدد هذا المثال عنوان وجهة مثال.
    تحسين لا timeWithTraffic معلمة لتحسين مسارك، مثل المسافة، ووقت السفر مع نسبة استخدام الشبكة الحالية، وما إلى ذلك. حدد قيمة المعلمة، timeWithTraffic.
    وحدة المسافة لا <your-preference> وحدة المسافة لمسارك. هذا المثال يستخدم .Mile كوحدة.
    وضع السفر لا القيادة وضع السفر لمسارك. حدد وضع Driving.

    لمزيد من المعلومات حول هذه المعلمات والقيم، راجع حساب طريق.

  7. على شريط أدوات المصمم، حدد Save.

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

إنشاء متغير لتخزين وقت السفر

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

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

  1. على المصمم، ضمن إجراء الحصول على مسار، حدد New step.

  2. ضمن Choose an operation، حدد Built-in. في مربع البحث، أدخل variables، وحدد الإجراء المسمى Initialize variable.

    Screenshot that shows the

  3. أعد تسمية هذا الإجراء بهذا الوصف: Create variable to store travel time

  4. قدم هذه المعلومات للمتغير الخاص بك كما هو موضح في هذا الجدول وفي الخطوات أدنى الجدول:

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

      Screenshot that shows the

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

    2. في محرر التعبير، أدخل هذا التعبير: div(,60)

      Screenshot that shows the expression editor with the

    3. داخل التعبير، ضع المؤشر بين القوس الأيسر ( ( ) والفاصلة ( ، )، وحدد Dynamic content.

      Screenshot that shows where to put the cursor in the

    4. في قائمة المحتوى الديناميكي، ضمن تحديد قيمة الخاصية، Travel Duration Traffic.

      Screenshot that shows the

    5. بعد أن يتم تحليل قيمة الخاصية داخل التعبير، حدد OK.

      Screenshot that shows the

      تظهر خاصية القيمة الآن كما هو موضح هنا:

      Screenshot that shows the

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

بعد ذلك، أضف شرطاً يتحقق من أن وقت السفر الحالي أكبر من حد معين.

مقارنة وقت السفر بالحد

  1. ضمن الإجراء Create variable to store travel time، حدد New step.

  2. ضمن Choose an operation، حدد Built-in. في مربع البحث، قم بإدخال condition. ومن قائمة الإجراءات، حدد الإجراء المسمى Condition.

    Screenshot that shows the

  3. أعد تسمية الحالة بهذا الوصف: If travel time exceeds limit

  4. أنشئ شرطاً يتحقق مما إذا كانت قيمة خاصية travelTime تتجاوز الحد الذي حددته كما هو موضح والموضح هنا:

    1. في الحالة، على الجانب الأيسر من الشرط، انقر داخل المربع Choose a value.

    2. من قائمة المحتوى الديناميكي التي تظهر، ضمن المتغيرات، حدد الخاصية المسماة travelTime.

      Screenshot that shows the

    3. في مربع المقارنة الأوسط، حدد عامل التشغيل المسمى is greater than.

    4. على الجانب الأيمن من الشرط، في المربع Choose a value، أدخل هذا الحد: 15

      عند الانتهاء، تبدو الحالة مثل هذا المثال:

      Screenshot that shows the finished condition for comparing the travel time to the specified limit.

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

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

إرسال بريد إلكتروني عند تجاوز الحد

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

  1. في الفرع True للشرط، حدد Add an action.

  2. ضمن Choose an operation، حدد Standard. في مربع البحث، أدخل send email. ترجع القائمة العديد من النتائج، لمساعدتك في تصفية القائمة، حدد أولا موصل البريد الإلكتروني الذي تريده.

    على سبيل المثال، إذا كان لديك حساب بريد إلكتروني Outlook، حدد الرابط لنوع حسابك:

    • بالنسبة إلى حسابات العمل أو المدرسة Azure، حدد Office 365 Outlook.
    • بالنسبة لحسابات Microsoft الشخصية، حدد Outlook.com.

    يستمر هذا المثال بتحديد Office 365 Outlook.

    Screenshot that shows the

  3. عند ظهور إجراءات الموصل، حدد الإجراء الذي يرسل البريد الإلكتروني، على سبيل المثال:

    Screenshot that shows the

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

    تقوم Azure Logic Apps بإنشاء اتصال بحساب بريدك الإلكتروني.

  5. أعد تسمية الإجراء بهذا الوصف: Send email with travel time

  6. بالنسبة للخاصية إلى، أدخل عنوان البريد الإلكتروني للمستلم. لأغراض الاختبار، يمكنك استخدام عنوان بريدك الإلكتروني.

  7. بالنسبة إلى خاصية الموضوع، حدد موضوع البريد الإلكتروني، وقم بتضمين المتغير travelTime باتباع الخطوات التالية:

    1. أدخل النص Current travel time (minutes): بمسافة لاحقة. احتفظ بالمؤشر في مربع الموضوع حتى تظل قائمة المحتوى الديناميكي مفتوحة.

    2. من قائمة المحتوى الديناميكي، في العنوان Variables، حدد See more بحيث يظهر المتغير المسمى travelTime.

      Screenshot that shows the dynamic content list with the

      ملاحظة

      لا تعرض قائمة المحتوى الديناميكي تلقائياً متغير travelTimeلأن خاصية Subject تتوقع قيمة سلسلة، بينما travelTime هي قيمة عددية.

      Screenshot that shows the dynamic content list with the

  8. بالنسبة للخاصية Body، حدد محتوى نص الرسالة الإلكترونية باتباع الخطوات التالية:

    1. أدخل النص Add extra travel time (minutes): بمسافة لاحقة. احتفظ بالمؤشر في مربع النص الأساسي حتى تظل قائمة المحتوى الديناميكي مفتوحة.

    2. في قائمة المحتوى الديناميكي، حدد Expression، الذي يعرض محرر التعبير.

      Screenshot that shows the dynamic content list with

    3. في محرر التعبير، أدخل sub(,15) حتى تتمكن من حساب عدد الدقائق التي تتجاوز الحد الخاص بك:

      Screenshot that shows the expression editor with the

    4. داخل التعبير، ضع المؤشر بين القوس الأيسر ( ( ) والفاصلة ( ، )، وحدد Dynamic content.

      Screenshot that shows where to put the cursor in the

    5. ضمن المتغيرات، حدد travelTime.

      Screenshot that shows the dynamic content list with

    6. بعد أن يتم حل الخاصية داخل التعبير، حدد OK.

      Screenshot that shows the dynamic content list and

      تظهر خاصية النص الأساسي الآن كما هو موضح هنا:

      Screenshot that shows the dynamic content list with the expression resolved in the email action's

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

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

Screenshot that shows the finished example logic app workflow

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

لبدء سير العمل يدويًا، في شريط أدوات المصمم، حدد Run Trigger>Run.

  • إذا بقي وقت السفر الحالي تحت الحد الأقصى، فإن سير العمل لا يفعل أي شيء آخر وينتظر أو الفاصل الزمني التالي قبل التحقق مرة أخرى.

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

    Screenshot that shows an example email that reports the current travel time and the extra travel time that exceeds your specified limit.

    تلميح

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

تهانينا، لقد قمت الآن بإنشاء وتشغيل سير عمل متكرر يستند إلى الجدول الزمني.

لإنشاء أسيار عمل أخرى تستخدم مشغل Recurrence، تحقق من هذه القوالب، التي تتوفر بعد مورد إنشاء تطبيق منطق جديد:

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

تنظيف الموارد

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

  1. في مربع البحث في مدخل Microsoft Azure، أدخل اسم مجموعة الموارد التي أنشأتها. من النتائج، ضمن Resource Groups، حدد مجموعة الموارد.

    هذا المثال أنشأ مجموعة الموارد المسماة LA-TravelTime-RG.

    لقطة شاشة تعرض مربع بحث Azure مع إدخال

    تلميح

    إذا أظهرت صفحة Azure الرئيسية مجموعة الموارد ضمن Recent resources، يمكنك تحديد المجموعة من الصفحة الرئيسية.

  2. في قائمة مجموعة الموارد، تحقق من تحديد Overview. في شريط أدوات الجزء Overview، حدد Delete resource group.

    لقطة شاشة تعرض جزء

  3. في جزء التأكيد الذي يظهر، أدخل اسم مجموعة الموارد وحدد Delete.

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

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