تُستخدم ملفات CSV قيم مفصولة بفواصل على نطاق واسع لتبادل البيانات بين التطبيقات. عندما تريد ترجمة هذه البيانات إلى معلومات قابلة للتقديم وذات مغزى ، تحتاج إلى تحويلها إلى تنسيق آخر. في إحدى منشوراتنا ، لقد رأينا كيفية تحويل بيانات CSV في التقارير باستخدام Java. ستوجهك هذه المقالة إلى تحويل بيانات CSV إلى تقارير PDF و MS Word DOC / DOCX باستخدام C # باستخدام قالب بسيط.
يتم تناول الموضوعات التالية أدناه:
إنشاء تقرير .NET API
GroupDocs.Assembly يوفر .NET Report API لأتمتة إنشاء التقرير. في هذه المقالة ، استخدمت GroupDocs.Assembly for .NET لإنشاء تقارير من بيانات CSV المحددة ونموذج تنسيق TXT. كما أنه يدعم مصادر بيانات متعددة مثل JSON و XML وأيضًا من ملفات MS Word و Excel و PowerPoint كملفات بيانات.
يمكنك تنزيل مثبت DLL أو MSI من قسم التنزيلات أو تثبيت API في تطبيق .NET عبر NuGet.
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 بملف بيانات CSV وخيارات التحميل.
- قم بإنشاء DataSourceInfo بمصدر البيانات المحدد.
- باستخدام DocumentAssembler ، قم باستدعاء الأسلوب AssembleDocument مع ملف القالب المحدد وملف الإخراج و 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 لإنشاء تقرير 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 مجاني
يمكنك الحصول على ترخيص مؤقت مجاني من أجل استخدام واجهة برمجة التطبيقات بدون قيود التقييم.
استنتاج
في الختام ، تعلمت تحويل بيانات CSV إلى تقارير PDF و MS Word باستخدام C #. يجب أن تكون الآن واثقًا من إنشاء تطبيق إنشاء تقارير .NET الخاص بك عن طريق تحويل بيانات CSV إلى تنسيق PDF. وبالمثل ، يمكنك أيضًا إنشاء تقارير باستخدام مصادر بيانات أخرى مثل JSON و XML.
لمزيد من المعلومات حول API ، يمكنك زيارة التوثيق ومستودع GitHub. في حالة وجود مزيد من الاستفسارات والغموض ، اتصل بالدعم المجاني على المنتدى.