تتناول هذه المقالة مشكلة تنسيق بيانات JSON الأولية في تنسيق تقرير قابل للتقديم وسهل الفهم داخل تطبيق .NET. سنقوم بتحويل بيانات JSON إلى تقارير PDF و DOCX في C # باستخدام قوالب بسيطة.

قم بإنشاء PDF أو Word Report من JSON في CSharp

NET API لإنشاء التقارير

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

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

PM> Install-Package GroupDocs.Assembly

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

لنبدأ بالخطوات التي ستقودك إلى تحويل بيانات JSON إلى تقرير PDF منسق في C #.

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

بيانات JSON

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

\[
	{
		"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>>

C # خطوات لتحويل JSON إلى PDF Report

تعمل الخطوات التالية لرمز C # على أتمتة تحويل بيانات JSON إلى تقرير PDF وفقًا للقالب المحدد.

  • حدد بيانات JSON وملف القالب ومسارات ملف تقرير إخراج PDF.
  • مثيل JsonDataSoure بملف بيانات JSON.
  • أنشئ DataSourceInfo باستخدام JsonDataSource محدد.
  • قم باستدعاء طريقة AssembleDocument لفئة DocumentAssembler لإنشاء تقرير PDF من بيانات JSON المتوفرة والقالب المحدد.
// قم بإنشاء تقرير PDF من بيانات JSON باستخدام قالب TXT في C # باستخدام GroupDocs.Assembly API
// تحديد ملفات مصدر البيانات والقالب وتقرير الإخراج.
const string strDataSource = "dataPath/ManagerData.json";
const string strDocumentTemplate = "templatePath/template.txt";
const string strDocumentReport = "reportsPath/reportFromJSON.pdf";
// إنشاء مصدر بيانات JSON
JsonDataSource dataSource = new JsonDataSource(CommonUtilities.GetDataSourceDocument(strDataSource));
// انشاء تقرير
DocumentAssembler assembler = new DocumentAssembler();
assembler.AssembleDocument(CommonUtilities.GetSourceDocument(strDocumentTemplate),
    CommonUtilities.SetDestinationDocument(strDocumentReport),
    new DataSourceInfo(dataSource, "managers"));

سيقوم الكود بإنتاج تقرير PDF كما هو موضح في الشكل أعلاه. يمكنك أيضًا الاختبار والإصدارات السابقة والأمثلة المشابهة من مستودع جيثب.

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

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

  • تحديد نفس القالب بتنسيق DOCX.
  • قم بتعيين تنسيق مستند تقرير الإخراج كـ DOCX.
  • سيظل باقي الكود كما هو لإنشاء تقرير MS Word DOCX من بيانات JSON.
// قم بإنشاء تقرير Word من بيانات JSON باستخدام قالب DOCX في C # باستخدام GroupDocs.Assembly API
// تحديد ملفات مصدر البيانات والقالب وتقرير الإخراج.
const string strDataSource = "dataPath/ManagerData.json";
const string strDocumentTemplate = "templatePath/template.docx";
const string strDocumentReport = "reportsPath/reportFromJSON.docx";
// إنشاء مصدر بيانات JSON
JsonDataSource dataSource = new JsonDataSource(CommonUtilities.GetDataSourceDocument(strDataSource));
// انشاء تقرير
DocumentAssembler assembler = new DocumentAssembler();
assembler.AssembleDocument(CommonUtilities.GetSourceDocument(strDocumentTemplate),
    CommonUtilities.SetDestinationDocument(strDocumentReport),
    new DataSourceInfo(dataSource, "managers"));

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

استنتاج

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

أنظر أيضا