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

Doconut bir .NET belge görüntüleyici SDK'sıdır ve belge renderleme ve etkileşimini web uygulamalarına 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ğlanan güvenli belge depolama .NET web uygulamasında

Gömülü Bir Görüntüleyicinin Dosya İndirmesinden Farkı Nedir?

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ştirilmiş özellikler için tutarlı bir alan sağlayabilir.

Render katmanını kendiniz inşa etmek zordur çünkü her formatın kendi 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 düzen 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ı ekler, meta veriler, renk ve çözünürlük konularını 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.

Adım 1: Gerekli Formatları ve Özellikleri Onaylayın

Kullanıcılarınızın açtığı dosyaların gerçek bir envanterini oluşturun. 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 mevcut ürün kapsamını, bir format ya da özellik taahhüt etmeden önce gözden geçirin. Ürün yetenekleri değişebilir, bu yüzden kabul testleriniz müşterilerinizin gerçekte kullandığı belgeler için nihai otorite olmalıdır.

Adım 2: Belgelerin Uygulamaya Nasıl Girdiğ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‑yetkili 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üklerse, renderlamadan önce doğrulayın. Dosya boyutu, uzantı, dosya imzası ve iş‑özel kısıtlamaları kontrol edin. Orijinal dosya adını bir yol olarak güvenmek yerine sunucu‑oluşturulan tanımlayıcıyı saklayın.

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

Uygulama—görüntüleyici UI değil—bir belgenin kimler tarafından açılabileceğine karar vermelidir.

ASP.NET Core'da, kimlik doğrulama ara katmanı, [Authorize] niteliği, politikalar, talepler ve kaynak‑bazlı yetkilendirme gibi standart mekanizmalar, bir görüntüleme oturumu 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ı kullanarak belgeyi ister.
Sunucu kullanıcıyı kimlik doğrular.
Sunucu, kullanıcının o belirli belgeye erişip erişemeyeceğini doğrular.
Sunucu, korunan depolama konumunu çözer.
Görüntüleyici, yalnızca yetkilendirilmiş oturum için gerekli bilgileri alır.

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

Adım 4: Doconut'ı 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 şunlara bağlı olabilir:

ASP.NET veya .NET uygulama tipiniz
Seçilen 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.

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

SDK işlevselliğini denetleyiciler ve UI bileşenleri içinde rastgele ç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ği kaydedilmeden 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 uygulama taklidiyle değiştirilmesi için net bir yer sunar.

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

Görüntüleyicinin 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ı
Özlü bir belge başlığı
Klavye‑erişilebilir çevre kontrolleri
Önemli görüntüleyici kontrollerini gizlemeyen bir düzen
Üst iş akışına geri dönmek için belirgin bir yol

Uzun dosya adları, büyük sayfa sayıları, geniş elektronik tablolar, ayrıntılı çizimler ve renderlanamayan belgelerle test edin. Hata durumu, sunucu yollarını, istisna izlerini veya depolama URL'lerini ifşa etmemelidir.

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

Dağıtımdan önce 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.

Kullanışlı önlemler şunları içerir:

Kısıtlı izinlere sahip ayrı bir geçici dizin
Benzersiz sunucu‑oluşturulmuş 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

Temizliği gözlemlenebilir kılın. Silme sessizce başarısız olursa, geçici dosyalar birikerek operasyonel ve güvenlik sorunu yaratır.

Adım 8: Üretim Güvenlik Önlemlerini 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şleri
İ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ı gecikmeye duyarlı uygulama süreçlerinden izole edin. Küçük test dosyalarına dayanmak yerine müşteri‑benzeri belgelerle ölçüm yapın.

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

Başarılı bir entegrasyon testi, “ilk sayfa göründü” demenin çok ötesine geçmelidir.

Test edin:

Gereken her dosya formatı
Küçük, büyük, çok‑sayfalı ve hasarlı 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ümlenmiş bir koleksiyon tutun. Doconut, .NET, Windows Server, depolama altyapısı veya ilgili bağımlılıklar yükseltildiğinde 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 gerektirir.
Yetkilendirme belirli belge için kontrol edilir.
Kullanıcı‑kontrolü girdi, sınırsız bir sunucu dosya yolu haline gelmez.
Depolama kimlik bilgileri asla istemciye ulaşmaz.
Yükleme limitleri ve doğrulama etkinleştirilir.
Geçici dosyalar kısıtlı erişime sahiptir ve test edilmiş bir temizlik politikası vardır.
Günlükler belge içeriği, gizli bilgiler ve hassas URL'leri içermez.
Kullanıcılara gösterilen hata mesajları temizlenmiştir.
SDK ve uygulama bağımlılıkları bir 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ışı ise sizin sorumluluğunuzdadır.

Bu sorumluluk bölümü, .NET ekiplerine birden çok render motoru inşa etmeden 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 keşfedin, ardından resmi indirme ve dokümantasyon kaynaklarını kendi belgelerinizle değerlendirin.

Sonuç

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

Bu temellerle 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 kontrolü elinde tutar.