تُستخدم ملفات CSV ([قيم مفصولة بفواصل][3] على نطاق واسع لتبادل البيانات بين التطبيقات. عندما تريد ترجمة هذه البيانات إلى معلومات قابلة للتقديم وذات مغزى ، تحتاج إلى تحويلها إلى تنسيق آخر. في إحدى منشوراتنا ، لقد رأينا [كيفية تحويل بيانات CSV في التقارير باستخدام Java][4]. ستوجهك هذه المقالة إلى تحويل بيانات CSV إلى تقارير PDF و MS Word DOC / DOCX باستخدام C # باستخدام قالب بسيط.
يتم تناول الموضوعات التالية أدناه:
- [إنشاء تقرير .NET API][5]
- [إنشاء تقرير PDF من بيانات CSV][6]
- [إنشاء تقرير MS Word من بيانات CSV][7]
إنشاء تقرير .NET API
[GroupDocs.Assembly][8] يوفر .NET Report API لأتمتة إنشاء التقرير. في هذه المقالة ، استخدمت [GroupDocs.Assembly for .NET][9] لإنشاء تقارير من بيانات CSV المحددة ونموذج تنسيق TXT. كما أنه يدعم مصادر بيانات متعددة مثل JSON و XML وأيضًا من ملفات MS Word و Excel و PowerPoint كملفات بيانات.
يمكنك تنزيل مثبت DLL أو MSI من [قسم التنزيلات][10] أو تثبيت API في تطبيق .NET عبر [NuGet][11].
PM> Install-Package GroupDocs.Assembly
إنشاء تقرير PDF من بيانات CSV في C
لنبدأ بتحويل البيانات المفصولة بفواصل إلى ملف PDF قابل للتقديم. ستوجهك الخطوات التالية إلى تحويل بيانات CSV إلى تقرير PDF منسق.
- تحميل مصدر بيانات CSV.
- حدد النموذج وفقًا لبيانات CSV.
- توفير مصدر بيانات CSV ونموذج لطريقة بسيطة لإنشاء تقرير PDF.
بيانات CSV
للحصول على تقرير PDF ، سأستخدم نموذج بيانات CSV التالي لأفراد مختلفين مع بيانات كل منهم عن الأعمار وتاريخ الميلاد.
Name,Age,Birth
John Doe,32,4/1/1989 16:00
Jane Doe,29,1/31/1992 7:00
John Smith,53,3/8/1968 13:00
قالب
ستكون الخطوة التالية هي تحديد القالب بتنسيق TXT أو DOCX. التالي هو القالب المستخدم في هذا المثال ويسمح بتكرار قائمة الأشخاص بتفاصيلهم.
<<foreach \[in persons\]>>Name: <<\[Name\]>>, Age: <<\[Age\]>>, Date of Birth: <<\[Birth\]:"dd.MM.yyyy">>
<</foreach>>
Average age: <<\[persons.Average(p => p.Age)\]>>
خطوات إنشاء تقرير PDF من CSV في C
دليل الخطوات التالية حول تحويل بيانات CSV إلى تقرير PDF وفقًا للقالب المحدد باستخدام C # مع .NET Reporting API.
- حدد ملف بيانات CSV وملف القالب ومسارات ملف إخراج PDF.
- مثيل [CsvDataSoure][12] بملف بيانات CSV وخيارات التحميل.
- قم بإنشاء [DataSourceInfo][13] بمصدر البيانات المحدد.
- باستخدام [DocumentAssembler][14] ، قم باستدعاء الأسلوب [AssembleDocument][15] مع ملف القالب المحدد وملف الإخراج و DataSourceInfo للحصول على تقرير PDF كمخرج.
يوضح الكود التالي كيفية تحويل بيانات CSV إلى تقرير PDF في C #.
// قم بإنشاء تقرير PDF من بيانات CSV باستخدام قالب TXT في C # باستخدام GroupDocs.Assembly API
// تحديد ملفات مصدر البيانات والقالب وتقرير الإخراج.
string csvDataSource = @"path/person.csv";
string templateFilePath = @"path/csv-template.txt";
string reportFilePath = @"path/csv-to-pdf-report.pdf";
// تحميل مصدر بيانات CSV
CsvDataSource dataSource = new CsvDataSource(csvDataSource, new CsvDataLoadOptions(true));
// إنشاء تقرير بتنسيق PDF
DocumentAssembler assembler = new DocumentAssembler();
assembler.AssembleDocument(templateFilePath, reportFilePath, new DataSourceInfo(dataSource, "persons"));
إنشاء تقرير MS Word من بيانات CSV في C
إذا كنت تريد أي تحرير يدوي في التقرير الذي تم إنشاؤه تلقائيًا ، فيمكنك أيضًا الحصول على الإخراج كمستند MS Word. ستكون العملية مشابهة جدًا لعملية إنشاء تقرير PDF أعلاه. ستوجه الخطوات التالية لإنشاء تقرير DOC / DOCX من بيانات CSV:
- قم بتحميل بيانات CSV من ملف.
- تحديد القالب بتنسيق TXT أو DOCX.
- قم بتعيين تنسيق مستند تقرير الإخراج كـ DOC / DOCX.
- قم باستدعاء الأسلوب [AssembleDocument][16] لإنشاء تقرير MS Word DOCX من بيانات CSV.
يوضح الكود التالي كيفية تحويل بيانات CSV إلى تقرير DOCX باستخدام C #.
// قم بإنشاء تقرير Word DOCX من بيانات CSV باستخدام قالب TXT في C # باستخدام GroupDocs.Assembly API
// تحديد ملفات مصدر البيانات والقالب وتقرير الإخراج.
string csvDataSource = @"path/person.csv";
string templateFilePath = @"path/csv-template.txt";
string reportFilePath = @"path/csv-to-pdf-report.docx";
// تحميل مصدر بيانات CSV
CsvDataSource dataSource = new CsvDataSource(csvDataSource, new CsvDataLoadOptions(true));
// قم بإنشاء تقرير بتنسيق DOCX
DocumentAssembler assembler = new DocumentAssembler();
assembler.AssembleDocument(templateFilePath, reportFilePath, new DataSourceInfo(dataSource, "persons"));
احصل على ترخيص API مجاني
يمكنك [الحصول على ترخيص مؤقت مجاني][17] من أجل استخدام واجهة برمجة التطبيقات بدون قيود التقييم.
استنتاج
في الختام ، تعلمت تحويل بيانات CSV إلى تقارير PDF و MS Word باستخدام C #. يجب أن تكون الآن واثقًا من إنشاء تطبيق إنشاء تقارير .NET الخاص بك عن طريق تحويل بيانات CSV إلى تنسيق PDF. وبالمثل ، يمكنك أيضًا إنشاء تقارير باستخدام مصادر بيانات أخرى مثل JSON و XML.
لمزيد من المعلومات حول API ، يمكنك زيارة [التوثيق][18] ومستودع [GitHub][19]. في حالة وجود مزيد من الاستفسارات والغموض ، اتصل بالدعم المجاني على [المنتدى][20].
أنظر أيضا
- [إنشاء تقارير من بيانات JSON باستخدام C #][21]
- [إنشاء تقارير من بيانات CSV باستخدام Java][22]
[1]: https://docs.fileformat.com/spreadsheet/csv/) [2]: https://blog.groupdocs.com/ar/assembly/generate-reports-from-csv-data-in-java/ [3]: https://docs.fileformat.com/spreadsheet/csv/) [4]: https://blog.groupdocs.com/ar/assembly/generate-reports-from-csv-data-in-java/ [5]: #report-generator-dotnet-api [6]: #csv-to-pdf-report-csharp [7]: #csv-to-docx-report-java [8]: https://products.groupdocs.com/assembly/java [9]: https://products.groupdocs.com/assembly/net/ [10]: https://downloads.groupdocs.com/assembly/net [11]: https://www.nuget.org/packages/groupdocs.assembly [12]: https://apireference.groupdocs.com/net/assembly/groupdocs.assembly.data/csvdatasource [13]: https://apireference.groupdocs.com/assembly/net/groupdocs.assembly/datasourceinfo [14]: https://apireference.groupdocs.com/assembly/net/groupdocs.assembly/documentassembler [15]: https://apireference.groupdocs.com/assembly/net/groupdocs.assembly/documentassembler/methods/assembledocument/index [16]: https://apireference.groupdocs.com/assembly/net/groupdocs.assembly/documentassembler/methods/assembledocument/index [17]: https://purchase.groupdocs.com/temporary-license [18]: https://docs.groupdocs.com/assembly/net/ [19]: https://github.com/groupdocs-assembly [20]: https://forum.groupdocs.com/c/assembly [21]: https://blog.groupdocs.com/ar/assembly/generate-reports-from-json-data-in-csharp/ [22]: https://blog.groupdocs.com/ar/assembly/generate-reports-from-csv-data-in-java/