Aspose.OMR Cloud SDK for Java به توسعه‌دهندگان جاوا امکان پردازش فرم‌های تشخیص علامت نوری (Optical Mark Recognition) و استخراج داده‌ها به‌صورت کارآمد را می‌دهد. این کتابخانه همچنین قابلیت‌های قدرتمند تبدیل اسناد را فراهم می‌کند و به شما اجازه می‌دهد تا با استفاده از Java cloud sdk و با حداقل کد، PDF را به CSV تبدیل کنید. در این آموزش گام به گام نصب SDK، پیکربندی گزینه‌های تبدیل و مدیریت خطاهای رایج را مرور خواهیم کرد. در پایان، یک روش آماده برای استفاده جهت تبدیل PDF به CSV از طریق Java خواهید داشت.

پیش‌نیازها و راه‌اندازی

برای دنبال کردن این راهنما به موارد زیر نیاز دارید:

  • Java 8 یا بالاتر نصب شده بر روی ماشین توسعه شما.
  • Maven 3.5+ برای مدیریت وابستگی‌ها.
  • یک حساب Aspose Cloud با شناسه مشتری و رمز مشتری. می‌توانید آنها را از پیشخوان Aspose Cloud دریافت کنید.

آخرین نسخه را از این صفحه دانلود کنید.

کتابخانه را با Maven نصب کنید:

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-omr-cloud</artifactId>
    <version>23.12</version>
</dependency>

یا از خط فرمان استفاده کنید:

mvn install com.aspose:aspose-omr-cloud

پس از افزودن وابستگی، احراز هویت را در پروژه Java خود پیکربندی کنید:

import com.aspose.omr.client.ApiClient;
import com.aspose.omr.client.auth.OAuthCredentials;

OAuthCredentials credentials = new OAuthCredentials("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
ApiClient apiClient = new ApiClient(credentials);

برای جزئیات بیشتر، به مستندات رسمی مراجعه کنید.

ویژگی‌های کلیدی Aspose.OMR Cloud SDK for Java

  • پردازش OMR با دقت بالا - پاسخ‌های علامت‌دار را با حداقل خطاهای مثبت شناسایی کنید.
  • تبدیل داخلی PDF به CSV - داده‌های فرم را مستقیماً به یک فایل CSV ساختار یافته استخراج کنید.
  • معماری بومی ابری - تمام عملیات بر روی سرورهای Aspose اجرا می‌شوند و کلاینت شما را سبک نگه می‌دارند.
  • مرجع جامع API - هر متد در API Reference مستند شده است.

پیکربندی گزینه‌های ورودی PDF و خروجی CSV

API تبدیل یک فایل PDF و مجموعه‌ای از گزینه‌های خروجی را می‌پذیرد. گزینه‌های معمول شامل:

  • outputDelimiter - کاراکتری که برای جدا کردن ستون‌ها استفاده می‌شود (به‌صورت پیش‌فرض کاما).
  • includeHeader - آیا ردیف سرصفحه با نام فیلدها اضافه شود یا نه.
  • encoding - رمزگذاری کاراکترها برای فایل CSV (مثلاً UTF‑8).

می‌توانید این گزینه‌ها را از طریق کلاس CsvExportOptions تنظیم کنید:

CsvExportOptions options = new CsvExportOptions();
options.setOutputDelimiter(',');
options.setIncludeHeader(true);
options.setEncoding("UTF-8");

مدیریت خطاهای رایج تبدیل و عیب‌یابی

هنگام تبدیل PDF به CSV، ممکن است با موارد زیر مواجه شوید:

  • Unsupported PDF features - SDK یک خطای 400 با پیام توصیفی برمی‌گرداند.
  • Invalid credentials - پاسخ 401 نشان‌دهنده مشکلات احراز هویت است.
  • File size limits - ممکن است برای تبدیل، PDFهای بزرگ نیاز به تقسیم داشته باشند.

همیشه استثنای ApiException که توسط SDK پرتاب می‌شود را بررسی کنید:

try {
    // conversion call
} catch (ApiException ex) {
    System.err.println("Error: " + ex.getMessage());
    // additional logging or retry logic
}

بهترین شیوه‌ها برای قالب‌بندی CSV و یکپارچگی داده‌ها

  • CSV تولید شده را با یک ابزار بررسی طرح (schema checker) قبل از وارد کردن به سیستم‌های downstream اعتبارسنجی کنید.
  • از includeHeader برای خود‑توضیحی کردن فایل استفاده کنید.
  • بر اساس locale مخاطبان هدف، یک جداکننده مناسب انتخاب کنید.
  • فضای خالی را از هر cell حذف کنید تا از کاراکترهای مخفی که می‌توانند تجزیه را خراب کنند، جلوگیری شود.

مراحل تبدیل PDF به CSV با استفاده از Java Cloud SDK

  1. مقداردهی اولیهٔ کلاینت API - یک نمونهٔ ApiClient با اعتبارهای OAuth خود ایجاد کنید.
  2. بارگذاری فایل PDF - از متد uploadFile برای ارسال سند منبع به ابر استفاده کنید.
  3. پیکربندی گزینه‌های خروجی CSV - جداکننده، شامل کردن سرصفحه و رمزگذاری را بر حسب نیاز تنظیم کنید.
  4. فراخوانی متد تبدیل - convertPdfToCsv را صدا بزنید و جریان پاسخ را دریافت کنید.
  5. ذخیره خروجی CSV - آرایه بایتی بازگشتی را در یک فایل محلی بنویسید و محتویات آن را بررسی کنید.

برای فراخوانی تبدیل، به متد ConvertPdfToCsv در مرجع API مراجعه کنید.

تبدیل PDF به CSV با استفاده از Java Cloud SDK - مثال کامل کد

مثال زیر یک تبدیل کامل end‑to‑end را نشان می‌دهد، شامل مدیریت خطا و پاک‌سازی منابع.

توجه: این مثال کد عملکرد اصلی را نشان می‌دهد. قبل از استفاده از آن در پروژه خود، مطمئن شوید مسیرهای فایل (input.pdf, output.csv) را به مکان‌های واقعی خود به‌روزرسانی کنید، اطمینان حاصل کنید تمام وابستگی‌های مورد نیاز به‌درستی نصب شده‌اند، و به‌طور کامل در محیط توسعه خود تست کنید. اگر با مشکلی مواجه شدید، لطفاً به مستندات رسمی مراجعه کنید یا برای دریافت کمک به تیم پشتیبانی مراجعه کنید.

تبدیل PDF به CSV از طریق REST API با استفاده از cURL

اگر ترجیح می‌دهید کتابخانه را در ساخت خود گنجانده نکنید، می‌توانید مستقیماً از طریق REST به نقطه انتهای تبدیل فراخوانی کنید. این رویکرد برای خطوط لوله CI یا محیط‌هایی که نصب کتابخانه Java امکان‌پذیر نیست، مفید است.

1. احراز هویت و دریافت توکن دسترسی

curl -X POST "https://api.aspose.cloud/connect/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

پاسخ شامل یک access_token است که در تماس‌های بعدی استفاده خواهید کرد.

۲. بارگذاری PDF منبع

curl -X PUT "https://api.aspose.cloud/v4.0/omr/storage/file/input.pdf" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/pdf" \
  --data-binary "@input.pdf"

3. اجرای تبدیل PDF به CSV

curl -X POST "https://api.aspose.cloud/v4.0/omr/pdf/toCsv" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "fileInfo": { "filePath": "input.pdf" },
        "outputOptions": {
            "outputDelimiter": ",",
            "includeHeader": true,
            "encoding": "UTF-8"
        }
      }' -o output.csv

