Java’da GroupDocs.Viewer ile Excel’den HTML Oluşturma

Eğer Excel’den HTML oluşturmayı hızlı bir şekilde, yalnızca önemli çalışma kitabı bölümlerini göstererek yapmak istiyorsanız, tanımlı yazdırma alanı bölümlerini işlemek en iyi yoldur. Bu öğretici, bir Excel dosyasından yalnızca yazdırma alanlarını çıkaran ve GroupDocs.Viewer for Java kullanarak temiz, bağımsız HTML sayfaları üreten bir Java önizleme çözümü oluşturmanızı adım adım gösterir. Bu yaklaşımın yüklemeyi nasıl hızlandırdığını, bant genişliğini azalttığını ve UI’nızı nasıl düzenli tuttuğunu göreceksiniz—portal, gösterge panoları ve herhangi bir web tabanlı belge görüntüleyici için mükemmeldir.

Spreadsheet Print Areas Rendering with GroupDocs.Viewer for Java

Hızlı cevaplar

  • “Excel’den HTML oluşturma” ne anlama geliyor? Programlı olarak bir Excel çalışma kitabını, tarayıcıların Excel olmadan görüntüleyebileceği web‑hazır HTML sayfalarına dönüştürmek anlamına gelir.
  • Neden yalnızca Excel yazdırma alanı işlenir? En ilgili verileri izole eder, işleme süresini ve bant genişliğini azaltır.
  • Bunu denemek için lisansa ihtiyacım var mı? Ücretsiz deneme veya geçici lisans mevcuttur; üretim için tam lisans gereklidir.
  • Hangi Java sürümü destekleniyor? Java 8 veya daha yeni (Java 11 önerilir).
  • Önizlemeyi bir web sayfasına gömebilir miyim? Evet—bağımsız HTML sayfaları üretmek için embedded‑resources seçeneğini kullanın.

“Excel’den HTML oluşturma” nedir?

Generate HTML from Excel, bir XLSX çalışma kitabının görsel düzenini, tarayıcıların yerel olarak işlediği standart HTML işaretlemesine dönüştürmek anlamına gelir. Bu teknik, istemci tarafında Microsoft Office gerektirmeden web uygulamalarında elektronik tablo verilerini anında önizlemenizi sağlar.

Neden yalnızca Excel yazdırma alanı işlenir?

Yalnızca yazdırma alanını işlemek, tipik raporlar için %60’a kadar daha hızlı yüklenen daha küçük bir HTML yükü oluşturur. Ayrıca, hassas formüller içerebilecek iç çalışma sayfalarını gizleyerek güvenliği artırır. Kullanıcı tarafından tanımlanan yazdırma alanına odaklanarak, yazarın niyetine uygun daha temiz ve amaca yönelik bir görünüm sunarsınız.

Önkoşullar

  • GroupDocs.Viewer for Java v25.2 ve üzeri (70+ belge formatını destekler ve tüm dosyayı belleğe yüklemeden 10.000 satıra kadar elektronik tablo işleyebilir).
  • Geliştirme makinenizde Maven yüklü.
  • JDK 8 veya daha yeni (Java 11 önerilir).
  • Bir IDE (IntelliJ IDEA, Eclipse veya VS Code).

GroupDocs.Viewer for Java’ı Kurma

pom.xml dosyanıza GroupDocs deposunu ve bağımlılığını ekleyin:

<repositories>
    <repository>
        <id>repository.groupdocs.com</id>
        <name>GroupDocs Repository</name>
        <url>https://releases.groupdocs.com/viewer/java/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-viewer</artifactId>
        <version>25.2</version>
    </dependency>
</dependencies>

Lisans edinme

Ücretsiz deneme ile başlayın veya değerlendirme için geçici lisans talep edin. Üretime hazır olduğunuzda, tüm özelliklerin kilidini açmak ve deneme sınırlamalarını kaldırmak için tam lisans satın alın.

Temel başlatma

Viewer, bir belgeyi yükleyen ve işleme hattını yöneten temel sınıftır. Aşağıda GroupDocs.Viewer ile bir elektronik tablo açmak için gereken minimum kod bulunmaktadır:

