چگونه PDF Form Field Values را به CSV در .NET صادر کنیم

این مقاله نشان می دهد که چگونه ارزش ها را از زمینه های فرم PDF (AcroForms) به CSV با استفاده از Aspose.PDF Form Exporter در .NET صادر کنید.شما یاد خواهید گرفت که اطلاعات فرم پر شده را جمع آوری کنید و آن را به عنوان یک فایل CSV استاندارد، آماده برای واردات یا تجزیه و تحلیل.

مشکل دنیای واقعی

استخراج دستی داده ها از فرم های PDF پر شده به ورق ها ناخوشایند و بدون خطا است. کسب و کارها اغلب نیاز به جمع آوری داده های میدان از چندین فرم به یک فایل CSV ساختار برای گزارش، واردات و یا اتوماسیون.

بررسی راه حل

Aspose.PDF Form Exporter برای .NET امکان صادرات خودکار ارزش های میدان فرم از هر PDF به یک فایل CSV سفارشی را فراهم می کند، جمع آوری داده ها را برای نظرسنجی ها، ثبت نام ها یا جریان های کار انطباق آسان تر می سازد.

پیش شرط

• Visual Studio 2019 یا بالاتر
• .NET 6.0 یا بالاتر
• Aspose.PDF برای .NET نصب شده از طریق NuGet

PM> Install-Package Aspose.PDF

پیاده سازی گام به گام

مرحله 1: نصب و تنظیم Aspose.PDF

فضاهای مورد نیاز را اضافه کنید:

using Aspose.Pdf.Plugins;
using System.IO;

مرحله دوم: فرم PDF را آماده کنید

مسیر را به PDF پر شده و خروجی CSV مورد نظر مشخص کنید:

string inputPdfPath = @"C:\Samples\filled_form.pdf";
string outputCsvPath = @"C:\Samples\form_data.csv";

مرحله 3: گزینه های صادرات را تنظیم کنید (محل انتخاب، دلیمیتر)

شما می توانید تمام میدان ها را صادر کنید یا نام میدان را با SelectFieldدر صورت لزوم یک دلیمیتر سفارشی تنظیم کنید (به طور پیش فرض comma است):

// Export all form fields:
var selectAllFields = new SelectField(); // (leave empty for all fields)
char delimiter = ',';

var exportOptions = new FormExporterValuesToCsvOptions(selectAllFields, delimiter);
exportOptions.AddInput(new FileDataSource(inputPdfPath));
exportOptions.AddOutput(new FileDataSource(outputCsvPath));

// To export only certain fields:
var selectFields = new SelectField { PartialName = "Field1" };
var exportOptions = new FormExporterValuesToCsvOptions(selectFields, delimiter);

مرحله چهارم: روند صادرات را اجرا کنید

استفاده از FormExporter پلاگین برای پردازش صادرات:

var plugin = new FormExporter();
ResultContainer result = plugin.Process(exportOptions);

مرحله 5: تصدیق CSV صادر شده

CSV را بخوانید و محتوای آن را بررسی کنید:

string[] csvLines = File.ReadAllLines(outputCsvPath);
foreach (var line in csvLines)
{
    Console.WriteLine(line);
}

مرحله ششم: حل اشتباهات

try
{
    ResultContainer result = plugin.Process(exportOptions);
    Console.WriteLine("Form data exported to CSV successfully.");
}
catch (Exception ex)
{
    Console.WriteLine($"Export failed: {ex.Message}");
}

نمونه کامل اجرای

using Aspose.Pdf.Plugins;
using System;
using System.IO;

class Program
{
    static void Main()
    {
        string inputPdfPath = @"C:\Samples\filled_form.pdf";
        string outputCsvPath = @"C:\Samples\form_data.csv";
        var selectAllFields = new SelectField();
        char delimiter = ',';

        var exportOptions = new FormExporterValuesToCsvOptions(selectAllFields, delimiter);
        exportOptions.AddInput(new FileDataSource(inputPdfPath));
        exportOptions.AddOutput(new FileDataSource(outputCsvPath));

        var plugin = new FormExporter();
        try
        {
            ResultContainer result = plugin.Process(exportOptions);
            Console.WriteLine("Exported form data to CSV.");
            string[] csvLines = File.ReadAllLines(outputCsvPath);
            foreach (var line in csvLines)
            {
                Console.WriteLine(line);
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Export failed: {ex.Message}");
        }
    }
}

استفاده از موارد و برنامه ها

• بررسی جمع آوری داده ها از صدها فرم پر
• ثبت نام یا صادرات داده های سفارش برای واردات به CRM / ERP
• گزارش انطباق یا حسابرسی

چالش ها و راه حل های مشترک

تحدی: انواع میدان های مخلوط یا ارزش های گمشدهراه حل: میدان های پیش اعتبار داده شده و معاملات صفر / خالی را در پردازش پایین مدیریت کنید.

تحدی: اختلافات دلیمی با داده های فرمراه حل: یک دلیمیتر متفاوت (به عنوان مثال، برچسب یا لوله) تنظیم کنید اگر ارزش های میدان شما حاوی commas باشد.

عملکرد و بهترین شیوه ها

• فرآیند جمع آوری PDF ها در یک حلقه برای صادرات در مقیاس بزرگ
• استفاده از انتخاب مربع صریح برای مجموعه های استاندارد داده
• تمیز کردن CSV صادرات برای مدیریت ایمن

نتیجه گیری

Aspose.PDF Form Exporter برای .NET به سرعت استخراج داده ها از فرم های PDF به CSV، انجام نظرسنجی، ثبت نام و یا پردازش داده های انطباق سریع تر و قابل اعتماد تر برای راه حل های .Net خود را.