Gömülü belge görüntüleme, bir uygulamanın parçası gibi hissettirmeli, eski bir tarayıcı uzantısına ya da yerel olarak yüklü bir masaüstü programına devretmemelidir. Windows tabanlı ASP.NET ve .NET projeleri için, Doconut bir belge görüntüleyici SDK'sı sağlayarak iş belgelerini web uygulamanız içinde render edebilir.

Bu kılavuz, belgelenmemiş Doconut kaynak kodunu ortaya çıkarmadan eklenti gerektirmeyen bir görüntüleme deneyiminin mimarisini açıklar.

.NET işleme hizmeti üzerinden geçerek eklenti gerektirmeyen gömülü bir görüntüleyiciye belgeler

“Eklenti Gerektirmeyen” Ne Anlama Gelir

Eklenti gerektirmeyen bir görüntüleyici, kullanıcıdan belgeyi açmadan önce ActiveX, Flash, Silverlight ya da özel bir tarayıcı uzantısı gibi teknolojileri kurmasını istemez.

Bu, birkaç sürtünme kaynağını azaltır:

Kullanıcıların yerel kurulum izinlerine ihtiyacı yoktur.
BT ekipleri bir istemci tarafı eklentisi dağıtmak ve güncellemek zorunda kalmaz.
Uygulama, görüntüleme iş akışını kendi arayüzü içinde tutar.
Eski eklenti bağımlılıkları, bir dosyanın açılması için koşul haline gelmez.

Eklenti gerektirmeyen, bağımlılık gerektirmeyen anlamına gelmez. Sunucu hâlâ doğru SDK, çalışma zamanı, yazı tipleri, depolama erişimi, yapılandırma ve lisansa ihtiyaç duyar. Uygulama ayrıca kimlik doğrulama, yetkilendirme, saklama ve izleme sorumluluğunu taşır.

Sunucu Taraflı Belge İşleme Neden Yardımcı Olur

İş belgeleri, sıradan web içeriğinden daha karmaşıktır. Office dosyaları, CAD çizimleri, e-posta mesajları ve yüksek çözünürlüklü görüntüler her biri format‑bilgili işleme gerektirir.

Sunucu taraflı bir .NET bileşeni bu işleme görevini üstlenirken, web uygulaması ortaya çıkan görüntüleme deneyimini sunar. Bu, her kullanıcının orijinal oluşturma yazılımını kurmasını önler.

Doconut bu rol için tasarlanmıştır. Mevcut ürün bilgileri, PDF, Office belgeleri, CAD çizimleri, e-posta dosyaları ve görüntüler gibi belge türlerini desteklediğini belirtir. Uygulamanızın ihtiyaç duyduğu kesin format ve özellikleri Doconut Viewer sayfasında doğrulayın.

Görüntüleme İş Akışını Planlayın

Güvenli bir belge isteği genellikle şu adımları izler:

Kullanıcı, bir uygulama tanımlayıcısı ile belgeyi seçer.
ASP.NET isteği kimlik doğrular.
Sunucu, o belirli belgeye erişimi doğrular.
Uygulama, korumalı depolama konumunu çözer.
Belge, desteklenen bütünleşme yöntemi kullanılarak görüntüleme katmanına iletilir.
Uygulama sonucu kaydeder ve geçici kaynakları serbest bırakır.

İstemcinin depolama kimlik bilgilerini, sınırsız sunucu yollarını ya da yetkilendirilmiş oturumun gerektirdiğinden daha fazla belge bilgisini alması asla olmamalıdır.

Standart ASP.NET Güvenlik Sınırlarını Kullanın

Görüntüleme sayfası, diğer hassas kaynaklar gibi korunmalıdır.

Standart .NET mekanizmaları şunları içerebilir:

Kimlik doğrulama ara katmanı
[Authorize] niteliği
Yetkilendirme politikaları ve talepler
Kaynağa dayalı yetkilendirme
Depolama ve görüntüleme hizmetleri için bağımlılık enjeksiyonu
Hassas veri filtrelemesiyle yapılandırılmış günlükleme

Yetkilendirme sunucuda değerlendirilmelidir. Kullanıcı arayüzündeki bir araç çubuğu eylemini ya da rotayı gizlemek, kararlı bir istemcinin doğrudan istekte bulunmasını engellemez.

SDK Erişimini Bir Uygulama Servisi Arkasına Alın

Görüntüleyiciye özgü çağrıları denetleyiciler ve sayfalar arasında yaymaktan kaçının. Ayrı bir uygulama servisi şunları yapabilir:

Yetkilendirilmiş belge tanımlayıcılarını çözer
Kontrollü bir Stream açar
Yüklü SDK sürümü için yapılandırma uygular
Dosya ve akış kaynaklarını serbest bırakır
Teknik hataları güvenli uygulama hatalarına dönüştürür
Zamanlamaları ve temizlenmiş tanılamaları kaydeder

Bu sınır, uygulamanın test edilmesini kolaylaştırır ve gelecekteki SDK yükseltmelerinin etkisini azaltır.

Resmi Doconut indirme ve dokümantasyon kaynaklarını paket kurulumu ve sürüm‑spesifik API rehberliği için kullanın.

