Integração anterior

Use esta seção quando uma aplicação .NET Standard existente ainda constrói o Viewer manualmente, passa opções para o middleware, coordena um web farm através de uma pasta compartilhada ou copia os scripts do visualizador para a aplicação. Essa arquitetura permanece documentada para clientes que ainda não migraram.

A versão do pacote identifica a geração

O ID do pacote por si só não é suficiente. Ambas as gerações são publicadas como Doconut.NETStandard:

Verifique a versão no arquivo de projeto, no arquivo de bloqueio ou no .nupkg em cache antes de escolher um manual. Uma referência de pacote que apenas indica Doconut.NETStandard não informa a qual API o código foi escrito.

Identifique a integração anterior

A aplicação está usando a integração anterior quando contém uma ou mais destas assinaturas:

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

Seu bloco using é outro sinal confiável — os tipos de configuração estavam espalhados por vários namespaces:

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

Páginas anteriores também costumam carregar cópias gerenciadas pela aplicação de:

docViewer.js
documentLinks.js
docViewer.UI.js

e declaram callbacks do visualizador como globais nomeados após o id do contêiner, como ctlDoc_OnViewerReady().

A integração atual, por sua vez, é identificada por AddDoconut(), UseDoconutResources(), UseDoconut() sem argumentos, um Viewer injetado, OpenDocumentAsync() e o namespace achatado Doconut.

Abra o manual preservado

O manual histórico traduzido permanece em Configuração legada .NET Standard. Seu URL não foi redirecionado ou substituído, pois descreve uma geração real de integração que aplicações existentes ainda utilizam.

Não combine trechos desse manual com a documentação atual de AddDoconut(). A construção do Viewer, o roteamento do middleware, licenças, recursos, conversão, coordenação de web-farm e a propriedade da sessão são todos diferentes.

Planeje uma migração

Use Migrar para .NET Standard 2.1 para o mapeamento verificado da construção manual e abertura síncrona de documentos para DI, middleware atual, sessões assíncronas, recursos gerados, publicação distribuída e plugins controlados por recursos.

Duas coisas merecem atenção antes de começar:

• O framework host. netstandard2.1 requer .NET Core 3.0 ou posterior. Um host .NET Framework não pode consumir o pacote atual de forma alguma.
• As mudanças do lado do cliente. Duas delas falham silenciosamente — o servidor continua funcionando e o console do navegador permanece vazio. Elas são abordadas no guia de migração.

Mantenha a implantação anterior intacta até que a aplicação atual passe nos testes de documento, licença, Busca, Anotação, Conversor, DICOM, segurança e reversão.