import com.groupdocs.viewer.Viewer;

// Initialize Viewer object with the path to your spreadsheet
try (Viewer viewer = new Viewer("path/to/your/spreadsheet.xlsx")) {
    // Further configurations will be discussed in upcoming sections.
}

GroupDocs.Viewer ile XLSX’i HTML’e Dönüştürme

Bu bölüm, GroupDocs.Viewer’ı kullanarak bir XLSX çalışma kitabını yalnızca tanımlı yazdırma alanı bölümlerini gösteren bağımsız HTML dosyalarına dönüştürmeyi gösterir. Görünüm seçeneklerini yapılandırıp görüntüleyiciyi çağırarak, web sayfalarına veya portalara gömülebilecek hafif önizlemeler oluşturabilirsiniz.

Aşağıda yalnızca Excel yazdırma alanını işleyen ve bağımsız HTML dosyaları üreten adım adım bir rehber bulunmaktadır.

Adım 1: Çıktı dizinini ve dosya yolu formatını tanımlama

İlk olarak, görüntüleyiciye oluşturulan HTML sayfalarının nereye yazılacağını belirtin.

import java.nio.file.Path;
import java.nio.file.Paths;

// Set the output directory path
Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY");

// Define a file path format for the rendered pages
Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");

Açıklama: outputDirectory, tüm önizleme dosyalarını tutacak klasördür. pageFilePathFormat ise görüntüleyicinin sayfa numarasıyla değiştirdiği bir yer tutucu ({0}) kullanır.

Adım 2: Yazdırma alanı işleme için HTML görünüm seçeneklerini yapılandırma

HtmlViewOptions, HTML’nin nasıl oluşturulacağını kontrol eder. forEmbeddedResources, her sayfa için tüm CSS/JS’yi satır içi içeren tek bir HTML dosyası oluşturur, dağıtımı basitleştirir. forRenderingPrintArea() motoruna yalnızca Excel yazdırma alanını işlemesini söyler.

import com.groupdocs.viewer.options.HtmlViewOptions;
import com.groupdocs.viewer.options.SpreadsheetOptions;

// Configure HTML view options with embedded resources and print area rendering
HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);
viewOptions.setSpreadsheetOptions(SpreadsheetOptions.forRenderingPrintArea());

Açıklama: HtmlViewOptions.forEmbeddedResources, her sayfa için tüm CSS/JS’yi satır içi içeren tek bir HTML dosyası oluşturur, dağıtımı basitleştirir. forRenderingPrintArea() motoruna yalnızca Excel yazdırma alanını işlemesini söyler.

Adım 3: Elektronik tabloyu yükleyin ve işleyin

Son olarak, görüntüleyiciyi çalışma kitabınıza yönlendirin ve işleme sürecini başlatın.

// Replace with your actual document path
Path documentPath = Paths.get("YOUR_DOCUMENT_DIRECTORY/SAMPLE_XLSX_WITH_PRINT_AREAS.xlsx");

try (Viewer viewer = new Viewer(documentPath.toString())) {
    // Render to HTML using the configured view options
    viewer.view(viewOptions);
}

Açıklama: view() yöntemi, belirlediğimiz seçeneklere göre çalışma kitabını işler ve yalnızca yazdırma alanı bölümlerini gösteren HTML dosyaları üretir.

Yaygın sorunlar ve çözümler

  • Dosya yolu hataları: Yolların mutlak veya projenizin çalışma dizinine göre doğru göreceli olduğundan emin olun.
  • İzin sorunları: Java sürecinin kaynak dosyaya okuma ve çıktı klasörüne yazma erişimi olduğundan emin olun.
  • Eksik yazdırma alanları: Elektronik tablonun gerçekten yazdırma alanları tanımladığını doğrulayın (Excel’de Sayfa Düzeni → Yazdırma Alanı).

