Integrazione degli SDK del visualizzatore di documenti con l'archiviazione cloud e le 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 aziende si stanno allontanando dagli 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, è possibile prelevare un file da qualsiasi bucket cloud, alimentarlo direttamente al componente visualizzatore Doconut e restituire pagine renderizzate o miniature al client senza mai scrivere il file su disco.
Riduzione della latenza e della larghezza di banda
Quando un documento è archiviato 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, consentendo 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 raggiungere 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. Non viene chiamato alcun SaaS di terze parti, e il visualizzatore non trasmette mai byte grezzi a un motore lato browser—solo tasselli di immagine o frammenti HTML che generi dietro le quinte.
Collegare Doconut ai popolari servizi di archiviazione cloud
Approccio generale all'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 opzioni di rendering opzionali. 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 utilizzato 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 in streaming un'immagine o un frammento HTML.
Poiché il flusso di lavoro si basa solo su stream, sostituire il codice Azure con Amazon S3 o Google Cloud Storage richiede solo una modifica nella chiamata al cloud‑SDK 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 prefisso separato. Poiché Doconut lavora con stream, è possibile 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 utilizzare 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 include 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 gestore delle annotazioni dal visualizzatore, aggiungi o modifica gli oggetti di annotazione e persisti lo stato delle annotazioni come XML. Memorizzare l'XML insieme al record del documento consente storici di revisione versionati, e il caricamento dell'XML nelle aperture successive ripristina lo stato visivo esatto.
Ricerca potenziata da OCR per PDF scansionati
I contratti, le ricevute o le immagini mediche scansionate spesso arrivano 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 risiede 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 corrispondenti e i rettangoli di delimitazione, che l'interfaccia può evidenziare. Poiché l'OCR gira sul server, puoi anche indicizzare il testo estratto in Azure Cognitive Search, Elasticsearch o qualsiasi altro servizio di ricerca per fornire una ricerca full‑text istantanea su tutto il tuo repository.
Collaborazione tramite token condivisi
Nelle integrazioni con Teams o SharePoint, tipicamente generi un token a breve durata che codifica l'ID del documento, le autorizzazioni dell'utente e un timestamp. La stringa token di Doconut restituita dalla chiamata OpenDocument può essere avvolta in un JWT o memorizzata in una voce di cache. Quando un altro utente clicca sul link condiviso, lo stesso token viene usato per re‑idratare il visualizzatore, preservando annotazioni e livelli OCR per tutti gli utenti coinvolti.
Conversione sicura lato server e stampa controllata con Doconut
Molte aziende hanno bisogno di convertire file Word, Excel o CAD in PDF per l'archiviazione, o di applicare una politica di “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 di documenti.
Una volta che il PDF esiste, puoi abilitare la Stampa controllata direttamente nell'interfaccia del visualizzatore. Doconut espone un metodo per impostare i permessi di stampa per un determinato token di documento. Quando l'utente clicca sul pulsante di 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 dialogo di stampa del browser.
Audit dell'attività di stampa
Poiché la richiesta di stampa passa attraverso il middleware 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 la segnalazione 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 di
IDistributedCache. Includi l'hash della versione del documento nelle chiavi della cache per evitare di servire immagini obsolete dopo una conversione. - Utilizza job in background per conversioni di massa – Quando si integra un grande archivio, accoda i task di conversione con Hangfire o Azure Functions. La classe visualizzatore Doconut funziona con worker
IHostedServiceperché accetta stream e restituisce token senza richiedere un contesto HTTP. - Regola la risoluzione dell'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 alla stringa 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 delle 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 termini di 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 qualche millisecondo il caricamento iniziale della pagina, soprattutto per team distribuiti a livello globale.
Seguendo queste linee guida, puoi supportare migliaia di utenti concorrenti su più continenti mantenendo la latenza sotto i 200 ms per la prima pagina—un benchmark a cui puntano molti portali aziendali.
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 funzionale in grado di prelevare documenti da Azure Blob, abilitare le annotazioni, eseguire ricerche basate su OCR e effettuare conversioni sicure 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? Iscriviti subito alla prova gratuita di Doconut e scopri quanto è facile offrire esperienze documentali sicure, ricercabili e collaborative in qualsiasi applicazione .NET.