Belge Görüntüleyici SDK'larını Bulut Depolama ve İşbirliği Platformlarıyla Entegre Etme

Bir belge görüntüleyici SDK'sını bulut depolama ve işbirliği platformlarıyla entegre etmek, .NET uygulamanızdan doğrudan sorunsuz, güvenli ve aranabilir belge deneyimleri sunmanızı sağlar. Doconut—.NET arka uçları için evrensel bir belge görüntüleyici—PDF, Office dosyaları, CAD çizimleri ve görüntüleri yerel olarak render edebilir, OCR‑tabanlı arama ekleyebilir, gerçek zamanlı açıklamayı etkinleştirebilir ve baskıyı kontrol edebilir; tüm bunları verileri seçtiğiniz bulut ya da yerel ortam içinde tutarak yapar. Bu kılavuz, kıdemli geliştiricilere ve yazılım mimarlarına Doconut'u Azure Blob, Amazon S3 veya Google Cloud Storage ile nasıl bağlayacaklarını ve görüntüleyiciyi Microsoft Teams, SharePoint veya özel React tabanlı çalışma alanları gibi işbirlikçi portallar üzerinden nasıl sunacaklarını gösterir.

---

Modern .NET Uygulamaları İçin Bulut‑Yerel Belge Görüntülemenin Önemi

Tek Bir .NET Çekirdeği ile Çapraz Platform Tutarlılığı

Şirketler, yalnızca masaüstü belge araçlarından uzaklaşıp Windows üzerinde çalışan web‑öncelikli deneyimleri benimsemektedir. Doconut'un sunucu‑tarafı render motoru .NET 6 ve üzeri üzerinde çalışır ve temel işletim sistemine bakılmaksızın aynı piksel‑mükemmel çıktıyı sağlar. Görüntüleyici akışlarla çalıştığı için herhangi bir bulut kovasından dosyayı alabilir, doğrudan Doconut görüntüleyici bileşenine besleyebilir ve dosyayı diske yazmadan render edilen sayfaları ya da küçük resimleri istemciye döndürebilirsiniz.

Gecikme ve Bant Genişliğini Azaltma

Bir belge Azure Blob Storage'da bulunduğunda, yalnızca ilk sayfayı görüntülemek için tüm dosyayı istemciye indirmek gereksiz gecikmeye yol açar. Doconut, isteğe bağlı küçük resim oluşturmayı destekler; önce düşük çözünürlüklü bir ön izleme isteyebilir ve kullanıcı kaydırdığında tam sayfa renderını alabilirsiniz. Bu desen, yüzlerce megabayt olabilen büyük CAD çizimleri (DWG, DXF) için özellikle değerlidir.

Güvenlik‑Öncelikli İşleme

Tüm ağır iş yükü sunucuda kalır. Doconut'un sunucu‑tarafı işleme yeteneklerini kullanarak gizli PDF'leri, yasal sözleşmeleri veya tıbbi kayıtları özel VNet'iniz içinde ya da kurumsal güvenlik duvarının arkasında tutarsınız. Üçüncü‑taraf bir SaaS çağrılmaz ve görüntüleyici tarayıcı‑tarafı motoruna ham baytları akıtmaz; yalnızca sahne arkasında oluşturduğunuz görüntü döşemeleri veya HTML parçacıkları gönderilir.

Doconut'u Popüler Bulut Depolama Hizmetlerine Bağlamak

Genel Entegrasyon Yaklaşımı

1. Belge akışını elde edin – Seçtiğiniz bulut sağlayıcısının SDK'sını (Azure Blob, Amazon S3, Google Cloud Storage) kullanarak dosyayı bir Stream nesnesine indirin.
2. Akışı Doconut'a iletin – Doconut görüntüleyici, isteğe bağlı render seçenekleriyle birlikte bir akışı kabul eder. Bu, web sunucusunda geçici dosyalara ihtiyaç duyulmasını ortadan kaldırır.
3. Bir görüntüleyici token'ı oluşturun – Doconut, mevcut oturum için açılan belgeyi benzersiz şekilde tanımlayan bir token döndürür. Token, ön uca JSON olarak döndürülebilir ve sonraki sayfa‑render veya açıklama isteklerinde kullanılabilir.
4. İsteğe bağlı sayfa renderı – Ön uç, token ve istenen sayfa numarasıyla Doconut uç noktasını çağırır; Doconut bir görüntü ya da HTML parçası akıtır.

