البرنامج التعليمي: إنشاء مهام سير العمل التي تعالج رسائل البريد الإلكتروني باستخدام Azure Logic Apps وAzure Functions وAzure Storage

مقالة
04/16/2024

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

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

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

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

تظهر لقطة الشاشة التالية سير العمل على مستوى عال:

لقطة شاشة تعرض مثال سير عمل الاستهلاك عالي المستوى لهذا البرنامج التعليمي.

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

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

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

إشعار

إذا كنت ترغب في استخدام موصل Gmail، يمكن لحسابات الأعمال G-Suite فقط استخدام هذا الرابط دون قيود في سير عمل تطبيقات المنطق. إذا كان لديك حساب عميل Gmail، يمكنك استخدام هذا الرابط مع خدمات معينة معتمدة من Google فقط، أو يمكنك إنشاء تطبيق عميل Google لاستخدامه للمصادقة باستخدام موصل Gmail. لمزيد من المعلومات، يرجى مراجعة سياسات أمان البيانات والخصوصية لموصلات Google في تطبيقات Azure Logic.
تحميل وتثبيت Microsoft Azure Storage Explorer المجاني. تساعدك هذه الأداة في التحقق من إعداد حاوية التخزين بشكل صحيح.
إذا كان سير العمل يحتاج إلى الاتصال عبر جدار حماية يحد من نسبة استخدام الشبكة لعناوين IP محددة، فيجب أن يسمح جدار الحماية هذا بالوصول إلى عناوين IP الواردة و الصادرة مستخدمة بواسطة تطبيقات Azure Logic في منطقة Azure حيث يوجد تطبيق المنطق الخاص بك. إذا كان سير العمل يستخدم أيضا موصلات مدارة، مثل موصل Office 365 Outlook أو موصل SQL، أو يستخدم موصلات مخصصة، فسيحتاج جدار الحماية أيضا إلى السماح بالوصول إلى جميععناوين IP الصادرة للموصل المدار في منطقة Azure لتطبيق المنطق.

إعداد مساحة تخزين لحفظ المرفقات

يمكنك حفظ رسائل البريد الإلكتروني الواردة والمرفقات كنقاط في حاوية تخزين Azure.

في مدخل Microsoft Azure باستخدام بيانات اعتماد حساب Azure، قم بإنشاء حساب تخزين ما لم يكن لديك حساب بالفعل، باستخدام المعلومات التالية في علامة التبويب Basics :

الخاصية	القيمة‬	‏‏الوصف
الاشتراك	<"Azure-subscription-name">	اسم اشتراك Azure
مجموعة الموارد	<مجموعة موارد Azure>	اسم مجموعة موارد Azure المستخدمة لتنظيم الموارد ذات الصلة وإدارتها. يستخدم هذا المثال LA-Tutorial-RG. ملاحظة: توجد مجموعة موارد داخل منطقة معينة. على الرغم من أن العناصر الموجودة في هذا البرنامج التعليمي قد لا تكون متوفرة في جميع المناطق، حاول استخدام نفس المنطقة عند الإمكان.
Storage account name	<اسم حساب تخزين Azure>	اسم حساب التخزين، الذي يجب أن يحتوي على 3-24 حرفًا ويمكن أن يحتوي على أحرف وأرقام صغيرة فقط. يستخدم هذا المثال attachmentstorageacct.
المنطقة	<تحديد منطقة Azure>	المنطقة التي تريد تخزين معلومات حول حساب التخزين الخاص بك. يستخدم هذا المثال غرب الولايات المتحدة.
الاداء	قياسي	يحدد هذا الإعداد أنواع البيانات المعتمدة ووسائط تخزين البيانات. شاهد أنماط حسابات التخزين.
التكرار	التخزين المتكرر جغرافيا (GRS)	يتيح هذا الإعداد تخزين نسخ متعددة من بياناتك كحماية من الأحداث المخطط لها وغير المخطط لها. لمزيد من المعلومات، راجع تكرار Azure Storage.

لإنشاء حساب تخزين، يمكنك أيضًا استخدام Azure PowerShell أو Azure CLI.

