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

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

واجهة برمجة تطبيقات Java لإنشاء التقارير - من XML إلى PDF و WORD

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

تنزيل أو تكوين

يمكنك تنزيل ملف JAR من قسم التنزيلات ، أو مجرد الحصول على المستودع وتكوينات التبعية لـ pom.xml لتطبيقات Java المستندة إلى المخضرم.

<repository>
	<id>GroupDocsJavaAPI</id>
	<name>GroupDocs Java API</name>
	<url>http://repository.groupdocs.com/repo/</url>
</repository>
<dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-assembly</artifactId>
        <version>21.4</version> 
</dependency>

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

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

  • قم بتحميل مصدر بيانات XML
  • حدد القالب وفقًا لبيانات XML الخاصة بك
  • توفير مصدر بيانات XML والقالب لطريقة لإنشاء التقرير.
XML إلى PDF Report في Java

بيانات XML

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

<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. هذا يسمح بالتكرار على المديرين وعملائهم المعنيين. بعد ذلك ، استخدم الكود المذكور أدناه لإنشاء التقرير.

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

خطوات Java لإنشاء تقرير PDF من XML

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

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

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

// قم بإنشاء تقرير PDF من بيانات XML باستخدام قالب TXT في Java
// تحديد ملفات مصدر البيانات والقالب وتقرير الإخراج.
String xmlDataSource = "dataPath/Managers.xml";
String templateFilePath = "templatePath/template.txt";
String reportFilePath = "reportsPath/PDFreportFromXML.pdf";

// تحميل مصدر بيانات XML
XmlDataSource datasource = new XmlDataSource(xmlDataSource);
DataSourceInfo dataSourceInfo = new DataSourceInfo(datasource,"managers");

// قم بتجميع المستند لإنشاء ملف PDF
DocumentAssembler assembler = new DocumentAssembler();
assembler.assembleDocument(templateFilePath, reportFilePath,dataSourceInfo);

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

وبالمثل ، يمكنك إنشاء تقرير MS Word DOC / DOCX من نفس بيانات XML في Java. لن يكون هناك فرق ، باستثناء تغيير اسم ملف الإخراج.

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

الكود التالي يحول XML وينشئ ملف DOCX باستخدام القالب المحدد في Java.

// قم بإنشاء تقرير MS Word من بيانات XML باستخدام قالب نصي في Java
// تحديد ملفات مصدر البيانات والقالب وتقرير الإخراج.
String xmlDataSource = "dataPath/Managers.xml";
String templateFilePath = "templatePath/template.docx";
String reportFilePath = "reportsPath/WordReportFromXML.docx";

//إنشاء مثيل لمصدر بيانات XML
XmlDataSource datasource = new XmlDataSource(xmlDataSource);
DataSourceInfo dataSourceInfo = new DataSourceInfo(datasource,"managers");

//تجميع الوثيقة 
DocumentAssembler assembler = new DocumentAssembler();
assembler.assembleDocument(templateFilePath, reportFilePath,dataSourceInfo);

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

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

استنتاج

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

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

أنظر أيضا