البرنامج التعليمي: إنشاء مهام سير عمل التنفيذ التلقائي قائمة على الجدول الزمني باستخدام Azure Logic Apps
وينطبق ذلك على: Azure Logic Apps (الاستهلاك)
يوضح هذا البرنامج التعليمي كيفية إنشاء مثال على سير عمل تطبيق منطق يتم تشغيله وفقًا لجدول زمني متكرر. على وجه التحديد، سير العمل المثال هذا يتحقق من وقت السفر، بما في ذلك نسبة استخدام الشبكة، بين مكانين ويعمل كل صباح من أيام الأسبوع. إذا تجاوز الوقت حدًا معينًا، يرسل لك سير العمل بريدًا إلكترونيًا يتضمن وقت السفر والوقت الإضافي اللازم للوصول إلى وجهتك. يتضمن سير العمل العديد من الخطوات، والتي تبدأ بمشغل مستند إلى الجدول الزمني متبوعاً بإجراء خرائط Bing، وإجراء عمليات البيانات، وإجراء التحكم في التدفق، وإجراء إعلام بالبريد الإلكتروني.
في هذا البرنامج التعليمي، تتعلم كيفية:
- إنشاء تطبيق منطق فارغ وسير عمل.
- أضف مشغل التكرار الذي يحدد الجدول الزمني لشتغيل سير العمل.
- أضف إجراء خرائط Bing للحصول على وقت السفر للطريق.
- أضف إجراءً يُنشئ متغيراً، ويحول وقت السفر من ثوانٍ إلى دقائق، ويخزن ذلك المتغير.
- إضافة شرط يقارن وقت السفر مع حد محدد.
- أضف إجراء يرسل بريدا إلكترونيا إذا تجاوز وقت السفر الحد المسموح به.
عند الانتهاء، يبدو سير العمل مشابهاً للمثال التالي عالي المستوى:
المتطلبات الأساسية
حساب واشتراك Azure. إذا لم يكن لديك اشتراك، فيجب التسجيل للحصول على حساب Azure مجاني.
حساب بريد إلكتروني من موفر بريد إلكتروني مدعوم من تطبيقات المنطق من Azure، مثل Office 365 Outlook أو Outlook.com أو Gmail. بالنسبة إلى مقدمي الخدمات الآخرين،راجع قائمة الموصلات هنا. تستخدم هذه البداية السريعة Office 365 Outlook بحساب عمل أو مدرسة. إذا كنت تستخدم حساب بريد إلكتروني آخر، تبقى الخطوات العامة كما هي، ولكن قد تختلف واجهة المستخدم الخاصة بك قليلاً.
هام
إذا كنت ترغب في استخدام موصل Gmail، يمكن لحسابات الأعمال G-Suite فقط استخدام هذا الرابط دون قيود في سير عمل تطبيقات المنطق. إذا كان لديك حساب عميل Gmail، يمكنك استخدام هذا الرابط مع خدمات معينة معتمدة من Google فقط، أو يمكنك إنشاء تطبيق عميل Google لاستخدامه للمصادقة باستخدام موصل Gmail. لمزيد من المعلومات، يرجى مراجعة نُهج أمان البيانات والخصوصية لموصلات Google في Azure Logic Apps.
للحصول على وقت السفر للمسار، تحتاج إلى مفتاح وصول لواجهة برمجة التطبيقات خرائط Bing. للحصول على هذا المفتاح، اتبع الخطوات الخاصة بـ كيفية الحصول على مفتاح خرائط Bing.
إذا كان سير العمل يحتاج إلى الاتصال عبر جدار حماية يحد من نسبة استخدام الشبكة لعناوين IP محددة، فيجب أن يسمح جدار الحماية هذا بالوصول إلى عناوين IP الواردة و الصادرة مستخدمة بواسطة تطبيقات Azure Logic في منطقة Azure حيث يوجد تطبيق المنطق الخاص بك. إذا كان يستخدم أيضًا موصلات مدارة مثل موصل Office 365 Outlook أو موصل SQL، أو يستخدم موصلات مخصصة، يحتاج جدار الحماية أيضًا إلى السماح بالوصول إلى جميععناوين IP الصادرة للموصل المدار في منطقة Azure الخاصة بتطبيق المنطق.
إنشاء سير عمل تطبيق منطق الاستهلاك
في مدخل Microsoft Azure، قم بتسجيل الدخول باستخدام حساب Azure الخاص بك.
في صفحة Azure الرئيسية، حدد Create a resource.
في قائمة Azure Marketplace، حدد Integration>Logic App.
في جزء Create Logic App، في علامة التبويب Basics، قم بتوفير المعلومات التالية حول مورد تطبيق المنطق الخاص بك.
الخاصية مطلوب القيمة الوصف الاشتراك نعم <"Azure-subscription-name"> اسم اشتراك Azure خاصتك. يستخدم هذا المثال الدفع أولًا بأول. مجموعة الموارد نعم LA-TravelTime-RG مجموعة موارد Azure حيث تقوم بإنشاء مورد تطبيق المنطق والموارد ذات الصلة. يجب أن يكون هذا الاسم فريدًا عبر المناطق ويمكن أن يحتوي فقط على أحرف وأرقام وواصلات ( -
) وتسطير سفلي (_
) وأقواس ((
)()
) ونقاط (.
).الاسم نعم LA-TravelTime اسم مورد تطبيق المنطق الذي يجب أن يكون فريداً عبر المناطق ويمكن أن يحتوي فقط على أحرف، وأرقام، وواصلات ( -
) وتسطير سفلي (_
) وأقواس ((
،)
) ونقاط (.
).قبل متابعة إجراء التحديدات، انتقل إلى قسم الخطة. بالنسبة إلى نوع الخطة، حدد Consumption لإظهار إعدادات سير عمل تطبيق منطق الاستهلاك فقط، والذي يعمل في تطبيقات Azure Logic Apps متعددة المستأجرين.
تحدد الخاصية Plan type أيضًا نوع نموذج الفوترة المراد استخدامه.
نوع الخطة الوصف قياسي نوع مورد التطبيق المنطقي هذا هو النوع الافتراضي ويتم تشغيله في تطبيقات Azure Logic Apps أحادية المستأجر ويستخدم نموذج فوترة قياسي. Consumption يتم تشغيل نوع التطبيق المنطقي هذا في تطبيقات Azure Logic Apps متعددة المستأجرين ويستخدم نموذج فوترة الاستهلاك. الآن استمر في إجراء التحديدات التالية:
الخاصية مطلوب القيمة الوصف المنطقة نعم غرب الولايات المتحدة منطقة مركز بيانات Azure لتخزين معلومات تطبيقك. ينشر هذا المثال نموذج تطبيق المنطق إلى منطقة غرب الولايات المتحدة في Azure.
ملاحظة:إذا كان اشتراكك مقترنًا ببيئة خدمة تكامل، فإن هذه القائمة تتضمن تلك البيئات.تمكين تحليلات السجلات نعم لا يظهر هذا الخيار وينطبق فقط عند تحديد نوع التطبيق المنطقي الاستهلاك. يمكنك تغيير هذا الخيار فقط عندما ترغب في تمكين تسجيل التشخيص. في هذا البرنامج التعليمي، احتفظ بالتحديد الافتراضي. عندما تنتهي، حدد "Review + create". بعد أن يتحقق Azure من صحة المعلومات حول مورد تطبيق المنطق، حدد Create.
بعد أن ينشر Azure تطبيقك، حدد Go to resource.
يفتح Azure جزء تحديد قالب سير العمل، والذي يعرض مقطع فيديو مقدمة، والمشغلات شائعة الاستخدام، وأنماط قوالب سير العمل.
مرر لأسفل بعد مقطع الفيديو وأقسام المشغلات الشائعة إلى قسم Templates، وحدد Blank Logic App.
بعد ذلك، أضف التكرار المشغل، الذي يقوم بتشغيل سير العمل بناءً على جدول محدد. كل سير عمل يجب أن يبدأ بمشغل، الذي يشتعل عندما يحدث حدث معين أو عندما تتقابل بيانات جديدة مع ظرف محدد. لمزيد من المعلومات، راجع إنشاء مثال سير عمل تطبيق منطق الاستهلاك في Azure Logic Apps متعددة المستأجرين.
إضافة مشغل التكرار
في مصمم سير العمل، ضمن مربع البحث، حدد مدمج.
في مربع البحث، أدخل recurrence، وحدد المشغل المسمى Recurrence.
في شكل التكرار، حدد زر ellipses ( ... )، ثم حدد Rename. أعد تسمية المشغل بهذا الوصف:
Check travel time every weekday morning
داخل المشغل، قم بتغيير هذه الخصائص كما هو موضح ومبين هنا.
الخاصية مطلوب القيمة الوصف الفاصل نعم 1 عدد الفواصل الزمنية التي يجب الانتظار بين عمليات الفحص التكرار نعم أسبوع وحدة الوقت التي يجب استخدامها لتكرار ضمن Interval وFrequency، افتح قائمة Add new parameter، وحدد هذه الخصائص لإضافتها إلى المشغل.
- في هذه الأيام
- في هذه الساعات
- في هذه الدقائق
الآن تعيين قيم خصائص إضافية كما هو موضح ومبين هنا.
الخاصية القيمة الوصف في هذه الأيام الاثنين والثلاثاء والأربعاء والخميس والجمعة هذا الإعداد متاح فقط عند تعيين Frequency على Week. في هذه الساعات 7, 8, 9 هذا الإعداد متاح فقط عند تعيين التكرار على أسبوع أو يوم. لهذه التكرارات، حدد ساعات اليوم. يعمل هذا المثال عند العلامات 7
و8
و9
ساعة.في هذه الدقائق 0, 15, 30, 45 هذا الإعداد متاح فقط عند تعيين التكرار على أسبوع أو يوم. لهذا التكرار، حدد دقائق اليوم. يبدأ هذا المثال عند علامة ساعة الصفر ويتم تشغيله كل 15 دقيقة. هذا المشغل حرائق كل يوم من أيام الأسبوع، كل 15 دقيقة، بدءاً من الساعة 7:00 صباحاً وتنتهي في الساعة 9:45 صباحاً. يعرض مربع Preview جدول التكرار. لمزيد من المعلومات، راجع جدولة المهام ومهام سير العمل و إجراءات ومشغلات سير العمل.
لإخفاء تفاصيل المشغل في الوقت الحالي، قم بطي الشكل بالنقر داخل شريط عنوان الشكل.
احفظ سير العمل الخاص بك. في شريط أدوات المصمم، حدد "Save" .
سير العمل الخاص بك يعمل الآن في مدخل Microsoft Azure ولكن لا تفعل أي شيء آخر غير المشغل على أساس الجدول الزمني المحدد. لذلك، أضف إجراءً يستجيب عند تشغيل المشغل.
الحصول على وقت السفر لمسار
الآن بعد أن أصبح لديك مشغل، أضف action يحصل على وقت السفر بين مكانين. توفر Azure Logic Apps موصل لـ Bing Maps API بحيث يمكنك الحصول على هذه المعلومات بسهولة. قبل بدء هذه المهمة، تأكد من أن لديك مفتاح API لخرائط Bing كما هو موضح في المتطلبات الأساسية لهذا البرنامج التعليمي.
في مصمم سير العمل، ضمن مشغل التكرار، حدد New step.
ضمن Choose an operation، حدد Standard. في مربع البحث، أدخل bing maps، وحدد الإجراء المسمى Get route.
إذا لم يكن لديك اتصال خرائط Bing، يطلب منك إنشاء اتصال. قدم تفاصيل الاتصال كما هو موضح، ثم حدد Create.
الخاصية مطلوب القيمة الوصف اسم الاتصال نعم BingMapsConnection ضع اسمًا لاتصالك. هذا المثال يستخدم BingMapsConnection
.مفتاح API نعم <Bing-Maps-API-key> أدخل مفتاح API لخرائط Bing الذي تلقيته سابقاً. إذا لم يكن لديك مفتاح لخرائط Bing، فتعرف على كيفية الحصول على مفتاح. أعد تسمية الإجراء بهذا الوصف:
Get route and travel time with traffic
.في الإجراء، افتح Add new parameter list، وحدد هذه الخصائص.
- تحسين
- وحدة المسافة
- وضع السفر
الآن أدخل قيم الخصائص المعروضة والمبينة هنا.
الخاصية مطلوب القيمة الوصف Waypoint 1 نعم <موقع البدء> أصل مسارك. يحدد هذا المثال مثال بدء العنوان. Waypoint 2 نعم <end-location> وجهة مسارك. يحدد هذا المثال عنوان وجهة مثال. تحسين لا timeWithTraffic معلمة لتحسين مسارك، مثل المسافة، ووقت السفر مع نسبة استخدام الشبكة الحالية، وما إلى ذلك. حدد قيمة المعلمة، timeWithTraffic. وحدة المسافة لا <your-preference> وحدة المسافة لمسارك. هذا المثال يستخدم .Mile كوحدة. وضع السفر لا القيادة وضع السفر لمسارك. حدد وضع Driving. لمزيد من المعلومات حول هذه المعلمات والقيم، راجع حساب طريق.
على شريط أدوات المصمم، حدد Save.
بعد ذلك، قم بإنشاء متغير بحيث يمكنك تحويل وقت السفر الحالي وتخزينه كدقائق، بدلاً من ثوانٍ. وبهذه الطريقة، يمكنك تجنب تكرار التحويل واستخدام القيمة بسهولة أكبر في الخطوات اللاحقة.
إنشاء متغير لتخزين وقت السفر
في بعض الأحيان، قد تحتاج إلى تشغيل العمليات على البيانات في سير العمل الخاص بك، ومن ثَم استخدام النتائج في إجراءات لاحقة. لحفظ هذه النتائج بحيث يمكنك إعادة استخدامها بسهولة أو الرجوع إليها، يمكنك إنشاء متغيرات تخزن هذه النتائج بعد المعالجة. يمكنك إنشاء متغيرات فقط في المستوى الأعلى في سير العمل الخاص بك.
بشكل افتراضي، يعرض إجراء الحصول على مسار وقت السفر الحالي مع نسبة استخدام الشبكة بالثواني من خاصية Travel Duration Traffic. عن طريق تحويل هذه القيمة وتخزينها كدقائق بدلاً من ذلك، يمكنك جعل القيمة أسهل لإعادة استخدامها لاحقاً دون التحويل مرة أخرى.
على المصمم، ضمن إجراء الحصول على مسار، حدد New step.
ضمن Choose an operation، حدد Built-in. في مربع البحث، أدخل variables، وحدد الإجراء المسمى Initialize variable.
أعد تسمية هذا الإجراء بهذا الوصف:
Create variable to store travel time
قدم هذه المعلومات للمتغير الخاص بك كما هو موضح في هذا الجدول وفي الخطوات أدنى الجدول:
الخاصية مطلوب القيمة الوصف الاسم نعم travelTime اسم المتغير الخاص بك. هذا المثال يستخدم travelTime
.النوع نعم عدد صحيح نوع البيانات للمتغير القيمة لا تعبير يحول وقت السفر الحالي من ثوانٍ إلى دقائق (راجع الخطوات الموجودة أسفل هذا الجدول). القيمة الأولية للمتغير الخاص بك لإنشاء تعبير خاص بخاصية القيمة، انقر داخل المربع حتى تظهر قائمة المحتوى الديناميكي. إذا لزم الأمر، قم بتوسيع المستعرض حتى تظهر القائمة الديناميكية. في قائمة المحتوى الديناميكي، حدد Expression، الذي يعرض محرر التعبير.
تعرض قائمة المحتوى الديناميكي مخرجات الإجراءات السابقة المتوفرة لك لتحديدها كمدخلات للإجراءات اللاحقة في سير العمل. تتضمن قائمة المحتوى الحيوي محرر تعبير يمكنك استخدامه لتحديد الوظائف التي تقوم بإجراء عمليات في التعبير الخاص بك. يتوفر محرر التعبير هذا فقط في قائمة المحتوى الديناميكي.
في محرر التعبير، أدخل هذا التعبير:
div(,60)
داخل التعبير، ضع المؤشر بين القوس الأيسر ( ( ) والفاصلة ( ، )، وحدد Dynamic content.
في قائمة المحتوى الديناميكي، ضمن تحديد قيمة الخاصية، Travel Duration Traffic.
بعد أن يتم تحليل قيمة الخاصية داخل التعبير، حدد OK.
تظهر خاصية القيمة الآن كما هو موضح هنا:
احفظ سير العمل الخاص بك. في شريط أدوات المصمم، حدد "Save" .
بعد ذلك، أضف شرطاً يتحقق من أن وقت السفر الحالي أكبر من حد معين.
مقارنة وقت السفر بالحد
ضمن الإجراء Create variable to store travel time، حدد New step.
ضمن Choose an operation، حدد Built-in. في مربع البحث، قم بإدخال condition. ومن قائمة الإجراءات، حدد الإجراء المسمى Condition.
أعد تسمية الحالة بهذا الوصف:
If travel time exceeds limit
أنشئ شرطاً يتحقق مما إذا كانت قيمة خاصية travelTime تتجاوز الحد الذي حددته كما هو موضح والموضح هنا:
في الحالة، على الجانب الأيسر من الشرط، انقر داخل المربع Choose a value.
من قائمة المحتوى الديناميكي التي تظهر، ضمن المتغيرات، حدد الخاصية المسماة travelTime.
في مربع المقارنة الأوسط، حدد عامل التشغيل المسمى is greater than.
على الجانب الأيمن من الشرط، في المربع Choose a value، أدخل هذا الحد:
15
عند الانتهاء، تبدو الحالة مثل هذا المثال:
احفظ سير العمل الخاص بك. في شريط أدوات المصمم، حدد "Save" .
بعد ذلك، أضف الإجراء الذي يتم تشغيله عندما يتجاوز وقت السفر الحد المسموح به.
إرسال بريد إلكتروني عند تجاوز الحد
الآن، أضف إجراءً يرسل لك بريداً إلكترونياً عندما يتجاوز وقت السفر الحد المسموح به. يتضمن هذا البريد الإلكتروني وقت السفر الحالي والوقت الإضافي اللازم للسفر على الطريق المحدد.
في الفرع True للشرط، حدد Add an action.
ضمن Choose an operation، حدد Standard. في مربع البحث، أدخل send email. ترجع القائمة العديد من النتائج، لمساعدتك في تصفية القائمة، حدد أولا موصل البريد الإلكتروني الذي تريده.
على سبيل المثال، إذا كان لديك حساب بريد إلكتروني Outlook، حدد الرابط لنوع حسابك:
- بالنسبة إلى حسابات العمل أو المدرسة Azure، حدد Office 365 Outlook.
- بالنسبة لحسابات Microsoft الشخصية، حدد Outlook.com.
يستمر هذا المثال بتحديد Office 365 Outlook.
عند ظهور إجراءات الموصل، حدد الإجراء الذي يرسل البريد الإلكتروني، على سبيل المثال:
إذا لم يكن لديك اتصال بالفعل، سجل الدخول إلى حساب البريد الإلكتروني الخاص بك وصادق عليه عند مطالبتك بذلك.
تقوم Azure Logic Apps بإنشاء اتصال بحساب بريدك الإلكتروني.
أعد تسمية الإجراء بهذا الوصف:
Send email with travel time
بالنسبة للخاصية إلى، أدخل عنوان البريد الإلكتروني للمستلم. لأغراض الاختبار، يمكنك استخدام عنوان بريدك الإلكتروني.
بالنسبة إلى خاصية الموضوع، حدد موضوع البريد الإلكتروني، وقم بتضمين المتغير travelTime باتباع الخطوات التالية:
أدخل النص
Current travel time (minutes):
بمسافة لاحقة. احتفظ بالمؤشر في مربع الموضوع حتى تظل قائمة المحتوى الديناميكي مفتوحة.من قائمة المحتوى الديناميكي، في العنوان Variables، حدد See more بحيث يظهر المتغير المسمى travelTime.
ملاحظة
لا تعرض قائمة المحتوى الديناميكي تلقائياً متغير travelTimeلأن خاصية Subject تتوقع قيمة سلسلة، بينما travelTime هي قيمة عددية.
بالنسبة للخاصية Body، حدد محتوى نص الرسالة الإلكترونية باتباع الخطوات التالية:
أدخل النص
Add extra travel time (minutes):
بمسافة لاحقة. احتفظ بالمؤشر في مربع النص الأساسي حتى تظل قائمة المحتوى الديناميكي مفتوحة.في قائمة المحتوى الديناميكي، حدد Expression، الذي يعرض محرر التعبير.
في محرر التعبير، أدخل sub(,15) حتى تتمكن من حساب عدد الدقائق التي تتجاوز الحد الخاص بك:
داخل التعبير، ضع المؤشر بين القوس الأيسر ( ( ) والفاصلة ( ، )، وحدد Dynamic content.
ضمن المتغيرات، حدد travelTime.
بعد أن يتم حل الخاصية داخل التعبير، حدد OK.
تظهر خاصية النص الأساسي الآن كما هو موضح هنا:
احفظ سير العمل الخاص بك. في شريط أدوات المصمم، حدد "Save" .
بعد ذلك، اختبر سير العمل الخاص بك، والذي يبدو الآن مشابهًا لهذا المثال:
تشغيل سير العمل
لبدء سير العمل يدويًا، في شريط أدوات المصمم، حدد Run Trigger>Run.
إذا بقي وقت السفر الحالي تحت الحد الأقصى، فإن سير العمل لا يفعل أي شيء آخر وينتظر أو الفاصل الزمني التالي قبل التحقق مرة أخرى.
إذا تجاوز وقت السفر الحالي الحد المسموح به، ستحصل على بريد إلكتروني مع وقت السفر الحالي وعدد الدقائق التي تتجاوز الحد المسموح به. إليك مثالاً للبريد الإلكتروني يرسله سير العمل الخاص بك:
تلميح
إذا لم تحصل على أي رسائل بريد إلكتروني، فتحقق من مجلد البريد الإلكتروني غير الهام. قد يقوم عامل تصفية البريد الإلكتروني غير الهام بإعادة توجيه هذه الأنواع من الرسائل. وإلا، إذا لم تكن متأكدًا من أن سير العمل الخاص بك قد تم تشغيله بشكل صحيح، فراجع استكشاف أخطاء سير العمل وإصلاحه.
تهانينا، لقد قمت الآن بإنشاء وتشغيل سير عمل متكرر يستند إلى الجدول الزمني.
لإنشاء أسيار عمل أخرى تستخدم مشغل Recurrence، تحقق من هذه القوالب، التي تتوفر بعد مورد إنشاء تطبيق منطق جديد:
- احصل على تذكيرات يومية يتم إرسالها إليك.
- حذف الكائنات الثنائية في Azure القديمة.
- أضف رسالة إلى قائمة انتظار تخزين Azure.
تنظيف الموارد
يستمر سير العمل في العمل حتى تقوم بتعطيل مورد تطبيق المنطق أو حذفه. عندما لا تعود بحاجة إلى سير العمل النموذجي، احذف مجموعة الموارد التي تحتوي على مورد تطبيق المنطق والموارد ذات الصلة.
في مربع البحث في مدخل Microsoft Azure، أدخل اسم مجموعة الموارد التي أنشأتها. من النتائج، ضمن Resource Groups، حدد مجموعة الموارد.
هذا المثال أنشأ مجموعة الموارد المسماة
LA-TravelTime-RG
.تلميح
إذا أظهرت صفحة Azure الرئيسية مجموعة الموارد ضمن Recent resources، يمكنك تحديد المجموعة من الصفحة الرئيسية.
في قائمة مجموعة الموارد، تحقق من تحديد Overview. في شريط أدوات الجزء Overview، حدد Delete resource group.
في جزء التأكيد الذي يظهر، أدخل اسم مجموعة الموارد وحدد Delete.
الخطوات التالية
في هذا البرنامج التعليمي، قمت بإنشاء سير عمل تطبيق منطق يتحقق من نسبة استخدام الشبكة استنادًا إلى جدول زمني محدد (في صباح أيام الأسبوع)، ويتخذ إجراءً (يرسل بريدًا إلكترونيًا) عندما يتجاوز وقت السفر حدًا محددًا. الآن، تعرف على كيفية إنشاء سير عمل يرسل طلبات قائمة بريدية للموافقة عليها من خلال دمج خدمات Azure خدمات Microsoft وتطبيقات البرامج كخدمة (SaaS) الأخرى.