コンバータプラグイン
ドキュメントを45の対象フォーマットに変換
コンバータプラグインは Doconut をドキュメント変換サービスに変えます。パブリック DocumentConverter ファサードの背後にあるエンジンを提供し、さらにオプトインで独自の HTTP 契約を持つドロップインウィジェットも提供するので、C# から、ウィジェットから、または自分で作成したフロントエンドからドキュメントを変換できます。
| 対象 | 使用シーン |
|---|---|
DocumentConverter (C#) | サーバー上で変換し、ブラウザは関与しません |
Drop-in widget (doconutConverter.js) | ページ内に、アップロード・変換・ダウンロード画面がすぐに使えるウィジェットが欲しい場合 |
HTTP endpoints (?convert=open|run|download) | 文書化されたサーバー契約に基づいて独自の変換 UI を構築したい場合 |
パッケージのインストール
最新の安定版コンバータプラグインをインストールします:
dotnet add package Doconut.NET6.Converterこのドキュメントで説明しているリリースにプラグインを固定するには、バージョンを別途指定します:
dotnet add package Doconut.NET6.Converter --version 26.10.0コンバータパッケージは Doconut.NET6 と同じバージョンに保ってください。パッケージ ID は Doconut.NET6.Converter です。.<version> はダウンロードされた .nupkg のファイル名にのみ現れます。
プラグインのライセンスファイル Doconut.Viewer.Converter.lic は Doconut.Viewer.lic と同じフォルダーに配置します。ビューアのライセンスと一緒に読み込まれます。
プラットフォーム。プラグインは Doconut.NET6 が動作するすべての環境で動作します:Windows と x64 の glibc ベース Linux(Alpine やその他の musl ベースディストリビューションは除く)。Linux では、最初のドキュメントを開く前にフォント設定ライブラリをインストールしてください:
apt-get update && apt-get install -y libfontconfig1RHEL、Fedora などの類似ディストリビューションでは、パッケージは fontconfig です。これがないと、ドキュメントのオープンに失敗し、The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation. が発生します。
プラグインの登録
AddConverter() メソッドは存在しません — Doconut のプラグインモデルは統一されています。すべてのプラグインは、コンバータも含めて、同じ方法で登録します:AddDoconut() 内で AddPlugin<TPlugin>() を呼び出します。ConverterPlugin は独自の NuGet パッケージ Doconut.NET6.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 には先頭のドットが含まれます。document が保護されていない限り、password は null です。
Stream png = await converter.ConvertAsync(stream, ".xlsx", ConversionTarget.Png, password: null, ct: ct);Stream html = await converter.WordToHtmlAsync("report.docx", ct);// html: Word 文書に戻すための HTML を保持する 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() が呼び出されましたが Converter プラグインが登録されていません...)。
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 のいずれかを選択させ、変換し、可能な場合は結果をプレビューし、ダウンロードを提供します。
オプション
| オプション | 型 | デフォルト | 備考 |
|---|---|---|---|
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 が成功したとき | ランレスポンスと同じフィールドに加えて、要求された 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 オブジェクトでフローを開始する; 現在アイドル状態でない限り何もしない
conv.destroy(); // リスナーを削除し、mount を空にする; これ以降インスタンスは使用できなくなるラベル
すべての文字列には英語のデフォルトがあります;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": "..." })を持ちますが、テーブルに「status only」と記載されている場合は除きます。未知の ?convert= 値は 400 を返します。
| ルート | 目的 | 成功レスポンス |
|---|---|---|
POST ?convert=open (multipart、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 は multipart 本体の最初のファイルを使用します。
結果をプレビューできない場合、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 は同じ値になります。ビューア結果を閉じても、まだ有効なダウンロードスタッシュは削除されず、ブラウザウィジェットをリセットしてもどちらのウィンドウも延長されません。
失敗モード(ルート別に分類):
| ルート | ステータス | 条件 | 本文 |
|---|---|---|---|
| any | 404 | ウィジェットが有効化されていません(AddConverterWidget() が呼び出されていません)— 3 つのルートがディスパッチされる前にチェックされます | ステータスのみ |
| any | 405 | HTTP メソッドが間違っています(open/run は POST が必要です;download は GET が必要です) | ステータスのみ |
open | 400 | multipart アップロードではありません | 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 に変換し、そうでなければ最初に許可された対象に変換する
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);
}エンドポイントは same-origin です: このバージョンは CORS をサポートしていません。UI とウィジェットスクリプトを Doconut と同じオリジンから提供するか、/doconut の両方のパス(ミドルウェアパスとリソースパス)を UI のオリジン下でリバースプロキシしてください。
本番環境で
- プラグインをインストール コアパッケージの隣に、同じバージョンで:
dotnet add package Doconut.NET6.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 バイト、すべてのノードで同一です
// 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);
}依存性注入から解決されます; コンストラクタは internal です。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 |
このページは役に立ちましたか?