Lavorare con la Document Viewer Library – supporta PDF, Office e formati CAD con annotazioni integrate, ricerca e stampa: Guida Pratica

La Document Viewer Library in Doconut ti consente di visualizzare file PDF, Office e CAD, aggiungere annotazioni, cercare nei contenuti e stampare — tutto da un unico componente .NET.
Se stai costruendo un portale incentrato sui documenti, un gestore di casi per il legal‑tech o uno strumento di revisione di disegni ingegneristici, hai bisogno di un visualizzatore che funzioni come i tuoi utenti: istantaneamente, in modo sicuro e senza servizi esterni. Doconut offre questa esperienza on‑premise, all’interno della tua applicazione ASP.NET o .NET Core, mantenendo il codice pulito e l’ingombro di distribuzione ridotto.

In questa guida pratica percorreremo il flusso di lavoro principale della Document Viewer Library, ti mostreremo come integrarla e dimostreremo i tre pilastri che la rendono indispensabile — annotazione, ricerca (inclusa OCR) e stampa controllata. Alla fine avrai un prototipo pronto all'uso e una chiara visione di come Doconut possa diventare la spina dorsale di qualsiasi soluzione aziendale ricca di documenti.

Visualizzatore aziendale sicuro che mostra file PDF, Office e CAD con strumenti di annotazione e stampa

Distribuzione su Windows e Opzioni di Prova Gratuita

La libreria di Doconut funziona su .NET 6 ed è pienamente supportata negli ambienti Windows. Che tu ospiti la tua app su Azure, AWS o on‑premise, offre rendering e prestazioni di annotazione costanti.

Per iniziare rapidamente, Doconut offre una prova gratuita che include l’accesso completo al motore di annotazione, alla ricerca abilitata con OCR e alle funzionalità di stampa controllata. Registrati sul sito ufficiale, scarica la licenza di prova e segui i passaggi di integrazione qui sotto per vedere la libreria in azione in pochi minuti.

Perché la Document Viewer Library è una Svolta per le Imprese .NET

Le aziende che gestiscono contratti, schemi ingegneristici o archivi dipendenti affrontano tre sfide ricorrenti:

Diversità di formati – PDF, documenti Word, fogli Excel e disegni CAD convivono nello stesso repository.
Revisione collaborativa – Gli utenti business devono evidenziare, commentare o timbrare un documento senza uscire dall’applicazione.
Accesso regolamentato – La stampa deve essere tracciabile e il testo ricercabile deve essere disponibile anche per le immagini scansionate.

La Document Viewer Library di Doconut risolve tutti e tre i punti con un singolo componente .NET lato server che supporta più di 33 tipi di file — inclusi DOCX, XLSX, PPTX, DWG e DXF — fin da subito. La libreria rende ogni formato nativamente, evitando la necessità di Microsoft Office, Acrobat o servizi di conversione esterni. Poiché il rendering avviene sul server, i dati sensibili rimangono dietro il tuo firewall, un requisito fondamentale per sanità, settore legale e finanza.

Il motore di annotazione integrato ti permette di aggiungere evidenziazioni, disegni a mano libera o timbri di approvazione direttamente sulla tela del visualizzatore. Le annotazioni sono memorizzate come XML leggero, facilitandone la persistenza in un database o in un sistema di versionamento. Il plugin di ricerca fornisce ricerca testuale istantanea su qualsiasi documento aperto; quando la sorgente è un’immagine scansionata, il motore OCR estrae le stringhe ricercabili al volo. Infine, la funzionalità di stampa controllata ti consente di imporre limiti di intervallo di pagine, filigrane o log di stampa, tutto tramite una singola chiamata API.

Insieme, queste capacità ti permettono di sostituire un complesso stack di visualizzatori di terze parti, plugin JavaScript e servizi di conversione esterni con una singola libreria manutenibile che scala da pochi utenti a distribuzioni aziendali su larga scala.

Integrare il Visualizzatore: Integrazione Passo‑Passo in ASP.NET Core

Di seguito trovi una descrizione concisa dei passaggi necessari per integrare la Document Viewer Library di Doconut in un’applicazione ASP.NET Core:

Registra il middleware Doconut – configura il middleware UseDoconut per gestire l’endpoint interno di tile immagine (DocImage.axd). Questo endpoint trasmette le pagine renderizzate come tile PNG, mantenendo l’interfaccia reattiva anche per file CAD di grandi dimensioni.
Carica la licenza – fornisci il file di licenza Doconut (es. DoconutLicense.xml) come file su disco o come stream. La libreria legge automaticamente la licenza al primo avvio di un’istanza del visualizzatore.
Crea un’istanza del visualizzatore – istanzia la classe Viewer, passando eventuali servizi richiesti come una cache distribuita o un accessor del contesto HTTP.
Configura le opzioni di rendering – imposta un oggetto di configurazione (ad esempio PdfConfig) per controllare il comportamento di rendering predefinito, l’estrazione di hyperlink e la risoluzione raster per i disegni CAD.
Apri un documento – chiama il metodo OpenDocument con il percorso del file (o stream) e la configurazione definita in precedenza. Il metodo restituisce un token sicuro che il front‑end JavaScript utilizza per richiedere immagini di pagina, annotazioni e risultati di ricerca.

Questi passaggi producono un visualizzatore lato server per ambienti Windows su .NET 6. L’approccio basato su token mantiene il client leggero: il front‑end deve solo fare riferimento al componente visualizzatore Doconut ospitato su https://doconut.app.

