以前の統合

以前の netstandard2.0 Doconut ライブラリのドキュメント

既存の .NET Standard アプリケーションがまだ Viewer を手動で構築し、ミドルウェアにオプションを渡し、共有フォルダーを介してウェブファームを調整し、またはビューアスクリプトをアプリケーションにコピーしている場合にこのセクションを使用してください。そのアーキテクチャは、移行していない顧客向けに引き続き文書化されています。

パッケージ バージョンが世代を識別する

パッケージ ID だけでは不十分です。両世代とも Doconut.NETStandard として公開されています。

バージョンターゲット世代
26.7.0 以下netstandard2.0以前 — こちらに記載
26.8.0 以上netstandard2.1現在 — 本セクションの残りで記載

マニュアルを選択する前に、プロジェクト ファイル、ロック ファイル、またはキャッシュされた .nupkg のバージョンを確認してください。単に Doconut.NETStandard とだけ記載されたパッケージ参照からは、コードがどの API に対して書かれているかは分かりません。

前の統合を特定する

アプリケーションが以下のシグネチャのいずれかを含んでいる場合、以前の統合を使用していると判断できます。

csharp
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 ブロックも信頼できるシグナルです — 設定タイプが複数の名前空間に分散していました:

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

以前のページでは、アプリケーション管理のコピーとして以下をロードすることが一般的でした:

text
docViewer.js
documentLinks.js
docViewer.UI.js

そして、ctlDoc_OnViewerReady() のようにコンテナ ID にちなんだ名前のグローバルとしてビューア コールバックを宣言していました。

現在の統合は、代わりに AddDoconut()、UseDoconutResources()、引数なしの UseDoconut()、インジェクトされた Viewer、OpenDocumentAsync()、および平坦化された Doconut 名前空間で識別されます。

保存されたマニュアルを開く

翻訳された過去のマニュアルは レガシー .NET Standard 設定 に残っています。その URL はリダイレクトも置き換えもされていません。これは、既存のアプリケーションが依然として使用している実際の統合世代を説明しているためです。

そのマニュアルからのスニペットを現在の AddDoconut() ドキュメントと組み合わせないでください。Viewer の構築、ミドルウェアのルーティング、ライセンス、リソース、変換、ウェブファームの調整、セッション所有権はすべて異なります。

移行の計画

手動構築と同期ドキュメントオープンから DI、現在のミドルウェア、非同期セッション、生成リソース、分散パブリッシュ、機能制御プラグインへの検証済みマッピングについては、.NET Standard 2.1 への移行 を使用してください。

開始する前に注意すべき点が二つあります:

  • ホスト フレームワーク。netstandard2.1 は .NET Core 3.0 以降が必要です。.NET Framework のホストは現在のパッケージをまったく使用できません。
  • クライアント側の変更。そのうち二つは黙って失敗します — サーバーは動作し続け、ブラウザのコンソールは何も表示しません。これらは移行ガイドで取り上げられています。

現在のアプリケーションがドキュメント、ライセンス、Search、Annotation、Converter、DICOM、セキュリティ、ロールバックテストを通過するまで、以前のデプロイメントをそのまま維持してください。

このページは役に立ちましたか?