Aspose.OMR Cloud SDK for Java Java geliştiricilerinin Optik İşaret Tanıma (OMR) formlarını işleyip verileri verimli bir şekilde çıkarmasını sağlar. Bu kütüphane ayrıca güçlü belge dönüştürme yetenekleri sunar ve Java bulut SDK’sı ile minimum kod kullanarak PDF dosyasını CSV formatına dönüştürmenize olanak tanır. Bu öğreticide SDK’yı kurma, dönüşüm seçeneklerini yapılandırma ve yaygın hataları ele alma konularını adım adım inceleyeceğiz. Sonunda, Java üzerinden PDF’yi CSV’ye dönüştürmek için kullanıma hazır bir metoda sahip olacaksınız.

Önkoşullar ve Kurulum

Bu kılavuzu izlemek için şunlara ihtiyacınız var:

  • Java 8 veya üzeri geliştirme makinenize kurulu.
  • Bağımlılık yönetimi için Maven 3.5+.
  • Bir Aspose Cloud hesabı, istemci kimliği ve istemci gizli anahtarı ile. Bunları Aspose Cloud Dashboard adresinden alabilirsiniz.

En son sürümü bu sayfadan indirin.

Kütüphaneyi Maven ile kurun:

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

Veya komut satırını kullanın:

mvn install com.aspose:aspose-omr-cloud

Bağımlılığı ekledikten sonra, Java projenizde kimlik doğrulamayı yapılandırın:

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);

Daha fazla ayrıntı için resmi belgeler’e bakın.

Aspose.OMR Cloud SDK for Java’ın Temel Özellikleri

  • Yüksek doğruluklu OMR işleme - işaretlenmiş cevapları minimum yanlış pozitifle tespit eder.
  • Yerleşik PDF’den CSV’ye dönüşüm - form verilerini doğrudan yapılandırılmış bir CSV dosyasına çıkarır.
  • Bulut‑yerel mimari - tüm işlemler Aspose sunucularında çalışır, istemcinizi hafif tutar.
  • Kapsamlı API referansı - her yöntem API Referansı adresinde belgelenmiştir.

PDF Girişi ve CSV Çıktı Seçeneklerini Yapılandırma

Conversion API bir PDF dosyasını ve bir dizi çıktı seçeneğini kabul eder. Tipik seçenekler şunları içerir:

  • outputDelimiter - sütunları ayırmak için kullanılan karakter (varsayılan olarak virgül).
  • includeHeader - alan adlarıyla bir başlık satırı eklenip eklenmeyeceği.
  • encoding - CSV dosyası için karakter kodlaması (ör. UTF‑8).

Bu seçenekleri CsvExportOptions sınıfı aracılığıyla ayarlayabilirsiniz:

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

Ortak Dönüşüm Hatalarını Ele Alma ve Sorun Giderme

PDF’yi CSV’ye dönüştürürken şu durumlarla karşılaşabilirsiniz:

  • Desteklenmeyen PDF özellikleri - SDK, açıklayıcı bir mesajla 400 hatası döndürür.
  • Geçersiz kimlik bilgileri - 401 yanıtı kimlik doğrulama sorunlarını gösterir.
  • Dosya boyutu sınırlamaları - Büyük PDF’ler dönüştürmeden önce bölünmesi gerekebilir.

SDK tarafından fırlatılan ApiException‘ı her zaman inceleyin:

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

CSV Biçimlendirme ve Veri Bütünlüğü için En İyi Uygulamalar

  • Oluşturulan CSV’yi, aşağı akış sistemlerine aktarmadan önce bir şema denetleyicisiyle doğrulayın.
  • includeHeader kullanarak dosyayı kendini tanımlayan hâle getirin.
  • Hedef kitlenizin yerel ayarına göre uygun bir ayırıcı seçin.
  • Ayrıştırmayı bozabilecek gizli karakterleri önlemek için her bir cell üzerindeki boşlukları kesin.

