XML هي لغة وصفية ذاتية موصى بها من قبل W3C مصممة لتخزين البيانات ونقلها. يمكن للمطور تغيير تنسيق XML إلى أي تنسيق آخر يمكن قراءته بشكل أفضل مثل PDF أو مستند MS Word داخل تطبيق .NET. تناقش هذه المقالة كيفية تحويل بيانات XML إلى تقارير PDF و MS Word باستخدام C # عبر قوالب بسيطة.

XML إلى PDF Report في C #

المواضيع التالية تناقش أدناه:

Report Generation .NET API - XML to PDF and WORD

GroupDocs.Assembly for .NET هو API لأتمتة إنشاء التقرير من بيانات XML باستخدام قالب DOCX أو TXT. بالإضافة إلى ذلك ، يدعم JSON و CSV ومصادر البيانات الأخرى لتحويل البيانات إلى تقارير بتنسيقات ملفات مختلفة.

يمكنك تنزيل مثبت DLL أو MSI من قسم التنزيلات أو تثبيت API في تطبيق .NET عبر NuGet.

PM> Install-Package GroupDocs.Assembly

إنشاء تقرير PDF من بيانات XML في C

ستقودك 3 خطوات بسيطة إلى تحويل بيانات XML إلى تقرير PDF منسق.

  1. قم بتحميل مصدر بيانات XML الخاص بك.
  2. حدد القالب وفقًا لبيانات XML التي تم تحميلها.
  3. أخيرًا ، قم بتوفير مصدر بيانات XML والقالب لطريقة إنشاء التقرير.

بيانات XML

يتم استخدام بيانات نموذج XML التالية لتحويلها إلى تقرير PDF. يحتوي على بيانات المديرين وعملائهم مع بعض التفاصيل.

<Managers>
	<Manager>
		<Name>John Smith</Name>
		<Contract>
			<Client>
				<Name>A Company</Name>
			</Client>
			<Price>1200000</Price>
		</Contract>
		<Contract>
		...
		</Contract>
		...
	</Manager>
	<Manager>
		<Name>Tony Anderson</Name>
		...
	</Manager>
	...
</Managers>

قالب

حدد القالب بتنسيق TXT أو DOCX وفقًا لبيانات XML المصدر. أنا أستخدم النموذج المذكور أدناه الذي تم إنشاؤه وفقًا لبيانات XML المذكورة أعلاه للمديرين. سيؤدي ذلك إلى جعل مُنشئ التقرير يتكرر على المديرين وعملائهم المعنيين. بعد الانتهاء من النموذج ، تكون على وشك الانتهاء. يمكنك استخدام الكود أدناه لإنشاء التقرير الخاص بك.

<<foreach \[in managers\]>>Manager: <<\[Name\]>>
Contracts:
<<foreach \[in Contract\]>>- <<\[Client.Name\]>> ($<<\[Price\]>>)
<</foreach>>
<</foreach>>

C # خطوات إنشاء تقرير PDF من XML

تسمح لك الخطوات التالية بأتمتة إنشاء تقارير PDF من بيانات XML وفقًا للقالب المحدد.

  • حدد ملف بيانات XML ، ملف قالب نصي ، وملفات تقرير إخراج PDF.
  • مثيل XMLDataSoure بملف بيانات XML.
  • أنشئ DataSourceInfo بمصدر بيانات XML محدد.
  • قم باستدعاء طريقة AssembleDocument لإنشاء تقرير PDF.

يقوم الكود التالي بتنفيذ الخطوات المذكورة أعلاه ويقوم بإنشاء ملف PDF من مصدر بيانات XML باستخدام C #.

// قم بإنشاء تقرير PDF من بيانات XML باستخدام قالب TXT في CSharp
// تحديد ملفات مصدر البيانات والقالب وتقرير الإخراج.
string xmlDataSource = @"dataPath/Managers.xml";
string templateFilePath = @"templatePath/xml-template.txt";
string reportFilePath = @"reportsPath/xml-to-pdf-report.pdf";
// تحميل مصدر بيانات XML
XmlDataSource dataSource = new XmlDataSource(xmlDataSource);
// قم بتجميع المستند لإنشاء ملف PDF
DocumentAssembler assembler = new DocumentAssembler();
assembler.AssembleDocument(templateFilePath, reportFilePath, new DataSourceInfo(dataSource, "managers"));

إنشاء تقرير MS Word من بيانات XML في C

وعلى نفس المنوال ، يمكنك أيضًا إنشاء التقرير بتنسيق MS Word DOC / DOCX باستخدام نفس بيانات XML. لن يكون هناك اختلاف في الكود عن الرمز الذي ناقشناه أعلاه ، باستثناء أنه يجب عليك تغيير اسم ملف الإخراج.

  • قم بتحميل ملف بيانات XML.
  • تحديد القالب بتنسيق TXT أو DOCX.
  • قم بتعيين تنسيق مستند تقرير الإخراج كـ DOCX.
  • قم بتوفير ملف بيانات XML والقالب ومسار ملف الإخراج إلى DocumentAssembler لتحويل XML إلى DOCX.

تقوم الكود التالي بتحويل XML وإنشاء ملف DOCX باستخدام القالب المحدد باستخدام C #.

// قم بإنشاء تقرير MS Word من بيانات XML باستخدام قالب نصي في CSharp
// تحديد ملفات مصدر البيانات والقالب وتقرير الإخراج.
string xmlDataSource = @"dataPath/Managers.xml";
string templateFilePath = @"templatePath/xml-template.txt";
string reportFilePath = @"reportsPath/xml-to-word-report.docx";
// تحميل مصدر بيانات XML
XmlDataSource dataSource = new XmlDataSource(xmlDataSource);
// قم بتجميع المستند لإنشاء تقرير Word
DocumentAssembler assembler = new DocumentAssembler();
assembler.AssembleDocument(templateFilePath, reportFilePath, new DataSourceInfo(dataSource, "managers"));

احصل على ترخيص API مجاني

يمكنك الحصول على ترخيص مؤقت مجاني من أجل استخدام واجهة برمجة التطبيقات بدون قيود التقييم.

استنتاج

باختصار ، لقد تعلمت تحويل بيانات XML إلى تنسيق PDF كتقرير باستخدام C # مع تطبيق .NET. بالإضافة إلى ذلك ، ناقشنا إنشاء التقرير بتنسيق DOC / DOCX من نفس XML باستخدام النموذج. بعد قراءة هذه السلسلة من منشورات إنشاء التقارير ؛ قم بإنشاء تقارير PDF و MS Word من JSON ، CSV ، XML ، يمكنك تطوير تقرير بناء تطبيق .NET.

لمزيد من المعلومات حول GroupDocs.Assembly والخيارات والأمثلة ، قم بزيارة التوثيق ومستودع GitHub. لمزيد من الاستفسارات ، اتصل بنا عبر المنتدى.

أنظر أيضا