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

  • مقالة

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

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

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

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

عند الانتهاء، يبدو سير العمل الخاص بك مثل هذا الإصدار على مستوى عال:

نظرة عامة على تطبيق المنطق النهائي عالي المستوى

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

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

  • حساب MailChimp حيث قمت مسبقاً بإنشاء قائمة باسم "test-members-ML" حيث يمكن لتطبيقك المنطقي إضافة عناوين بريد إلكتروني للأعضاء المعتمدين. إذا لم يكن لديك حساب، فقم بالتسجيل للحصول على حساب مجاني، ثم تعلمكيفية إنشاء قائمة MailChimp.

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

  • حساب بريد إلكتروني في Office 365 Outlook أوOutlook.com، والذي يدعم مهام سير عمل الموافقة. يستخدم هذا البرنامج التعليمي Office 365 Outlook. إذا كنت تستخدم حساب بريد إلكتروني مختلفاً، فستظل الخطوات العامة كما هي، ولكن قد ستبدو واجهة المستخدم الخاصة بك مختلفة قليلاً.

  • إذا كان سير عمل تطبيق المنطق يحتاج إلى الاتصال من خلال جدار حماية يحد من نسبة استخدام الشبكة إلى عناوين IP محددة، فإن جدار الحماية هذا يحتاج إلى السماح بالوصول إلى كل من عناوين IP الواردةوالصادرة التي تستخدمها Azure Logic Apps في منطقة Azure حيث يوجد مورد تطبيق المنطق الخاص بك. إذا كان تطبيق المنطق يستخدم أيضًا موصلات مدارة، مثل موصل Office 365 Outlook أو موصل SQL، أو يستخدم موصلات مخصصة، يحتاج جدار الحماية أيضًا إلى السماح بالوصول إلى جميععناوين IP الصادرة للموصل المدار في منطقة Azure الخاصة بتطبيق المنطق.

إنشاء مورد تطبيق المنطق الخاص بك

  1. سجل الدخول إلى مدخل Microsoft Azure باستخدام بيانات اعتماد حساب Azure. في صفحة Azure الرئيسية، حدد Create a resource.

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

    لقطة شاشة تعرض قائمة Azure Marketplace مع تحديد

  3. في جزء Logic App ، قم بتوفير المعلومات الموضحة هنا حول مورد تطبيق المنطق الذي تريد إنشاؤه.

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

    الخاصية القيمة الوصف
    الاشتراك <اسم اشتراك Azure خاصتك> اسم اشتراك Azure خاصتك. هذا المثال يستخدم Pay-As-You-Go.
    مجموعة الموارد LA-MailingList-RG اسم مجموعة موارد Azure، والذي يُستخدم لتنظيم الموارد ذات الصلة. ينشئ هذا المثال مجموعة موارد جديدة باسم LA-MailingList-RG.
    الاسم قائمة LA البريدية اسم تطبيق المنطق الخاص بك، والذي يمكن أن يحتوي فقط على أحرف وأرقام وواصلات (-) وشرطات سفلية (_) وأقواس ((و)) ونقاط (.). هذا المثال يستخدم LA-MailingList.
    ⁧⁩الموقع⁧⁩ غرب الولايات المتحدة المنطقة التي تريد تخزين معلومات تطبيق الـLogic فيها. هذا المثال يستخدم West US.
    ⁧⁩نوع الخطة⁧⁩ Consumption
    Log Analytics إيقاف تشغيل حافظ على بقاء إعداد الإيقاف Off للتسجيل التشخيصي.

  4. عندما تنتهي، حدد "Review + create". بعد أن يتحقق Azure من صحة المعلومات حول تطبيق المنطق، حدد Create.

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

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

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

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

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

إضافة مشغل لمراقبة رسائل البريد الإلكتروني

  1. في مربع البحث مصمم سير العمل، أدخل when email arrives، وحدد المشغل المسمى عند وصول بريد إلكتروني جديد.

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

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

    لقطة شاشة تعرض مربع البحث Logic Apps Designer الذي يحتوي على مصطلح البحث

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

    تنشئ تطبيقات Azure Logic اتصالاً بحساب بريدك الإلكتروني.

  3. في المشغل، قم بتوفير معايير التحقق من البريد الإلكتروني الجديد.

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

      لقطة شاشة تعرض المصمم مع إجراء

    2. أضف خاصية عامل تصفية الموضوع للمشغل بحيث يمكنك تصفية رسائل البريد الإلكتروني بناءً على سطر الموضوع. افتح القائمة Add new parameter، وحدد Subject Filter.

      لقطة شاشة تعرض قائمة

      لمزيد من المعلومات حول خصائص هذا المشغل، راجع مرجع موصل Office 365 Outlook أو مرجع موصل Outlook.com.

    3. بعد ظهور الخاصية في المشغل، أدخل هذا النص: subscribe-test-members-ML

      لقطة شاشة تعرض خاصية

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

    لقطة شاشة تظهر شكل المشغل المنهار.

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

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

