Legacy Belge Görüntüleme Çözümlerini Modern Düşük‑İz SDK'lara Taşıma
← Back to Blog7 min read

Legacy Belge Görüntüleme Çözümlerini Modern Düşük‑İz SDK'lara Taşıma

Modern, güvenli ve duyarlı bir belge görüntüleyiciye en hızlı yol, eski bileşenleri Doconut’un düşük‑iz SDK'sı ile değiştirmektir. Kendo UI kullanan web portalları için SDK, hızlı renderleme, tam erişilebilirlik ve odaklanmış bir entegrasyon yolu sağlar. Bir zamanlar masaüstü‑only kütüphaneler veya harici dönüşüm hizmetleri üzerine özel görüntüleyiciler inşa eden işletmeler, kısa sürede sorunlarla karşılaşır: bakım maliyetleri artar, istemci‑tarafı bağımlılıklar kırılgan hâle gelir ve erişilebilirlik göz ardı edilir. Doconut, .NET arka uçtan yerel PDF, Office ve CAD renderlemesi sunarak bu engelleri ortadan kaldırır; ön uç hafif ve tamamen kontrolünüz altında kalır.

Sonraki bölümlerde, eski nesil görüntüleyicilerin neden birer sorumluluk haline geldiğini, Doconut’un mimarisinin bu sorunları nasıl çözdüğünü ve hemen kullanmaya başlayabileceğiniz pratik bir geçiş yol haritasını inceleyeceğiz.

Bağımlılık‑ağır bir legacy görüntüleyiciden güvenli bir sunucu‑tarafı belge görüntüleyiciye geçiş
Bağımlılık‑ağır bir legacy görüntüleyiciden güvenli bir sunucu‑tarafı belge görüntüleyiciye geçiş

1. Legacy Görüntüleyiciler: Tanıdık Arayüzlerin Ardındaki Gizli Maliyetler

Çoğu “legacy” belge görüntüleyici, tarayıcıların hâlâ eklentilere, ActiveX denetimlerine veya sunucuda büyük Office kurulumlarına dayandığı zamanlarda ortaya çıktı. Bu durum çeşitli şekillerde kendini gösterir:

SorunGerçek‑dünya etkisi
İstemci‑tarafı bağımlılıklarKullanıcıların tarayıcı eklentilerini kurması veya etkinleştirmesi gerekir; kurumsal BT bunları engeller ve iş akışını bozar.
Sunucu‑tarafı Office gereksinimleriWeb sunucusuna Microsoft Office kurulumu, en iyi uygulama güvenliğine aykırıdır ve lisans maliyetlerini şişirir.
Sınırlı format desteğiYeni CAD veya görüntü formatları (DWG, DXF, PNG) desteklenmez, dolayısıyla geçici çözümler veya manuel dönüşümler gerekir.
Ölçeklenebilirlik darboğazlarıRenderleme istemci CPU'sunda gerçekleşir; büyük PDF'ler veya çok sayfalı Office dosyaları yavaşlamaya ve çöküşlere neden olur.
Erişilebilirlik boşluklarıKlavye navigasyonu, ekran okuyucu desteği ve WCAG uyumu genellikle sonradan eklenir; bu da işletmeleri uyumluluk riskine sokar.
Bakım kabusuArtık güncellenmeyen satıcı SDK'ları güvenlik sorumluluğu haline gelir ve her yama tam bir yeniden dağıtım gerektirir.

Bu gizli maliyetleri bir belge‑odaklı sistem—DMS, CRM portalı veya e‑öğrenme platformu—ile birleştirdiğinizde ROI hızla eriyebilir. Modern işletmeler, istemci eklentilerine bağımlı olmayan, Office gerektirmeyen ve sunucuda ölçeklenebilen bir görüntüleyiciye ihtiyaç duyar. Doconut tam da bunu sunar.


2. Düşük‑İz, Sunucu‑Tarafı Renderleme: Modern Uygulamalar İçin İdeal PDF Görüntüleyici SDK

Doconut’un temel gücü, sunucu‑tarafı belge renderleme motoru sayesinde raster görüntüleri tarayıcıya akıtmasıdır; istemci‑tarafı eklenti ihtiyacını ortadan kaldırır. Mimari, yukarıdaki zorluklarla şu şekilde eşleşir:

a. Tarayıcı İçin Minimum İstemci İz

  • Görüntüleyici yalnızca HTML, CSS ve çok az JavaScript sunar. ActiveX, Flash veya Silverlight yok—sadece desteklenen web tarayıcılarına standart web varlıkları gönderilir.
  • Renderleme sunucuda gerçekleştiği için istemcinin .NET Desktop, Office veya bir CAD görüntüleyici kurmasına gerek kalmaz.