عند الانتهاء، حدد Review>Create.
بعد أن تقوم Azure بنشر حساب التخزين الخاص بك، ابحث عن حساب التخزين الخاص بك، واحصل على مفتاح الوصول إلى حساب التخزين:
1. في قائمة حساب التخزين، ضمن Security + networking، حدد Access keys.
2. انسخ اسم حساب التخزين ومفتاحك1،واحفظ هذه القيم في مكان آمن.
لإنشاء حساب تخزين، يمكنك أيضًا استخدام Azure PowerShell أو Azure CLI.
إنشاء حاوية تخزين نقاط لمرفقات البريد الإلكتروني الخاص بك.
1. في قائمة حساب التخزين الخاص بك، ضمن Data storage، حدد Containers.
2. في شريط أدوات صفحة الحاويات ، حدد حاوية.
3. ضمن حاوية جديدة، أدخل المرفقات كاسم الحاوية. ضمن مستوى الوصول العام، حدد حاوية (وصول القراءة المجهول للحاويات والنقطة)>موافق.
عند الانتهاء، تعرض قائمة الحاويات الآن حاوية التخزين الجديدة.

لإنشاء حساب تخزين، يمكنك أيضًا استخدام Azure PowerShell أو Azure CLI.

بعد ذلك، قم بتوصيل مستكشف التخزين بحساب التخزين الخاص بك.

إعداد مستكشف التخزين

الآن، قم بتوصيل Storage Explorer بحساب التخزين الخاص بك حتى تتمكن من التأكد من أن سير العمل الخاص بك يمكنه حفظ المرفقات بشكل صحيح ككائنات ثنائية كبيرة الحجم في حاوية التخزين الخاصة بك.

قم بتشغيل مستكشف تخزين Microsoft Azure تسجيل بحساب Azure الخاص بك.

إشعار

إذا لم تظهر مطالبة، في شريط نشاط Storage Explorer، حدد إدارة الحساب (أيقونة الحساب).
في نافذة تحديد بيئة Azure، حدد بيئة Azure، ثم حدد التالي.

يستمر هذا المثال عن طريق تحديد Azure العمومي متعدد المستأجرين.
في نافذة المستعرض التي تظهر، سجل الدخول باستخدام حساب Azure الخاص بك.
ارجع إلى Storage Explorer ونافذة Account Management ، وتحقق من تحديد مستأجر Microsoft Entra الصحيح والاشتراك.
في شريط نشاط Storage Explorer، حدد Open الاتصال Dialog.
في نافذة Select Resource ، حدد Storage account or service.
في نافذة تحديد أسلوب الاتصال، حدد اسم الحساب والمفتاح>التالي.

في الاتصال إلى نافذة تخزين Azure، قم بتوفير المعلومات التالية، وحدد التالي.

الخاصية	القيمة
‏‫اسم العرض‬	اسم مألوف لاتصالك
Account name	اسم حساب التخزين الخاص بك
مفتاح الحساب	مفتاح الوصول الذي قمت بحفظه مسبقا

في نافذة Summary، قم بتأكيد معلومات الاتصال، ثم حدد الاتصال.

يقوم Storage Explorer بإنشاء الاتصال، ويعرض حساب التخزين الخاص بك في نافذة Explorer ضمن Emulator وStorage>Accounts.
للعثور على حاوية تخزين نقاط، ضمن حسابات التخزين،قم بتوسيع حساب التخزين الخاص بك، والذي هو إجراء تخزين مرفق هنا، وتوسيع حاويات النقاط حيث تجد حاوية المرفقات، على سبيل المثال:

قم بإنشاء دالة Azure التي تزيل HTML من رسائل البريد الإلكتروني.

إنشاء دالة لإزالة HTML

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

قبل أن تتمكن من إنشاء دالة، قم بإنشاء تطبيق دالة باتباع الخطوات التالية:

في علامة التبويب Basics ، قم بتوفير المعلومات التالية:

