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

Bulut depolama ve işbirliği platformlarıyla belge görüntüleyici SDK'lerini entegre etme

Belge görüntüleyici SDK'sını bulut depolama ve işbirliği platformlarıyla entegre etmek, .NET uygulamanızdan sorunsuz, güvenli ve aranabilir belge deneyimleri sunmanızı sağlar. Doconut—.NET back‑ends için evrensel bir belge görüntüleyici—ile PDF'leri, Office dosyalarını, CAD çizimlerini ve görüntüleri yerel olarak render edebilir, OCR tabanlı arama ekleyebilir, gerçek zamanlı not eklemeyi etkinleştirebilir ve yazdırmayı kontrol edebilirsiniz; tüm bunları verileri seçtiğiniz bulut ya da yerel ortamda tutarak yaparsınız. 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.

Neden Bulut‑Yerel Belge Görüntüleme Modern .NET Uygulamaları İçin Önemlidir

Tek bir .NET çekirdeği ile çapraz platform tutarlılığı

Kurumsallar, yalnızca masaüstü belge araçlarından uzaklaşıp Windows üzerinde çalışan web‑öncelikli deneyimleri benimseyiyor. Doconut'un sunucu‑tarafı render motoru .NET 6 ve üzeri üzerinde çalışır ve temel işletim sisteminden bağımsız olarak aynı piksel‑mükemmel çıktıyı sağlar. Görüntüleyici akışlarla çalıştığı için, herhangi bir bulut kovasından bir dosyayı alabilir, doğrudan Doconut görüntüleyici bileşenine besleyebilir ve dosyayı diske yazmadan işlenmiş 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 önizleme 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 işleme

Tüm yoğun işlemler 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'inizde 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ğlama

Genel entegrasyon yaklaşımı

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.
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.
Bir görüntüleyici belirteci oluşturun – Doconut, mevcut oturum için açılan belgeyi benzersiz şekilde tanımlayan bir belirteç döndürür. Belirteç, ön‑yüze JSON olarak döndürülebilir ve sonraki sayfa‑render veya not ekleme isteklerinde kullanılabilir.
İsteğe bağlı sayfa renderı – Ön‑yüz, belirteç ve istenen sayfa numarasıyla Doconut uç noktasını çağırır; Doconut bir görüntü ya da HTML fragmenti 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 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 sahip olabilir. Doconut akışlarla çalıştığı için, doğru kovayı çalışma zamanında çözebilir, belgeyi açabilir ve belirteci geçerli kullanıcının haklarına göre sınırlı tutabilirsiniz. Doconut'un dahili önbelleği (IDistributedCache), Redis ya da 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ı Not Ekleme ve OCR'yi Etkinleştirme

Not Ekleme eklentisi: statik görüntüleyiciyi bir inceleme merkezine dönüştürme

Doconut, kullanıcıların metni vurgulamasına, yapışkan not eklemesine veya serbest el şekilleri çizmelerine olanak tanıyan bir Not Ekleme Eklentisi ile birlikte gelir. Bir belge açıldıktan sonra, görüntüleyiciden bir not yöneticisi elde eder, not nesnelerini ekler veya değiştirir ve not 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 ve sonraki açılışlarda XML'i yüklemek tam görsel durumu geri getirir.

Taralı PDF'ler için OCR‑destekli arama

Taralı sözleşmeler, makbuzlar veya tıbbi görüntüler genellikle yalnızca görüntü PDF'leri 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, bu yüzden çıkarılan metin korumalı ortamınızdan dışarı çıkmaz. OCR tamamlandığında, eşleşen sayfa numaralarını ve sınırlama dikdörtgenlerini almak için arama API'sını ç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 indeksleyerek tüm deponuzda anlık tam metin arama sağlayabilirsiniz.

Paylaşılan belirteçlerle işbirliği

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

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

Birçok kuruluş, gelen Word, Excel veya CAD dosyalarını arşivleme için PDF'ye dönüştürmek veya “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'sını sunucuda çağır, kaynak dosya yolunu (veya akışı) ve istenen çıktı formatını ilet. Dönüştürme tamamen arka uçta gerçekleşir ve belge deponuza kaydedilebilecek bir PDF üretir.

PDF oluşturulduktan sonra, görüntüleyici UI'sinde doğrudan Kontrollü Yazdırma'yı etkinleştirebilirsiniz. Doconut, belirli bir belge belirteci için yazdırma izinlerini ayarlayan bir yöntem sunar. Kullanıcı yazdır 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 “yazdırma devre dışı” mesajı döndürür. Bu yaklaşım, tarayıcının yazdırma iletişim kutusunu engellemek için özel JavaScript kullanımını ortadan kaldırır.

Yazdırma etkinliğini denetleme

Yazdırma isteği Doconut ara katmanından geçtiği için, ASP.NET Core'un günlükleme boru hattına bağlanarak kimin neyi ne zaman yazdırdığı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.

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

Dağıtık önbellekleme 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.
Toplu dönüştürme için arka plan işleri kullanın – Büyük bir arşivi devreye alırken, dönüştürme görevlerini Hangfire veya Azure Functions ile kuyruğa alın. Doconut görüntüleyici sınıfı, akışları kabul edip belirteç döndürdüğü için bir HTTP bağlamına ihtiyaç duymadan IHostedService çalışanlarıyla çalışır.
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ı ise CAD detayı için 300 DPI isteyebilir. Çözünürlüğü kullanıcı‑ajan dizesine veya istemci‑tarafı ayara göre ayarlayın.
Notların tembel yüklemesini etkinleştirin – Not XML'ini ayrı bir tabloda saklayın ve kullanıcı not panelini açtığında yükleyin. Bu, başlangıç yükünü azaltır ve ilk sayfa renderını hızlandırır.
Bellek ayak izlerini izleyin – Yüksek çözünürlüklü CAD sayfalarını render etmek bellek yoğun olabilir. .NET GC'yi üretimde sunucu modunda kullanacak şekilde yapılandırın (<gcServer enabled="true"/>) ve kontrolsüz render işlerini önlemek için makul bir zaman aşımı belirleyin.
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—birçok kurumsal portalın hedeflediği bir ölçüt.

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

Doconut'u değerlendirmek için en hızlı yol, resmi siteden ücretsiz denemeyi indirmek, NuGet paketini yeni bir ASP.NET Core projesine eklemek ve hızlı‑başlangıç kılavuzunu izlemektir. Dakikalar içinde Azure Blob'tan belge çekebilen, not eklemeyi etkinleştiren, OCR‑tabanlı arama yapan ve güvenli sunucu‑tarafı dönüştürme gerçekleştiren işlevsel bir görüntüleyiciye sahip olacaksınız. Adım‑adım talimatlar için Doconut belgelerini ziyaret edin 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? Doconut ücretsiz denemesine hemen 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.