b. Kapsamlı Format Kapsamı

Doconut, Office, PDF, CAD, e‑posta ve görüntü kategorilerinde 33+ formatı yerel olarak destekler—DOC/DOCX, XLS/XLSX, PPT/PPTX, DWG, DXF, PNG, JPG ve daha fazlası. Bu, geliştiricilerin üçüncü‑taraf dönüştürücüleri bir araya getirmesini gerektiren “dosya‑tipi‑boşluğunu” ortadan kaldırır.

c. Dahili Açıklama, Arama ve Kontrollü Yazdırma

  • Açıklama Eklentisi – görüntüleyicide doğrudan vurgulama, yorum ekleme veya serbest çizim yapma.
  • Arama Eklentisi – tüm belge içinde anlık metin arama, taranmış görüntüler için OCR desteği.
  • Kontrollü Yazdırma – görüntüleyici UI üzerinden yazdırma politikaları uygulayarak yetkisiz kopyaları önleme.

d. Office‑Siz İş Akışları İçin Sunucu‑Tarafı Dönüşüm

Dönüştürme Eklentisi, Word, Excel, PowerPoint ve CAD dosyalarını sunucuda PDF, PNG veya HTML’e dönüştürür. Microsoft Office kurulumu, harici SaaS hizmeti ve veri sızıntısı yoktur; her şey güvenlik duvarınızın içinde kalır.

e. Yerleşik Erişilebilirlik

Doconut, WCAG 2.2 AA yönergelerini kutudan çıkar çıkmaz uygular—klavye navigasyonu, ARIA etiketleri ve ekran okuyucu dostu işaretleme görüntüleyicinin HTML’ine entegre edilmiştir. Kurumsal erişilebilirlik politikalarını etkinleştirmek, sıfırdan geliştirmek yerine bir anahtarla açılır.

f. Modern .NET Yığınlarıyla Sorunsuz Entegrasyon

ASP.NET Core, .NET 6 veya mikro‑servis mimarileri kullanıyorsanız, Doconut tek bir middleware çağrısıyla istek hattına bağlanır. Görüntüleyici, Kendo UI bileşenleri veya desteklenen herhangi bir web ön yüzüyle entegre edilebilir.


3. Geçiş Planı: Legacy’den Doconut’a

Aşağıda, mevcut bir .NET web uygulamasında eski görüntüleyiciyi Doconut ile değiştirmek için pratik, adım‑adım bir plan bulacaksınız. Amaç, eski görüntüleyiciyi Doconut’a takas ederken dış API’yi aşağı akış tüketicileri için stabil tutmaktır.

Adım 1: Ortamı Hazırlayın

  1. Doconut NuGet paketini çözümünüze ekleyin.
  2. Sunucunuzun .NET 6 (veya daha yeni) çalıştığından emin olun; Doconut’un bağımlılık optimizasyonu en yeni çalışma zamanında parlar.

Adım 2: Doconut Middleware’ini Kaydedin

Doconut middleware’ini ASP.NET istek hattında erken bir konuma yerleştirin; böylece belge görüntüleri istekleri Doconut motoru tarafından yakalanıp işlenir.

Adım 3: Lisansı Yükleyin

Uygulama başlangıcında Doconut lisans dosyasını (veya XML belgesini) bir kez yükleyin. Eğer eklenti‑özel lisanslarınız (ör. Açıklama Eklentisi) varsa, ilgili Doconut API’siyle yükleyin.

Adım 4: Eski Render Çağrılarını Değiştirin

Legacy kodun belge sayfasını bitmap veya byte array olarak render ettiği yerleri tespit edin. Bu çağrıları Doconut’un belge‑aç akışıyla değiştirin; bu akış bir token döndürür. Token’ı, Doconut’un görüntü‑servis uç noktalarına sayfa görüntüsü veya küçük resim talep etmek için kullanın.

Adım 5: Açıklama ve Aramayı Etkinleştirin

Mevcut “yorum ekle” veya “arama” işlevlerini Doconut’un Açıklama ve Arama eklentilerine yönlendirin. Her iki eklenti de JSON dönen basit sunucu‑tarafı metodlar sunar; ön yüzünüz bu veriyi tüketebilir.

Adım 6: Ön‑Uç Entegrasyonunu Güncelleyin

Doconut render edilmiş görüntüleri akıttığı için ön‑uç sadece her sayfa için bir <img> etiketi ya da canvas‑tabanlı bir görüntüleyici gerekir. Kendo UI için, görüntü URL’lerini pürüzsüz sayfa geçişi sağlayan bir Kendo Carousel’a bağlayın.

