إرسال بريد إلكتروني باستخدام مصنع بيانات Azure أو البنية الأساسية لبرنامج ربط العمليات التجارية Azure Synapse.

ينطبق على: Azure Data Factory Azure Synapse Analytics

تلميح

جرب Data Factory في Microsoft Fabric، وهو حل تحليلي متكامل للمؤسسات. يغطي Microsoft Fabric كل شيء بدءا من حركة البيانات إلى علم البيانات والتحليلات في الوقت الحقيقي والمعلومات المهنية وإعداد التقارير. تعرف على كيفية بدء إصدار تجريبي جديد مجانا!

غالباً ما يكون من الضروري إرسال إشعارات أثناء تنفيذ المسار أو بعده. يوفر الإعلام تنبيهات استباقية ويقلل من الحاجة إلى المراقبة التفاعلية لاكتشاف المشكلات.  توضح هذه المقالة كيفية تكوين إعلامات البريد الإلكتروني من Azure Data Factory أو البنية الأساسية لبرنامج ربط العمليات التجارية لـ Azure Synapse. 

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

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

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

إنشاء سير عمل تطبيق منطق قياسي باسم SendEmailFromPipeline. أضف مشغل الطلب المسمى When an HTTP request is received، وأضف إجراء Office 365 Outlook المسمى Send an email (V2).

يعرض مصمم سير عمل التطبيق المنطقي مع مشغل الطلب وإجراء إرسال بريد إلكتروني (V2).

في مشغل الطلب، قم بتوفير JSON هذا للخاصية Request Body JSON Schema :

{
    "properties": {
        "dataFactoryName": {
            "type": "string"
        },
        "message": {
            "type": "string"
        },
        "pipelineName": {
            "type": "string"
        },
        "receiver": {
            "type": "string"
        }
    },
    "type": "object"
}

يجب أن يبدو مشغل الطلب في مصمم سير العمل كما يلي:

يظهر مصمم سير العمل لمشغل الطلب مع تعبئة حقل مخطط JSON نص الطلب.

بالنسبة إلى الإجراء Send an email (V2)، قم بتخصيص الطريقة التي ترغب بها في تنسيق البريد الإلكتروني، باستخدام الخصائص من مخطط Body JSON للطلب:

يعرض مصمم سير العمل لإجراء إرسال بريد إلكتروني (V2).

حفظ سير العمل. قم بالاستعراض إلى صفحة نظرة عامة لسير العمل. دون ملاحظة عن عنوان URL لسير العمل، وتمييزه في الصورة أدناه:

يعرض صفحة نظرة عامة على سير العمل مع تمييز عنوان URL لسير العمل.

إشعار

للعثور على عنوان URL لسير العمل، يجب الاستعراض وصولا إلى سير العمل نفسه، وليس فقط تطبيق المنطق الذي يحتوي عليه. من صفحة Workflows لمثيل logic app، حدد سير العمل ثم انتقل إلى صفحة Overview الخاصة به.

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

بعد إنشاء سير عمل التطبيق المنطقي لإرسال البريد الإلكتروني، يمكنك تشغيله من مسار باستخدام نشاط ويب .

  1. إنشاء البنية الأساسية لبرنامج ربط العمليات التجارية الجديدة والعثور على نشاط ويب ضمن الفئة «General»، لسحبه إلى لوحة التعديل.

  2. حدد نشاط «Web1» الجديد، ثم حدد علامة التبويب «Settings».

    قم بتوفير عنوان URL من سير عمل التطبيق المنطقي الذي قمت بإنشائه مسبقا في حقل URL .

    حدد JSON التالي للنص الأساسي.

       {
        "message" : "This is a custom dynamic message from your pipeline with run ID @{pipeline().RunId}.",
        "dataFactoryName" : "@{pipeline().DataFactory}", 
        "pipelineName" : "@{pipeline().Pipeline}", 
        "receiver" : "@{pipeline().parameters.receiver}"
       }
    

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

    يعرض البنية الأساسية لبرنامج ربط العمليات التجارية مع نشاط ويب تم تكوينه باستخدام عنوان URL لسير عمل التطبيق المنطقي ونص رسالة JSON.

  3. حدد منطقة خلفية مصمم خط الأنابيب لتحديد صفحة «pipeline properties» وإضافة معلمة جديدة تُسمى المستلم، وتوفير عنوان بريد إلكتروني كقيمته الافتراضية.

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

    عرض تكوين معلمة المتلقي في مصمم البنية الأساسية لبرنامج ربط العمليات التجارية

  4. نشر خط الأنابيب الخاص بك، ومن ثَم تشغيله يدويًا لتأكيد إرسال البريد الإلكتروني كما هو متوقع.

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

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

يمكنك استخدام متغيرات النظام والتعبيرات لتصبح الرسائل ديناميكية. على سبيل المثال:

  • @activity("CopyData").output.errors[0].Message

  • @activity("DataFlow").error.Message

ستعيد التعبيرات أعلاه رسائل الخطأ ذات الصلة من فشل نشاط النسخ، والتي يمكن إعادة توجيهها بعد ذلك إلى نشاط الويب الذي يرسل البريد الإلكتروني. راجع مقالة «Copy activity output properties» للحصول على مزيد من التفاصيل.

كيفية إرسال إعلامات إخطارات Teams من خط البنية الأساسية لبرنامج ربط العمليات التجارية