コンバータプラグイン

ドキュメントを45の対象フォーマットに変換

コンバータプラグインは Doconut をドキュメント変換サービスに変えます。パブリック DocumentConverter ファサードの背後にあるエンジンを提供し、オプトインで独自の HTTP 契約を持つドロップインウィジェットも提供するため、C# から、ウィジェットから、または自分で作成したフロントエンドからドキュメントを変換できます。

表面使用シーン
DocumentConverter (C#)ブラウザを使用せず、サーバー上で変換します
Drop-in widget (doconutConverter.js)ページ内に既成のアップロード、変換、ダウンロード画面が欲しい場合
HTTP endpoints (?convert=open|run|download)ドキュメント化されたサーバー契約に対して独自の変換 UI を構築する場合

パッケージのインストール

最新の安定版コンバータプラグインをインストールします:

bash
dotnet add package Doconut.NET8.Converter

このドキュメントで説明しているリリースにプラグインを固定するには、バージョンを別途指定します:

bash
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 では、最初のドキュメントを開く前にフォント設定ライブラリをインストールしてください:

bash
apt-get update && apt-get install -y libfontconfig1

RHEL、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 として提供され、ベースビューアパッケージと共にインストールされます。

csharp
builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
    options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
});

これが C# ファサードに必要なすべてです。ウィジェットとその HTTP エンドポイントは別個のオプトインであり、AddConverterWidget() です(ドロップインウィジェット を参照)。

プラグインは Converter 機能を付与するライセンスが必要です。ライセンスがない場合、AddDoconut() はアプリがリクエストを処理する前の起動時に InvalidOperationException をスローします:

text
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 を解決してください — 設計上ステートレスなので、単一のインスタンスをリクエスト間で安全に再利用できます。

csharp
// DocumentConverter を注入します; そのコンストラクタは internal なので、決して `new` しないでください。
Stream pdf = await converter.ConvertAsync("contract.docx", ConversionTarget.Pdf, ct: ct);
csharp
// sourceExtension には先頭のドットが含まれます。パスワードは、ドキュメントが保護されていない限り null です。
Stream png = await converter.ConvertAsync(stream, ".xlsx", ConversionTarget.Png, password: null, ct: ct);
csharp
Stream html = await converter.WordToHtmlAsync("report.docx", ct);
csharp
// 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 のメンバーがあります:

text
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 エンドポイントはオプトインで、デフォルトでは無効化されています — デフォルトで安全です。サーバー側でプラグイン登録と共に有効化してください:

csharp
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() が例外をスローします:

text
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 ファイル自体は引き続き配信されます(単なる埋め込み静的リソースで、通信先エンドポイントだけが制限されています)。

埋め込む

html
<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 のいずれかを選択させ、変換し、可能な場合は結果をプレビューし、ダウンロードを提供します。

オプション

オプション型デフォルト備考
basePathstring/doconut?convert= エンドポイントのベースパスです。実際に UseDoconut() がマウントされている ASP.NET ブランチと一致する必要があります(通常は MiddlewarePath を通じて調整されます)
resPathstring/doconut-res他の Doconut ウィジェットとの設定一貫性のために受け入れられます;コンバータウィジェットは現在それから URL を生成しません
maxUploadMbnumber25クライアント側の事前チェックのみです — アップロード前にサイズオーバーのファイルを拒否します。サーバーは独自に上限を強制し、超過した場合は 413 で応答します
licenseUrlstring | nullnull設定すると、結果画面の透かし通知をこの URL へのリンクに変えます
labelsobject{}ウィジェットの英語デフォルト文字列(ドロップテキスト、ボタン、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() はウィジェットインスタンス自体を返します — それを保持してウィジェットをプログラムで操作してください:

javascript
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' があります。

キー英語デフォルト
dropPromptDrag & drop a document here
dropHintPDF, Word, Excel, PowerPoint, images and more
chooseFileChoose file
uploadingUploading {name}…
page / pages1 page / {n} pages
noTargetsNo conversion targets are available for this file.
convertTo / convertConvert to / Convert
convertingConverting to {target}…
readyToDownloadReady to download
download / convertAnotherDownload / Convert another
watermarkNoticeOutput is watermarked — get a license to remove it.
retryRetry
genericErrorSomething went wrong. Please try again.
sizeLimitThat file is larger than the {mb} MB upload limit. Please choose a smaller file.
serverErrorThe server could not process this request. Please try again.
networkErrorCould 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 カスタムプロパティから色、半径、フォントを読み取ります。そのため、内部を触らずにテーマを変更できます:

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
任意405HTTP メソッドが間違っています(open/run は POST が必要です;download は GET が必要です)status only
open400マルチパートアップロードではありませんExpected a multipart file upload.
open400ファイルがない、または空ですNo file uploaded.
open400変換できないソース拡張子This file type cannot be converted.
open403ファイルタイプはライセンスが許可していない機能を必要とします(Dicom がない DICOM ファイル)Converting this file type requires the Dicom capability license.
open413アップロードされたファイルが MaxUploadMb を超えています。Content-Length に対してチェックされ、アップロードが読み取られている間もチェックされますFile is too large.
run400トークンが不正です(GUID ではありません)Invalid token.
run400target が ConversionTarget に解析できませんUnknown target format.
run400target がソースの allowedTargets にありませんThat target format is not available for this file.
run404保管されたアップロードが期限切れか、トークンが開かれたことがありませんUpload expired — please re-open the file.
open, run500処理が内部で失敗しましたサニタイズされたメッセージ — 他のすべての Doconut エラーパスと同様にサニタイズされ、内部の詳細は決して公開されません
download400トークンが不正です(GUID ではありません)status only
download404不明または期限切れのダウンロードトークンstatus only

fetch を使用した完全な往復:

javascript
// 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 のオリジン下でリバースプロキシしてください。

本番環境で

  1. プラグインをインストール コアパッケージの隣に、同じバージョンで: dotnet add package Doconut.NET8.Converter。
  2. ライセンスファイルを追加. Doconut.Viewer.Converter.lic を Doconut.Viewer.lic と同じフォルダーに置きます。
  3. サーバー上限を設定. MaxUploadMb は AddConverterWidget 内でサーバーが適用する上限です; ウィジェットの maxUploadMb はクライアント側のチェックだけです。両方を同じに保ちます。
  4. UI を同一オリジンから提供 Doconut エンドポイントと同じオリジンとして、またはリバースプロキシで提供します(独自のフロントエンドを構築する を参照)。
  5. 変換結果を破棄. ConvertAsync が返すストリームはプールされています; 破棄するとバッファがプールに返されます。

Web ファーム

ウィジェットは、open を提供したノードのメモリに各アップロードとその結果を保持します。スティッキーセッションのないロードバランサーの背後では、後続の run、download、またはプレビューリクエストが別のノードに到達し、アップロードが見つからないことがあります。AddDoconut() 後に、共有された暗号化ウィジェットストアを一度だけ登録してください:

csharp
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

csharp
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

csharp
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

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