İş akışı yalnızca akışlara dayandığı için Azure kodunu Amazon S3 veya Google Cloud Storage ile değiştirmek, sadece akışı oluşturan bulut‑SDK çağrısında bir değişiklik yapmayı gerektirir; Doconut boru hattının geri kalanı aynı kalır.

Çok‑Kiracılı Depolamayı Yönetme

Bir SaaS DMS'de, her kiracı ayrı bir kova veya önek (prefix) sahip olabilir. Doconut akışlarla çalıştığı için, çalışma zamanında doğru kovayı çözümleyebilir, belgeyi açabilir ve token'ı mevcut kullanıcının haklarına göre sınırlayabilirsiniz. Doconut'un dahili önbelleği (IDistributedCache), Redis veya Azure Cache for Redis kullanacak şekilde yapılandırılabilir; böylece aynı sayfa için tekrarlanan istekler yeniden render edilmek yerine bellekte tutulur.

İşbirlikçi İş Akışlarında Gerçek‑Zamanlı Açıklama ve OCR'yi Etkinleştirme

Açıklama eklentisi: Statik bir görüntüleyiciyi inceleme merkezine dönüştürme

Doconut, kullanıcıların metni vurgulamasına, yapışkan notlar eklemesine veya serbest el şekilleri çizmelerine olanak tanıyan bir Açıklama Eklentisi ile birlikte gelir. Bir belge açıldıktan sonra, görüntüleyiciden bir açıklama yöneticisi elde eder, açıklama nesnelerini ekler veya değiştirir ve açıklama durumunu XML olarak kalıcı hale getirirsiniz. XML'i belge kaydıyla birlikte depolamak, sürümlü inceleme geçmişlerini mümkün kılar; sonraki açılışlarda XML'i yüklemek tam görsel durumu geri getirir.

Tar scanned PDF'ler için OCR‑destekli arama

Taranmış sözleşmeler, makbuzlar veya tıbbi görüntüler genellikle yalnızca görüntü içeren PDF'ler olarak gelir. Doconut'un Arama Eklentisi, görüntüleyici yapılandırmasında etkinleştirildiğinde OCR'ı sunucuda otomatik olarak çalıştırır. OCR motoru sunucu‑tarafı yığını içinde bulunur, böylece çıkarılan metin korunan ortamınızdan dışarı çıkmaz. OCR tamamlandığında, eşleşen sayfa numaralarını ve sınırlayıcı dikdörtgenleri almak için arama API'sini çağırabilir ve UI bu alanları vurgulayabilir. OCR sunucuda çalıştığı için çıkarılan metni Azure Cognitive Search, Elasticsearch veya başka bir arama hizmetine de indeksleyerek tüm depodaki anlık tam metin aramasını sağlayabilirsiniz.

Paylaşılan token'lar aracılığıyla işbirliği

Teams veya SharePoint entegrasyonlarında, genellikle belge kimliğini, kullanıcı izinlerini ve zaman damgasını kodlayan kısa ömürlü bir token oluşturursunuz. Doconut'un OpenDocument çağrısından dönen token dizesi bir JWT içinde sarılabilir veya bir önbellek girdisine kaydedilebilir. Başka bir kullanıcı paylaşılan bağlantıya tıkladığında, aynı token görüntüleyiciyi yeniden doldurmak için kullanılır; böylece açıklamalar ve OCR katmanları tüm katılımcılar için korunur.

Doconut ile Güvenli Sunucu‑Tarafı Dönüştürme ve Kontrollü Baskı

Birçok işletme, gelen Word, Excel veya CAD dosyalarını arşivleme amacıyla PDF'ye dönüştürmek veya “sadece onaylandığında yazdır” politikasını uygulamak zorundadır. Doconut'un Dönüştürücü Eklentisi, bu senaryoları Microsoft Office veya üçüncü‑taraf hizmetlere ihtiyaç duymadan yönetir. Dönüştürme API'sini sunucuda çağırır, kaynak dosya yolunu (veya akışı) ve istenen çıktı formatını iletirsiniz. Dönüştürme tamamen arka uçta çalışır ve belge deponuzda saklanabilecek bir PDF üretir.

