Bir iş uygulamasına belge görüntüleme eklemek, bir PDF'yi iframe içinde göstermekten daha fazlasını gerektirir. Office dosyaları, CAD çizimleri, e-posta dosyaları ve görseller farklı renderleme yetenekleri isterken, uygulamanın hâlâ kimlik doğrulama, depolama, yetkilendirme ve saklama sürecini kontrol etmesi gerekir.

Doconut .NET belge görüntüleyici SDK'sı, web uygulamalarına belge renderleme ve etkileşimi gömmek için tasarlanmıştır. Doğrulanmamış bir kaynak‑kod tarifini sunmak yerine, bu kılavuz ekibinizin alması gereken entegrasyon kararlarını açıklar ve SDK'yı çevreleyen yaygın .NET bileşenlerini tanımlar.

Gömülü bir görüntüleyiciye bağlanmış güvenli belge depolama bir .NET web uygulamasında

Neden Gömülü Bir Görüntüleyici, Dosya İndirmesinden Farklıdır?

Bir indirme uç noktası orijinal dosyayı aktarır ve görüntüleme deneyimini uygulamanız dışındaki bir yazılıma bırakır. Gömülü bir görüntüleyici kullanıcıyı ürününüz içinde tutar ve gezinme, arama, inceleme ve diğer etkinleştirilebilir özellikler için tutarlı bir alan sağlayabilir.

Renderleme katmanını kendiniz inşa etmek zordur çünkü her formatın kendine özgü kuralları vardır:

PDF dosyaları gömülü yazı tipleri, ek açıklamalar, formlar ve çok büyük sayfa setleri içerebilir.
Word, Excel ve PowerPoint dosyaları dikkatli yerleşim ve yazı tipi yönetimi gerektirir.
CAD çizimleri doğru ölçekleme, katmanlar ve ayrıntılı yakınlaştırma ister.
E-posta ve görüntü formatları ek dosyalar, meta veriler, renk ve çözünürlük sorunları getirir.

Özel bir SDK, uygulama ekibinin her desteklenen format için ayrı bir renderlayıcı sürdürmek yerine erişim kontrolü, iş akışları ve kullanıcı deneyimine odaklanmasını sağlar.

1. Adım: Gerekli Formatları ve Özellikleri Doğrulayın

Kullanıcılarınızın açtığı dosyaların gerçek envanterini çıkararak başlayın. Temel formatları ara sıra kullanılanlardan ayırın ve test için temsilci örnekler kaydedin.

Kontrol listeniz şunları içerebilir:

PDF ve XPS belgeleri
Kelime işlem belgeleri
Elektronik tablolar
Sunumlar
CAD çizimleri
E-posta dosyaları
Yaygın görüntü formatları

Ardından her iş akışı için önemli olan özellikleri belirleyin. Görüntüleme, metin arama, ek açıklama, yazdırma ve dönüştürme farklı yeteneklerdir ve farklı Doconut bileşenleri veya lisanslamalar gerektirebilir.

Doğrulanmış Doconut Viewer sayfası üzerindeki ürün yeteneklerini inceleyin; format ya da özellik taahhüdünde bulunmadan önce. Ürün yetenekleri değişebilir, bu yüzden kabul testleriniz müşterilerinizin gerçekten kullandığı belgeler için son otorite olmalıdır.

2. Adım: Belgelerin Uygulamaya Nasıl Gireceğini Seçin

Bir ASP.NET uygulaması belgeleri birkaç kontrollü kaynaktan alabilir:

ASP.NET Core IFormFile olarak işlenen bir yükleme
Korunan bir dosya konumu
Bir veritabanı veya belge‑yönetim deposu
Sunucu tarafından erişilen nesne depolama
Stream döndüren dahili bir hizmet

Görüntüleme iş akışı, sunucu‑yetkilendirilmiş bir belge referansı kullanmalıdır. Depolama kimlik bilgilerini, sınırsız dosya yollarını veya kalıcı herkese açık URL'leri istemci tarafı işaretlemesinde bulundurmayın.

Kullanıcılar dosya yüklediğinde, renderlemeden önce doğrulama yapın. Dosya boyutu, uzantı, dosya imzası ve iş kurallarına göre kısıtlamaları kontrol edin. Orijinal dosya adını bir yol olarak güvenmek yerine sunucu‑oluşturulan tanımlayıcıyı saklayın.

3. Adım: Kimlik Doğrulama ve Yetkilendirme Tanımlayın

Uygulama—görüntüleyici UI'sı değil—belgeyi kimlerin açabileceğine karar vermelidir.

