Integrasi sebelumnya

Gunakan bagian ini ketika aplikasi .NET Standard yang ada masih membuat Viewer secara manual, mengirimkan opsi ke middleware, mengkoordinasikan web farm melalui folder bersama, atau menyalin skrip penampil ke dalam aplikasi. Arsitektur itu tetap didokumentasikan untuk pelanggan yang belum bermigrasi.

Versi paket mengidentifikasi generasi

ID paket saja tidak cukup. Kedua generasi dipublikasikan sebagai Doconut.NETStandard:

Periksa versi di file proyek, file kunci, atau .nupkg yang di‑cache sebelum Anda memilih manual. Referensi paket yang hanya berisi Doconut.NETStandard tidak memberi tahu Anda apa API yang digunakan kode tersebut.

Identifikasi integrasi sebelumnya

Aplikasi menggunakan integrasi sebelumnya ketika mengandung satu atau lebih tanda tangan berikut:

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

Blok usingnya adalah sinyal andal lainnya — tipe konfigurasi tersebar di beberapa namespace:

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

Halaman sebelumnya juga biasanya memuat salinan yang dikelola aplikasi dari:

docViewer.js
documentLinks.js
docViewer.UI.js

dan mendeklarasikan callback penampil sebagai global yang dinamai sesuai dengan id kontainer, seperti ctlDoc_OnViewerReady().

Integrasi saat ini sebaliknya diidentifikasi oleh AddDoconut(), UseDoconutResources(), UseDoconut() tanpa argumen, sebuah Viewer yang disuntikkan, OpenDocumentAsync(), dan namespace Doconut yang diratakan.

Buka manual yang dipertahankan

Manual historis yang diterjemahkan tetap berada di Pengaturan .NET Standard Legacy. URL‑nya belum dialihkan atau diganti, karena menggambarkan generasi integrasi nyata yang masih digunakan oleh aplikasi yang ada.

Jangan menggabungkan potongan kode dari manual itu dengan dokumentasi AddDoconut() saat ini. Konstruksi penampil, routing middleware, lisensi, sumber daya, konversi, koordinasi web‑farm, dan kepemilikan sesi semuanya berbeda.

Rencanakan migrasi

Gunakan Migrasi ke .NET Standard 2.1 untuk pemetaan terverifikasi dari konstruksi manual dan pembukaan dokumen sinkron ke DI, middleware saat ini, sesi async, sumber daya yang dihasilkan, penerbitan terdistribusi, dan plugin yang dibatasi kemampuan.

Ada dua hal yang perlu diperhatikan sebelum Anda memulai:

• Kerangka kerja host. netstandard2.1 memerlukan .NET Core 3.0 atau lebih baru. Host .NET Framework tidak dapat mengonsumsi paket saat ini sama sekali.
• Perubahan sisi klien. Dua di antaranya gagal secara diam‑diam — server tetap berfungsi dan konsol browser tetap kosong. Hal ini dibahas dalam panduan migrasi.

Pertahankan penyebaran sebelumnya tetap utuh sampai aplikasi saat ini lulus tes dokumen, lisensi, pencarian, anotasi, konverter, DICOM, keamanan, dan pengujian pemulihan.