コンバータプラグイン
ドキュメントを45の対象フォーマットに変換
コンバータプラグインは Doconut をドキュメント変換サービスに変えます。パブリック DocumentConverter ファサードの背後にあるエンジンを提供し、オプトインで独自の HTTP 契約を持つドロップインウィジェットも提供するため、C# から、ウィジェットから、または自分で作成したフロントエンドからドキュメントを変換できます。
| 表面 | 使用シーン |
|---|---|
DocumentConverter (C#) | ブラウザを使用せず、サーバー上で変換します |
Drop-in widget (doconutConverter.js) | ページ内に既成のアップロード、変換、ダウンロード画面が欲しい場合 |
HTTP endpoints (?convert=open|run|download) | ドキュメント化されたサーバー契約に対して独自の変換 UI を構築する場合 |
パッケージのインストール
最新の安定版コンバータプラグインをインストールします:
dotnet add package Doconut.NET8.Converterこのドキュメントで説明しているリリースにプラグインを固定するには、バージョンを別途指定します:
dotnet add package Doconut.NET8.Converter --version 26.10.0コンバータパッケージは Doconut.NET8 と同じバージョンに保ってください。パッケージ ID は Doconut.NET8.Converter です。.<version> はダウンロードされた .nupkg ファイル名にのみ現れます。
プラグインのライセンスファイル Doconut.Viewer.Converter.lic は Doconut.Viewer.lic と同じフォルダーに配置します。ビューアのライセンスと一緒に読み込まれます。
プラットフォーム。 プラグインは Doconut.NET8 が動作するすべての環境で動作します: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.NET8.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 が欠如したライセンス、バージョンウィンドウ外で使用された有料ライセンスに対してスローされます。臨時のデモ/NFR ライセンスは受け入れられます。無料のサイレントティアはありません。ライセンスのロード方法については、License Setup を参照してください。
ライセンスと透かし
| ライセンス状態 | 起動時 | 変換出力 |
|---|---|---|
バージョンウィンドウ内で Converter を付与する有料ビューアライセンス | 起動 | クリーン — watermarked: false |
| アクティブな臨時(デモ/NFR)ライセンス | 起動 | 変換時に評価用透かし — watermarked: true が付与されます |
| 期限切れの臨時(デモ/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 のいずれかを選択させ、変換し、可能な場合は結果をプレビューし、ダウンロードを提供します。
オプション
| オプション | 型 | デフォルト | 備考 |
|---|---|---|---|
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(); // リスナーを削除し、マウントを空にする; これ以降インスタンスは使用できなくなるラベル
すべての文字列には英語のデフォルトがあります;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)に配置されています。404 が返され、AddConverterWidget() が呼び出されるまで応答します。エラーは JSON 本文、{ "error": "..." } を含みますが、テーブルで「status only」と記載されている場合を除きます。未知の ?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 つのルートがディスパッチされる前にチェックされます | status only |
| 任意 | 405 | HTTP メソッドが間違っています(open/run は POST が必要です;download は GET が必要です) | status only |
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 ではありません) | status only |
download | 404 | 不明または期限切れのダウンロードトークン | status only |
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.NET8.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);
}依存性注入から解決されます;コンストラクタは 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 を付与するライセンスを使用してください |
| 出力に透かしが付いている | ライセンスが一時的(Demo/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 と応答(Upload expired — please re-open the file. from run) | 30 分のウィンドウが経過した、または Web ファームノードにアップロードがない | ファイルを再度開いてください; ファーム内では AddDoconutDistributedWidgets を登録してください |
| UI が別オリジンにあるとウィジェットが失敗 | エンドポイントが CORS をサポートしていない | UI を同一オリジンから提供するか、Doconut パスをリバースプロキシしてください |
| テーマが適用されない | 変数が祖先要素またはマウント内部の要素に設定されており、ウィジェット独自の .dcw ルールがマウント上に設定している | マウント自体を対象にしてください: #doconut-convert.dcw または #doconut-convert |
このページは役に立ちましたか?