اكتب "وظيفة Azure" التي تعالج أحداث Dataverse

40 دقائق

استعرض التمرين السابق كيفية تسجيل خطافات الويب التي تعرض بيانات Microsoft Dataverse لـ "واجهة API" ويب خارجية. ستنشئ في هذا التمرين مثالاً لواجهة API الويب باستخدام "وظائف Azure" لتوضيح كيفية استهلاك حدث Webhook المنشور.

وظائف Azure مقابل المكونات الإضافية

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

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

لبدء كتابة "وظيفة Azure" التي تعالج أحداث Dataverse، ستستخدم قالب تطوير Visual Studio لعام 2019 لإنشاء "وظيفتك" ونشرها. توفر Visual Studio عددًا من الأدوات المتاحة للمساعدة في تسهيل تطوير Azure. لذا، أنت مطالب بتثبيت "أدوات تطوير Azure" في مثيل 2019 الخاص بـ Visual Studio. يمكنك إضافتها من خلال "مثبت Visual Studio"، إذا لم يكن لديك الميزة مثبتة.

إنشاء مشروع "وظيفة Azure"

قم بإنشاء مشروع "وظيفة Azure" جديد باستخدام قالب "وظائف Azure". عن طريق إنشاء مشروع جديد ثم إدخال "دالة" في شريط البحث، يمكنك العثور على هذا النموذج.
امنح مشروع الدالة اسمًا وصفيًا، ثم حدد إنشاء.
حدد نوع "وظائف Azure" v2 (.NET Core)‎ وتأكد من تحديد قالب مشغل Http. يمكنك تعيين حساب التخزين إلى دون لأنك لن تستخدم مساحة التخزين لهذا التمرين؛ ومع ذلك، قد تحتاج إليها في سيناريوهات أخرى. قم بتعيين مستوى المصادقة إلى الدالة ثم تحديد إنشاء.

باستخدام التعليمة البرمجية للقالب التالي الموجود في ملف .cs الخاص بالوظيفة، يجب إنشاء مشروعك النموذجي الآن:

public static class Function1
    {
        [FunctionName("Function1")]
        public static async Task<IActionResult> Run(
            [HttpTrigger(AuthorizationLevel.Function, "get", "post", Route = null)] HttpRequest req,
            ILogger log)
        {
            log.LogInformation("C# HTTP trigger function processed a request.");

            string name = req.Query["name"];

            string requestBody = await new StreamReader(req.Body).ReadToEndAsync();
            dynamic data = JsonConvert.DeserializeObject(requestBody);
            name = name ?? data?.name;

            return name != null
                ? (ActionResult)new OkObjectResult($"Hello, {name}")
                : new BadRequestObjectResult("Please pass a name on the query string or in the request body");
        }
    }

ستستبدل هذه التعليمة البرمجية لاحقًا، ولكن أولاً، ستنشر دالتك للتأكد أن كل شيء يعمل بشكل صحيح.

نشر "وظيفة Azure" الخاصة بك إلى Azure

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

أسلوب آخر لإنشاء "وظائف Azure"

إذا كنت تريد إنشاء "دالة Azure" يدويًا دون مساعدة Visual Studio 2019، فيمكنك القيام بذلك من مدخل Azure:

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

ملاحظة

لا يتناول هذا الدرس تفاصيل إنشاء مجموعة "وظائف Azure" جديدة.

تحديث منطق "دالتك" للتفاعل مع بيانات Dataverse

إذا لزم الأمر، قم بتغيير FunctionName الخاص بالدالة واسم الفئة المقابل إلى شيء أكثر أهمية (أي، MSLearnFunction).
انسخ ملف RemoteExecutionContextHelper.cs الموجود في قسم "الموارد" بهذا التمرين والصقه في مشروعك. يحتوي الملف على جزء التعليمة البرمجية المتكررة التالي، والذي سيطبع تفاصيل "سياق التنفيذ البعيد" لرسالة Dataverse:
```
public static string SerializeContext(dynamic context)
```
أضف عبارات الاستخدام التالية إلى "دالتك":
```
using Newtonsoft.Json.Linq;
```
```
using RemoteExecutionContextHelper;
```
انسخ جزء التعليمة البرمجية المتكرر التالي والصقه في الأسلوب Run للدالة:

log.LogInformation("C# HTTP trigger function processed a request.");

            string queryParams = "";
            foreach (var q in req.Query)
            {
                queryParams += $"Key: {q.Key} Value: {q.Value}\n";
            }


            string requestBody = await new StreamReader(req.Body).ReadToEndAsync();
            dynamic data = JsonConvert.DeserializeObject(requestBody);
            string requestHeader = "";
            foreach (var h in req.Headers)
            {
                requestHeader += $"Key: {h.Key} Value: {h.Value}\n";
            }
            log.LogInformation("Query Parameters:\n" + queryParams);
            log.LogInformation("Request Header: \n" + requestHeader);
            log.LogInformation("Request Body:\n" + requestBody);
            string requestBodyFormatted = JValue.Parse(requestBody).ToString(Formatting.Indented);
            log.LogInformation("Request Body Formatted:\n" + requestBodyFormatted);

            try
            {
                string context = RemoteExecutionContextSerializer.SerializeContext(data);
                log.LogInformation("Context: " + context);

                return (ActionResult)new OkObjectResult(data.InitiatingUserId);
            }
            catch (Exception ex)
            {
                return new BadRequestObjectResult(ex.ToString());
            }

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

تسجيل خطاف ويب Dataverse يستدعي "وظيفة Azure" الخاصة بك

في هذا التمرين، ستستخدم "أداة تسجيل المكوّن الإضافي" لتسجيل خطاف ويب يستدعي "وظيفة Azure" الجديدة.

افتح "أداة تسجيل المكون الإضافي" وقم بتسجيل الدخول إلى بيئة Dataverse الخاصة بك.
قم بتسجيل خطاف ويب جديد عن طريق تحديد تسجيل خطاف الويب الجديد ضمن خيار قائمة التسجيل.
احصل على عنوان URL الخاص بالوظيفة من مدخل Azure عن طريق تحديد الحصول على عنوان URL للدالة.
الصق القيمة المنسوخة في أحد المحررات النصية، والتي يجب أن تبدو مثل الصورة التالية.

https://[AppServiceUrl].azurewebsites.net/api/MsLearnFunction?code=[WebhookKey]

قم بقص قيمة سلسلة استعلام التعليمات البرمجية ولصقها من عنوان URL المنسوخ ووضعها في القسم القيمة من سلسلة تسجيل خطاف ويب (تأكد من إزالة القسم code=).
سجّل خطوة جديدة ستنشر رسالة عند إنشاء حساب جديد. قم بتسجيل خطوة جديدة عن طريق النقر بزر الماوس الأيمن فوق مجموعة الإخطارات عبر الويب الجديدة ثم تحديد تسجيل خطوة جديدة.
قم بتكوين الخطوة كما هو موضح في الشكل التالي. نظرًا لأنك ستنشئ خطاف الويب هذا ليتم تشغيله بشكل متزامن، فتأكد تعيين العلم عند تسجيل الخطوة الجديدة.

اختبر تكامل خطاف الويب لديك

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

متابعة

اكتب "وظيفة Azure" التي تعالج أحداث Microsoft Dataverse

وظائف Azure مقابل المكونات الإضافية