الخاصية	القيمة‬	‏‏الوصف
الاشتراك	<اسم اشتراك Azure>	نفس اشتراك Azure الذي استخدمته سابقًا
مجموعة الموارد	LA-Tutorial-RG	نفس مجموعة موارد Azure التي استخدمتها سابقًا
اسم تطبيق الوظائف	<function-app-name>	اسم تطبيق الوظائف الخاص بك، والذي يجب أن يكون فريدا عالميا عبر Azure. يستخدم هذا المثال بالفعل CleanTextFunctionApp، لذا قم بتوفير اسم مختلف، مثل MyCleanTextFunctionApp-your-name<>
هل تريد نشر التعليمات البرمجية أو صورة الحاوية؟	رمز	نشر ملفات التعليمات البرمجية.
مكدس وقت التشغيل	<اللغة المفضلة>	حدد وقت تشغيل يدعم لغة برمجة الوظائف المفضلة لديك. يتوفر التحرير في المدخل للبرامج النصية JavaScript وPowerShell وTypeScript وC# فحسب. يجب أن تكون وظائف المكتبة الفئات C# وJava وPython مطورة محلياً. بالنسبة لدالات C# وF#، حدد .NET.
‏‏الإصدار	<رقم الإصدار>	حدد إصدار وقت التشغيل المثبت.
المنطقة	<تحديد منطقة Azure>	نفس المنطقة التي استخدمتها سابقا. يستخدم هذا المثال غرب الولايات المتحدة.
نظام تشغيل	<نظام التشغيل الخاص بك>	يتم تحديد نظام التشغيل مسبقا لك استنادا إلى تحديد مكدس وقت التشغيل، ولكن يمكنك تحديد نظام التشغيل الذي يدعم لغة برمجة الوظائف المفضلة لديك. يتم اعتماد التحرير في المدخل فقط على نظام Windows. يحدد هذا المثال Windows.
خيارات الاستضافة وخططها	الاستهلاك (بلا خادم)	حدد خطة الاستضافة التي تحدد كيفية تخصيص الموارد لتطبيق الوظائف. في خطة الاستهلاك الافتراضية، تتم إضافة الموارد ديناميكيا كما هو مطلوب من قبل وظائفك. في هذه الاستضافة بدون خادم، تدفع فقط مقابل الوقت الذي تعمل فيه وظائفك. يجب عليك إدارةتحجيم نطاق وظيفة التطبيق الخاصة بك، عندما تقوم بتشغيل خطة App Service.

حدد Next: Storage. في علامة التبويب Storage ، قم بتوفير المعلومات التالية:

الخاصية	القيمة‬	‏‏الوصف
حساب التخزين	cleantextfunctionstorageacct	أنشئ حساب تخزين يستخدمه تطبيق الوظائف لديك. يجب أن يتراوح طول أسماء حسابات التخزين بين 3 و24 حرفا ويمكن أن تحتوي على أحرف صغيرة وأرقام فقط. ملاحظة: يحتوي حساب التخزين هذا على تطبيقات الوظائف الخاصة بك ويختلف عن حساب التخزين الذي تم إنشاؤه مسبقًا لمرفقات البريد الإلكتروني. كما يمكنك استخدام حساب موجود، والذي ينبغي أن يفي بمتطلبات حساب التخزين.

عندما تنتهي، حدد "Review + create". قم بتأكيد معلوماتك، وحدد إنشاء.
بعد أن يقوم Azure بإنشاء مورد تطبيق الدالة ونشره، حدد Go to resource.

الآن قم بإنشاء دالتك محليا حيث إن إنشاء الدالة في مدخل Microsoft Azure محدود. تأكد من استخدام قالب مشغل HTTP، وتوفير المعلومات التالية لوظيفتك، واستخدام نموذج التعليمات البرمجية المضمن، الذي يزيل HTML ويعيد النتائج إلى المتصل:

الخاصية	القيمة
اسم الدالة	إزالةHTMLFunction
مستوى التخويل	دالة

#r "Newtonsoft.Json"

using System.Net;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Primitives;
using Newtonsoft.Json;
using System.Text.RegularExpressions;

public static async Task<IActionResult> Run(HttpRequest req, ILogger log) 
{
   log.LogInformation("HttpWebhook triggered");

   // Parse query parameter
   string emailBodyContent = await new StreamReader(req.Body).ReadToEndAsync();

   // Replace HTML with other characters
   string updatedBody = Regex.Replace(emailBodyContent, "<.*?>", string.Empty);
   updatedBody = updatedBody.Replace("\\r\\n", " ");
   updatedBody = updatedBody.Replace(@"&nbsp;", " ");

   // Return cleaned text
   return (ActionResult)new OkObjectResult(new { updatedBody });
}

لاختبار الدالة الخاصة بك، يمكنك استخدام نموذج الإدخال التالي:

{"name": "Testing my function"}

يبدو إخراج الدالة الخاص بك مثل النتيجة التالية:
```
{"updatedBody":"{\"name\": \"Testing my function\"}"}
```

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

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

في مربع البحث عالي المستوى في مدخل Microsoft Azure، أدخل logic apps، وحدد Logic apps.
في صفحة Logic apps ، حدد Add.