دستور خروجی output.csv را مستقیماً در پوشه کاری شما دانلود می‌کند.

برای دریافت فهرست کامل پارامترها و مثال‌های اضافی، مستندات API.

نتیجه‌گیری

شما اکنون یاد گرفته‌اید که چگونه PDF را به CSV با استفاده از Java cloud SDK و Aspose.OMR Cloud SDK for Java تبدیل کنید. این راهنما نصب، احراز هویت، پیکربندی گزینه‌های خروجی CSV، مدیریت خطا و بهترین شیوه‌ها برای یکپارچگی داده‌ها را پوشش داد. به‌خاطر داشته باشید برای استفاده در تولید، یک لایسنس معتبر از صفحه قیمت‌گذاری Aspose.OMR Cloud دریافت کنید؛ یک لایسنس موقت برای ارزیابی در دسترس است. ادغام این تبدیل در برنامه‌های Java شما استخراج داده‌ها از فرم‌های OMR را ساده‌سازی کرده و کارایی کلی جریان کار را بهبود می‌بخشد.

پرسش‌های متداول

چگونه PDF را به CSV با استفاده از Java cloud sdk تبدیل کنم؟
از متد convertPdfToCsv کلاس OmrApi پس از تنظیم CsvExportOptions استفاده کنید. مثال کامل کد در این مقاله گام‌های دقیق را نشان می‌دهد.

آیا می‌توانم PDF را به CSV تبدیل کنم از طریق Java بدون SDK؟
در حالی که می‌توانید یک تجزیه‌گر سفارشی پیاده‌سازی کنید، کتابخانه Aspose.OMR Cloud یک راه‌حل قابل اعتماد و تست‌شده ارائه می‌دهد که چیدمان‌های پیچیده OMR و نکات PDF را مدیریت می‌کند.

خطاهای رایج هنگام تبدیل PDF به CSV چیست و چگونه می‌توانم آن‌ها را مدیریت کنم؟
مسائل معمول شامل ویژگی‌های پشتیبانی‌نشده PDF یا خطاهای احراز هویت هستند. SDK خطای ApiException را با پیام‌های جزئیات‌دار پرتاب می‌کند که می‌توانید آن را دریافت و لاگ کنید، همان‌طور که در مثال نشان داده شده است.

آیا مثال تبدیل PDF به CSV در جاوا وجود دارد؟
بله، مثال کامل کد بالا به عنوان یک مثال آماده برای اجرا برای تبدیل PDF به CSV در جاوا عمل می‌کند و یک java method to convert PDF to CSV عملی را نشان می‌دهد.

بیشتر بخوانید