Annotazioni Integrate per Flussi di Revisione in Tempo Reale

Le annotazioni trasformano un visualizzatore passivo in uno spazio di lavoro collaborativo. Il gestore di annotazioni di Doconut opera per pagina e memorizza tutto come XML, il che significa che puoi versionare, auditare o unire facilmente le modifiche in un database.

Flusso tipico di annotazione

Recupera il gestore di annotazioni per la pagina corrente chiamando il metodo GetAnnotationManager del visualizzatore, fornendo le dimensioni della pagina.
Crea un oggetto annotazione (ad es. un timbro immagine, evidenziazione o disegno a mano libera) e imposta posizione, dimensione e proprietà visive.
Aggiungi l’annotazione al gestore.
Persiste l’XML dell’annotazione usando GetAnnotationXml e salvalo nel tuo archivio dati.
Quando il documento viene riaperto, carica l’XML salvato nel visualizzatore con LoadAnnotationXML.

Scenari aziendali

Legal Tech – Gli avvocati appongono un timbro “Firma” su un contratto, quindi inviano l’XML al servizio di gestione dei casi per l’audit.
Revisione Ingegneristica – I progettisti aggiungono disegni di correzione direttamente su una pagina DWG; l’XML dell’annotazione è memorizzato insieme alla cronologia delle revisioni.
HR & Reclutamento – I recruiter evidenziano sezioni chiave di un curriculum, aggiungono commenti e inviano la versione annotata al profilo del candidato.

Poiché i dati delle annotazioni risiedono sul server, mantieni pieno controllo su chi può modificare, visualizzare o stampare. L’API è volutamente snella: ti servono solo i metodi di recupero, aggiunta e caricamento del gestore, e puoi costruire funzionalità UI aggiuntive (undo/redo, strumenti personalizzati) senza introdurre dipendenze extra.

Ricerca Istantanea e OCR: Rendere Ogni Documento Trovabile

Un repository di documenti è utile solo quando gli utenti possono trovare le informazioni di cui hanno bisogno in pochi secondi. Il plugin di ricerca di Doconut offre ricerca testuale completa e istantanea su qualsiasi file aperto. Per PDF raster o disegni CAD scansionati, il motore OCR integrato estrae il testo su richiesta, trasformando le immagini in contenuti ricercabili senza una fase di pre‑elaborazione separata.

Flusso tipico di ricerca

Chiama il metodo di ricerca del visualizzatore (esposto dal Search Plugin) con la parola chiave desiderata.
Ricevi un elenco di numeri di pagina corrispondenti e le coordinate di ciascuna occorrenza.
Per ogni risultato, ottieni il gestore di annotazioni della pagina e aggiungi un’annotazione di evidenziazione temporanea per mostrare all’utente dove appare il termine.

Quando un utente apre un PDF scansionato di una fattura, il visualizzatore esegue automaticamente OCR su ogni pagina durante il rendering. Il testo estratto viene indicizzato in memoria, rendendo le ricerche successive istantanee. Questo approccio elimina la necessità di un servizio OCR separato, riduce la latenza e garantisce che il testo ricercabile non lasci mai il tuo ambiente sicuro.

Benefici aziendali

Portali clienti possono mostrare clausole rilevanti da un contratto con un solo tasto.
Strumenti di reporting finanziario consentono agli analisti di individuare una voce di spesa tra decine di estratti scansionati.
Sistemi di cartelle cliniche diventano ricercabili per nomi di farmaci all’interno di note mediche scansionate, migliorando la sicurezza del paziente.

Tutto ciò è realizzato con zero dipendenze di terze parti, mantenendo lo stack leggero e la superficie di conformità ridotta.

Stampa Controllata dal Visualizzatore – Sicurezza Incontra la Convenienza

La stampa è spesso il punto più debole nella sicurezza dei documenti. La funzionalità di stampa controllata di Doconut ti dà l’autorità di decidere cosa, quando e come un documento può essere stampato, fornendo al contempo una familiare finestra di dialogo di stampa del browser.

Flusso tipico di stampa

Definisci un oggetto PrintConfig che specifica opzioni come limiti di intervallo di pagine, filigrane e se registrare ogni richiesta di stampa.
Passa la configurazione insieme al token del documento al metodo Print del visualizzatore.
Il visualizzatore rende le pagine selezionate sul server, applica le filigrane e trasmette il PDF stampabile al browser del client.
Viene creata automaticamente una voce di audit, consentendo agli amministratori di tracciare chi ha stampato cosa e quando.

Gestendo la stampa sul server, Doconut garantisce che il documento originale non lasci mai il tuo ambiente protetto e ti offre piena visibilità sull’attività di stampa — un requisito critico per i settori regolamentati.

Conclusione

La Document Viewer Library di Doconut offre ai team .NET un singolo componente sicuro e ricco di funzionalità per il rendering di PDF, file Office e disegni CAD, arricchiti da annotazioni, ricerca con OCR e stampa controllata. Con l’elaborazione lato server, la conversione integrata e il supporto per oltre 33 formati, puoi eliminare costose dipendenze di terze parti e mantenere i dati sensibili sotto il tuo diretto controllo.

Pronto a modernizzare il flusso di lavoro documentale della tua impresa? Inizia subito la prova gratuita di Doconut, scarica la libreria e segui i passaggi di integrazione descritti sopra per portare potenti capacità di visualizzazione, annotazione e ricerca nella tua applicazione .NET in pochi minuti.