توليد Word من القالب في C#

إن أتمتة توليد المستندات أمر ضروري للشركات التي تهدف إلى إنشاء تقارير ديناميكية، فواتير، ورسائل. مع Aspose.Words Mail Merge for .NET، يمكنك ملء قوالب Word بكفاءة بالبيانات من مصادر متنوعة، بما في ذلك الكائنات، CSV، JSON، وXML. ستوجهك هذه الدليل لاستخدام دمج البريد في C# لتبسيط وأتمتة تدفقات العمل للمستندات، مع التركيز على إنشاء مستندات Word ديناميكية باستخدام C# .NET.

المواضيع المغطاة:

نظرة عامة على دمج البريد لـ .NET

Aspose.Words Mail Merge for .NET يمكّن المطورين من توليد مستندات شخصية من قوالب محددة مسبقًا تحتوي على حقول دمج. تم تصميم هذا الملحق للتكامل السلس ضمن بيئات .NET، مع تقديم القدرات التالية:

  • ملء القوالب ديناميكيًا بالبيانات، دعمًا لـ توليد مستندات Word بإطار عمل .NET.
  • تنفيذ توليد مستندات بالجملة بكفاءة، مع الاستفادة من حل دمج البريد .NET لمجموعات البيانات الكبيرة.
  • ضمان تنسيق متسق عبر المخرجات، مما يعزز أفضل الممارسات لقوالب مستندات Word C#.

الميزات الرئيسية:

  1. دعم متعدد المصادر: استخدم البيانات من الكائنات، قواعد البيانات، XML، JSON، وCSV لإنشاء مستندات Word مخصصة باستخدام C#.
  2. أداء عالي: التعامل بكفاءة مع مجموعات البيانات الكبيرة والعمليات بالجملة لـ توليد مستندات Word ديناميكية باستخدام .NET Core.
  3. قوالب قابلة للتخصيص: إنشاء قوالب مع عناصر نائب لإدخال البيانات، مستفيدًا من قدرات أتمتة دمج البريد Word لـ .NET.

الإعداد

للبدء، قم بتثبيت Aspose.Words باستخدام NuGet:

PM> Install-Package Aspose.Words

توليد مستند Word من قالب باستخدام كائنات C#

لنبدأ بملء قالب Word باستخدام كائنات C#. سنقوم بإنشاء مستند Word (DOC/DOCX) مع العناصر النائبة التالية:

<<[sender.Name]>> يقول: "<<[sender.Message]>>."

في هذا المثال، sender هو مثيل من فئة سنستخدمها لملء القالب باستخدام طريقة توليد مستند Word من قاعدة بيانات C#.

بعد ذلك، سنستخدم محرك التقارير الخاص بـ Aspose.Words لتوليد مستند Word من القالب ومثيل فئة Sender من خلال اتباع هذه الخطوات:

  1. إنشاء مثيل من فئة Document وتهيئته مع مسار قالب Word.
  2. إنشاء وتهيئة كائن من فئة Sender.
  3. إنشاء مثيل من فئة ReportingEngine.
  4. ملء القالب باستخدام ReportingEngine.BuildReport()، الذي يأخذ مثيل Document، مصدر البيانات، واسم مصدر البيانات كمعلمات.
  5. حفظ مستند Word المولد باستخدام Document.Save().

إليك عينة من الشيفرة توضح كيفية توليد مستند Word من قالب في C#.

الناتج

توليد مستند Word من مصدر بيانات XML في C#

لتوليد مستند Word من مصدر بيانات XML، سنستخدم قالب Word أكثر تعقيدًا مع العناصر النائبة التالية:

<<foreach [in persons]>>الاسم: <<[Name]>>, العمر: <<[Age]>>, تاريخ الميلاد: <<[Birth]:"dd.MM.yyyy">>
<</foreach>>
متوسط العمر: <<[persons.Average(p => p.Age)]>>

مصدر بيانات XML المستخدم في هذا المثال موضح أدناه.

لإنشاء مستند Word من مصدر بيانات XML، اتبع هذه الخطوات:

  1. إنشاء مثيل من فئة Document وتهيئته مع مسار قالب Word.
  2. إنشاء مثيل من فئة XmlDataSource وتهيئته مع مسار ملف XML.
  3. إنشاء مثيل من فئة ReportingEngine.
  4. استخدام طريقة ReportingEngine.BuildReport() لملء قالب Word.
  5. حفظ مستند Word المولد باستخدام طريقة Document.Save().

إليك عينة من الشيفرة توضح كيفية توليد مستند Word من مصدر بيانات XML في C#.

الناتج

توليد مستند Word من مصدر بيانات JSON في C#

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

<<foreach [in managers]>>المدير: <<[Name]>>
العقود:
<<foreach [in Contract]>>- <<[Client.Name]>> ($<<[Price]>>)
<</foreach>>
<</foreach>>

مصدر بيانات JSON المقابل الذي سنستخدمه لملء القالب موضح أدناه:

لتوليد مستند Word من JSON، سنستخدم فئة JsonDataSource لتحميل مصدر البيانات، وستتبع الخطوات المتبقية الهيكل السابق. إليك عينة من الشيفرة توضح كيفية توليد مستند Word من قالب JSON في C#.

الناتج

توليد مستند Word من مصدر بيانات CSV في C#

لتوليد مستند Word من مصدر بيانات CSV، سنستخدم قالب Word التالي:

<<foreach [in persons]>>الاسم: <<[Column1]>>, العمر: <<[Column2]>>, تاريخ الميلاد: <<[Column3]:"dd.MM.yyyy">>
<</foreach>>
متوسط العمر: <<[persons.Average(p => p.Column2)]>>

سيتم ملء القالب باستخدام بيانات CSV التالية:

الآن، دعنا نستعرض الشيفرة في C#. تبقى الخطوات كما هي باستثناء اختلاف رئيسي واحد: سنستخدم فئة CsvDataSource لتحميل بيانات CSV. توضح عينة الشيفرة التالية كيفية توليد مستند Word من مصدر بيانات CSV.

الناتج

جرب Aspose.Words لـ .NET مجانًا

يمكنك تجربة Aspose.Words لـ .NET باستخدام ترخيص مؤقت مجاني.

الخاتمة

في هذه المقالة، تعلمت كيفية توليد مستندات Word من القوالب باستخدام C#. استكشفت كيفية الاستفادة من مصادر بيانات متنوعة مثل الكائنات، XML، JSON، وCSV من أجل توليد مستندات ديناميكية في .NET. لمزيد من الأفكار حول قدرات معالجة قوالب Word لـ .NET، اغمر في الوثائق، ولا تتردد في التواصل عبر المنتدى.

انظر أيضًا