Pratik uygulamalar

  1. Belge yönetim sistemleri: Kullanıcılara tüm çalışma kitabını yüklemeden raporların temiz bir önizlemesini gösterir.
  2. Finansal gösterge panoları: Yazdırma alanı olarak işaretlenmiş ana finansal tabloların HTML anlık görüntülerini otomatik olarak oluşturur.
  3. Öğrenme platformları: Öğrencilere ödev verilerinin odaklanmış görünümlerini sunar.
  4. CRM portalları: İç çalışma sayfalarını gizlerken müşteri metriklerini vurgular.
  5. Veri bilimi not defterleri: Belgelerde özlü elektronik tablo önizlemeleri gömülür.

Performans ipuçları

  • Bellek ayarı: Çok büyük çalışma kitapları için JVM yığınını (-Xmx2g veya daha yüksek) artırın.
  • Tembel yükleme: Yalnızca ilk birkaç sayfaya ihtiyacınız varsa, gerekli sayfa sayısına ulaştıktan sonra işleme durun.
  • Paralel işleme: Ayrı Viewer örnekleri (her biri kendi iş parçacığında) kullanarak birden fazla çalışma kitabını aynı anda işleyin.

Yazdırma alanları olmadan elektronik tablo önizleme

SpreadsheetOptions, elektronik tablo işleme davranışını yapılandırır; tanımlı yazdırma alanına çıktıyı sınırlayıp sınırlamama seçeneğini içerir. Daha sonra tüm çalışma kitabını göstermek isterseniz, sadece SpreadsheetOptions.forRenderingPrintArea() çağrısını atlayın ve varsayılan SpreadsheetOptions‘ı kullanın. Bu, her çalışma sayfasını ve hücreyi işler ve orijinal dosyada bulunan tüm veri, formül ve biçimlendirmeyi içeren tam bir convert XLSX to HTML önizlemesi sağlar.

Sonuç

Artık Java’da Excel’den HTML oluşturmayı, bir elektronik tablonun yalnızca tanımlı yazdırma alanlarını işleyerek nasıl yapacağınızı öğrendiniz. Bu teknik, önizlemeleri daha hızlı, daha temiz ve daha güvenli hale getirir—modern web ve kurumsal uygulamalar için mükemmeldir.

Sonraki adımlar

  • PdfViewOptions veya PngViewOptions kullanarak diğer görünüm formatları (PDF, PNG) ile deney yapın.
  • Önizleme oluşturmayı kimlik doğrulama ile birleştirerek hassas verileri koruyun.
  • Özel sayfa boyutlandırma, ızgara çizgileri ve daha fazlası için tam SpreadsheetOptions API’sını keşfedin.

Sıkça sorulan sorular

S: Yalnızca Excel yazdırma alanını işlemenin temel faydası nedir?
C: Karışıklığı azaltır ve işleme süresini hızlandırır, en önemli verileri vurgulayan odaklanmış bir önizleme sunar.

S: Yazdırılamayan çalışma sayfalarını da işleyebilir miyim?
C: Evet—SpreadsheetOptions.forRenderingPrintArea() çağrısını atlayın ve tüm çalışma kitabını işlemek için varsayılan seçenekleri kullanın.

S: GroupDocs.Viewer diğer elektronik tablo formatlarını destekliyor mu?
C: XLS, XLSX, CSV, ODS ve birkaç diğer formatı işler. Tam liste için resmi dokümantasyona bakın.

S: Çok büyük dosyalar için işleme hızını nasıl artırabilirim?
C: JVM yığın boyutunu artırın, yalnızca ihtiyaç duyulan sayfaları işleyin ve çok iş parçacıklı işleme düşünün.

S: Yazdırma alanlarım görünmüyor—ne kontrol etmeliyim?
C: Kaynak dosyada (Excel → Sayfa Düzeni → Yazdırma Alanı) yazdırma alanının tanımlı olduğundan ve en son GroupDocs.Viewer sürümünü kullandığınızdan emin olun.

Kaynaklar

Son Güncelleme: 2026-09-15
Tested With: GroupDocs.Viewer for Java 25.2
Author: GroupDocs

İlgili Öğreticiler