Попередня інтеграція

Використовуйте цей розділ, коли існуючий застосунок .NET Standard все ще створює Viewer вручну, передає параметри в проміжне ПЗ, координує веб‑ферму через спільну папку або копіює скрипти переглядача у застосунок. Така архітектура залишається задокументованою для клієнтів, які ще не мігрували.

Версія пакету визначає покоління

Само ідентифікатор пакету недостатньо. Обидва покоління публікуються як Doconut.NETStandard:

Перевірте версію у файлі проєкту, у файлі блокування або у кешованому .nupkg перед тим, як обирати посібник. Посилання на пакет, яке просто містить Doconut.NETStandard, не повідомляє, проти якої API написаний код.

Визначення попередньої інтеграції

Застосунок використовує попередню інтеграцію, коли містить один або кілька з цих підписів:

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

Його блок using є ще одним надійним сигналом — типи конфігурації були розподілені по кількох просторах імен:

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

Попередні сторінки також часто завантажують копії, керовані застосунком, таких:

docViewer.js
documentLinks.js
docViewer.UI.js

і оголошують зворотні виклики переглядача як глобальні змінні, названі за ідентифікатором контейнера, наприклад ctlDoc_OnViewerReady().

Поточна інтеграція, навпаки, ідентифікується за допомогою AddDoconut(), UseDoconutResources(), UseDoconut() без аргументів, інжектованого Viewer, OpenDocumentAsync() та спрощеного простору імен Doconut.

Відкриття збереженого посібника

Перекладений історичний посібник розташований за адресою Наслідування налаштування .NET Standard. Його URL не був перенаправлений чи замінений, оскільки він описує реальне покоління інтеграції, яке ще використовують існуючі застосунки.

Не поєднуйте фрагменти з того посібника з поточною документацією AddDoconut(). Конструювання переглядача, маршрутизація проміжного ПЗ, ліцензії, ресурси, конвертація, координація веб‑ферми та володіння сесією — усе це різне.

Планування міграції

Використовуйте Міграція до .NET Standard 2.1 для перевіреного переходу від ручного конструювання та синхронного відкриття документів до DI, поточного проміжного ПЗ, асинхронних сесій, згенерованих ресурсів, розподіленого публікування та плагінів з обмеженням можливостей.

Дві речі вимагають уваги перед початком:

• Хостова платформа. netstandard2.1 вимагає .NET Core 3.0 або новішого. Хост на .NET Framework взагалі не може споживати поточний пакет.
• Зміни на боці клієнта. Дві з них працюють без повідомлень про помилку — сервер продовжує працювати, а консоль браузера залишається порожньою. Вони описані у посібнику з міграції.

Залишайте попереднє розгортання незмінним, доки поточний застосунок не пройде його тести документу, ліцензії, пошуку, анотації, конвертера, DICOM, безпеки та відкату.