في صفحة Create Logic App ، ضمن Plan، حدد Consumption كنوع الخطة، والذي يعرض بعد ذلك خيارات سير عمل Consumption logic app فقط. قم بتوفير المعلومات التالية، ثم حدد Review + create.

الخاصية	القيمة‬	‏‏الوصف
الاشتراك	<اسم اشتراك Azure>	نفس اشتراك Azure الذي استخدمته سابقًا
مجموعة الموارد	LA-Tutorial-RG	نفس مجموعة موارد Azure التي استخدمتها سابقًا
إدخال اسم التطبيق	LA-ProcessAttachment	اسم تطبيق المنطق وسير العمل. دائما ما يكون لتطبيق منطق الاستهلاك وسير العمل نفس الاسم.
المنطقة	غرب الولايات المتحدة	نفس المنطقة التي استخدمتها سابقًا
تمكين تحليلات السجل	لا	لهذا البرنامج التعليمي، احتفظ بإعداد إيقاف التشغيل .

تأكد من المعلومات التي قدمتها، وحدد إنشاء. بعد أن ينشر Azure تطبيقك، حدد Go to resource.
في قائمة مورد تطبيق المنطق، حدد Logic app designer لفتح مصمم سير العمل.

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

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

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

في مصمم سير العمل، حدد إضافة مشغل.
بعد فتح جزء إضافة مشغل، في مربع البحث، أدخل office 365 outlook. من قائمة نتائج المشغل، ضمن Office 365 Outlook، حدد عند وصول بريد إلكتروني جديد (V3).
إذا تمت مطالبتك ببيانات الاعتماد، فسجل الدخول إلى حساب بريدك الإلكتروني، مما يؤدي إلى إنشاء اتصال بين سير العمل وحساب البريد الإلكتروني.

الآن قم بتوفير معايير المشغل للتحقق من البريد الإلكتروني الجديد وتشغيل سير العمل الخاص بك.

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

من قائمة Advanced parameters، حدد Subject Filter.

بعد ظهور مربع عامل تصفية الموضوع في الإجراء، حدد الموضوع كما هو موضح هنا:

الخاصية	القيمة‬	‏‏الوصف
عامل تصفية الموضوع	محلل الأعمال 2 #423501	النص الذي يجب العثور عليه في موضوع البريد الإلكتروني

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

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

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

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

ضمن المشغل، حدد علامة الجمع (+)، ثم حدد إضافة إجراء.
في جزء إضافة إجراء ، في مربع البحث، أدخل الشرط.
من قائمة نتائج الإجراء، حدد الإجراء المسمى Condition.
أعد تسمية الشرط باستخدام وصف أفضل.
1. في جزء معلومات الشرط ، استبدل الاسم الافتراضي للشرط بالوصف التالي: إذا كان البريد الإلكتروني يحتوي على مرفقات وعبارة موضوع المفتاح
قم بإنشاء شرط يتحقق من وجود رسائل البريد الإلكتروني التي تحتوي على مرفقات.
1. في الصف الأول ضمن قائمة And operation، حدد داخل المربع الموجود في أقصى اليسار. من قائمة المحتويات الديناميكية التي تظهر، حدد الخاصية يحتوي على مرفق.
2. في المربع الأوسط، حافظ على تساويعامل التشغيل.
3. في المربع الموجود في أقصى اليمين، أدخل true، وهي القيمة المراد مقارنتها بقيمة الخاصية Has Attachment التي يتم إخراجها من المشغل. إذا كانت القيمتان متساويتين، يحتوي البريد الإلكتروني على مرفق واحد على الأقل، ويمر الشرط، ويستمر سير العمل.
في تعريف سير العمل الأساسي، والذي يمكنك عرضه عن طريق تحديد طريقة عرض التعليمات البرمجية على المصمم، يبدو الشرط مشابها للمثال التالي:
```
"Condition": {
 "actions": { <actions-to-run-when-condition-passes> },
 "expression": {
 "and": [ {
 "equals": [
 "@triggerBody()?['HasAttachment']",
 "true"
 ]
 } ]
 },
 "runAfter": {},
 "type": "If"
}
```
احفظ سير العمل الخاص بك.

قم باختبار حالتك

في شريط أدوات المصمم، حدد تشغيل تشغيل المشغل>.