Kullanışlı Bir Görüntüleyici Host’u Oluşturun

Uygulama‑sahibi görüntüleyici konteyneri gerçek belgeler için yeterli alan almalıdır. Dar kartlar ve sabit masaüstü genişliklerinden kaçının.

.viewer-workspace {
  display: grid;
  grid-template-rows: auto minmax(0, 1fr);
  width: 100%;
  min-height: 36rem;
  height: calc(100dvh - 4rem);
}

.viewer-host {
  min-width: 0;
  min-height: 0;
  overflow: hidden;
}

Bu, çevre sayfa için standart CSS’dir, Doconut yapılandırması değildir. Belirtilmemiş iç seçicileri hedeflemeyin ya da SDK seçenekleri uydurmayın.

Sayfa ayrıca şunları sağlamalıdır:

Açık bir yükleme durumu
Güvenli bir hata mesajı
Görünür belge başlığı
Üst iş akışına dönüş yolu
Erişilebilir uygulama kontrolleri
Geniş elektronik tablolar ve detaylı çizimler için yeterli alan

Belgeleri Render Etmeden Önce Doğrulayın

Kullanıcılar dosya yüklediğinde şunları kontrol edin:

Dosya boyutu
Uzantı ve dosya imzası
Desteklenen format
Parola ya da şifreleme gereksinimleri
İş‑özel kısıtlamalar
Sunucu‑tarafı oluşturulan depolama adı

Orijinal dosya adından doğrudan sunucu yolları oluşturmayın. Güvenli bir uygulama tanımlayıcısı saklayın ve bunu yetkilendirilmiş bir sunucu‑tarafı hizmeti aracılığıyla çözün.

Windows Sunucusunu Hazırlayın

Render davranışı sunucu ortamına bağlı olabilir. Şunları doğrulayın:

Desteklenen Windows ve .NET sürümleri
Gerekli yazı tipleri
Geçici depolama konumu ve izinleri
Mevcut CPU, bellek ve disk kapasitesi
Azami belge boyutu ve eşzamanlı oturum sayısı
Lisans yapılandırması
Temizleme prosedürleri

Üretim ortamına benzer bir ortamda temsilci müşteri belgelerini test edin.

Güvenlik ve Gizlilik Kontrol Listesi

Yayına almadan önce:

Gerektiğinde görüntüleme isteklerini kimlik doğrulayın.
Kullanıcıyı belirli belge için yetkilendirin.
Depolama yollarını ve kimlik bilgilerini sunucuda tutun.
Geçici dosya izinlerini kısıtlayın.
Orijinal, geçici veri ve dışa aktarımlar için saklama süresini tanımlayın.
Kullanıcıya gösterilen hataları temizleyin.
Belge içeriklerini ve sırları günlüklerden hariç tutun.
Yükleme ve eşzamanlılık limitlerini uygulayın.
SDK ve uygulama bağımlılıklarını güncel tutun.

Uyumluluk iddiaları, tek bir UI bileşeninden ziyade tam dağıtılmış sistem ve organizasyon süreçlerinizi yansıtmalıdır.

Mutlu Yolun Ötesinde Test Edin

Test kütüphaneniz şunları içermelidir:

Çok sayfalı PDF’ler
Büyük elektronik tablolar
Detaylı CAD çizimleri
Alışılmadık yazı tiplerine sahip sunumlar
Ekli dosyalar içeren e‑posta dosyaları
Büyük görüntüler
Bozuk ve desteklenmeyen dosyalar
Yetkisiz istekler
Eşzamanlı görüntüleme oturumları
Kesintili istekler ve uygulama yeniden başlatmaları

Başarısızlıkların sunucu yollarını, yığın izlerini ya da depolama URL’lerini ortaya çıkarmadığından emin olun.

Doconut Nerede Konumlanır

Doconut, .NET web uygulaması içinde gömülü belge‑görüntüleme yeteneğini sağlar. Uygulamanız, çevre güvenlik, depolama, iş akışı, duyarlı düzen ve operasyonel kontrolleri sunar.

Bu ayrım, ekiplerin eski eklenti‑bağımlı iş akışlarını, belge işleme zahmetsiz ya da sorumluluksuz hâle gelmiş gibi göstermeden değiştirmelerine olanak tanır.

Doğrulanmış Doconut .NET belge görüntüleyici SDK’ı keşfedin, ardından seçtiğiniz sürümle eşleşen talimatlar için resmi indirme sayfasını kullanın.

Sonuç

Eklenti gerektirmeyen bir belge deneyimi, kurulum sürtünmesini azaltır ve kullanıcıları uygulamanız içinde tutar. Sunucu‑yetkili bir belge akışı üzerine inşa edin, SDK erişimini izole edin, geniş bir görüntüleyici host sağlayın ve üretim‑benzeri yük altında gerçek dosyaları test edin.

Windows tabanlı ASP.NET ve .NET uygulamaları için Doconut, belge görüntüleme katmanını sağlayabilir; ekibiniz ise uygulama ve belge yaşam döngüsü üzerinde kontrolü elinde tutar.