La visualizzazione di documenti incorporata dovrebbe apparire come parte dell'applicazione, non come un passaggio a una vecchia estensione del browser o a un programma desktop installato localmente. Per progetti ASP.NET e .NET basati su Windows, Doconut fornisce un SDK per visualizzatore di documenti che può renderizzare i documenti aziendali all'interno della tua applicazione web.

Questa guida spiega l'architettura di un'esperienza di visualizzazione senza plugin senza presentare il codice sorgente non documentato di Doconut.

Documenti che passano attraverso un servizio di rendering .NET verso un visualizzatore incorporato senza plugin

Cosa Significa “Senza Plugin”

Un visualizzatore senza plugin non richiede all'utente finale di installare tecnologie come ActiveX, Flash, Silverlight o un'estensione personalizzata del browser prima di aprire un documento.

Ciò riduce diverse fonti di attrito:

Gli utenti non hanno bisogno di permessi di installazione locale.
I team IT non devono distribuire e aggiornare un plugin lato client.
L'applicazione mantiene il flusso di visualizzazione all'interno della propria interfaccia.
Le dipendenze da plugin legacy non diventano una condizione per aprire un file.

Senza plugin non significa senza dipendenze. Il server ha ancora bisogno dell'SDK corretto, del runtime, dei font, dell'accesso allo storage, della configurazione e della licenza. L'applicazione rimane inoltre responsabile di autenticazione, autorizzazione, conservazione e monitoraggio.

Perché il Rendering di Documenti sul Server è Utile

I documenti aziendali sono più complessi rispetto al contenuto web ordinario. I file Office, i disegni CAD, i messaggi email e le immagini ad alta risoluzione richiedono tutti una elaborazione consapevole del formato.

Un componente .NET lato server può gestire tale elaborazione mentre l'applicazione web presenta l'esperienza di visualizzazione risultante. Questo evita di chiedere a ogni utente di installare il software di authoring originale.

Doconut è progettato per questo ruolo. Le informazioni attuali sul prodotto descrivono il supporto per tipi di documento tra cui PDF, documenti Office, disegni CAD, file email e immagini. Conferma i formati esatti e le funzionalità richieste dalla tua applicazione sulla pagina del visualizzatore Doconut.

Pianifica il Flusso di Visualizzazione

Una richiesta di documento sicura tipicamente segue questi passaggi:

L'utente seleziona un documento utilizzando un identificatore dell'applicazione.
ASP.NET autentica la richiesta.
Il server verifica l'accesso a quel documento specifico.
L'applicazione risolve la posizione di storage protetta.
Il documento viene passato al livello di visualizzazione utilizzando il metodo di integrazione supportato.
L'applicazione registra il risultato e rilascia le risorse temporanee.

Il client non dovrebbe mai ricevere credenziali di storage, percorsi server non limitati, o più informazioni sul documento di quelle richieste dalla sessione autorizzata.

Utilizza i Confini di Sicurezza Standard di ASP.NET

La pagina di visualizzazione dovrebbe essere protetta come qualsiasi altra risorsa sensibile.

I meccanismi .NET standard possono includere:

Middleware di autenticazione
l'attributo [Authorize]
Policy di autorizzazione e informazioni di autorizzazione
Autorizzazione basata su risorse
Iniezione delle dipendenze per i servizi di storage e visualizzazione
Logging strutturato con filtraggio dei dati sensibili

L'autorizzazione deve essere valutata sul server. Nascondere un'azione della barra degli strumenti o una route nell'interfaccia utente non impedisce a un client determinato di richiederla direttamente.

Mantieni l'Accesso all'SDK Dietro un Servizio Applicativo

Evita di diffondere chiamate specifiche del visualizzatore attraverso controller e pagine. Un servizio applicativo dedicato può:

Risolvere gli identificatori dei documenti autorizzati
Aprire uno Stream controllato
Applicare la configurazione per la versione SDK installata
Rilasciare le risorse di file e stream
Convertire i fallimenti tecnici in errori applicativi sicuri
Registrare i tempi e le diagnostiche sanificate

Questo confine rende l'applicazione più facile da testare e riduce l'impatto di futuri aggiornamenti dell'SDK.

Utilizza le risorse ufficiali di download e documentazione Doconut per l'installazione del pacchetto e le indicazioni API specifiche per versione.

