Intégration précédente

Utilisez cette section lorsqu'une application .NET Standard existante crée encore Viewer manuellement, transmet des options au middleware, coordonne un web‑farm via un dossier partagé, ou copie les scripts du visualiseur dans l'application. Cette architecture reste documentée pour les clients qui n'ont pas migré.

La version du paquet identifie la génération

L'ID du paquet à lui seul ne suffit pas. Les deux générations sont publiées sous Doconut.NETStandard :

Vérifiez la version dans le fichier de projet, le fichier de verrouillage ou le .nupkg mis en cache avant de choisir un manuel. Une référence de paquet qui indique simplement Doconut.NETStandard ne vous indique rien sur l'API contre laquelle le code a été écrit.

Identifier l'intégration précédente

L'application utilise l'intégration précédente lorsqu'elle contient une ou plusieurs de ces signatures :

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();

Son bloc using est un autre signal fiable — les types de configuration étaient répartis sur plusieurs espaces de noms :

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

Les pages précédentes chargent également souvent des copies gérées par l'application de :

docViewer.js
documentLinks.js
docViewer.UI.js

et déclarent les rappels du visualiseur comme des globals nommés d'après l'ID du conteneur, comme ctlDoc_OnViewerReady().

L'intégration actuelle est quant à elle identifiée par AddDoconut(), UseDoconutResources(), UseDoconut() sans arguments, un Viewer injecté, OpenDocumentAsync(), et l'espace de noms aplati Doconut.

Ouvrir le manuel conservé

Le manuel historique traduit se trouve toujours à Configuration .NET Standard héritée. Son URL n'a pas été redirigé ou remplacé, car il décrit une génération d'intégration réelle que les applications existantes utilisent encore.

Ne combinez pas les extraits de ce manuel avec la documentation actuelle de AddDoconut(). La construction du visualiseur, le routage du middleware, les licences, les ressources, la conversion, la coordination du web‑farm et la propriété des sessions sont tous différents.

Planifier une migration

Utilisez Migrer vers .NET Standard 2.1 pour la correspondance vérifiée entre la construction manuelle et l'ouverture synchrone de documents et le DI, le middleware actuel, les sessions asynchrones, les ressources générées, la publication distribuée et les plugins à fonctionnalités conditionnelles.

Deux points méritent attention avant de commencer :

• Le framework hôte. netstandard2.1 nécessite .NET Core 3.0 ou ultérieur. Un hôte .NET Framework ne peut pas consommer le paquet actuel du tout.
• Les changements côté client. Deux d'entre eux échouent silencieusement — le serveur continue de fonctionner et la console du navigateur reste vide. Ils sont couverts dans le guide de migration.

Conservez le déploiement précédent intact jusqu'à ce que l'application actuelle réussisse ses tests de document, licence, Recherche, Annotation, Convertisseur, DICOM, sécurité et de restauration.