تلقائي التقارير باستخدام C# Mail Merge و Aspose.Words' Mail Merge Plugin

تلقائي إنشاء مستندات مخصصة – مثل التقارير والرسائل والفواتير – يمكن أن تعزز بشكل كبير كفاءة تدفق العمل الخاص بك. مع C# Mail Merge مدعومة من Aspose.Words لـ .NET، يمكنك تحقيق هذا بسهولة.هذا الدليل سوف يمرك من خلال استخدام Azpose-Word Mail merge Plugin لتنفيذ توليد وثيقة فعالة وقابلة للتمدد داخل تطبيقات .Net الخاصة بك – دون الحاجة إلى MS Word أو Office Interop.

المحتوى

• ما هو Mail Merge؟
• مصادر البيانات لـ Mail Merge
• إعداد البريد المدمج القوالب
• بدءا من Aspose.Words لـ .NET
• أداء البريد المدمج مع نموذج البيانات
• البريد يدمج مع بيانات XML
• التصميم المخصص للاندماج الميدان
• البريد المشترك مع المناطق
• إرسال رسالة نستيد
• استنتاجات

ما هو Mail Merge؟

Mail Merge هو منهجية قوية لتوليد المستندات بشكل ديناميكي من خلال تصنيف القوالب مع البيانات من مصادر مختلفة.مع Aspose.Words، يمكنك تلقائيا المهام مثل:

• إنتاج الرسائل والفواتير الشخصية.
• إنشاء التقارير الكبيرة باستخدام تنسيقات منظمة مثل XML أو JSON أو قواعد البيانات، مما يسمح بتوليد التقارير الديناميكية باستخدام C# و Aspose.Words.

مصادر البيانات لـ Mail Merge

يدعم Aspose.Words مجموعة متنوعة من مصادر البيانات، بما في ذلك:

• الموضوعات: النماذج الشعبية باستخدام حالات الفصول الدراسية.
• XML: تحميل البيانات المنظمة للمجالات الديناميكية.
• JSON: سهلة التكامل مع APIs الحديثة.
• CSV: إزالة البيانات اللوحية لتوليد الوثائق الكبيرة.
• DataTable/DataSet: استخدم ADO.NET لدمج قواعد البيانات.