ASP.NET Core'da, kimlik doğrulama ara katmanı, [Authorize] özniteliği, politikalar, talepler ve kaynak‑bazlı yetkilendirme gibi standart mekanizmalar, bir görüntüleme oturumunu başlatan uç noktayı koruyabilir. Yetkilendirme kararı, mevcut kullanıcıyı ve istenen belgeyi içermelidir.

Güvenli bir istek akışı şu şekildedir:

Kullanıcı, uygulama‑seviyesinde bir tanımlayıcıyla belgeyi ister.
Sunucu kullanıcıyı kimlik doğrular.
Sunucu, kullanıcının o belgeye erişim izni olup olmadığını doğrular.
Sunucu, korunan depolama konumunu çözer.
Görüntüleyici, yalnızca yetkilendirilmiş oturum için gerekli bilgiyi alır.

Bir araç çubuğu düğmesini gizlemek yetkilendirme kontrolü olarak kabul edilmemelidir. İndirme veya yazdırma kontrolleri gösterilmese bile sunucu‑tarafı erişim denetimleri gereklidir.

4. Adım: Doconut'u Resmi Entegrasyon Kaynaklarıyla Ekleyin

Doconut tarafından sağlanan güncel paket ve kurulum talimatlarını kullanın. Doğrulanmış Doconut indirme sayfası NuGet entegrasyon kaynakları, dokümantasyon, örnekler ve demolar sunar.

Tam kurulum aşağıdakilere bağlı olarak değişebilir:

ASP.NET ya da .NET uygulama tipiniz
Seçtiğiniz Doconut ürünü ve eklentileri
Doconut sürümü
Lisansınız
Etkinleştirdiğiniz belge formatları ve özellikler
Windows sunucu yapılandırmanız

Yüklü sürümle eşleşen dokümantasyonu izleyin. İlgisiz blog gönderilerinden kod parçacıkları kopyalamaktan kaçının; ad alanları, yapılandırma, varlık yolları ve API'ler sürümler arasında değişebilir.

5. Adım: Ayrı Bir Görüntüleme Sınırı Oluşturun

SDK işlevselliğini tüm denetleyiciler ve UI bileşenleri içinde çağırmak yerine, belge görüntülemeyi küçük bir uygulama hizmetinin arkasına alın.

Bu hizmet şunlardan sorumlu olabilir:

Yetkilendirilmiş bir belge tanımlayıcısını çözmek
Gerektiğinde belgeyi kontrollü bir Stream olarak açmak
Gerekli görüntüleme yapılandırmasını sağlamak
Dosya ve akış kaynaklarını serbest bırakmak
Teknik hataları güvenli uygulama hatalarına çevirmek
Belge içeriğini loglamadan operasyonel metrikleri kaydetmek

Bu sınır, yükseltmeleri kolaylaştırır ve depolama ayrıntılarının sunum katmanına sızma riskini azaltır. Ayrıca testlerin güvenli bir implementasyonla değiştirilebileceği net bir yer sunar.

6. Adım: Görüntüleyici Sayfasını Tasarlayın

Görüntüleyicinin kullanışlı olması için yeterli alanı olmalıdır. Alakasız kontrollerle çevrili dar bir kart, büyük elektronik tabloları ve CAD çizimlerini incelemeyi zorlaştırır.

Sayfayı şu unsurlara göre planlayın:

Sabit bir görüntüleyici yüksekliği
Açık yükleme, boş ve hata durumları
Kısa bir belge başlığı
Klavye‑erişilebilir çevre kontrolleri
Önemli görüntüleyici kontrollerini gizlemeyen bir yerleşim
Üst iş akışına dönmek için belirgin bir yol

Uzun dosya adları, yüksek sayfa sayısı, geniş elektronik tablolar, detaylı çizimler ve renderlaması başarısız belgelerle test edin. Hata durumu sunucu yollarını, istisna izlerini ya da depolama URL'lerini ifşa etmemelidir.

7. Adım: Dosyaları ve Geçici Verileri Yönetin

Dağıtıma geçmeden bir saklama politikası tanımlayın. Orijinal dosya, geçici render verileri, önbellekler, dışa aktarmalar, ek açıklamalar ve günlükleri ayrı ayrı düşünün.

Yararlı önlemler şunlardır:

Kısıtlı izinlere sahip ayrı bir geçici dizin
Benzersiz sunucu‑oluşturulan adlar
Başarılı ve başarısız oturumların ardından temizlik
Terk edilmiş geçici dosyalar için zamanlanmış bir süreç
Depolama kotaları ve izleme
Güvenlik politikanız gerektiriyorsa dinlenme sırasında şifreleme

