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

La Document Viewer Library in Doconut ti consente di visualizzare file PDF, Office e CAD, annotarli, cercarne il contenuto e stamparli—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 enterprise ricca di documenti.

Visualizzatore enterprise 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 è un Cambiamento di Gioco per le Imprese .NET

Le imprese 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 auditabile e il testo ricercabile deve essere disponibile anche per le immagini scannerizzate.

La Document Viewer Library di Doconut risolve tutti e tre i problemi con un unico componente .NET lato server che supporta più di 33 tipi di file—incluse DOCX, XLSX, PPTX, DWG e DXF—prontamente. La libreria rende ogni formato nativamente, evitando la necessità di Microsoft Office, Acrobat o servizi di conversione esterni. Poiché il rendering avviene sul server, mantieni i dati sensibili dietro il tuo firewall, aspetto cruciale per sanità, 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 scannerizzata, 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, il 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 enterprise.

Integrazione del Visualizzatore: Guida Passo‑Passo in ASP.NET Core

Di seguito 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 la licenza automaticamente durante la creazione della prima 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 basati 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 Lavoro 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 consente di versionare, auditare o fondere 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 esempio un timbro immagine, un’evidenziazione o un disegno a mano libera) e imposta posizione, dimensione e proprietà visive.
Aggiungi l’annotazione al gestore.
Persiste l’XML dell’annotazione usando GetAnnotationXml e archivialo nel tuo data store.
Quando il documento viene riaperto, carica l’XML salvato nel visualizzatore con LoadAnnotationXML.

Scenari enterprise

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

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

Ricerca Istantanea e OCR: Rendere Ogni Documento Ricercabile

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 full‑text istantanea su qualsiasi file aperto. Per PDF raster o disegni CAD scannerizzati, il motore OCR integrato estrae testo su richiesta, trasformando le immagini in contenuto ricercabile senza un passaggio di pre‑elaborazione separato.

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 scannerizzato 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 per le imprese

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

Tutto ciò è realizzato senza 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 stampare un documento, 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 fornisce ai team .NET un componente unico, sicuro e ricco di funzionalità per il rendering di PDF, file Office e disegni CAD, arricchendoli con annotazioni, ricerca abilitata 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 tua 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.