コンバータ プラグイン
45 の対象フォーマットに文書を変換
コンバータ プラグインは Doconut を文書変換サービスに変えます。パブリック DocumentConverter ファサードの背後にあるエンジンを提供し、オプトインで独自の HTTP 契約を持つドロップイン ウィジェットも提供するため、C# から、ウィジェットから、または自分で作成したフロントエンドから文書を変換できます。
| 対象 | 使用シーン |
|---|---|
DocumentConverter (C#) | サーバー上で変換し、ブラウザーは関与しません |
Drop-in widget (doconutConverter.js) | ページ内に既成のアップロード、変換、ダウンロード画面が欲しい場合 |
HTTP エンドポイント (?convert=open|run|download) | 文書化されたサーバー契約に対して独自の変換 UI を構築する場合 |
パッケージのインストール
最新の安定版コンバータ プラグインをインストールします:
dotnet add package Doconut.NETStandard.Converterこのドキュメントで説明しているリリースにプラグインを固定するには、バージョンを別途指定します:
dotnet add package Doconut.NETStandard.Converter --version 26.10.0コンバータ パッケージは Doconut.NETStandard と同じバージョンに保ってください。パッケージ ID は Doconut.NETStandard.Converter です。.<version> はダウンロードされた .nupkg のファイル名にのみ現れます。
プラグインのライセンス ファイル Doconut.Viewer.Converter.lic は Doconut.Viewer.lic と同じフォルダーに配置します。ビューア ライセンスと一緒に読み込まれます。
プラグインの登録
AddConverter() メソッドは存在しません — Doconut のプラグインモデルは統一されています。コンバータを含むすべてのプラグインは同じ方法で登録されます: AddDoconut() 内で AddPlugin<TPlugin>() を呼び出します。ConverterPlugin は独自の NuGet パッケージ Doconut.NETStandard.Converter に同梱されており、ベース ビューア パッケージと共にインストールされます。
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
});これで C# ファサードに必要なものはすべてです。ウィジェットとその HTTP エンドポイントは別個のオプトインで、AddConverterWidget() です(ドロップイン ウィジェット を参照)。
プラグインは Converter 機能を付与するライセンスが必要です。これがない場合、AddDoconut() はアプリがリクエストを処理する前の起動時に InvalidOperationException をスローします:
The Converter plugin is registered via AddPlugin but no active license grants Converter. Remove the AddPlugin<...>() call or install a license (or trial/demo) that includes Converter.ライセンスがない場合、レガシー TRIAL ファイルがある場合、Converter が欠如したライセンス、またはバージョンウィンドウ外で使用された有料ライセンスの場合にスローされます。Temporary Demo/NFR ライセンスは受け付けられます。無料のサイレントティアはありません。ライセンスのロード方法については ライセンス設定 を参照してください。
ライセンスと透かし
| ライセンス状態 | 起動時 | 変換出力 |
|---|---|---|
バージョンウィンドウ内で Converter を付与する有料ビューア ライセンス | 開始 | クリーン — watermarked: false |
| 有効な一時 (Demo/NFR) ライセンス | 開始 | 変換し、評価透かし — watermarked: true が付与されます |
| 期限切れの一時 (Demo/NFR) ライセンス | 開始 | 変換し、評価透かし — watermarked: true が付与されます |
ライセンスなし、レガシー TRIAL ファイル、Converter がないライセンス、またはバージョンウィンドウ外の有料ライセンス | AddDoconut() がスローされます | — |
両方の呼び出しパスは同じルールでフラグを計算します: DocumentConverter C# ファサードはライセンスの IsViewerLicensed と IsTemporary の状態から内部的に導出し、ウィジェットの ?convert=run ハンドラは同等のチェック(IsViewerLicensed && !IsTrial && !IsTemporary)を行い、返す watermarked フィールドを埋めます。統合は購入前に評価ライセンスでエンドツーエンドに構築・テストでき、変更されるのは出力バイトだけです。
DICOM ソース(.dcm、.ima)も Dicom 機能が必要です。これがない場合、ConvertAsync は LicenseException(Converting '.dcm' requires the Dicom capability license.)をスローし、ウィジェットの open は 403 と応答します。
C# からの使用
すべての変換は、0 に位置付けられたシーク可能な MemoryStream を返し、すぐに読み取りまたはコピーできる状態です。必要な場所で DI から DocumentConverter を解決してください — 設計上ステートレスなので、単一のインスタンスをリクエスト間で安全に再利用できます。
// DocumentConverter を注入します; コンストラクタは internal なので、決して `new` しないでください。
Stream pdf = await converter.ConvertAsync("contract.docx", ConversionTarget.Pdf, ct: ct);// sourceExtension には先頭のドットが含まれます。パスワードは、ドキュメントが保護されていない限り null です。
Stream png = await converter.ConvertAsync(stream, ".xlsx", ConversionTarget.Png, password: null, ct: ct);Stream html = await converter.WordToHtmlAsync("report.docx", ct);// html: HTML を保持し、Word 文書に戻すための Stream です。たとえば WordToHtmlAsync の結果などです。
Stream docx = await converter.HtmlToWordAsync(html, ConversionTarget.Docx, ct);間違えやすい2つの詳細があります: ストリーム オーバーロードの sourceExtension には先頭のドット(".xlsx"、"xlsx" ではなく)を含める必要があります — コンバータはそれをフォーマット カタログと照合し、拡張子だけでは解決できません。また、その名前にもかかわらず、WordToHtmlAsync は Task<Stream> を返し、Task<string> ではありません — HTML ドキュメント(画像は Base64 埋め込み)をストリームとして取得し、他のすべての変換結果と同様です。
呼び出し側が返されたストリームを所有し、コピーまたは内容を返した後に破棄すべきです。DocumentConverter サービス自体は依存性注入から解決されます; 手動で構築したり破棄したりしないでください。
対象フォーマット
ConversionTarget (名前空間 Doconut.Configs.Conversion) には 45 のメンバーがあります:
Pdf, Docx, Doc, Html, Xlsx, Pptx, Png, Jpeg, Csv, Tiff, Bmp, Gif, Svg, Xml,
Txt, Xls, Jp2, Rtf, Odt, Ods, Odp, Epub, Xps, Webp, Msg, Eml, Emlx, Mhtml,
Xlsm, Xlsb, Ppt, Docm, Dot, Dotx, Dotm, Vsdx, Vssx, Vstx, Vsdm, Vssm, Vstm,
Vdx, Vsx, Vtx, Icoすべてのソースがすべてのターゲットに変換できるわけではありません — プラグインは各ソースのフォーマット ファミリー(Word、Excel、PowerPoint、PDF、CAD、Image、Email、Diagram、Project/Task、PSD、web document、DICOM)をそれぞれ固定された許可対象セットにマッピングします。DICOM ソース(.dcm、.ima)を変換するには、Dicom 機能を付与するライセンスも必要です; そのターゲットは Pdf、Png、Jpeg、Bmp、Tiff、および Gif です。この enum を UI のターゲットリストとしてハードコードしないでください: ?convert=open は、アップロードされたファイルに対する実際の allowedTargets を返し、これがピッカーの駆動要素となります。
ドロップイン ウィジェット
エンドポイントを有効化
ウィジェットの ?convert=open|run|download エンドポイントはオプトインで、デフォルトでは無効化されています — デフォルトで安全です。プラグインの登録と共にサーバー側で有効化してください:
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
options.AddConverterWidget(widget =>
{
widget.MaxUploadMb = 25;
});
});AddConverterWidget() を引数なしで呼び出すと、デフォルト(MaxUploadMb = 25)でウィジェットが有効になります。これだけでは変換権限は付与されません: AddPlugin<ConverterPlugin>() が必要です、または AddDoconut() が例外をスローします:
AddConverterWidget() was called but the Converter plugin is not registered. Add options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>() (the widget needs it), or remove the AddConverterWidget() call.AddConverterWidget() がない場合、3 つの ?convert= エンドポイントは 404 を返します — しかし、JS ファイル自体は引き続き配信されます(単なる埋め込み静的リソースです。通信先のエンドポイントだけが制限されています)。
埋め込む
<div id="doconut-convert"></div>
<script src="/doconut-res/js/doconutConverter.js"></script>
<script>
Doconut.convert('#doconut-convert', { basePath: '/doconut', resPath: '/doconut-res', maxUploadMb: 25 });
</script>Doconut.convert(selectorOrElement, options) は CSS セレクタまたは要素を受け取り、マウントが見つからない場合は例外を投げ、ハンドルを返します。ウィジェットはファイルをアップロードし、ページ 1 のプレビューを表示し、ユーザーに allowedTargets の中から 1 つ選択させ、変換し、可能な場合は結果をプレビューし、ダウンロードを提供します。
オプション
| オプション | 型 | デフォルト | 備考 |
|---|---|---|---|
basePath | string | /doconut | ?convert= エンドポイントのベースパスです。UseDoconut() が実際にマウントされている ASP.NET ブランチと一致する必要があります(通常は MiddlewarePath を通じて調整されます)。 |
resPath | string | /doconut-res | 他の Doconut ウィジェットとの設定一貫性のために受け入れられますが、コンバータウィジェットは現在それから URL を生成しません。 |
maxUploadMb | number | 25 | クライアント側の事前チェックのみです — アップロード前にサイズオーバーのファイルを拒否します。サーバーは独立して独自の上限を適用し、超過した場合は 413 で応答します。 |
licenseUrl | string | null | null | 設定されている場合、結果画面の透かし通知をこの URL へのリンクに変換します。 |
labels | object | {} | ウィジェットの英語デフォルト文字列(ドロップテキスト、ボタン、aria-live アナウンス、エラーメッセージ)の任意のサブセットを上書きします。 |
コールバック
| コールバック | 発火条件 | ペイロード |
|---|---|---|
onReady() | ウィジェットがアイドル/ドロップ画面を描画したとき | — |
onSourceLoaded({ token, pages, sourceExt, allowedTargets }) | ?convert=open が成功したとき | ソースセッショントークン、ページ数、ソース拡張子(先頭のドットなし)、許可されたターゲットリスト |
onConverted({ downloadToken, resultToken, resultPages, downloadName, watermarked, target }) | ?convert=run が成功したとき | run 応答と同じフィールドに加えて、要求された target |
onDownload({ downloadName, downloadToken }) | ユーザーがダウンロードリンクをクリックしたとき | ブラウザのネイティブダウンロードと同時に発火します — それをインターセプトしたり置き換えたりしません。 |
onError({ phase, message }) | オープンまたは実行リクエストが失敗したとき | phase は 'open' または 'run' です。message はサニタイズされたサーバーエラー(またはアップロードサイズ事前チェックのクライアント側メッセージ)です。 |
例外を投げるコールバックは捕捉されログに記録されます;ウィジェットのフローを壊すことはありません。
命令的ハンドル
Doconut.convert() はウィジェットインスタンス自体を返します — それを保持してウィジェットをプログラム的に操作してください:
const conv = Doconut.convert('#doconut-convert', { basePath: '/doconut' });
const file = document.querySelector('#picker').files[0]; // 自分のファイルから <input type="file" id="picker">
conv.reset(); // idle/drop 画面に戻る; onReady を再度発火しない
conv.loadFile(file); // File オブジェクトでフローを開始する; 現在アイドル状態でない限り no-op
conv.destroy(); // リスナーを削除し、mount を空にする; これ以降 instance は使用できなくなるラベル
すべての文字列には英語のデフォルトがあります;labels は任意のサブセットを上書きし、残りは英語のままです。実行時に変化するフラグメントは {placeholders} を使用します。例として uploading: 'Uploading {name}…' と pages: '{n} pages' があります。
| キー | 英語デフォルト |
|---|---|
dropPrompt | Drag & drop a document here |
dropHint | PDF, Word, Excel, PowerPoint, images and more |
chooseFile | Choose file |
uploading | Uploading {name}… |
page / pages | 1 page / {n} pages |
noTargets | No conversion targets are available for this file. |
convertTo / convert | Convert to / Convert |
converting | Converting to {target}… |
readyToDownload | Ready to download |
download / convertAnother | Download / Convert another |
watermarkNotice | Output is watermarked — get a license to remove it. |
retry | Retry |
genericError | Something went wrong. Please try again. |
sizeLimit | That file is larger than the {mb} MB upload limit. Please choose a smaller file. |
serverError | The server could not process this request. Please try again. |
networkError | Could not reach the server. Please check your connection and try again. |
さらに、キーはドロップゾーンの aria-label(dropAriaLabel)、プレビュー alt テキスト(previewAlt、resultAlt)、licenseUrl と共に使用される透かし通知のリンク形式(watermarkNoticePrefix、watermarkNoticeLink、watermarkNoticeSuffix)、読み取れない応答(badResponse)および aria-live アナウンス(annReady、annUploading、annLoaded、annLoadedNoTargets、annConverting、annDone、annError)をカバーします。
サーバーからの JSON エラーはサーバーが書いたまま表示されます;serverError は、失敗したレスポンスに JSON エラーが含まれない場合にのみ使用されます。例として無効化されたウィジェットの 404 があります。
テーマ設定
ウィジェットは dcw クラスをマウント要素に追加し、CSS カスタムプロパティから色、半径、フォントを読み取ります。そのため、内部を触らずにテーマを変更できます:
#doconut-convert.dcw {
--dcw-accent: #6b46c1;
--dcw-radius: 12px;
--dcw-font: "Inter", system-ui, sans-serif;
}デフォルト: --dcw-accent: #2b6cb0、--dcw-bg: #ffffff、--dcw-fg: #1a202c、--dcw-muted: #718096、--dcw-border: #cbd5e0、--dcw-radius: 8px、および --dcw-font 用のシステム UI フォントです。
独自のフロントエンドを構築する
ウィジェットはこの HTTP 契約のクライアントに過ぎません — 別の UX のために直接それに対して独自のフロントエンドを構築してください。3 つのルートはすべて ASP.NET ブランチの下にあり、UseDoconut() がマウントされている場所(通常は /doconut)に配置され、AddConverterWidget() が呼び出されるまで 404 を返します。エラーは JSON 本文、{ "error": "..." } を含みますが、テーブルで「ステータスのみ」と記載されている場合は除きます。未知の ?convert= 値は 400 を返します。
| ルート | 用途 | 成功レスポンス |
|---|---|---|
POST ?convert=open(マルチパート、1 ファイル) | ソースドキュメントをアップロードしてプレビュー用に開く | 200 — { token, pages, sourceExt, allowedTargets } |
POST ?token=<token>&convert=run&target=<ext> | 保管されたソースを target に変換する | 200 — { downloadToken, resultToken, resultPages, downloadName, watermarked } |
GET ?convert=download&token=<downloadToken> | 変換されたファイルをストリームする | 200 — ファイルバイト、Content-Disposition: attachment、Cache-Control: no-store |
sourceExt は open レスポンス内で先頭にドットがありません(例: "docx")— DocumentConverter.ConvertAsync の sourceExtension パラメータとは逆の規約で、こちらはドットが必要です。allowedTargets は小文字のターゲット名("pdf"、"html"、…)を一覧表示します;それらのうちの一つを target として渡すと、大文字小文字を区別せずにマッチします。open はマルチパート本文の最初のファイルを使用します。
resultToken は null で、結果をプレビューできない場合は resultPages は 0 です。downloadName はターゲットの拡張子を付けたソースファイル名です。
プレビュー画像は標準のビューア画像ルート {basePath}?token={token}&page=1&thumb=1&width={px} を使用し、open からの token または run からの resultToken を使用します。ウィジェットは width=240 を要求します。
アップロードされたソースバイトはサーバー側に保管され、最後に読み取られてから 30 分間保持されます。この期間が過ぎると、run は 404 を返し、ファイルを再度開く必要があります。変換された結果も同じ保管領域にあり、変換完了時に downloadToken は新たな 30 分間のウィンドウを取得します。一方、resultToken は結果プレビュー用の通常のビューアセッショントークンです。結果がプレビュー可能な場合、downloadToken と resultToken は同じ値になります。ビューア結果を閉じても有効なダウンロード保管は削除されず、ブラウザウィジェットをリセットしてもどちらのウィンドウも延長されません。
失敗モード(ルート別):
| ルート | ステータス | 条件 | 本文 |
|---|---|---|---|
| 任意 | 404 | ウィジェットが有効化されていません(AddConverterWidget() が呼び出されていません)— 3 つのルートがディスパッチされる前にチェックされます | ステータスのみ |
| 任意 | 405 | HTTP メソッドが間違っています(open/run は POST が必要です;download は GET が必要です) | ステータスのみ |
open | 400 | マルチパートアップロードではありません | Expected a multipart file upload. |
open | 400 | ファイルがない、または空です | No file uploaded. |
open | 400 | 変換できないソース拡張子 | This file type cannot be converted. |
open | 403 | ファイルタイプはライセンスが付与しない機能を必要とします(Dicom がない DICOM ファイル) | Converting this file type requires the Dicom capability license. |
open | 413 | アップロードされたファイルが MaxUploadMb を超えています。Content-Length に対してチェックされ、アップロードが読み取られる間もチェックされます | File is too large. |
run | 400 | トークンの形式が不正です(GUID ではありません) | Invalid token. |
run | 400 | target が ConversionTarget に解析できません | Unknown target format. |
run | 400 | target がソースの allowedTargets にありません | That target format is not available for this file. |
run | 404 | 保管されたアップロードが期限切れになったか、トークンが開かれたことがありません | Upload expired — please re-open the file. |
open, run | 500 | 内部処理に失敗しました | サニタイズされたメッセージ — 他のすべての Doconut エラーパスと同様にサニタイズされ、内部の詳細は決して公開されません |
download | 400 | トークンの形式が不正です(GUID ではありません) | ステータスのみ |
download | 404 | 不明または期限切れのダウンロードトークン | ステータスのみ |
fetch を使用した完全なラウンドトリップ:
// file: 変換対象のファイル、例えば <input type="file"> から取得したもの。
async function convertFile(file) {
const base = '/doconut';
// 1. open: ファイルをアップロードする
const form = new FormData();
form.append('file', file, file.name);
const openResp = await fetch(base + '?convert=open', { method: 'POST', body: form });
if (!openResp.ok) throw new Error((await openResp.json()).error);
const opened = await openResp.json();
// 2. run: PDFに変換できる場合はPDFへ、そうでなければ最初に許可された対象へ変換する
const target = opened.allowedTargets.includes('pdf') ? 'pdf' : opened.allowedTargets[0];
const runResp = await fetch(base + '?token=' + encodeURIComponent(opened.token) +
'&convert=run&target=' + target, { method: 'POST' });
if (!runResp.ok) throw new Error((await runResp.json()).error);
const converted = await runResp.json();
// 3. download: ブラウザがそのままたどれる単純なGET
window.location.href = base + '?convert=download&token=' + encodeURIComponent(converted.downloadToken);
}エンドポイントは 同一オリジン です:このバージョンは CORS サポートを提供しません。UI とウィジェットスクリプトを Doconut と同じオリジンから提供するか、/doconut の両方のパス(ミドルウェアパスとリソースパス)を UI のオリジン下でリバースプロキシしてください。
本番環境で
- プラグインをインストール コアパッケージの隣に、同じバージョンで:
dotnet add package Doconut.NETStandard.Converter. - ライセンスファイルを追加
Doconut.Viewer.Converter.licをDoconut.Viewer.licと同じフォルダーに配置します. - サーバー上限を設定
MaxUploadMbはAddConverterWidget内でサーバーが適用する上限です; ウィジェットのmaxUploadMbはクライアント側のチェックのみです。両方を同じに保ってください. - UI を同一オリジンから提供 Doconut エンドポイントと同じオリジンから、またはリバースプロキシで提供します(独自のフロントエンドを構築する を参照)。
- 変換結果を破棄
ConvertAsyncが返すストリームはプールされています; 破棄するとバッファがプールに戻ります。
Web ファーム
ウィジェットは、open を提供したノードのメモリ上に各アップロードとその結果を保持します。スティッキーセッションのないロードバランサーの背後では、後続の run、download、またはプレビューリクエストが別のノードに到達し、アップロードが見つからないことがあります。AddDoconut() 後に、共有かつ暗号化されたウィジェットストアを一度だけ登録してください:
byte[] farmKey = Convert.FromBase64String(builder.Configuration["Doconut:FarmKey"]);
builder.Services.AddDoconutDistributedWidgets(store =>
{
store.RootPath = @"\\fileshare\doconut"; // すべてのノードが読み書きできるフォルダー
store.FarmKey = farmKey; // 少なくとも 32 bytes、すべてのノードで同一です
// store.Ttl = TimeSpan.FromMinutes(30); // アップロードが保持される期間 (デフォルト)
});- 単一サーバーは何も必要としません: この呼び出しを行わない場合、インメモリストアが使用されます。
- アップロードと結果は、共有上で保存時に暗号化されます(AES-256、encrypt-then-MAC)。各ファイルはトークンに紐付けられるため、あるトークンが別のファイルを読むことはできません。
- 共有上では、アップロードまたは結果は書き込まれた後
Ttlの間保持されます。読み取りはその期間を延長しません。 FarmKeyは少なくとも 32 バイトで、すべてのノードで同一である必要があります。シークレットストアからロードし、ハードコードしないでください。登録時にRootPathが欠如しているかFarmKeyが 32 バイト未満の場合、ArgumentExceptionがスローされます。RootPathを、分散ビューアが使用するのと同じ共有場所に設定してください。
API リファレンス
ファサードとウィジェットオプションは Doconut 名前空間にあります。ConversionTarget は Doconut.Configs.Conversion にあります。ConverterPlugin は Doconut.Plugins.Converter にあります。
DocumentConverter
public sealed class DocumentConverter
{
public Task<Stream> ConvertAsync(
string filePath, ConversionTarget target,
string? password = null, CancellationToken ct = default);
public Task<Stream> ConvertAsync(
Stream source, string sourceExtension, ConversionTarget target,
string? password = null, CancellationToken ct = default);
public Task<Stream> WordToHtmlAsync(string filePath, CancellationToken ct = default);
public Task<Stream> HtmlToWordAsync(
Stream htmlSource, ConversionTarget outputFormat = ConversionTarget.Docx,
CancellationToken ct = default);
}依存性注入から解決されます;コンストラクタは内部です。sourceExtension には先頭のドットが含まれます。HtmlToWordAsync は outputFormat が ConversionTarget.Doc のときに .doc ファイルを書き込み、その他の値の場合は .docx ファイルを書き込みます。
ConversionTarget
45 の出力フォーマットは 対象フォーマット に一覧されています。
ConverterWidgetOptions
public sealed class ConverterWidgetOptions
{
public int MaxUploadMb { get; set; } = 25;
}DoconutOptions.AddConverterWidget(Action<ConverterWidgetOptions>? configure = null) を介して設定します。これにより DoconutOptions が返され、呼び出しをチェーンできます。
トラブルシューティング
| 症状 | 原因 | 対策 |
|---|---|---|
AddDoconut() が The Converter plugin is registered via AddPlugin but no active license grants Converter. をスローします | ライセンスがない、TRIAL ファイルがある、Converter がないライセンス、またはバージョンウィンドウ外の有料ライセンス | Converter を付与するライセンスをインストールするか、AddPlugin<ConverterPlugin>() を削除してください |
AddDoconut() が AddConverterWidget() was called but the Converter plugin is not registered. をスローします | ウィジェットがプラグインなしで有効になっている | options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>() を追加してください |
DocumentConverter の解決時に No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>(). がスローされます | ConverterPlugin が登録されていません | AddDoconut() 内に AddPlugin<ConverterPlugin>() を追加してください |
| ストリーム変換でフォーマットがサポートされていないと表示されます | sourceExtension に先頭のドットがありません | ".xlsx" を渡してください、"xlsx" ではなく |
ConvertAsync が Converting '.dcm' requires the Dicom capability license. をスローします | DICOM ソースで、ライセンスが Dicom を付与していません | Dicom を付与するライセンスを使用してください |
| 出力に透かしが入っています | ライセンスが一時的(デモ/NFR)です | Converter を付与する有料ライセンスを使用してください |
ウィジェットはロードされますが、リクエストが 404 で応答します | AddConverterWidget() が呼び出されていない、または basePath が UseDoconut() がマウントされているブランチと一致しません | AddConverterWidget() を呼び出してください;basePath を修正してください |
open が 403 Converting this file type requires the Dicom capability license. と応答します | DICOM アップロードで、ライセンスが Dicom を付与していません | Dicom を付与するライセンスを使用してください |
open が 413 File is too large. と応答します | アップロードが MaxUploadMb を超えています | AddConverterWidget で MaxUploadMb を発生させてください;ウィジェットの maxUploadMb はクライアント側のチェックのみです |
run が 400 That target format is not available for this file. と応答します | 対象がソースの allowedTargets のいずれでもありません | open からの allowedTargets のみを提供してください |
run または download が 404 と応答します(run からの Upload expired — please re-open the file.) | 30 分のウィンドウが経過した、または Web ファームノードにアップロードがありません | ファイルを再度開いてください;ファーム内では AddDoconutDistributedWidgets を登録してください |
| UI が別オリジンにあるとウィジェットが失敗します | エンドポイントが CORS をサポートしていません | UI を同一オリジンから提供するか、Doconut パスをリバースプロキシしてください |
| テーマが適用されません | 変数が祖先要素またはマウント内部の要素に設定されており、ウィジェット独自の .dcw ルールがマウント上に設定しています | マウント自体を対象にしてください:#doconut-convert.dcw または #doconut-convert |
フレームワークノート
viewer.Converter.GetConverter()はここには存在しません。変換はもはやビューアーインスタンスを介して行われません。代わりにDoconut.DocumentConverterを注入してください。- この
ConversionTarget列挙型はすべてのソースファミリーをカバーします。以前のライブラリにはファミリーごとの*ConfigConverter型があり、WordConfigConverter、ExcelConfigConverterなどがあり、それぞれが独自の入れ子になったEnTargetFormat列挙型を持ち、さらに入力用のSourceFormatConverter列挙型がありました。これらはすべて廃止されました;移行ガイド を参照してください。 - Windows のみ、.NET Standard パッケージの他の部分と同様です。
このページは役に立ちましたか?