گزارش‌ها را از داده‌های اکسل در C# ایجاد کنید

شما می‌توانید به راحتی گزارش‌های سفارشی را از جداول داده‌های مایکروسافت اکسل ایجاد کنید. این گزارش‌ها می‌توانند به‌صورت برنامه‌نویسی با استفاده از صفحات گسترده اکسل به‌عنوان یک جدول داده تولید شوند. این مقاله بر روی نحوه تولید گزارش از داده‌های اکسل با استفاده از C# تمرکز خواهد کرد.

موضوعات زیر در این مقاله بررسی می‌شود:

C# API برای تولید گزارشات

من از API GroupDocs.Assembly for .NET برای تولید گزارش از داده‌های Excel استفاده خواهم کرد. این API به شما امکان می‌دهد تا برنامه‌های قدرتمند اتوماسیون اسناد و تولید گزارش بسازید. این API پشتیبانی از استخراج داده‌ها از منابع داده مختلفی مانند XML، JSON و CSV را فراهم می‌کند. شما می‌توانید به راحتی گزارش‌هایی را در تمام فرمت‌های فایل معمولی مانند PDF، HTML و Microsoft Word تولید کنید. این API می‌تواند برای توسعه برنامه‌ها در هر محیط توسعه‌ای که به پلتفرم .NET هدف‌گذاری شده باشد، استفاده شود.

You can either download the DLL of the API or install it using the NuGet.

Install-Package GroupDocs.Assembly

گزارش‌های تولید شده از داده‌های اکسل با استفاده از C#

شما می‌توانید گزارش‌ها را از داده‌های اکسل با پیروی از مراحل ساده زیر ایجاد کنید:

  1. Get Excel data source.
  2. تعریف template با توجه به داده‌های Excel.
  3. Provide data source and template to simple C# code for report generation

Excel Data

داده‌های جدولی موجود در صفحه‌گسترده اکسل می‌تواند به عنوان یک منبع داده برای تولید گزارش‌ها استفاده شود. من از داده‌های نمونه اکسل زیر برای تولید گزارش استفاده خواهم کرد. این داده‌های قرارداد مشتریان با مدیران مربوطه و قیمت قرارداد توافق شده آنهاست.

منبع داده اکسل

منبع داده اکسل

الگو

اکنون الگوی زیر را در فایل DOCX تعریف کنید. این امکان را برای تکرار داده‌های قراردادها و مدیران مربوطه آنها با قیمت قرارداد فراهم می‌کند. پس از آن، می‌توانید به کد برای تولید گزارش بروید.

قالب گزارش

قالب گزارش

Excel را به گزارش Word در C# تبدیل کنید

لطفاً مراحل ذکر شده در زیر را برای اتوماتیک کردن تبدیل داده‌های Excel به گزارش DOCX بر اساس الگو دنبال کنید.

  • تعریف مسیرهای فایل داده اکسل، فایل الگو و فایل گزارش خروجی DOCX
  • تعریف DocumentTableOptions
  • Create DocumentTable with defined Excel data file and DocumentTableOptions
  • متد AssembleDocument کلاس DocumentAssembler را فراخوانی کنید تا گزارش را از داده‌های Excel ارائه شده و الگوی تعریف شده تولید کنید.

کد نمونه زیر نشان می‌دهد چگونه می‌توان از منبع داده Excel گزارشی را مطابق با قالب تعریف‌شده با استفاده از C# تولید کرد.

string ExcelDataFile = "Contracts_Data.xlsx";
string strDocumentTemplate = "Template.docx";
string strDocumentReport = "Output.docx";

// تعریف جدول داده از فایل اکسل
DocumentTableOptions options = new DocumentTableOptions 
{ 
    FirstRowContainsColumnNames = true 
};
DocumentTable table = new DocumentTable(ExcelDataFile, 0, options);

// یک سند با استفاده از جدول سند خارجی به عنوان منبع داده تهیه کنید.
DocumentAssembler assembler = new DocumentAssembler();
assembler.AssembleDocument(strDocumentTemplate, strDocumentReport,
    new DataSourceInfo(table, "contracts"));

نمونه کد بالا گزارشی به شرح زیر تولید خواهد کرد.

گزارش تولید شده

گزارش تولید شده

کلاس DocumentTableOptions مجموعه‌ای از گزینه‌ها را برای کنترل استخراج داده‌ها از یک جدول سند فراهم می‌کند. در اینجا، خاصیت FirstRowContainsColumnNames به true تنظیم شده است.

کلاس DocumentTable دسترسی به داده‌های یک جدول (یا صفحه گسترده) که در یک سند خارجی قرار دارد را فراهم می‌کند تا در حین جمع‌آوری یک سند استفاده شود.

کلاس DocumentAssembler روش‌هایی را برای تولید گزارش‌ها بر اساس سند الگو با داده‌ها ارائه می‌دهد.

یک مجوز رایگان بگیرید

شما می‌توانید بدون محدودیت‌های ارزیابی API را با درخواست یک مجوز موقت رایگان امتحان کنید.

نتیجه‌گیری

در این مقاله، شما یاد گرفته‌اید که چگونه از داده‌های Excel گزارش تولید کنید با استفاده از C#. شما می‌توانید اطلاعات بیشتری در مورد GroupDocs.Assembly برای API .NET با استفاده از documentation بیاموزید. در صورت هرگونه ابهام، لطفاً با ما در forum تماس بگیرید.

همچنین ببینید