تبدأ هذه الخطوة سير العمل وتشغله يدويا، ولكن لن يحدث أي شيء حتى يصل البريد الإلكتروني التجريبي إلى علبة الوارد.
أرسل لنفسك رسالة بريد إلكتروني تفي بالمعايير التالية:
- موضوع البريد الإلكتروني الخاص بك يحتوي على النص الذي حددته في عامل تصفية الموضوعالخاص بالمشغل: Business Analyst 2 #423501
- يحتوي بريدك الإلكتروني على مرفق واحد. في الوقت الحالي، فقط قم بإنشاء ملف نصي فارغ واحد وإرفاق هذا الملف ببريدك الإلكتروني.
عند وصول البريد الإلكتروني، يتحقق سير العمل من المرفقات ونص الموضوع المحدد. إذا مر الشرط، يتم تشغيل المشغل ويتسبب في إنشاء مثيل سير عمل وتشغيله في Azure Logic Apps.
للتحقق من تشغيل المشغل وتشغيل سير العمل بنجاح، في قائمة logic app، حدد Overview.
- لعرض المشغلات التي تم تشغيلها بنجاح، حدد محفوظات المشغلات.
- لعرض مهام سير العمل التي تم تشغيلها بنجاح، حدد Run history.
إذا لم يتم تشغيل المشغل، أو لم يتم تشغيل سير العمل على الرغم من وجود مشغل ناجح، فراجع استكشاف أخطاء سير عمل تطبيق المنطق وإصلاحها.

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

إشعار

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

استدعاء إزالة وظيفةHTML

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

في قائمة logic app، حدد Logic app designer. في الفرع True ، حدد Add an action.
ضمن مربع البحث "تحديد عملية"، حدد "الكل". في مربع البحث، أدخل azure functions، وحدد الإجراء المسمى Choose an Azure function.
حدد تطبيق الوظائف الذي تم إنشاؤه مسبقا، وهو CleanTextFunctionApp في هذا المثال:
الآن حدد الدالة الخاصة بك، والتي تسمى RemoveHTMLFunction في هذا المثال.
أعد تسمية شكل الدالة بالوصف التالي: استدعاء RemoveHTMLFunction لتنظيف نص البريد الإلكتروني
الآن قم بتحديد الإدخال الخاص بك وظيفة لمعالجة.
1. ضمن طلب النص الأساسي، أدخل هذا النص مع مسافة زائدة:
  
  { "emailBody":
  
  في أثناء العمل على هذا الإدخال في الخطوات التالية، يظهر خطأ حول JSON غير صالح حتى يتم تنسيق الإدخال بشكل صحيح كـ JSON. عند اختبار هذه الدالة مسبقًا، استخدم الإدخال المحدد لهذه الدالة تدوين كائن JavaScript (JSON). لذلك، يجب أن يستخدم نص الطلب نفس التنسيق.
  
  أيضًا، عندما يكون المؤشر داخل المربع طلب النص الأساسي، تظهر قائمة المحتوى الديناميكي حتى تتمكن من تحديد قيم الخصائص المتوفرة من الإجراءات السابقة.
2. من قائمة المحتوى الديناميكي، ضمن عند وصول بريد إلكتروني جديد،حدد خاصية نص. بعد هذه الخاصية، تذكر إضافة قوس الإغلاق المتعرج (}).
عند الانتهاء، يبدو الإدخال إلى الدالة مثل المثال التالي:
احفظ سير العمل الخاص بك.

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

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

على المصمم، في كتلة True ، ضمن دالة Azure، حدد Add an action.
ضمن مربع البحث Choose an operation، حدد All. في مربع البحث، أدخل create blob، وحدد الإجراء المسمى Create blob.

قم بتوفير معلومات الاتصال لحساب التخزين الخاص بك، وحدد إنشاء، على سبيل المثال:

الخاصية	القيمة‬	‏‏الوصف
اسم الاتصال	تخزين المرفقات الاتصال	إدخال اسم للاتصال.
نوع المصادقة	مفتاح الاختصار	نوع المصادقة المراد استخدامه للاتصال
اسم حساب Azure Storage أو نقطة النهاية	<اسم حساب التخزين>	اسم حساب التخزين الذي تم إنشاؤه مسبقا، وهو attachmentstorageacct لهذا المثال
مفتاح الوصول إلى حساب تخزين Azure	<مفتاح الوصول إلى حساب التخزين>	مفتاح الوصول لحساب التخزين الذي تم إنشاؤه مسبقا