Java Cloud SDK Kullanarak PDF’yi CSV’ye Dönüştürme Adımları

  1. API istemcisini başlatın - OAuth kimlik bilgilerinizle bir ApiClient örneği oluşturun.
  2. PDF dosyasını yükleyin - uploadFile metodunu kullanarak kaynak belgeyi buluta gönderin.
  3. CSV dışa aktarma seçeneklerini yapılandırın - gerektiği gibi ayırıcı, başlık ekleme ve kodlamayı ayarlayın.
  4. Dönüştürme metodunu çağırın - convertPdfToCsv metodunu çağırın ve yanıt akışını yakalayın.
  5. CSV çıktısını kaydedin - döndürülen bayt dizisini yerel bir dosyaya yazın ve içeriğini doğrulayın.

Dönüştürme çağrısı için, API referansındaki ConvertPdfToCsv yöntemine bakın.

Java Cloud SDK Kullanarak PDF’yi CSV’ye Dönüştürme - Tam Kod Örneği

Aşağıdaki örnek, hata işleme ve kaynak temizlemesini içeren tam uçtan uca bir dönüşümü göstermektedir.

Not: Bu kod örneği temel işlevselliği gösterir. Projenizde kullanmadan önce dosya yollarını (input.pdf, output.csv) gerçek dosya konumlarınıza göre güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi belgeler adresine bakın veya destek ekibi ile iletişime geçin.

cURL kullanarak REST API üzerinden PDF’den CSV’ye Dönüştürme

Kitaplığı derlemenize dahil etmek istemezseniz, dönüşüm uç noktasını doğrudan REST üzerinden çağırabilirsiniz. Bu yaklaşım, CI boru hatları veya Java kitaplığını kurmanın mümkün olmadığı ortamlar için faydalıdır.

1. Kimlik Doğrulama ve Erişim Token’ı Al

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"

Yanıt, sonraki çağrılarda kullanacağınız bir access_token içerir.

2. Kaynak PDF’yi Yükle

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’den CSV’ye Dönüştürme İşlemini Gerçekleştir

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

Komut, ortaya çıkan output.csv dosyasını doğrudan çalışma dizininize indirir.

Parametrelerin tam listesi ve ek örnekler için, API belgelerine bakın.

Sonuç

Artık Aspose.OMR Cloud SDK for Java ile Java bulut SDK’sı kullanarak PDF’yi CSV’ye dönüştürmeyi öğrendiniz. Kılavuz, kurulum, kimlik doğrulama, CSV dışa aktarma seçeneklerinin yapılandırılması, hata yönetimi ve veri bütünlüğü için en iyi uygulamaları kapsadı. Üretim kullanımı için geçerli bir lisans almayı unutmayın; değerlendirme için geçici bir lisans mevcuttur. Bu dönüşümü Java uygulamalarınıza entegre etmek, OMR formlarından veri çıkarımını kolaylaştıracak ve genel iş akışı verimliliğini artıracaktır. Aspose.OMR Cloud pricing page

SSS

Java cloud SDK kullanarak PDF’i CSV’ye nasıl dönüştürürüm?
CsvExportOptions ayarlandıktan sonra OmrApi sınıfının convertPdfToCsv metodunu kullanın. Bu makaledeki tam kod örneği adımları gösterir.

Java ile SDK olmadan PDF’yi CSV’ye dönüştürebilir miyim?
Özel bir ayrıştırıcı uygulayabilirsiniz, ancak Aspose.OMR Cloud kütüphanesi karmaşık OMR düzenlerini ve PDF inceliklerini işleyen güvenilir, test edilmiş bir çözüm sunar.

PDF’yi CSV’ye dönüştürürken yaygın hatalar nelerdir ve bunları nasıl ele alabilirim?
Tipik sorunlar, desteklenmeyen PDF özellikleri veya kimlik doğrulama hataları içerir. SDK, yakalayabileceğiniz ve örnekte gösterildiği gibi kaydedebileceğiniz ayrıntılı mesajlarla ApiException fırlatır.

Java’da PDF’den CSV’ye dönüşüm örneği var mı?
Evet, yukarıdaki tam kod örneği, Java’da çalıştırmaya hazır bir PDF’den CSV’ye dönüşüm örneği olarak hizmet verir ve pratik bir java method to convert PDF to CSV gösterir.

Daha Fazla Oku