إرسال بريد إلكتروني للموافقة

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

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

  2. ضمن Choose an operation، في مربع البحث، أدخلsend approval، وحدد الإجراء المسمى Send approval email.

    لقطة شاشة تعرض قائمة

  3. أدخل الآن قيم الخصائص المحددة الموضحة والموضحة هنا. ترك كل الآخرين في قيمهم الافتراضية. لمزيد من المعلومات حول هذه الخصائص، راجع مرجع موصل Office 365 Outlook أو مرجع موصل Outlook.com.

    لقطة شاشة تعرض خصائص

    الخاصية القيمة الوصف
    لكي تتمكن من <عنوان البريد الإلكتروني للموافقة> عنوان البريد الإلكتروني للموافق. لأغراض الاختبار، يمكنك استخدام عنوانك الخاص. يستخدم هذا المثال عنوان البريد الإلكتروني sophiaowen@fabrikam.com الوهمي.
    Subject Approve member request for test-members-ML موضوع بريد إلكتروني وصفي
    خيارات المستخدم Approve, Reject تأكد من أن هذه الخاصية تحدد خيارات الاستجابة التي يمكن للموافق تحديدها، وهي موافقة أو رفض بشكل افتراضي.

    ملاحظة

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

  4. احفظ سير عمل التطبيق المنطقي الخاص بك.

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

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

  1. ضمن الإجراء إرسال بريد إلكتروني للموافقة، حدد خطوة جديدة.

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

    لقطة شاشة تعرض مربع البحث

  3. في شريط عنوان Condition، حدد زر ellipses ( ... )، ثم حدد Rename. أعد تسمية الحالة بهذا الوصف: If request approved

    لقطة شاشة تعرض زر علامات الحذف المحدد مع فتح قائمة

  4. قم بإنشاء شرط يتحقق مما إذا كان الموافق قد حدد موافقة.

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

    2. من قائمة المحتوى الديناميكي التي تظهر، ضمن Send approval email، حدد خاصية SelectedOption.

      لقطة شاشة تعرض قائمة المحتوى الديناميكي حيث يظهر إخراج

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

    4. على الجانب الأيمن من الشرط، في المربع Choose a value، أدخل النص، Approve.

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

      لقطة شاشة توضح الحالة النهائية لمثال الطلب المعتمد

  5. احفظ سير عمل التطبيق المنطقي الخاص بك.

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

أضف عضواً إلى قائمة MailChimp

أضف الآن إجراءً يضيف العضو المعتمد إلى قائمتك البريدية.

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

  2. ضمن مربع البحث Choose an operation، حدد All. في مربع البحث، أدخل mailchimp وحدد الإجراء المسمى Add member to list.

    لقطة شاشة تعرض مربع

  3. إذا لم يكن لديك بالفعل اتصال بحساب MailChimp الخاص بك، فستتم مطالبتك بتسجيل الدخول.

  4. في إجراء Add member to list، قدم المعلومات كما هو موضح والموضحة هنا:

    لقطة شاشة تعرض معلومات الإجراء

    الخاصية مطلوب القيمة الوصف
    List Id نعم <mailing-list-name> حدد اسم قائمة MailChimp البريدية الخاصة بك. هذا المثال يستخدم test-members-ML.
    عنوان البريد الإلكتروني نعم <عنوان البريد الإلكتروني للعضو الجديد> في قائمة المحتوى الديناميكي التي تفتح، من قسم When a new email arrives، حدد From، وهو الناتج من المشغل ويحدد عنوان البريد الإلكتروني للعضو الجديد.
    الحالة نعم <member-subscription-status> حدد حالة الاشتراك لتعيينها للعضو الجديد. هذا المثال يختار subscribed.

    لمزيد من المعلومات، راجع إدارة المشتركين باستخدام MailChimp API.

    لمزيد من المعلومات حول خصائص الإجراء إضافة عضو إلى القائمة، راجع مرجع موصل MailChimp.

  5. احفظ سير عمل التطبيق المنطقي الخاص بك.

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

تحقق من النجاح أو الفشل

  1. في الفرع True، ضمن الإجراء Add member to list، حدد Add an action.

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

  3. أعد تسمية الحالة بهذا الوصف: If add member succeeded

  4. أنشئ شرطاً يتحقق مما إذا كان العضو المعتمد قد نجح أو فشل في الانضمام إلى قائمتك البريدية:

    1. على الجانب الأيسر من الشرط، انقر داخل المربع Choose a value. من قائمة المحتوى الديناميكي التي تظهر، في قسم Add member to list، حدد خاصية Status.

      على سبيل المثال، تبدو حالتك مثل هذا المثال:

      لقطة شاشة تعرض مربع

    2. في مربع المقارنة الأوسط، حدد عامل التشغيل is equal to.

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

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

      لقطة شاشة توضح الحالة النهائية للتحقق من الاشتراك الناجح أو الفاشل.

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