إعداد النموذج لـ Mail Merge {#إعداد النموذج لـ Mail Merge}

نموذج دمج البريد هو المستند الذي يحتوي على الحقول دمج التي سيتم جمعها مع البيانات من مصدر البيانات المحدد أثناء التنفيذ. يمكن أن يكون النموذج في تنسيق DOC أو DOCX ولا يتطلب نمط محدد. اتبع هذه الخطوات لإنشاء نموذج دمج البريد:

• افتح المستند أو قم بإنشاء مستند جديد في MS Word.
• ضع المسار حيث تريد إدخال حقل الانضمام.
• من قائمة إدخال، حدد خيار الميدان.
• من قائمة أسماء المناطق، حدد MergeField.
• حدد اسمًا لحقل الانضمام في مربع اسم الحقل ثم انقر فوق OK.
• حفظ الوثيقة

الشاشة التالية تشير إلى نموذج وثيقة .

.NET Mail Merge API - تثبيت

يمكنك تثبيت Aspose.Words for .NET من خلال أساليب مختلفة:

• تحميل DLL
• إرسال رسالة خاصة إلى NuGet Package Manager

أداء Mail Merge في Word Document باستخدام C#

بمجرد أن يكون قالبك جاهزًا ، يمكنك إجراء دمج البريد لتوليد المستندات.هنا خطوات لإجراء دمج البريد على قالبك المعد:

• قم بتحميل نموذج المستند باستخدام وثيقة الطبقة .
• إعداد خيارات الاندماج البريد المطلوب، مثل أرشيف الوسم : أرشيف الوسم : أرشيف.
• إرسال رسالة بريد إلكتروني باستخدام أرشيف الوسم : أرشيف الوسم : ( طريقة، ونقل مصدر البيانات كمعيار.
• حفظ المستندات التي تم إنشاؤها باستخدام أرشيف الوسم : Save (String) الطريقة .

وهنا نموذج من الرمز يظهر كيفية توليد التقارير تلقائيًا في C# باستخدام مجموعة من القيم:

كلمة الوثيقة بعد ملء البريد

أداء Mail Merge باستخدام XML Data Source في C#

يتم استخدام ملفات XML في كثير من الأحيان لتخزين ونقل البيانات. Aspose.Words for .NET يدعم XML كمصدر بيانات لعمليات دمج البريد. DataSet أدناه هو نموذج ملف XML لدينا حالة الاستخدام.

<customers>
    <customer Name="John Ben Jan" ID="1" Domain="History" City="Boston"/>
    <customer Name="Lisa Lane" ID="2" Domain="Chemistry" City="LA"/>
    <customer Name="Dagomir Zits" ID="3" Domain="Heraldry" City="Milwaukee"/>
    <customer Name="Sara Careira Santy" ID="4" Domain="IT" City="Miami"/>
</customers>

يأخذ العينة الرمزية التالية البيانات من مصدر بيانات XML ويقوم بتنفيذ دمج البريد باستخدام C#.

أدناه هو البريد المشترك معبد سيتم جمعها مع البيانات من ملف XML.

هذه الصورة تمثل الصفحة الأولى من وثيقة Word الناتجة التي تم الحصول عليها بعد تنفيذ دمج البريد.

التصميم المخصص للمناطق المدمجة

Aspose.Words for .NET يوفر السيطرة المتزايدة على عملية دمج البريد الإلكتروني. أرشيف الوسم : FieldMergingCallback الممتلكات تسمح لك لتكوين سلوك الاندماج البريدية كما يلتقي كل حقل الانضمام. فيديوهات متعلقة بـ “ FieldMerging ” و IFieldMergingCallback.ImageFieldMerging الطرق تسمح بتخصيص عملية دمج البريد.

فيما يلي عينة من الرمز التي تظهر كيفية تطبيق التنسيق المخصص أثناء دمج البريد الإلكتروني من خلال نموذج المثال المقدم:

يتم تنفيذ الفئة التالية HandleMergeFieldAlternatingRows.

Mail Merge with Regions باستخدام C#

في بعض الحالات، قد تحتاج إلى تسجيل وتكرار منطقة معينة داخل وثيقة كلمة.في مثل هذه السيناريوهات، استخدم المرابطة البريدية مع المناطق.لإنشاء منطقة، حدد كل من بداية ونهاية المنطقة؛ ثم سوف يكرر هذا المنطقة لكل سجل في مصدر البيانات.تحتوي نموذج الأمثلة أدناه على منطقتين - الأوامر وتفاصيل الطلبات- باستخدام الحقول المتراكمة «TableStart:OrderDetails» و«TabellEnd:Orders».

إليك عينة من الرمز التي تنفذ دمج البريد على أساس المناطق للمناطق المذكورة أعلاه معبد.

تظهر الأساليب التالية كيفية قراءة البيانات من قاعدة بيانات.

البريد الالكتروني (Nested Mail)

في كثير من الأحيان ، يتم ترتيب البيانات من المصدر في تنسيقات علاجية. على سبيل المثال ، قد يكون لـ “الأوامر” علاقة واحدة تلو الأخرى مع “التفاصيل” ، والتي تحافظ على سجلات العناصر داخل أمر. نموذج الفاتورة هذا السيناريو يناسب بشكل جيد.

فيما يلي مصدر بيانات XML لنموذج دمج البريد المنسوج لدينا.

<?xml version="1.0" encoding ="utf-8"?>
<Orders xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="OrdersSchema.xsd">
    <Order>
        <Number>23</Number>
        <Address>Nelson Street</Address>
        <Suburb>Howick</Suburb>
        <City>Auckland</City>
        <Phonenumber>543 1234</Phonenumber>
        <Date>03/01/2010</Date>
        <Total>14.00</Total>
        <Item>
            <Name>BBQ Chicken Pizza</Name>
            <Price>6.00</Price>
            <Quantity>1</Quantity>
            <ItemTotal>6.00</ItemTotal>
        </Item>
        <Item>
            <Name>1.5 Litre Coke</Name>
            <Price>4.00</Price>
            <Quantity>2</Quantity>
            <ItemTotal>8.00</ItemTotal>
        </Item>
    </Order>
    <Order>
        <Number>10</Number>
        <Address>Parkville Avenue</Address>
        <Suburb>Pakuranga</Suburb>
        <City>Auckland</City>
        <Phonenumber>548 7342</Phonenumber>
        <Date>05/03/2010</Date>
        <Total>6.00</Total>
        <Item>
            <Name>Hawaiian Pizza</Name>
            <Price>4.00</Price>
            <Quantity>1</Quantity>
            <ItemTotal>4.00</ItemTotal>
        </Item>
        <Item>
            <Name>Fries</Name>
            <Price>1.00</Price>
            <Quantity>2</Quantity>
            <ItemTotal>2.00</ItemTotal>
        </Item>
    </Order>
</Orders>

الملف المطابق OrderSchema.xsd لهذا XML هو:

<?xml version="1.0" encoding ="utf-8"?>
<xs:schema id="OrdersSchema" xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:element name="Orders">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="Order">
                    <xs:complexType>
                        <xs:sequence>
                            <xs:element name="Number"/>
                            <xs:element name="Address"/>
                            <xs:element name="Suburb"/>
                            <xs:element name="City"/>
                            <xs:element name="Phonenumber"/>
                            <xs:element name="Date"/>
                            <xs:element name="Total"/>
                            <xs:element name="Item">
                                <xs:complexType>
                                    <xs:sequence>
                                        <xs:element name="Name"/>
                                        <xs:element name="Price"/>
                                        <xs:element name="Quantity"/>
                                        <xs:element name="ItemTotal"/>
                                    </xs:sequence>
                                </xs:complexType>
                            </xs:element>
                        </xs:sequence>
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
</xs:schema>

يقوم عينة الرمز التالية بتنفيذ مزيج البريد المنسوج باستخدام C#.

كلمة الوثيقة بعد ملء البريد

أدناه هو الصفحة الأولى من وثيقة Word الناتجة التي تم الحصول عليها بعد تنفيذ دمج البريد المنسوج.

استنتاجات

Aspose.Words لـ .NET هو API شامل لدمج البريد الذي يوفر كل من الميزات القياسية والمتوسطة المناسبة لتطبيقات .Net. مع عدد قليل فقط من خطوط الرمز، يمكنك تطوير التقارير البسيطة أو المعقدة من مصادر البيانات المختلفة بسهولة. الوثائق. للبدء بـ Aspose.Words لـ .NET، استكشاف المتاحة. دليل المطور ونموذج الرمز على GitHub. يقدم Aspose Plugin أيضًا وظائف متقدمة لتوليد التقارير.

جرب Aspose.Words for .NET for مجانا

يمكنك الحصول على ترخيص مؤقت مجاني لمحاولة Aspose.Words لـ .NET دون قيود. احصل على ترخيصك المؤقت الآن.

More in this category

• تحويل Word DOC/DOCX إلى PDF في C# .NET و Aspose.Words' Document Converter Plugin
• إنشاء رمز شريطي في مستندات وورد (.NET، C#) | قراءة رمز شريطي من وورد (.NET)
• استخراج الصور من مستندات Word في C# معالجة الصور التلقائية
• العثور على واستبدال النص في مستندات الكلمة باستخدام C# تلقائي تحرير الكلمة
• إنشاء مستندات كلمة مخصصة باستخدام C# .NET Aspose.Words Mail Merge Plugin