Integrazione precedente

Usa questa sezione quando un'applicazione .NET Standard esistente costruisce ancora Viewer manualmente, passa opzioni al middleware, coordina un web‑farm tramite una cartella condivisa o copia gli script del viewer nell'applicazione. Quell'architettura rimane documentata per i clienti che non hanno ancora migrato.

La versione del pacchetto identifica la generazione

Il solo ID del pacchetto non è sufficiente. Entrambe le generazioni vengono pubblicate come Doconut.NETStandard:

Controlla la versione nel file di progetto, nel file di blocco o nel .nupkg memorizzato nella cache prima di scegliere un manuale. Un riferimento al pacchetto che dice semplicemente Doconut.NETStandard non ti dice nulla su quale API il codice è stato scritto.

Identifica l'integrazione precedente

L'applicazione utilizza l'integrazione precedente quando contiene una o più di queste firme:

var viewer = new Viewer(_cache, _accessor);
var viewer = new Viewer(_cache, _accessor, licenseFilePath);

var token = viewer.OpenDocument(path, config, documentOptions);
viewer.InitCache();

appBranch.UseDoconut(new DoconutOptions { UnSafeMode = false, ShowDoconutInfo = false });

appBranch.UseDoconutWebFarm(new WebFarmOptions { Path = sharedFolder });

Viewer.DoconutLicense(licenseStream);
Viewer.SetLicensePlugin(pluginLicenseStream);

var converter = viewer.Converter.GetConverter();

Il suo blocco using è un altro segnale affidabile — i tipi di configurazione erano sparsi in diversi namespace:

using Doconut.Configs;
using Doconut.Configs.View;
using Doconut.Configs.Cloud;
using Doconut.Models;

Le pagine precedenti caricano spesso copie gestite dall'applicazione di:

docViewer.js
documentLinks.js
docViewer.UI.js

e dichiarano callback del viewer come variabili globali nominate in base all'ID del contenitore, ad esempio ctlDoc_OnViewerReady().

L'integrazione attuale, invece, è identificata da AddDoconut(), UseDoconutResources(), UseDoconut() senza argomenti, un Viewer iniettato, OpenDocumentAsync() e il namespace appiattito Doconut.

Apri il manuale preservato

Il manuale storico tradotto è disponibile su Configurazione Legacy .NET Standard. Il suo URL non è stato reindirizzato né sostituito, perché descrive una generazione di integrazione reale che le applicazioni esistenti continuano a utilizzare.

Non combinare frammenti di quel manuale con la documentazione corrente di AddDoconut(). Costruzione del viewer, routing del middleware, licenze, risorse, conversione, coordinamento del web‑farm e proprietà della sessione sono tutti diversi.

Pianifica una migrazione

Usa Migra a .NET Standard 2.1 per la mappatura verificata dalla costruzione manuale e dall'apertura sincrona dei documenti a DI, middleware attuale, sessioni asincrone, risorse generate, pubblicazione distribuita e plugin con controllo di capacità.

Due aspetti meritano attenzione prima di iniziare:

• Il framework host. netstandard2.1 richiede .NET Core 3.0 o versioni successive. Un host .NET Framework non può consumare il pacchetto attuale affatto.
• Le modifiche lato client. Due di esse falliscono silenziosamente — il server continua a funzionare e la console del browser rimane vuota. Sono trattate nella guida di migrazione.

Mantieni l'implementazione precedente intatta finché l'applicazione attuale non supera i test su documento, licenza, Ricerca, Annotazione, Converter, DICOM, sicurezza e rollback.