إرسال بريد إلكتروني باستخدام مصنع بيانات 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).

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

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

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

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

حفظ سير العمل. قم بالاستعراض إلى صفحة نظرة عامة لسير العمل. دون ملاحظة عن عنوان 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 الذي حددته في تطبيق المنطق، ويمكنك أيضا تخصيص هذه التنسيقات كما هو مطلوب.

   

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

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

   

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

   

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

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

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

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

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

المحتوى ذو الصلة

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