コンバータ プラグイン

45 の対象フォーマットに文書を変換

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

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

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

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

bash
dotnet add package Doconut.NETStandard.Converter

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

bash
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 に同梱されており、ベース ビューア パッケージと共にインストールされます。

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 が欠如したライセンス、またはバージョンウィンドウ外で使用された有料ライセンスの場合にスローされます。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 を解決してください — 設計上ステートレスなので、単一のインスタンスをリクエスト間で安全に再利用できます。

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

オプション

オプション型デフォルト備考
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 が成功したとき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 オブジェクトでフローを開始する; 現在アイドル状態でない限り no-op
conv.destroy();       // リスナーを削除し、mount を空にする; これ以降 instance は使用できなくなる

ラベル

すべての文字列には英語のデフォルトがあります;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)に配置され、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 つのルートがディスパッチされる前にチェックされますステータスのみ
任意405HTTP メソッドが間違っています(open/run は POST が必要です;download は GET が必要です)ステータスのみ
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 ではありません)ステータスのみ
download404不明または期限切れのダウンロードトークンステータスのみ

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に変換できる場合は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 のオリジン下でリバースプロキシしてください。

本番環境で

  1. プラグインをインストール コアパッケージの隣に、同じバージョンで: dotnet add package Doconut.NETStandard.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);
}

依存性注入から解決されます;コンストラクタは内部です。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 を付与するライセンスを使用してください
出力に透かしが入っていますライセンスが一時的(デモ/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 パッケージの他の部分と同様です。

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