إعادة تسمية إجراء Create blob بالوصف التالي: إنشاء كائن ثنائي كبير الحجم لنص البريد الإلكتروني

في إجراء Create blob ، قم بتوفير المعلومات التالية:

الخاصية	القيمة‬	‏‏الوصف
اسم حساب التخزين أو نقطة نهاية الكائن الثنائي كبير الحجم	*استخدام إعدادات الاتصال (<اسم حساب> التخزين)*	حدد حساب التخزين الخاص بك، وهو attachmentstorageacct لهذا المثال.
مسار المجلد	<اسم المسار والحاوية>	مسار واسم الحاوية التي قمت بإنشائها مسبقًا. في هذا المثال، حدد أيقونة المجلد، ثم حدد حاوية المرفقات .
اسم النقاط	<اسم المرسل>	على سبيل المثال، استخدم اسم المرسل كاسم نقاط. حدد داخل هذا المربع بحيث تظهر قائمة المحتوى الديناميكي. من المقطع عند وصول بريد إلكتروني جديد، حدد الحقل من.
محتوى النقاط	<المحتوى مقابل الكائن الثنائي كبير الحجم>	على سبيل المثال، استخدم نص البريد الإلكتروني خالية من HTML كمحتوى نقاط. حدد داخل هذا المربع بحيث تظهر قائمة المحتوى الديناميكي. من قسم Call RemoveHTMLFunction لتنظيف نص البريد الإلكتروني، حدد Body.

تظهر الصورة التالية الحقول التي يجب تحديدها لإجراء إنشاء كائن ثنائي كبير الحجم:

لقطة شاشة تعرض معلومات حول نص البريد الإلكتروني الخالي من HTML في إجراء إنشاء كائن ثنائي كبير الحجم.

عند الانتهاء، يبدو الإجراء مثل المثال التالي:

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

احفظ سير العمل الخاص بك.

التحقق من معالجة المرفقات

في شريط أدوات المصمم، حدد تشغيل تشغيل المشغل>.

تبدأ هذه الخطوة سير العمل وتشغله يدويا، ولكن لن يحدث أي شيء حتى يصل البريد الإلكتروني التجريبي إلى علبة الوارد.
أرسل لنفسك رسالة بريد إلكتروني تفي بالمعايير التالية:
- موضوع البريد الإلكتروني الخاص بك يحتوي على النص الذي حددته في عامل تصفية الموضوعالخاص بالمشغل: Business Analyst 2 #423501
- يحتوي بريدك الإلكتروني على مرفق واحد على الأقل. في الوقت الحالي، فقط قم بإنشاء ملف نصي فارغ واحد، وأرفق هذا الملف ببريدك الإلكتروني.
- يحتوي بريدك الإلكتروني على بعض محتوى الاختبار في النص، على سبيل المثال: Testing my logic app workflow
إذا لم يتم تشغيل سير العمل أو تشغيله على الرغم من نجاح المشغل، فراجع استكشاف أخطاء سير عمل تطبيق المنطق وإصلاحها.
تحقق من حفظ سير العمل للبريد الإلكتروني في حاوية التخزين الصحيحة.
1. في Storage Explorer، قم بتوسيع مرفقات Emulator وStorageacct>>(Key)>Blob Containers.>
2. تحقق من حاوية المرفقات للبريد الإلكتروني.
  
  عند هذه النقطة، يظهر البريد الإلكتروني فقط في الحاوية لأن سير العمل لم يعالج المرفقات بعد.
3. عند الانتهاء، احذف البريد الإلكتروني في مستكشف التخزين.
اختياريا، لاختبار الفرع False ، الذي لا يفعل شيئا في الوقت الحالي، يمكنك إرسال بريد إلكتروني لا يفي بالمعايير.

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

معالجة المرفقات

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

ارجع إلى المصمم. ضمن الإجراء Create blob for email body، حدد Add an action.
ضمن مربع البحث "تحديد عملية"، حدد "الكل". في مربع البحث، أدخل لكل منها، وحدد الإجراء المسمى لكل منها.
أعد تسمية التكرار الحلقي بالوصف التالي: لكل مرفق بريد إلكتروني
الآن حدد البيانات الخاصة بالحلقة لمعالجتها. في التكرار الحلقي لكل مرفق بريد إلكتروني، حدد داخل المربع تحديد إخراج من الخطوات السابقة بحيث تظهر قائمة المحتوى الديناميكي. من المقطع عند وصول بريد إلكتروني جديد، حدد المرفقات.

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

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

