JSON هو تنسيق لتبادل البيانات منسق وقابل للقراءة لنقل البيانات ذات السمات. ومع ذلك ، فإن البيانات الكبيرة بتنسيق JSON ليست جيدة المظهر وسهلة الفهم. نحتاج في الغالب إلى تحويل بيانات JSON الكبيرة إلى تنسيق قابل للتقديم. ستوجهك هذه المقالة إلى تحويل بيانات JSON إلى تقارير PDF و MS Word في Java باستخدام قالب بسيط.

إنشاء تقرير Java API

سأستخدم GroupDocs.Assembly for Java API لإنشاء تقارير من بيانات JSON المتوفرة والقالب بتنسيق DOCX و TXT. كما يدعم إنشاء التقارير تلقائيًا بتنسيقات متعددة من مصادر بيانات CSV و XML.

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

يمكنك تنزيل ملف JAR من قسم التنزيلات ، أو الحصول على المستودع وتكوينات التبعية لـ pox.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.1</version> 
</dependency>

إنشاء تقرير PDF من بيانات JSON في جافا

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

  • احصل على مصدر بيانات JSON
  • حدد النموذج وفقًا لبيانات JSON
  • توفير مصدر بيانات JSON والقالب لرمز جافا البسيط لإنشاء التقرير.
JSON إلى PDF Report في Java

بيانات JSON

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

\[
	{
		"Name":"John Smith","Contract":\[
		{"Client":{"Name":"A Company"},"Price":1200000},
		{"Client":{"Name":"B Ltd."},"Price":750000},
		{"Client":{"Name":"C & D"},"Price":350000}\]
	},
	{
		"Name":"Tony Anderson","Contract":\[
		{"Client":{"Name":"E Corp."},"Price":650000},
		{"Client":{"Name":"F & Partners"},"Price":550000}\]
	},
	{
		"Name":"July James","Contract":\[
		{"Client":{"Name":"G & Co."},"Price":350000},
		{"Client":{"Name":"H Group"},"Price":250000},
		{"Client":{"Name":"I & Sons"},"Price":100000},
		{"Client":{"Name":"J Ent."},"Price":100000}\]
	}
\]

قالب

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

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

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

تتيح الخطوات التالية ورمز Java التحويل التلقائي لبيانات JSON إلى تقرير PDF وفقًا للقالب المحدد.

  • حدد ملف بيانات JSON وملف قالب .txt ومسارات ملف تقرير إخراج PDF.
  • مثيل JsonDataSoure مع ملف بيانات JSON.
  • أنشئ DataSourceInfo باستخدام JsonDataSource محدد.
  • قم باستدعاء طريقة تجميع المستندات الخاصة بفئة DocumentAssembler لإنشاء تقرير PDF من بيانات JSON المتوفرة والقالب المحدد.
// قم بإنشاء تقرير PDF من بيانات JSON باستخدام قالب TXT في Java باستخدام GroupDocs.Assembly API
// تحديد ملفات مصدر البيانات والقالب وتقرير الإخراج.
String jsonFilePath = "dataPath/ManagerData.json";
String templateFilePath = "templatePath/template.txt";
String reportFilePath = "reportsPath/reportFromJSON.pdf";				
// إنشاء مصدر بيانات JSON
JsonDataSource datasource= new JsonDataSource(jsonFilePath);			  
DataSourceInfo dataSourceInfo = new DataSourceInfo(datasource,"managers");
// انشاء تقرير
DocumentAssembler assembler = new DocumentAssembler();
assembler.assembleDocument(templateFilePath,reportFilePath,dataSourceInfo);

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

وبالمثل ، مثل إنشاء تقرير PDF أعلاه ، يمكنك بسهولة إنشاء تقرير DOCX من خلال:

  • تحديد نفس القالب بتنسيق DOCX.
  • قم بتعيين تنسيق مستند تقرير الإخراج كـ DOCX.
  • سيظل باقي الكود كما هو لإنشاء تقرير MS Word DOCX من بيانات JSON.
// قم بإنشاء تقرير Word من بيانات JSON باستخدام قالب DOCX في Java باستخدام GroupDocs.Assembly API
// تحديد ملفات مصدر البيانات والقالب وتقرير الإخراج.
String jsonFilePath = "dataPath/ManagerData.json";
String templateFilePath = "templatePath/template.docx";
String reportFilePath = "reportsPath/reportFromJSON.docx";			
// إنشاء مصدر بيانات JSON
JsonDataSource datasource= new JsonDataSource(jsonFilePath);			  
DataSourceInfo dataSourceInfo = new DataSourceInfo(datasource,"managers");
// انشاء تقرير
DocumentAssembler assembler = new DocumentAssembler();
assembler.assembleDocument(templateFilePath,reportFilePath,dataSourceInfo);

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

استنتاج

آمل أن تشعر بالراحة عند إنشاء تطبيق يستند إلى Java لإنشاء تقارير عن طريق تحويل بيانات JSON إلى تنسيق PDF. وبالمثل ، يمكنك إنشاء تقارير بتنسيقات أخرى مثل DOCX باستخدام مصادر بيانات أخرى مثل CSV و XML.

أنظر أيضا