Adım 7: Test, Optimize Et, Dağıt

  • Performans – ilk sayfaya erişim süresini ölçün; Doconut’un sunucu‑tarafı raster renderlemesi genellikle standart PDF’lerde bir saniyenin altında sonuç verir.
  • Güvenlik – render edilmiş görüntüler dışına belge verisinin sızmadığını doğrulayın.
  • Erişilebilirlik – bir ekran okuyucu denetimi yapın; Doconut’un işaretlemesi zaten ARIA rollerini içerir.

Test seti geçtiğinde, legacy görüntüleyici rotasını yeni Doconut uç noktasıyla değiştirin ve güncellemeyi yayına alın.


4. Doconut ve Kendo UI ile Erişilebilirlik ve Kullanıcı Deneyimini Artırma

Erişilebilirlik artık bir “iyi olur” değil; birçok düzenlenmiş sektörde (sağlık, finans, kamu) zorunluluktur. Doconut’un kutudan çıkan uyumluluğu, bu standartları özel kod yazmadan karşılamanızı sağlar.

Klavye Navigasyonu

Her etkileşimli öğe—sayfa gezinme, yakınlaştırma kontrolleri, açıklama araçları—standart tabindex özniteliklerine sahiptir. Kullanıcılar sadece klavye ile belge içinde gezinebilir; bu, Section 508 uyumu için bir zorunluluktur.

ARIA Etiketleri ve Ekran Okuyucular

Görüntüleyicinin HTML’i role="document" ve açıklayıcı aria-label öznitelikleri içerir; sayfa numaraları ve yakınlaştırma seviyesi gibi bilgileri yardımcı teknolojilere iletir. Ek ARIA betiği eklemenize gerek kalmaz.

Yüksek‑Kontrast Modu

Doconut, görüntüleyici arayüzünde ayarlanan yüksek‑kontrast tercihlerini yansıtabilir. UI, karanlık‑üzerine‑açık bir şemaya geçerek görme engelli kullanıcılar için okunabilirliği artırır.

Kendo UI ile Entegrasyon

Kendo UI’nın erişilebilir widget’ları (ör. kendoButton, kendoSlider) Doconut’un görüntü akışı üzerine oturabilir. Sonuç, uygulamanızın geri kalanıyla doğal bir şekilde bütünleşen, tamamen klavye‑navigasyonlu bir görüntüleyicidir.


5. Geleceğe Hazırlık: Görüntüleyiciyi Eklentilerle Genişletme

Doconut’un modüler eklenti mimarisi, temel görüntüleme ile başlayıp iş ihtiyaçları geliştikçe ekstra yetenekleri açmanıza olanak tanır.

EklentiTemel FaydaTipik Kurumsal Kullanım
Açıklama EklentisiVurgulama, yorum, çizimHukuki inceleme, mühendislik değişiklik siparişleri
Arama EklentisiTam‑metin, OCR‑güçlü aramaSağlık kayıtları sorgulama, finans denetimi
Dönüştürme EklentisiSunucu‑tarafı Office → PDF/HTMLDMS alım hatları, otomatik raporlama
Kontrollü YazdırmaYazdırma kotası, filigranGizli sözleşmeler, düzenleyici dosyalar

Tüm eklentiler sunucu‑tarafında çalıştığı için veri işleme, lisans ve ölçekleme üzerinde merkezi kontrol sağlarsınız. Yeni bir eklenti eklemek, lisansını yüklemek ve ilgili API’yi çağırmak kadar basittir; ön‑uç yeniden derlemesi gerekmez.


Sonuç

Belge‑görüntüleme yığınınızı modernleştirmek pahalı ve riskli bir revizyon olmak zorunda değil. Doconut’un düşük‑iz, sunucu‑tarafı renderleme motorunu benimseyerek şunları elde edersiniz:

  • Harici dönüştürücülere ihtiyaç duymadan geniş format desteği.
  • Uyumluluk gereksinimlerini karşılayan yerleşik açıklama, arama ve kontrollü yazdırma.
  • Kutudan çıkan kurumsal‑düzeyde erişilebilirlik.
  • Mevcut .NET ve Kendo UI projeleriyle sorunsuz entegrasyon.

Legacy görüntüleyicileri emekliye ayırıp kullanıcılarınıza daha hızlı, daha güvenli bir deneyim sunmaya hazır mısınız? Doconut ile geçişinize bugün başlayın – SDK’yı indirin, geçiş planını izleyin ve farkı dakikalar içinde görün.

#document rendering#PDF Viewer SDK#legacy migration#enterprise .NET#Doconut#belge renderleme#PDF Görüntüleyici SDK#eski sistem geçişi#kurumsal .NET