إنشاء نقاط لكل مرفق

في المصمم، في التكرار الحلقي لكل مرفق بريد إلكتروني، حدد إضافة إجراء لتحديد المهمة التي يجب تنفيذها على كل مرفق تم العثور عليه.
ضمن مربع البحث Choose an operation، حدد All. في مربع البحث، أدخل create blob، وحدد الإجراء المسمى Create blob.
أعد تسمية الإجراء Create blob 2 بالوصف التالي: Create blob لكل مرفق بريد إلكتروني

في إجراء إنشاء كائن ثنائي كبير الحجم لكل مرفق بريد إلكتروني، قم بتوفير المعلومات التالية:

الخاصية	القيمة‬	‏‏الوصف
اسم حساب التخزين أو نقطة نهاية الكائن الثنائي كبير الحجم	*استخدام إعدادات الاتصال (<اسم حساب> التخزين)*	حدد حساب التخزين الخاص بك، وهو attachmentstorageacct لهذا المثال.
مسار المجلد	<اسم المسار والحاوية>	مسار واسم الحاوية التي قمت بإنشائها مسبقًا. في هذا المثال، حدد أيقونة المجلد، ثم حدد حاوية المرفقات .
اسم النقاط	<اسم المرفق>	على سبيل المثال، استخدم اسم المرفق كاسم نقاط. حدد داخل هذا المربع بحيث تظهر قائمة المحتوى الديناميكي. من المقطع عند وصول بريد إلكتروني جديد، حدد حقل الاسم.
محتوى النقاط	<محتوى-بريد إلكتروني>	على سبيل المثال، استخدم محتوى البريد الإلكتروني كمحتوى كائن ثنائي كبير الحجم. حدد داخل هذا المربع بحيث تظهر قائمة المحتوى الديناميكي. من قسم When a new email arrives، حدد Content.

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

عند الانتهاء، يبدو الإجراء مثل المثال التالي:

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

احفظ سير العمل الخاص بك.

التحقق من معالجة المرفقات

في شريط أدوات المصمم، حدد تشغيل تشغيل المشغل>.

تبدأ هذه الخطوة سير العمل وتشغله يدويا، ولكن لن يحدث أي شيء حتى يصل البريد الإلكتروني التجريبي إلى علبة الوارد.
أرسل لنفسك رسالة بريد إلكتروني تفي بالمعايير التالية:
- موضوع البريد الإلكتروني الخاص بك يحتوي على النص الذي حددته في عامل تصفية الموضوعالخاص بالمشغل: Business Analyst 2 #423501
- يحتوي بريدك الإلكتروني على مرفقين على الأقل. في الوقت الحالي، فقط قم بإنشاء ملفين نصيين فارغين وإرفاق هذه الملفات ببريدك الإلكتروني.
إذا لم يتم تشغيل سير العمل أو تشغيله على الرغم من نجاح المشغل، فراجع استكشاف أخطاء سير عمل تطبيق المنطق وإصلاحها.
تحقق من حفظ سير العمل للبريد الإلكتروني والمرفقات في حاوية التخزين الصحيحة.
1. في Storage Explorer، قم بتوسيع مرفقات Emulator وStorageacct>>(Key)>Blob Containers.>
2. تحقق من حاوية المرفقات لكل من البريد الإلكتروني والمرفقات.
3. عند الانتهاء، احذف البريد الإلكتروني والمرفقات في مستكشف التخزين.

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

أرسل إشعارات البريد الإلكتروني

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

يستمر هذا المثال مع موصل Office 365 Outlook، الذي يعمل فقط مع حساب العمل أو المؤسسة التعليمية في Azure. بالنسبة لحسابات Microsoft الشخصية، حدد موصل Outlook.com.
إذا تمت مطالبتك ببيانات الاعتماد، فسجل الدخول إلى حساب بريدك الإلكتروني بحيث تنشئ Azure Logic Apps اتصالا بحساب بريدك الإلكتروني.
إعادة تسمية إجراء إرسال بريد إلكتروني بالوصف التالي: إرسال بريد إلكتروني للمراجعة

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

لإضافة أسطر فارغة في مربع تحرير، اضغط على Shift + Enter.
إذا لم تتمكن من العثور على حقل متوقع في قائمة المحتوى الديناميكي، فحدد عرض المزيد بجوار عند وصول بريد إلكتروني جديد.

الخاصية القيمة‬ ‏‏الوصف