إرسال بريد إلكتروني إذا تمت إضافة العضو

  1. ضمن شرط If add member succeeded، في الفرع True، حدد Add an action.

    لقطة شاشة تعرض الفرع

  2. في مربع البحث Choose an operation، أدخلoutlook send email، وحدد الإجراء المسمى Send an email.

    لقطة شاشة تعرض مربع البحث

  3. أعد تسمية الإجراء بهذا الوصف: Send email on success

  4. في الإجراء Send email on success، قدم المعلومات كما هو موضح والموضحة هنا:

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

    الخاصية مطلوب القيمة الوصف
    النص الأساسي نعم <success-email-body> محتوى نص للبريد الإلكتروني الناجح. في هذا البرنامج التعليمي، اتبع الخطوات التالية:

    1. أدخل هذا النص بمسافة لاحقة: New member has joined "test-members-ML":

    2. من قائمة المحتوى الديناميكي التي تظهر، حدد خاصية Email Address.

    ملاحظة: إذا لم تظهر هذه الخاصية، بجوار رأس القسم Add member to list، فحدد See more.

    3. في الصف التالي، أدخل هذا النص بمسافة لاحقة: Member opt-in status:

    4. من قائمة المحتوى الديناميكي، ضمن Add member to list، حدد خاصية Status.
    Subject نعم <success-email-subject> موضوع البريد الإلكتروني الناجح. في هذا البرنامج التعليمي، اتبع الخطوات التالية:

    1. أدخل هذا النص بمسافة لاحقة: Success! Member added to "test-members-ML":

    2. من قائمة المحتوى الديناميكي، ضمن Add member to list، حدد خاصية Email Address.
    لكي تتمكن من نعم <your-email-address> عنوان البريد الإلكتروني الخاص بمكان إرسال البريد الإلكتروني الخاص بالنجاح. لأغراض الاختبار، يمكنك استخدام عنوان البريد الإلكتروني الخاص بك.

  5. احفظ سير عمل التطبيق المنطقي الخاص بك.

إرسال بريد إلكتروني إذا لم تتم إضافة العضو

  1. ضمن شرط If add member succeeded، في الفرع False، حدد Add an action.

    لقطة شاشة التي تعرض الفرع

  2. في مربع البحث Choose an operation، أدخلoutlook send email، وحدد الإجراء المسمى Send an email.

    لقطة شاشة تعرض مربع البحث

  3. أعد تسمية الإجراء بهذا الوصف: Send email on failure

  4. قدم معلومات حول هذا الإجراء كما هو موضح هنا:

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

    الخاصية مطلوب القيمة الوصف
    النص الأساسي نعم <body-for-failure-email> محتوى نص رسالة البريد الإلكتروني الفاشل. في هذا البرنامج التعليمي، أدخل هذا النص:

    Member might already exist. Check your MailChimp account.
    Subject نعم <subject-for-failure-email> موضوع رسالة البريد الإلكتروني الفاشل. في هذا البرنامج التعليمي، اتبع الخطوات التالية:

    1. أدخل هذا النص بمسافة لاحقة: Failed, member not added to "test-members-ML":

    2. من قائمة المحتوى الديناميكي، ضمن Add member to list، حدد خاصية Email Address.
    لكي تتمكن من نعم <your-email-address> عنوان البريد الإلكتروني الخاص بمكان إرسال رسالة البريد الإلكتروني الخاصة بالفشل. لأغراض الاختبار، يمكنك استخدام عنوان البريد الإلكتروني الخاص بك.

  5. احفظ سير عمل التطبيق المنطقي الخاص بك.

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

لقطة شاشة تعرض مثال سير عمل تطبيق المنطق النهائي.

تشغيل سير عمل تطبيق المنطق

  1. أرسل لنفسك طلب بريد إلكتروني للانضمام إلى قائمتك البريدية. انتظر حتى يظهر الطلب في بريدك الوارد.

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

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

  3. في رسالة الموافقة الإلكترونية التي تتلقاها، حدد Approve.

  4. إذا لم يكن عنوان البريد الإلكتروني للمشترك موجودا في القائمة البريدية، يضيف سير العمل عنوان البريد الإلكتروني لهذا الشخص ويرسل إليك بريدا إلكترونيا مثل هذا المثال:

    لقطة شاشة تعرض مثال البريد الإلكتروني لاشتراك ناجح.

    إذا تعذر على سير العمل إضافة المشترك، فستتلقى رسالة بريد إلكتروني مثل هذا المثال:

    لقطة شاشة تعرض مثال البريد الإلكتروني لاشتراك فاشل.

تلميح

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

تهانينا، لقد قمت الآن بإنشاء وتشغيل سير عمل تطبيق منطقي يدمج المعلومات عبر Azure وخدمات Microsoft وتطبيقات SaaS الأخرى.

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

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

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

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

    لقطة شاشة تعرض مربع بحث Azure مع إدخال «la-mailinglist-rg» وتحديد LA-MailingList-RG.

    تلميح

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

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

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

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

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

في هذا البرنامج التعليمي، قمت بإنشاء سير عمل تطبيق منطقي يعالج الموافقات لطلبات القائمة البريدية. الآن، تعرف على كيفية إنشاء سير عمل تطبيق منطقي يعالج مرفقات البريد الإلكتروني ويخزنها من خلال دمج خدمات Azure، مثل Azure Storage وAzure Functions.

معالجة مرفقات البريد الإلكتروني