PDF oluşturulduktan sonra, görüntüleyici UI'sinde doğrudan Kontrollü Baskıyı etkinleştirebilirsiniz. Doconut, belirli bir belge token'ı için baskı izinlerini ayarlayan bir yöntem sunar. Kullanıcı baskı düğmesine tıkladığında, Doconut bayrağı kontrol eder ve ya yazdırılabilir bir görüntü akışı render eder ya da dostça bir “baskı devre dışı” mesajı döndürür. Bu yaklaşım, tarayıcının baskı iletişim kutusunu engellemek için özel JavaScript kullanımını ortadan kaldırır.

Baskı etkinliğinin denetlenmesi

Baskı isteği Doconut ara katmanından geçtiği için, ASP.NET Core'un kayıt (logging) boru hattına bağlanarak kimin neyi ne zaman bastığını yakalayabilirsiniz. Denetim kaydını bir SQL tablosunda saklayın veya uyumluluk raporlaması için bir SIEM sistemine yönlendirin—her belge erişiminin izlenebilir olması gereken hukuk teknolojisi veya sağlık çözümleri için kritik bir özelliktir.

Çapraz‑Platform Ortamlarında Ölçekleme ve Performans için En İyi Uygulamalar

1. Dağıtık önbelleği kullanın – Doconut'un dahili sayfa‑döşeme önbelleği Redis, Azure Cache veya herhangi bir IDistributedCache uygulamasıyla desteklenebilir. Dönüştürmeden sonra eski görüntülerin sunulmasını önlemek için önbellek anahtarlarına belge sürüm hash'ini ekleyin.
2. Toplu dönüşüm için arka plan işleri kullanın – Büyük bir arşivi devreye alırken, dönüşüm görevlerini Hangfire veya Azure Functions ile kuyruğa ekleyin. Doconut görüntüleyici sınıfı, akışları kabul edip token döndürdüğü için bir HTTP bağlamına ihtiyaç duymadan IHostedService çalışanlarıyla çalışır.
3. Cihaza göre görüntü çözünürlüğünü ayarlayın – Mobil cihazlar daha düşük bir ImageResolution (150‑200 DPI) ile fayda sağlar, masaüstü iş istasyonları CAD detayları için 300 DPI isteyebilir. Çözünürlüğü kullanıcı‑ajan dizesine veya istemci‑tarafı bir ayara göre ayarlayın.
4. Açıklamaların tembel yüklemesini etkinleştirin – Açıklama XML'ini ayrı bir tabloda depolayın ve kullanıcı açıklama panelini açtığında yükleyin. Bu, ilk yükü azaltır ve ilk sayfa renderını hızlandırır.
5. Bellek kullanımını izleyin – Yüksek çözünürlüklü CAD sayfalarını render etmek bellek yoğun olabilir. .NET GC'yi üretimde sunucu modunu kullanacak şekilde yapılandırın (<gcServer enabled="true"/>) ve kontrolsüz render işlerini önlemek için makul bir zaman aşımı belirleyin.
6. Statik varlıklar için bir CDN uygulayın – Görüntüleyicinin JavaScript ve CSS paketleri statiktir. Azure CDN, CloudFront veya Cloudflare üzerinden sunarak, özellikle küresel olarak dağıtılmış ekipler için ilk sayfa yüklemesinden milisaniyeler kazanın.

Bu yönergeleri izleyerek, kıtalar arasında binlerce eşzamanlı kullanıcıyı destekleyebilir ve ilk sayfa için gecikmeyi 200 ms'nin altında tutabilirsiniz—bu, birçok kurumsal portalın hedeflediği bir ölçüttür.

Doconut'un Ücretsiz Denemesiyle Hızlı Başlangıç

Doconut'u değerlendirmek için en hızlı yol, resmi siteden ücretsiz deneme sürümünü indirmek, NuGet paketini yeni bir ASP.NET Core projesine eklemek ve hızlı‑başlangıç kılavuzunu izlemektir. Birkaç dakika içinde Azure Blob'tan belge çekebilen, açıklamayı etkinleştiren, OCR‑tabanlı arama yapan ve güvenli sunucu‑tarafı dönüşüm gerçekleştiren işlevsel bir görüntüleyiciye sahip olacaksınız. Adım‑adım talimatlar için Doconut belgelerine göz atın ve bugün bulut‑yerel belge deneyiminizi inşa etmeye başlayın.

Belge iş akışlarınızı dönüştürmeye hazır mısınız? Şimdi Doconut ücretsiz denemesine kaydolun ve herhangi bir .NET uygulamasında güvenli, aranabilir ve işbirlikçi belge deneyimleri sunmanın ne kadar kolay olduğunu görün.