Integración anterior

Utilice esta sección cuando una aplicación .NET Standard existente aún construye Viewer manualmente, pasa opciones al middleware, coordina una granja web a través de una carpeta compartida o copia los scripts del visor en la aplicación. Esa arquitectura sigue documentada para los clientes que no han migrado.

La versión del paquete identifica la generación

El ID del paquete por sí solo no es suficiente. Ambas generaciones se publican como Doconut.NETStandard:

Verifique la versión en el archivo de proyecto, el archivo de bloqueo o el .nupkg en caché antes de elegir un manual. Una referencia de paquete que solo dice Doconut.NETStandard no le indica nada sobre qué API está escrita el código.

Identificar la integración anterior

La aplicación está usando la integración anterior cuando contiene una o más de estas firmas:

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

Su bloque using es otra señal fiable — los tipos de configuración estaban distribuidos en varios espacios de nombres:

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

Las páginas anteriores también suelen cargar copias gestionadas por la aplicación de:

docViewer.js
documentLinks.js
docViewer.UI.js

y declarar devoluciones de llamada del visor como globales nombradas según el id del contenedor, como ctlDoc_OnViewerReady().

La integración actual, en cambio, se identifica por AddDoconut(), UseDoconutResources(), UseDoconut() sin argumentos, un Viewer inyectado, OpenDocumentAsync(), y el espacio de nombres aplanado Doconut.

Abrir el manual preservado

El manual histórico traducido permanece en Configuración heredada de .NET Standard. Su URL no ha sido redirigida ni reemplazada, porque describe una generación real de integración que las aplicaciones existentes aún utilizan.

No combine fragmentos de ese manual con la documentación actual de AddDoconut(). La construcción del visor, el enrutamiento del middleware, licencias, recursos, conversión, coordinación de granjas web y la propiedad de la sesión son todos diferentes.

Planificar una migración

Utilice Migrar a .NET Standard 2.1 para la asignación verificada de la construcción manual y la apertura síncrona de documentos a DI, middleware actual, sesiones async, recursos generados, publicación distribuida y complementos con control de capacidades.

Dos cosas merecen atención antes de comenzar:

• El framework host. netstandard2.1 requiere .NET Core 3.0 o posterior. Un host .NET Framework no puede consumir el paquete actual en absoluto.
• Los cambios del lado del cliente. Dos de ellos fallan silenciosamente — el servidor sigue funcionando y la consola del navegador permanece vacía. Están cubiertos en la guía de migración.

Mantenga la implementación anterior intacta hasta que la aplicación actual apruebe sus pruebas de documento, licencia, búsqueda, anotación, conversor, DICOM, seguridad y reversión.