.NET Standard 2.1 への移行
既存の Doconut.NETStandard アプリケーションを 26.7.0 から 26.8.0 に移行する
Doconut には 2 つの異なる .NET Standard 統合があります。これらは同じ Doconut.NETStandard パッケージ名を使用しているため、パッケージやスタートアップ、ライセンス、ブラウザーリソースを変更する前に、バージョンとアプリケーション内の API から世代を特定してください。
バージョンは分岐点です
両世代は 同じパッケージ ID で公開されます。区別できるのはバージョンだけです:
| バージョン | ターゲット | API |
|---|---|---|
| 26.7.0 以下 | netstandard2.0 | 以前の API |
| 26.8.0 以上 | netstandard2.1 | 現在の API |
バージョン番号を上げることがアップグレードです。 インストールする別個のパッケージはなく、互換性シムもありません — 26.8.0 は異なる API サーフェスです。バージョンを上げた後はコンパイルエラーが発生することが予想されます。本ガイドの残りはそれらの一覧です。
使用している統合はどれですか?
| プロジェクトに含まれる場合… | 世代 |
|---|---|
new Viewer(_cache, _accessor, ...) | 以前 |
viewer.OpenDocument(...) (同期) | 以前 |
viewer.InitCache() | 以前 |
UseDoconut(new DoconutOptions { ... }) | 以前 |
UseDoconutWebFarm(...) / WebFarmOptions | 以前 |
Viewer.DoconutLicense(...) または Viewer.SetLicensePlugin(...) | 以前 |
viewer.Converter.GetConverter() | 以前 |
using Doconut.Configs; / using Doconut.Models; | 以前 |
手動でコピーされた docViewer.js、documentLinks.js、または docViewer.UI.js | 以前 |
builder.Services.AddDoconut(...) | 現在 |
app.UseDoconutResources() と app.UseDoconut()(引数なしで) | 現在 |
Viewer(依存性注入により提供) | 現在 |
await viewer.OpenDocumentAsync(...) | 現在 |
同じアプリケーションに両方の列が存在する場合、移行は未完了とみなしてください。他世代のリソースやミドルウェアを通じてドキュメントトークンを送信しないでください。
まずホストフレームワークを確認してください
これは好みではなく、厳格な条件です。現在のパッケージは netstandard2.1 を対象としています:
| ホスト | 26.8.0 を使用可能か |
|---|---|
| .NET Core 3.0 以降(.NET 5/6/7/8 を含む) | はい |
| .NET Framework(すべてのバージョン) | いいえ |
.NET Framework は netstandard2.1 ライブラリを参照できません。アプリケーションが .NET Framework 上で動作している場合、ここで止めて代わりに Doconut.NETFramework パッケージを使用してください。26.9.0 以降は .NET Framework 4.7.2 が必要です。このリリースの両方の参照アプリケーションは net8.0 を対象としています。
移行前に
- 既存のアプリケーションのブランチとデプロイ可能なバックアップを作成します。
- コアおよびプラグイン パッケージの正確なバージョンを記録します。
- すべての
new Viewer(...)呼び出し、InitCache()呼び出し、ライセンス読み込み呼び出し、UseDoconutWebFarmマッピング、変換コントローラ、コピーされた Doconut スクリプト、カスタムツールバーアクション、viewer コールバック、document-open エンドポイントをインベントリ化します。 - 現在の
.licファイルとデプロイシークレットをソース管理外に保管します。 - PDF、Office、画像、CAD、メール、DICOM、検索可能、パスワード保護、注釈付きドキュメントの代表的なセットを取得します。
- 既存のセッションタイムアウト、セキュリティ動作、フォント、プラットフォーム設定を記録します。
本番環境を変更する前に、まず 1 つの環境で移行してください。現在の統合はサービスのライフタイム、リクエストルーティング、セッション所有権、クライアントリソース配信を変更し、さらにファームを運用している場合はページがブラウザーに届く方法も変更します。
1. 名前空間: ほぼすべてがルートに移動しました
構成タイプは 4 つの名前空間に分散していましたが、現在はすべて Doconut にあります。
| 以前 | 現在 |
|---|---|
using Doconut.Configs.View; | using Doconut; |
using Doconut.Models; | using Doconut; |
using Doconut.Configs; | using Doconut; |
using Doconut.Configs.Cloud; | using Doconut.Clouds; |
using Doconut.Configs.Conversion; | 変更なし |
using Doconut.Middleware; | 変更なし |
型名は変更されませんでした: WordConfig、PdfConfig、ExcelConfig、CssConfig、ScriptConfig、CloudUploadConfig、AzureConfig、CDNConfig、FileShareConfig、残りもすべて存在します。ほとんどのファイルでは、全体の編集は using 行を 2 行削除することです。
Doconut.Configs.Editor(BaseConfigEditor、PdfConfigEditor)は削除され、このパッケージには置き換えがありません。アプリケーションがこれらの型を参照している場合は、別途計画し、今回の移行の一部として扱わないでください。
2. パッケージとライセンスの互換性
コアパッケージは意図的に置き換えるか更新してください。同一のパッケージ ID に依存して新しい API を選択しないでください。デフォルトのコマンドは最新の安定版リリースをインストールします:
dotnet add package Doconut.NETStandardこのガイドで監査されたリリースへの再現可能な移行を行うには、バージョンを別のオプションとして渡してください:
dotnet add package Doconut.NETStandard --version 26.9.0すべての Doconut プラグインはコアパッケージと同じバージョンに保ってください — Doconut.NETStandard.Converter と Doconut.NETStandard.Dicom。現在の統合は AddDoconut() の間にライセンスを一度だけロードし、以下の優先順位を使用します:
LicenseStream > LicenseContent > LicensePath > automatic discovery自動検出は Doconut.Viewer.lic とそれに付随する Doconut.Viewer.<Capability>.lic ファイルを探します。以前の静的呼び出し Viewer.DoconutLicense(...) と Viewer.SetLicensePlugin(...) は現在の起動メカニズムではなく、古い Viewer コンストラクタが受け入れていたライセンスパスの List<string> も同様です。ライセンスを DoconutOptions に移動し、自動検出を使用する場合は付随ファイルを一緒に保ち、ライセンスを変更した後に再起動し、IDoconutLicenseService を通じて機能を検証してください。
古いプラグインライセンスが存在することが、現在のプラグインビルドの権利を保証するものと推測しないでください。Viewer、Search、Annotation、Converter、そして DICOM を承認されたリリース成果物で個別にテストしてください。
3. 起動と依存性注入
以前はビューアがリクエストごとに構築され、オプションがミドルウェアに渡されていました:
// 以前の統合 — 対照のみ; 現在の SDK に対してコンパイルしないでください。
var viewer = new Viewer(_cache, _accessor);
// …
appBranch.UseDoconut(new DoconutOptions { UnSafeMode = false, ShowDoconutInfo = false });現在の統合では Doconut を一度だけ登録し、依存性注入から Viewer を受け取ります:
builder.Services.AddDoconut(options =>
{
options.UnsafeMode = false; // スペル変更に注意: UnSafeMode → UnsafeMode
options.ShowDoconutInfo = false;
options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddDistributedMemoryCache(); // セッションステートにはキャッシュが必要です (MVC/Razor Pages はすでに追加されています)
builder.Services.AddSession();
app.UseSession();
app.UseDoconutResources();
app.UseDoconut();Viewer は一時的なサービスです。ドキュメントセッションマネージャーとそのキャッシュは、長期間存続するドキュメント状態を所有し、特定の注入された Viewer インスタンスではありません。
引き継ぐべき3つの項目:
new Viewer(cache, accessor)はなくなりました。 コントローラーにDoconut.Viewerを注入するか、Razor ビューで@inject Doconut.Viewer Viewerを使用してください。UseDoconutResources()は手動配線app.UseMiddleware<EmbeddedResourceMiddleware>()を置き換え、ドキュメントブランチの 前に 実行する必要があります。UnSafeMode→UnsafeMode。 1 文字のリネームでコンパイラが検出します。
UnsafeMode が false の場合、SDK はセッショントークンを元のリクエストと照合します。そのため、AddSession() / UseSession() はパイプライン内に残っている必要があり、ブランチの前に UseSession() が必要です。
もはや存在しないメソッド
| 以前 | 現在 |
|---|---|
viewer.OpenDocument(path, config, options) | await viewer.OpenDocumentAsync(path, config, options) |
viewer.InitCache() | 削除 — 手動でウォームアップするものはありません。呼び出しと「すでに初期化済みか?」フラグを削除してください |
viewer.ExportToPng(sharedPath) | §7 を参照 |
viewer.ExportToCloud(cloudConfig) | §7 を参照 |
using var v = new Viewer(...); v.CloseDocument(t) | viewer.CloseDocument(token) (注入されたインスタンス上) |
4. ミドルウェアとリソースルーティング
UseDoconut() は現在引数を取らなくなりました。MapWhen ブランチの形状自体を変更する必要はなく、内部のミドルウェアだけを変更してください:
app.UseDoconutResources(); // ブランチの前に
app.MapWhen(
ctx => ctx.Request.Path.Value?.EndsWith("DocImage.axd", StringComparison.OrdinalIgnoreCase) == true,
branch => branch.UseDoconut());現在のパイプラインでは:
- セッションセキュリティが有効な間、Doconut の前に
UseSession()を呼び出す; UseDoconut()の前にUseDoconutResources()を呼び出す;ResourcesPath、生成されたリソース URL、クライアントResPathを整合させたままにする;- マップしたブランチとクライアント
BasePathを整合させたままにする。
MiddlewarePath は検証済みの構成です;それ自体で ASP.NET Core のブランチを作成することはありません。
5. ビューアの構築とライフタイム
アプリケーションが所有する Viewer オブジェクトのキャッシュを削除します。Viewer には保持する価値が何も残っていません:ドキュメント状態を保持せず、セッションキャッシュがリクエストの寿命を超えるすべてを所有します。エンドポイント、Razor ページ、コントローラー、またはスコープド アプリケーションサービスに注入してください:
app.MapPost("/api/open", async (Viewer viewer) =>
{
var token = await viewer.OpenDocumentAsync("wwwroot/files/Sample.pdf");
return Results.Ok(new { token });
});返されたトークンはサーバー側のドキュメントセッションを識別します。これをベアラークレデンシャルとして扱い、ログに記録したり、永続化したり、分析に使用したりしないでください。
6. ドキュメントのオープンとクローズ
同期的な OpenDocument(...) を OpenDocumentAsync(...) に置き換えます:
// 現在の統合: Viewer は DI から取得され、ドキュメントのオープンは非同期です。
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { AllowSearch = true });現在のオーバーロードはファイルパスまたはストリーム、オプションのフォーマット設定、オプションの DocOptions、およびキャンセルトークンを受け取ります。ブラウザーが不要になったらサーバーセッションを明示的にクローズしてください:
viewer.CloseDocument(token);InitCache() の呼び出しとそれを保護するフラグをすべて削除します — 手動でウォームアップするものはありません。切り替え後に以前のライブラリで生成されたトークンを再利用しないでください:現在の API を通じて各ドキュメントを再度オープンしてください。
7. Webファーム → 分散: 最大の変更
UseDoconutWebFarm と WebFarmOptions はもう存在しません。 アプリがそれらを呼び出す場合、このセクションがアップグレード手順です;呼び出さない場合は §8 に進んでください。
以前は1つのミドルウェアがすべてを担当していました:共有フォルダーから事前にレンダリングされた画像を配信し、別のノードがまだ書き込み中である間 ポーリング していました。
// 以前の統合 — 1 回の呼び出し、ファイルシステムを介した暗黙的な調整です。
appBranch.UseDoconutWebFarm(new WebFarmOptions
{
Path = Path.Combine(env.WebRootPath, "webfarm"),
PageWaitTimeSeconds = 180,
StartWaitFromPage = 5,
});同じ処理は現在、2つの明示的な半分に分割されています。書き込み側 — ドキュメントをオープンするノードが、全アーティファクトセット(ページ、ドキュメント情報、検索インデックス、メタデータ)を共有領域に公開します:
var result = await _publisher.PublishAsync( // DistributedDocumentPublisher、DI から注入されます
pathToFile,
new FileShareConfig
{
Location = CloudLocation.FileShare,
RootPath = @"\\fileserver\doconut", // 今日使用しているのと同じフォルダー
UsePerTokenSubfolders = true,
},
config,
documentOptions,
new DistributedDocumentPublishOptions
{
CleanUpStagingDirectory = true,
FirstPagePriority = true,
});
return Content(result.Token);読み取り側 — 任意のノードが共有領域から提供します:
app.MapWhen(
ctx => ctx.Request.Path.Value?.EndsWith("DocImage.axd", StringComparison.OrdinalIgnoreCase) == true,
branch => branch.UseDoconutCloud<FileShareCloudHandler>(options =>
{
options.Location = CloudLocation.FileShare;
options.CloudUploadConfig = /* 上記と同じ SAME FileShareConfig */;
}, "/"));| 以前 | 現在 |
|---|---|
WebFarmOptions.Path | FileShareConfig.RootPath |
PageWaitTimeSeconds / StartWaitFromPage | 削除 — 書き込み側で FirstPagePriority に置き換え、読み取り側で FileShareConfig.ReadReadyPollMs が追加されます |
viewer.OpenDocument(...) その後 viewer.ExportToPng(share) | 1つの PublishAsync(...) 呼び出し |
DocOptions.IsWebfarm / WebfarmPath | まだ存在します、IsWebFarm / WebFarmPath と表記は — ただし公開パスでは不要です |
トポロジーは変更されません。 RootPath を同じ UNC 共有にポイントし、すべてのノードは現在と同様に動作し続けます。変更点は、公開がレンダリングの副作用ではなく、呼び出す操作になることです。
両方の側が一致する必要があります。
RootPathまたはUsePerTokenSubfoldersがパブリッシャーとハンドラ間で異なる場合、相手ノードは 404 を返します。設定を1つのヘルパーで構築し、両側から呼び出してください。
PageWaitTimeSeconds = 180 は「ページが表示されるまで最大3分ブロックする」ことを意味しました。置き換えは明示的です:FirstPagePriority = true を使用すると、ページ1は即座に配信可能となり、以降のページは書き込まれるまで HTTP 202 Accepted で応答します。retryOn409 が設定されている場合、バンドルされたビューアは自動的に再試行します。再試行しないクライアントは、まだレンダリング中のページのタイルが壊れた状態で表示されます。
バックグラウンドの公開やアクセスチケットを含む完全な構成は、分散デプロイ にあります。
8. 変換はプラグインで、はるかに小さくなります
プラグインを登録し、次に DocumentConverter ファサードを注入します:
builder.Services.AddDoconut(o => o.AddPlugin<ConverterPlugin>());// 以前の統合
var converter = viewer.Converter.GetConverter();
var config = new WordConfigConverter { TargetFormat = WordConfigConverter.EnTargetFormat.PDF };
var result = converter.Convert(stream, SourceFormatConverter.DOCX, config);
// 現在の統合
var result = await _converter.ConvertAsync(stream, ".docx", ConversionTarget.Pdf, null, ct);置き換えられるもの:
SourceFormatConverter— なくなりました。ファイル拡張子を文字列で渡します(ドットを含む)。- 各ファミリーの
*ConfigConverterタイプ(WordConfigConverter、ExcelConfigConverter、…)で、ネストされたEnTargetFormat列挙型がありましたが、なくなりました。現在は各ファミリーごとに一つのConversionTarget列挙型があります。 viewer.Converter.GetConverter()— なくなりました。Doconut.DocumentConverterを注入します。
ConvertAsync はシーク可能なストリームを返すため、return File(result, mime, name) は直接機能します — 旧コードをコピーする必要がある MemoryStream は不要です。提供されているサンプルでは、68ケースの拡張子スイッチとほぼ同一のコントローラが10個削除されました。
完全な機能一覧については、コンバータプラグイン を参照してください。
9. クラウドプロバイダー
UseDoconutCloud は汎用化されました。プロバイダーはミドルウェア内部で切り替えられる Location の値ではなく、型引数として指定します:
// 以前の統合
appBranch.UseDoconutCloud(new CloudOptions { Location = CloudLocation.CDN, ... });
// 現在の統合
branch.UseDoconutCloud<CDNCloudHandler>(options =>
{
options.Location = CloudLocation.CDN;
options.CloudUploadConfig = new CDNConfig { DoconutCdnUrl = "..." };
}, "/");名前空間(Doconut.Configs.Cloud → Doconut.Clouds)を除けば、設定クラスは変更されていません:AzureConfig、AmazonConfig、GoogleCloudConfig、DropBoxConfig、RedisConfig、CDNConfig、FTPConfig、さらに新しい FileShareConfig があります。ハンドラの名前は <Provider>CloudHandler です。
CDN ハンドラは 読み取り専用 です — CDN に既にあるものを提供するだけで、アップロードは行いません。
10. 名前が変更された設定オブジェクト
| 以前 | 現在 |
|---|---|
DoconutOptions.UnSafeMode | UnsafeMode |
DocOptions.IsWebfarm | IsWebFarm |
DocOptions.WebfarmPath | WebFarmPath |
DocOptions.ImageResolution | まだ存在しますが 廃止 — 代わりにフォーマット設定で解像度を設定してください |
DocOptions も IsSecured を取得します。
現在の API は以前よりも関心事を厳密に分離しています。そのため、各設定が現在所有しているオブジェクトに属しているか確認してください:
| 関心事 | 現在の型 |
|---|---|
| ミドルウェアパス、ライセンス、プラグイン登録 | DoconutOptions |
| パスワード、タイムアウト、セキュリティ、透かし | DocOptions |
| フォーマットレンダリングと DPI | PdfConfig、WordConfig、ExcelConfig、およびその他の BaseConfig タイプ |
| ブラウザウィジェットのデフォルト | ViewerConfig または同等の JavaScript オプション |
| 生成された CSS とスクリプト | CssConfig と ScriptConfig |
| 共有ストレージとクラウドプロバイダー | FileShareConfig と他の Doconut.Clouds 設定 |
DocOptions.ImageResolution をレンダリングコントロールとして引き継がないでください。これは廃止されています。フォーマット固有の設定で BaseConfig.ImageResolution を設定してください。以前の設定が同じ動作をするという前提ではなく、すべてのデフォルトを見直しましょう。
11. クライアント側ビューア — 静かに失敗する2つの変更
これらの変更はどちらもサーバーの動作を完全に保ちます。ドキュメントは正しくレンダリングされ、ページも正しく表示され、ブラウザのコンソールにも何も出力されません。C# が最初の試みでコンパイルできても、このセクションは必ず読んでください。
ビューアのコールバックは現在オプションであり、グローバル関数ではありません
以前のビューアはハンドラを 名前で 呼び出し、コンテナ ID からグローバル関数名を導出していました。ページに function ctlDoc_OnViewerReady() を宣言し、<div id="div_ctlDoc"> を使用するだけで十分でした。現在のビューアはオプションオブジェクトで明示的なコールバックを受け取り、これらのグローバル関数を探さなくなりました:
objctlDoc = $("#div_ctlDoc").docViewer({
// ... 既存のオプション ...
onViewerBusy: ctlDoc_OnViewerBusy, // 名前で見つかりました
onViewerReady: ctlDoc_OnViewerReady, // 名前で見つかりました
onCopy: ctlDoc_Copy, // は ctlDoc_Copy(text)
onAutoLoadStatus: ctlDoc_AutoLoadStatus // は ctlDoc_AutoLoadStatus(page)
});なぜこれが問題か: 旧呼び出しは空の catch でラップされており、すべてを吸い込んでいました。現在は関数が実行されず、エラーも報告されません。一般的な症状は、停止しないビジー スピナーです — それを隠していた関数が ctlDoc_OnViewerReady だったためです。その背後のドキュメントは問題ありません。
完全なオプション一覧は onPageLoading、onPageLoaded、onThumbnailClicked、onPageClicked、onDoubleClick、onViewerBusy、onViewerReady、onViewerError、onCopy、onAnnSaved、onAnnSaveError、onAnnLoaded、onAnnClosed、onAutoLoadStatus、onThumbsShown、そして onError です。リンククリック用のコールバックはありません:ハイパーリンクの処理は組み込みで、showHyperlinks によって駆動されます。
ResPath はリソースプレフィックスを指す必要があります
ResPath: '', // 以前 — リソースはアプリケーションのルートから取得されていました
ResPath: 'doconut-res/images', // 現在 — プレフィックス UseDoconutResources() がマウントされますDoconutOptions.ResourcesPath を使用してプレフィックスを変更した場合は、その値を使用してください。
12. ビューアツールバー、検索、そしてアノテーション
古いスクリプトを一つずつ移行しないでください。現在のリファレンスアプリケーションは、1つの完全なページパッケージを構成します:
ReferenceCssを使用して Viewer CSS とライセンスされた Search/Annotation CSS を出力します;- アプリケーション所有の Viewer ツールバーをレンダリングします;
searchBarMount、annBarMount、および必要な Viewer マウントをレンダリングします;ReferenceScriptsを使用して Viewer とライセンスされたモジュールスクリプトを出力します;- アプリケーション独自のツールバーヘルパースクリプトをロードします;
- 1つの
objViewerを初期化します; - ライセンスされた Search と Annotation のリボンを初期化します;
- 各リボンで
attach(objViewer)を呼び出します; - ドキュメントを開き、
objViewer.View(token)を呼び出します。
Search と Annotation は同じ Viewer に付属するモジュールであり、独立したツールバーではありません。メインツールバーはホストアプリケーションに属し、Search と Annotation のリボンは埋め込まれた機能制御されたリソースです。
documentLinks.js と docViewer.UI.js のように手動でコピーしたファイルは、現在のページが ReferenceCss と ReferenceScripts によって出力されたリソースで動作するようになってから削除してください。
13. プラグイン登録
静的なプラグインライセンスメソッドは現在のプラグインを登録しません。各リリースパッケージを明示的にインストールし、登録してください:
builder.Services.AddDoconut(options =>
{
options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
options.AddPlugin<Doconut.Plugins.Dicom.DicomPlugin>();
});AddDoconut() は起動時に登録されたプラグイン機能を検証します。Converter と DICOM はリリースされた .NET Standard プラグインです。通常の Search と Annotation は組み込みのライセンス機能であり、AddPlugin<TPlugin>() パッケージではありません。
14. セッションとドキュメントのセキュリティ
現在の統合はドキュメントを不透明なトークンとキャッシュされたセッションにバインドします。デフォルトの UnsafeMode = false を使用すると、UseDoconut() がドキュメントアクセスのセキュリティを追加し、ホストは ASP.NET セッションを構成する必要があります:
builder.Services.AddDistributedMemoryCache(); // セッションステートにはキャッシュが必要です (MVC/Razor Pages はすでにキャッシュを追加しています)
builder.Services.AddSession();
app.UseSession();レビュー済みの設計で別の要件がない限り、DocOptions.IsSecured = true を保持してください。単一ノードでの移行ショートカットとして UnsafeMode = true を使用しないでください。トークンがないリクエスト、形式が不正なトークン、期限切れトークン、別のブラウザセッションからのトークンでテストしてください。
ファーム環境では、ページリクエストが最初のリクエストを受け取っていないノードに届くことがあり、その場合、セッション単位のチェックが拒否します。これが UnsafeMode = true が正しい唯一のケースであり、AddDoconutDistributedDocumentSecurity を介した署名付きアクセスチケットと組み合わせる必要があります。単独で配布しないでください。詳細は 分散デプロイメント を参照してください。
命名に関する注意
すべてのフレームワークでクラスは Viewer です。古いスニペットやサードパーティの記事で DocumentViewer を見つけた場合、その型は SDK には存在しませんでした。
15. 推奨作業順序
- ホストフレームワークが netstandard2.1 を使用できることを確認してください。使用できない場合は中止してください。
- パッケージを 26.8.0 に更新し、ビルドしてください。コンパイルエラーを解消します—ほとんどは §1 の
using行です。 - スタートアップを
AddDoconut()に移動し、ミドルウェア呼び出しを新しい順序(§3、§4)に変更してください。 Viewerを構築していた場所に注入し、OpenDocumentを非同期にし、InitCache()を削除してください(§5、§6)。- Web ファームを使用している場合は §7 を実行してください — 名前変更ではなく再設計が必要な唯一の部分です。
- ドキュメントを変換する場合は §8 を実行してください。
- §11 を実行してください — クライアント側の変更です。 これらは自動的に通知されないものです。
- ブラウザで実際のドキュメントを開き、ビジースピナーを確認してください。 緑のビルドは何も証明しません:ライセンス、プラグイン登録、リソースパス、ビューアコールバックはすべて実行時に失敗します。ファームの場合、あるノードで公開されたドキュメントが別のノードで提供されていることを確認してください。
移行のテスト
最低限、次を確認してください:
- 本番ライセンスとすべての登録プラグインでのアプリケーション起動;
- 選択されたパス以下の Viewer CSS/スクリプトとすべてのページ画像リクエスト;
- ドキュメントのオープン、ナビゲーション、ズーム、サムネイル、印刷、明示的なクローズ;
- テキストを含むドキュメントでの検索と、画像のみのファイルが検索不可であること;
- アノテーションのロード、保存、エクスポート、および機能制御;
- コンバータのターゲット検出、出力、ダウンロード、ウォーターマーク状態;
- DICOM ページ、フレーム、アニメーション;技術メタデータはこのパッケージでは利用できません;
- パスワード保護されたドキュメント、カスタムフォント、非ラテン文字、設定されたタイムアウト;
- セッション間トークンの拒否と期限切れセッションの挙動;
- ファームの場合: 1つのノードで公開し、別のノードから遅延ページを要求し、次を確認する:ビューアが壊れたタイルを表示する代わりに
202応答を再試行すること; - モバイル、ダークモード、そして本番リバースプロキシパス。
ロールバック計画
以前のデプロイアーティファクト、対応するパッケージ、ライセンスファイル、およびコピーされたブラウザリソースを一緒に保管してください。安全なロールバックはアプリケーション全体の世代を切り替えます;以前の世代のサーバーと現在のスクリプト、または現在のサーバーと new Viewer(...) 呼び出し箇所を混在させません。
切り替え前に、以下を文書化してください:
- ロールバックに使用するデプロイメントスロットまたはアーティファクト;
- 共有ストレージへの影響(該当する場合)— 26.8.0 で公開されたアーティファクトは以前のウェブファームミドルウェアでは使用されません;
- アクティブなドキュメントセッションがどのように無効化されるか;
- ロールバックの判断に使用するヘルスチェックとスモークドキュメント;
- 誰が以前のパッケージセットと構成を復元できるか。
旧ドキュメント
翻訳された以前のマニュアルは以下で利用可能です:
レガシー .NET Standard 設定。 以前の統合ゲートウェイ は同じ識別シグナルを説明し、この移行ガイドへリンクしています。
歴史的な URL をブックマークやサポートチケットに保持してください、netstandard2.0 のインストールがまだ存在する間は。これは異なる世代を文書化しており、現在の API へはリダイレクトされません。
このページは役に立ちましたか?