Temizlik gözlemlenebilir olmalı. Silme sessizce başarısız olursa, geçici dosyalar birikerek operasyonel ve güvenlik sorunu yaratır.

8. Adım: Üretim Güvencelerini Yapılandırın

Belge renderlaması CPU, bellek ve geçici disk alanı tüketebilir. Uygulamayı açık limitlerle koruyun:

Maksimum yükleme boyutu
Maksimum eşzamanlı render işi sayısı
İstek ve işleme zaman aşımı
Asenkron renderlama yapıldığında kuyruk limitleri
Geçici depolama kotaları
Sağlık kontrolleri ve yapılandırılmış hata izleme

Büyük ya da öngörülemeyen iş yükleri için renderlamayı gecikme‑hassas uygulama süreçlerinden izole edin. Küçük test dosyalarına dayanmak yerine müşteri‑benzeri belgelerle ölçüm yapın.

9. Adım: Tam İş Akışını Test Edin

Başarılı bir entegrasyon testi, “ilk sayfa göründü” demekten çok daha fazlasını kapsamalıdır.

Test edin:

Her gerekli dosya formatı
Küçük, büyük, çok‑sayfalı ve bozuk dosyalar
Alışılmadık yazı tiplerine sahip belgeler
İş akışınız destekliyorsa şifre korumalı dosyalar
Yetkili ve yetkisiz kullanıcılar
Eşzamanlı görüntüleme oturumları
Uygulama yeniden başlatmaları ve kesintili istekler
Başarı ve başarısızlık sonrası temizlik
Seçtiğiniz ürün yapılandırmasında bulunan görüntüleyici özellikleri

Temizlenmiş test belgelerinden oluşan sürümlü bir koleksiyon tutun. Doconut, .NET, Windows Server, depolama altyapısı veya ilgili bağımlılıkları yükselttiğinizde yeniden çalıştırın.

Güvenlik Kontrol Listesi

Yayına almadan önce şunları doğrulayın:

Her görüntüleme isteği gerektiğinde kimlik doğrulama ister.
Belirli belge için yetkilendirme kontrol edilir.
Kullanıcı‑kontrolündeki girişler sınırsız bir sunucu dosya yoluna dönüşemez.
Depolama kimlik bilgileri asla istemciye ulaşmaz.
Yükleme limitleri ve doğrulama etkinleştirilmiştir.
Geçici dosyalar kısıtlı erişime sahiptir ve test edilmiş bir temizlik politikası vardır.
Günlükler belge içeriğini, gizli bilgileri ve hassas URL'leri içermez.
Kullanıcıya gösterilen hata mesajları temizlenmiştir.
SDK ve uygulama bağımlılıkları güncelleme sürecine tabidir.

Görüntüleyici kontrolleri iş akışınızı destekleyebilir, ancak bilgi yetkili bir kullanıcıya göründükten sonra her yakalama biçimini engelleyemez. Bunları erişim kontrolleri ve uygun bir bilgi‑koruma politikasıyla birlikte kullanın.

Doconut Nerede Konumlanır?

Doconut, .NET uygulaması içinde belge‑görüntüleme yeteneğini sağlar; kimlik, yetkilendirme, dosya depolama, saklama, denetim ve çevre iş akışı sizin sorumluluğunuzdadır.

Bu sorumluluk bölüşümü, .NET ekiplerine birden çok render motoru geliştirmeden iş belgelerini desteklemek için pratik bir yol sunar. Ayrıca entegrasyon detaylarını, dağıttığınız sürümün resmi dokümantasyonuna bağlı tutar.

Doconut .NET belge görüntüleyici SDK sayfasını keşfedin, ardından kendi belgelerinizle değerlendirmek için resmi indirme ve dokümantasyon kaynaklarını kullanın.

Sonuç

Güvenilir bir gömülü belge görüntüleyici, net format gereksinimleri ve güvenli sunucu‑tarafı belge akışıyla başlar. Girdileri doğrulayın, her belge isteğini yetkilendirin, SDK erişimini bir uygulama hizmetiyle izole edin, geçici dosya temizliğini planlayın ve gerçekçi dosyalarla test edin.

Bu temeller üzerine kurulduğunda, Doconut Windows tabanlı .NET web uygulamanız için görüntüleme katmanını sağlayabilir; ekibiniz ise uygulama mimarisi ve belge yaşam döngüsü üzerinde tam kontrol sahibi olur.