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

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

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

Перевірте версію у файлі проєкту, у lock‑файлі або у кешованому .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(). Конструювання Viewer, маршрутизація проміжного ПЗ, ліцензії, ресурси, конвертація, координація веб‑ферми та управління сеансами — усе це різне.

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

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

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

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

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