Costruisci un Host Visualizzatore Utilizzabile

Il contenitore del visualizzatore di proprietà dell'applicazione dovrebbe avere spazio sufficiente per documenti reali. Evita schede strette e larghezze fisse da desktop.

.viewer-workspace {
  display: grid;
  grid-template-rows: auto minmax(0, 1fr);
  width: 100%;
  min-height: 36rem;
  height: calc(100dvh - 4rem);
}

.viewer-host {
  min-width: 0;
  min-height: 0;
  overflow: hidden;
}

Questo è CSS standard per la pagina circostante, non una configurazione Doconut. Non mirare a selettori interni non documentati né inventare opzioni SDK.

Uno stato di caricamento chiaro
Un messaggio di errore sicuro
Un titolo del documento visibile
Un modo per tornare al flusso di lavoro principale
Controlli applicativi accessibili
Spazio sufficiente per fogli di calcolo ampi e disegni dettagliati

Convalida i Documenti Prima del Rendering

Se gli utenti caricano file, verifica:

Dimensione del file
Estensione e firma del file
Formato supportato
Requisiti di password o crittografia
Restrizioni specifiche per il business
Nome di storage generato dal server

Non costruire percorsi server direttamente dal nome file originale. Memorizza un identificatore applicativo sicuro e risolvilo tramite un servizio lato server autorizzato.

Prepara il Server Windows

Il comportamento del rendering può dipendere dall'ambiente del server. Conferma:

Versioni Windows e .NET supportate
Font richiesti
Posizione e permessi di storage temporaneo
CPU, memoria e capacità disco disponibili
Dimensione massima del documento e sessioni concorrenti
Configurazione della licenza
Procedure di pulizia

Testa documenti rappresentativi dei clienti su un ambiente che corrisponda alla produzione.

Checklist di Sicurezza e Privacy

Prima del rilascio:

Autenticare le richieste di visualizzazione dove necessario.
Autorizzare l'utente per il documento specifico.
Mantenere i percorsi di storage e le credenziali sul server.
Limitare i permessi dei file temporanei.
Definire la conservazione per originali, dati temporanei ed esportazioni.
Sanitizzare gli errori mostrati agli utenti.
Escludere i contenuti dei documenti e i segreti dai log.
Applicare limiti di upload e concorrenza.
Mantenere l'SDK e le dipendenze dell'applicazione aggiornate.

Le affermazioni sulla conformità dovrebbero riflettere l'intero sistema distribuito e i processi della tua organizzazione, non un singolo componente UI.

Testa Oltre il Caso Ideale

La tua libreria di test dovrebbe includere:

PDF multi-pagina
Fogli di calcolo di grandi dimensioni
Disegni CAD dettagliati
Presentazioni con font non comuni
File email con allegati
Immagini di grandi dimensioni
File danneggiati e non supportati
Richieste non autorizzate
Sessioni di visualizzazione concorrenti
Richieste interrotte e riavvii dell'applicazione

Conferma che i fallimenti non rivelino percorsi server, stack trace o URL di storage.

Dove si Inserisce Doconut

Doconut fornisce la capacità di visualizzazione di documenti incorporata all'interno di un'applicazione web .NET. La tua applicazione fornisce la sicurezza circostante, lo storage, il flusso di lavoro, il layout responsivo e i controlli operativi.

Questa separazione consente ai team di sostituire i flussi di lavoro dipendenti da plugin legacy senza far finta che la gestione dei documenti diventi senza sforzo o priva di responsabilità.

Esplora il verificato SDK visualizzatore documenti .NET di Doconut, poi utilizza la pagina di download ufficiale per le istruzioni che corrispondono alla versione selezionata.

Conclusione

Un'esperienza di documenti senza plugin riduce l'attrito di installazione e mantiene gli utenti all'interno della tua applicazione. Costruiscila su un flusso di documenti autorizzato dal server, isola l'accesso all'SDK, fornisci un host visualizzatore spazioso e testa file reali sotto carico simile alla produzione.

Per applicazioni ASP.NET e .NET basate su Windows, Doconut può fornire lo strato di visualizzazione dei documenti mentre il tuo team mantiene il controllo dell'applicazione e del ciclo di vita dei documenti.