Integrazione degli SDK del Visualizzatore di Documenti con Archiviazione Cloud e Piattaforme di Collaborazione
Perché la Visualizzazione di Documenti Cloud‑Native è Importante per le Moderne App .NET
Coerenza cross‑platform con un unico core .NET
Le imprese stanno abbandonando gli strumenti di documenti solo desktop e stanno adottando esperienze web‑first che funzionano su Windows. Il motore di rendering lato server di Doconut gira su .NET 6 e versioni successive, garantendo lo stesso output pixel‑perfect indipendentemente dal sistema operativo sottostante. Poiché il visualizzatore lavora con stream, puoi prelevare un file da qualsiasi bucket cloud, passarne direttamente lo stream al componente Doconut e restituire pagine renderizzate o miniature al client senza mai scrivere il file su disco.
Riduzione di latenza e larghezza di banda
Quando un documento risiede in Azure Blob Storage, scaricare l'intero file sul client solo per visualizzare la prima pagina genera latenza inutile. Doconut supporta la generazione di miniature on‑demand, permettendoti di richiedere prima un'anteprima a bassa risoluzione e di recuperare il rendering a pagina intera solo quando l'utente scorre. Questo modello è particolarmente utile per grandi disegni CAD (DWG, DXF) che possono superare centinaia di megabyte.
Elaborazione con priorità alla sicurezza
Tutto il lavoro pesante rimane sul server. Utilizzando le capacità di elaborazione lato server di Doconut, mantieni PDF riservati, contratti legali o cartelle cliniche all'interno della tua VNet privata o dietro un firewall aziendale. Nessun SaaS di terze parti viene chiamato e il visualizzatore non trasmette byte grezzi al motore del browser—solo tasselli di immagine o frammenti HTML generati dietro le quinte.
Collegare Doconut ai Servizi di Archiviazione Cloud più Diffusi
Approccio generale di integrazione
- Ottieni lo stream del documento – Usa l'SDK del provider cloud scelto (Azure Blob, Amazon S3, Google Cloud Storage) per scaricare il file in un oggetto
Stream. - Passa lo stream a Doconut – Il visualizzatore Doconut accetta uno stream insieme a eventuali opzioni di rendering. Questo elimina la necessità di file temporanei sul server web.
- Genera un token per il visualizzatore – Doconut restituisce un token che identifica in modo univoco il documento aperto per la sessione corrente. Il token può essere restituito al front‑end come JSON e usato per richieste successive di rendering di pagina o annotazione.
- Renderizza le pagine su richiesta – Il front‑end chiama l'endpoint Doconut con il token e il numero di pagina desiderato; Doconut restituisce un'immagine o un frammento HTML.
Poiché il flusso di lavoro si basa esclusivamente su stream, sostituire il codice Azure con Amazon S3 o Google Cloud Storage richiede solo una modifica nella chiamata SDK cloud che crea lo stream; il resto della pipeline Doconut rimane identico.
Gestione dell'archiviazione multi‑tenant
In un DMS SaaS, ogni tenant può avere un bucket o un prefisso separato. Poiché Doconut lavora con stream, puoi risolvere il bucket corretto a runtime, aprire il documento e mantenere il token limitato alle rivendicazioni dell'utente corrente. La cache interna di Doconut (IDistributedCache) può essere configurata per usare Redis o Azure Cache for Redis, garantendo che le richieste ripetute per la stessa pagina vengano servite dalla memoria anziché da un nuovo rendering.
Abilitare Annotazioni in Tempo Reale e OCR nei Flussi di Lavoro Collaborativi
Plugin di annotazione: trasformare un visualizzatore statico in un hub di revisione
Doconut fornisce un Plugin di Annotazione che consente agli utenti di evidenziare testo, aggiungere note adesive o disegnare forme a mano libera. Dopo l'apertura di un documento, ottieni un manager delle annotazioni dal visualizzatore, aggiungi o modifica gli oggetti di annotazione e persisti lo stato delle annotazioni come XML. Memorizzare l'XML accanto al record del documento consente storici di revisione versionati, e il caricamento dell'XML nelle aperture successive ripristina lo stato visivo esatto.
Ricerca alimentata da OCR per PDF scansionati
Contratti, ricevute o immagini mediche scansionate arrivano spesso come PDF solo immagine. Il Search Plugin di Doconut esegue automaticamente l'OCR sul server quando lo abiliti nella configurazione del visualizzatore. Il motore OCR vive all'interno dello stack lato server, quindi il testo estratto non lascia mai il tuo ambiente protetto. Una volta completato l'OCR, puoi chiamare l'API di ricerca per recuperare i numeri di pagina e i rettangoli di delimitazione corrispondenti, che l'interfaccia può evidenziare. Poiché l'OCR è eseguito sul server, puoi anche indicizzare il testo estratto in Azure Cognitive Search, Elasticsearch o qualsiasi altro servizio di ricerca per fornire ricerca full‑text istantanea su tutto il repository.
Collaborazione tramite token condivisi
Nelle integrazioni con Teams o SharePoint, tipicamente generi un token a breve durata che codifica l'ID del documento, i permessi dell'utente e un timestamp. La stringa di token restituita da OpenDocument può essere incapsulata in un JWT o memorizzata in una voce di cache. Quando un altro utente clicca sul link condiviso, lo stesso token viene usato per reidratare il visualizzatore, preservando annotazioni e livelli OCR per tutti i partecipanti.
Conversione Sicura Lato Server e Stampa Controllata con Doconut
Molte imprese devono convertire file Word, Excel o CAD in PDF per l'archiviazione, o applicare una politica “stampa‑solo‑se‑approvata”. Il Converter Plugin di Doconut gestisce questi scenari senza richiedere Microsoft Office o servizi di terze parti. Invoci l'API di conversione sul server, passando il percorso del file sorgente (o lo stream) e il formato di output desiderato. La conversione avviene interamente sul back‑end, producendo un PDF che può essere memorizzato nel tuo repository documentale.
Una volta che il PDF è disponibile, puoi abilitare la Stampa Controllata direttamente nell'interfaccia del visualizzatore. Doconut espone un metodo per impostare i permessi di stampa per un dato token documento. Quando l'utente clicca sul pulsante stampa, Doconut verifica il flag e o rende uno stream di immagine stampabile o restituisce un messaggio amichevole “stampa disabilitata”. Questo approccio elimina la necessità di JavaScript personalizzato per bloccare la finestra di stampa del browser.
Audit dell’attività di stampa
Poiché la richiesta di stampa passa attraverso il middleware di Doconut, puoi agganciarti al pipeline di logging di ASP.NET Core per catturare chi ha stampato cosa e quando. Memorizza la voce di audit in una tabella SQL o inoltrala a un sistema SIEM per report di conformità—critico per soluzioni legali o sanitarie dove ogni accesso al documento deve essere tracciabile.
Best Practice per Scalabilità e Prestazioni in Ambienti Cross‑Platform
- Sfrutta la cache distribuita – La cache interna di tile di pagina di Doconut può essere supportata da Redis, Azure Cache o qualsiasi implementazione
IDistributedCache. Includi l'hash della versione del documento nelle chiavi di cache per evitare di servire immagini obsolete dopo una conversione. - Usa job in background per conversioni massive – Quando importi un grande archivio, accoda i task di conversione con Hangfire o Azure Functions. La classe del visualizzatore Doconut funziona con worker
IHostedServiceperché accetta stream e restituisce token senza richiedere un contesto HTTP. - Regola la risoluzione immagine per dispositivo – I dispositivi mobili beneficiano di un
ImageResolutionpiù basso (150‑200 DPI), mentre le workstation desktop possono richiedere 300 DPI per i dettagli CAD. Regola la risoluzione in base allo user‑agent o a un'impostazione client‑side. - Abilita il lazy loading delle annotazioni – Memorizza l'XML delle annotazioni in una tabella separata e caricalo solo quando l'utente apre il pannello annotazioni. Questo riduce il payload iniziale e velocizza il rendering della prima pagina.
- Monitora l’utilizzo di memoria – Il rendering di pagine CAD ad alta risoluzione può essere intensivo in memoria. Configura il GC di .NET per usare la modalità server in produzione (
<gcServer enabled="true"/>) e imposta un timeout ragionevole per prevenire job di rendering incontrollati. - Applica un CDN per le risorse statiche – I bundle JavaScript e CSS del visualizzatore sono statici. Servili da Azure CDN, CloudFront o Cloudflare per ridurre di alcuni millisecondi il caricamento iniziale, soprattutto per team distribuiti a livello globale.
Seguendo queste linee guida, potrai supportare migliaia di utenti concorrenti su più continenti mantenendo la latenza sotto i 200 ms per la prima pagina—un benchmark a cui molte porte aziendali aspirano.
Inizia Rapidamente con la Prova Gratuita di Doconut
Il modo più veloce per valutare Doconut è scaricare la prova gratuita dal sito ufficiale, aggiungere il pacchetto NuGet a un nuovo progetto ASP.NET Core e seguire la guida rapida. In pochi minuti avrai un visualizzatore funzionante capace di prelevare documenti da Azure Blob, abilitare annotazioni, eseguire ricerca basata su OCR e effettuare conversione sicura lato server. Per istruzioni passo‑passo, visita la documentazione di Doconut e inizia a costruire oggi la tua esperienza documentale cloud‑native.
Pronto a trasformare i tuoi flussi di lavoro documentali? Registrati subito alla prova gratuita di Doconut e scopri quanto è semplice fornire esperienze documentali sicure, ricercabili e collaborative in qualsiasi applicazione .NET.