إلى <recipient-email-address> لأغراض الاختبار، يمكنك استخدام عنوان البريد الإلكتروني الخاص بك.

الموضوع ASAP - Review applicant for position:الموضوع موضوع البريد الإلكتروني الذي تريد تضمينه. انقر داخل هذا المربع، وأدخل نص المثال، ومن قائمة المحتوى الديناميكي، حدد حقل الموضوع أسفل عند وصول بريد إلكتروني جديد.

الخاصية	القيمة‬	‏‏الوصف
إلى	<recipient-email-address>	لأغراض الاختبار، يمكنك استخدام عنوان البريد الإلكتروني الخاص بك.
الموضوع	`ASAP - Review applicant for position:`الموضوع	موضوع البريد الإلكتروني الذي تريد تضمينه. انقر داخل هذا المربع، وأدخل نص المثال، ومن قائمة المحتوى الديناميكي، حدد حقل الموضوع أسفل عند وصول بريد إلكتروني جديد.
نص الرسالة	`Please review new applicant:` `Applicant name:`من `Application file location:`مسار `Application email content:`نص الرسالة	محتوى نص البريد الإلكتروني. انقر داخل هذا المربع، وأدخل نص المثال، ومن قائمة المحتوى الديناميكي، حدد هذه الحقول: - الحقلمن ضمن عند وصول عنوان بريد إلكتروني جديد- حقلالمسار ضمنإنشاء كائن ثنائي كبير الحجم لنص عنوان البريد الإلكتروني- حقل النص الأساسي ضمناستدعاء RemoveHTMLFunction لتنظيف نص عنوان البريد الإلكتروني

نص الرسالة

Please review new applicant:

Applicant name:من

Application file location:مسار

Application email content:نص الرسالة

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

- الحقلمن ضمن عند وصول
عنوان بريد إلكتروني جديد- حقلالمسار ضمنإنشاء كائن ثنائي كبير الحجم لنص
عنوان البريد الإلكتروني- حقل النص الأساسي ضمناستدعاء RemoveHTMLFunction لتنظيف نص عنوان البريد الإلكتروني

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

إشعار

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

احفظ سير العمل الخاص بك.

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

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

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

أرسل لنفسك رسالة إلكترونية تستوفي هذه المعايير:

موضوع البريد الإلكتروني الخاص بك يحتوي على النص الذي حددته في عامل تصفية الموضوعالخاص بالمشغل: Business Analyst 2 #423501
يحتوي بريدك الإلكتروني على مرفق واحد أو أكثر. يمكنك إعادة استخدام ملف نصي فارغ من الاختبار السابق. للحصول على سيناريو أكثر واقعية، أرفق ملف سيرة ذاتية.

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


Name: Jamal Hartnett

Street address: 12345 Anywhere Road

City: Any Town

State or Country: Any State

Postal code: 00000

Email address: jamhartnett@outlook.com

Phone number: 000-000-0000

Position: Business Analyst 2 #423501

Technical skills: Dynamics CRM, MySQL, Microsoft SQL Server, JavaScript, Perl, Power BI, Tableau, Microsoft Office: Excel, Visio, Word, PowerPoint, SharePoint, and Outlook

Professional skills: Data, process, workflow, statistics, risk analysis, modeling; technical writing, expert communicator and presenter, logical and analytical thinker, team builder, mediator, negotiator, self-starter, self-managing  

Certifications: Six Sigma Green Belt, Lean Project Management

Language skills: English, Mandarin, Spanish

Education: Master of Business Administration

تشغيل سير العمل الخاص بك. إذا نجحت، يرسل لك سير العمل رسالة بريد إلكتروني تشبه المثال التالي:

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

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

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

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

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

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

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

تعرف على الموصلات في Azure Logic Apps

البرنامج التعليمي: إنشاء مهام سير العمل التي تعالج رسائل البريد الإلكتروني باستخدام Azure Logic Apps وAzure Functions وAzure Storage

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

إعداد مساحة تخزين لحفظ المرفقات

إعداد مستكشف التخزين

إنشاء دالة لإزالة HTML

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

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

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

قم باختبار حالتك

استدعاء إزالة وظيفةHTML

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

التحقق من معالجة المرفقات

معالجة المرفقات

إنشاء نقاط لكل مرفق

التحقق من معالجة المرفقات

أرسل إشعارات البريد الإلكتروني

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

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

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

الموارد الإضافية