Plugin Konverter

Konversi dokumen ke 45 format target

Plugin Konverter mengubah Doconut menjadi layanan konversi dokumen. Ia menyediakan mesin di balik antarmuka publik DocumentConverter, dan — opsional — widget drop-in dengan kontrak HTTP‑nya sendiri, sehingga Anda dapat mengonversi dokumen dari C#, dari widget, atau dari frontend yang Anda buat sendiri.

PermukaanGunakan ketika
DocumentConverter (C#)Anda mengonversi di server, tanpa melibatkan browser
Drop-in widget (doconutConverter.js)Anda menginginkan layar unggah, konversi, dan unduh yang siap pakai di halaman Anda
HTTP endpoints (?convert=open|run|download)Anda membangun UI konversi Anda sendiri terhadap kontrak server yang terdokumentasi

Pasang paket

Pasang plugin Konverter stabil terbaru:

bash
dotnet add package Doconut.NETStandard.Converter

Untuk mengunci plugin ke rilis yang dijelaskan dalam dokumentasi ini, berikan versi secara terpisah:

bash
dotnet add package Doconut.NETStandard.Converter --version 26.10.0

Pertahankan paket Konverter pada versi yang sama dengan Doconut.NETStandard. ID paketnya adalah Doconut.NETStandard.Converter; .<version> hanya muncul dalam nama file .nupkg yang diunduh.

Berkas lisensi plugin, Doconut.Viewer.Converter.lic, diletakkan di folder yang sama dengan Doconut.Viewer.lic; berkas ini dibaca bersama lisensi penampil.

Daftarkan plugin

Tidak ada metode AddConverter() — model plugin Doconut seragam. Setiap plugin, termasuk Konverter, didaftarkan dengan cara yang sama: panggil AddPlugin<TPlugin>() di dalam AddDoconut(). ConverterPlugin dikirim dalam paket NuGet‑nya sendiri, Doconut.NETStandard.Converter, yang dipasang bersamaan dengan paket penampil dasar.

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

Itu semua yang dibutuhkan antarmuka C#. Widget dan endpoint HTTP‑nya adalah opsi terpisah, AddConverterWidget() (lihat Widget Drop-in).

Plugin memerlukan lisensi yang memberikan kemampuan Converter. Tanpa lisensi, AddDoconut() melemparkan InvalidOperationException saat startup, sebelum aplikasi melayani permintaan:

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.

Ia melemparkan kesalahan karena tidak ada lisensi, berkas legacy TRIAL, lisensi tanpa Converter, dan lisensi berbayar yang digunakan di luar jendela versinya. Lisensi Demo/NFR sementara diterima. Tidak ada tingkatan gratis yang diam. Lihat Pengaturan Lisensi untuk cara memuat lisensi.

Lisensi & watermark

Status lisensiSaat startupOutput konversi
Lisensi penampil berbayar yang memberikan Converter, dalam jendela versinyaMulaiBersih — watermarked: false
Lisensi Sementara Aktif (Demo/NFR)MulaiMengonversi, dengan watermark evaluasi — watermarked: true
Lisensi Sementara Kedaluwarsa (Demo/NFR)MulaiMengonversi, dengan watermark evaluasi — watermarked: true
Tidak ada lisensi, berkas legacy TRIAL, lisensi tanpa Converter, atau lisensi berbayar di luar jendela versinyaAddDoconut() melempar—

Kedua jalur pemanggilan menghitung flag berdasarkan aturan yang sama: antarmuka C# DocumentConverter menurunkannya secara internal dari status IsViewerLicensed dan IsTemporary lisensi, dan penangan ?convert=run widget melakukan pemeriksaan setara (IsViewerLicensed && !IsTrial && !IsTemporary) untuk mengisi bidang watermarked yang dikembalikannya. Integrasi dapat dibangun dan diuji end‑to‑end dengan lisensi evaluasi sebelum pembelian — hanya byte output yang berubah.

Sumber DICOM (.dcm, .ima) juga memerlukan kemampuan Dicom. Tanpa itu, ConvertAsync melemparkan LicenseException (Converting '.dcm' requires the Dicom capability license.) dan open widget menjawab 403.

Penggunaan dari C#

Setiap konversi mengembalikan sebuah MemoryStream yang dapat dicari (seekable) yang diposisikan pada 0, siap untuk dibaca atau disalin segera. Resolusi DocumentConverter dari DI di mana pun Anda membutuhkannya — ia bersifat tanpa status (stateless) secara desain, sehingga satu instance aman untuk digunakan kembali di seluruh permintaan.

csharp
// Suntikkan DocumentConverter; konstruktornya internal, jadi jangan pernah `new` itu.
Stream pdf = await converter.ConvertAsync("contract.docx", ConversionTarget.Pdf, ct: ct);
csharp
// sourceExtension mencakup titik di depannya. password bernilai null kecuali dokumen dilindungi.
Stream png = await converter.ConvertAsync(stream, ".xlsx", ConversionTarget.Png, password: null, ct: ct);
csharp
Stream html = await converter.WordToHtmlAsync("report.docx", ct);
csharp
// html: sebuah Stream yang memuat HTML untuk diubah kembali menjadi dokumen Word, seperti hasil dari WordToHtmlAsync.
Stream docx = await converter.HtmlToWordAsync(html, ConversionTarget.Docx, ct);

Dua detail yang mudah keliru: sourceExtension pada overload stream harus menyertakan titik di depan (".xlsx", bukan "xlsx") — konverter mencocokkannya dengan katalog format dan ekstensi tanpa titik tidak akan terpecahkan. Dan meskipun namanya, WordToHtmlAsync mengembalikan Task<Stream>, bukan Task<string> — Anda mendapatkan dokumen HTML (gambar tersemat sebagai Base64) sebagai stream, sama seperti setiap hasil konversi lainnya.

Pemanggil memiliki stream yang dikembalikan dan harus membuangnya setelah menyalin atau mengembalikan isinya. Layanan DocumentConverter itu sendiri diresolusikan dari dependency injection; jangan membuat atau membuangnya secara manual.

Format target

ConversionTarget (namespace Doconut.Configs.Conversion) memiliki 45 anggota:

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

Tidak setiap sumber dapat dikonversi ke setiap target — plugin memetakan setiap keluarga format sumber (Word, Excel, PowerPoint, PDF, CAD, Image, Email, Diagram, Project/Task, PSD, dokumen web, DICOM) ke set tetap target yang diizinkan. Mengonversi sumber DICOM (.dcm, .ima) juga memerlukan lisensi yang memberikan kemampuan Dicom; targetnya adalah Pdf, Png, Jpeg, Bmp, Tiff, dan Gif. Jangan mengkodekan keras enum ini sebagai daftar target UI Anda: ?convert=open mengembalikan allowedTargets yang sebenarnya untuk file apa pun yang baru saja diunggah, dan itulah yang harus menggerakkan pemilih.

Widget Drop-in

Aktifkan endpoint

Endpoint ?convert=open|run|download widget bersifat opt-in dan dinonaktifkan secara default — aman secara bawaan. Aktifkan mereka di sisi server, bersamaan dengan pendaftaran plugin:

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

AddConverterWidget() tanpa argumen mengaktifkan widget dengan nilai default (MaxUploadMb = 25). Itu tidak memberikan hak konversi sendiri: ia membutuhkan AddPlugin<ConverterPlugin>(), atau AddDoconut() melempar pengecualian:

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.

Tanpa AddConverterWidget(), tiga endpoint ?convert= menjawab 404 — tetapi file JS itu sendiri tetap disajikan (itu adalah sumber daya statis tertanam biasa; hanya endpoint yang dibicarakannya yang dibatasi).

Sematkan itu

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) mengambil selector CSS atau elemen, melempar jika mount tidak ditemukan, dan mengembalikan sebuah handle. Widget mengunggah file, menampilkan pratinjau halaman 1, memungkinkan pengguna memilih salah satu allowedTargets, mengonversi, menampilkan pratinjau hasil bila memungkinkan, dan menawarkan unduhan.

Opsi

OpsiTipeBawaanCatatan
basePathstring/doconutJalur dasar untuk endpoint ?convert=; harus cocok dengan cabang ASP.NET tempat UseDoconut() sebenarnya dipasang (biasanya dikoordinasikan melalui MiddlewarePath)
resPathstring/doconut-resDiterima untuk konsistensi konfigurasi dengan widget Doconut lainnya; widget konverter saat ini tidak membangun URL apa pun darinya
maxUploadMbnumber25Hanya pemeriksaan pra‑sisi klien — menolak file yang terlalu besar sebelum diunggah. Server menegakkan batasnya secara independen dan menjawab 413 jika terlampaui
licenseUrlstring | nullnullJika diatur, mengubah pemberitahuan watermark pada layar hasil menjadi tautan ke URL ini
labelsobject{}Menimpa sebagian atau seluruh string default bahasa Inggris widget (teks drop, tombol, pengumuman aria‑live, pesan kesalahan)

Callback

CallbackTerjadi ketikaMuatan
onReady()Widget telah merender layar idle/drop—
onSourceLoaded({ token, pages, sourceExt, allowedTargets })?convert=open berhasiltoken sesi sumber, jumlah halaman, ekstensi sumber (tanpa titik di depan), daftar target yang diizinkan
onConverted({ downloadToken, resultToken, resultPages, downloadName, watermarked, target })?convert=run berhasilfield yang sama dengan respons run, plus target yang diminta
onDownload({ downloadName, downloadToken })Pengguna mengklik tautan Unduhdipicu bersamaan dengan unduhan native browser — tidak menyela atau menggantinya
onError({ phase, message })Permintaan open atau run gagalphase adalah 'open' atau 'run'; message adalah error server yang disanitasi (atau pesan sisi klien untuk pemeriksaan pra‑ukuran unggahan)

Callback yang melempar akan ditangkap dan dicatat; tidak pernah memutus alur widget.

Penanganan Imperatif

Doconut.convert() mengembalikan instance widget itu sendiri — simpan untuk mengendalikan widget secara programatik:

javascript
const conv = Doconut.convert('#doconut-convert', { basePath: '/doconut' });
const file = document.querySelector('#picker').files[0]; // sebuah File dari milik Anda sendiri <input type="file" id="picker">
conv.reset();         // kembali ke layar idle/drop; tidak memicu ulang onReady
conv.loadFile(file);  // memulai alur dengan objek File; tidak melakukan apa-apa kecuali sedang idle
conv.destroy();       // menghapus pendengar, mengosongkan mount; instance tidak dapat digunakan lagi setelah ini

Label

Setiap string memiliki default bahasa Inggris; labels menimpa sebagian atau seluruhnya dan sisanya tetap bahasa Inggris. Fragmen yang berubah pada runtime menggunakan {placeholders}, seperti uploading: 'Uploading {name}…' dan pages: '{n} pages'.

KunciDefault bahasa Inggris
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.

Kunci tambahan mencakup aria-label zona drop (dropAriaLabel), teks alt pratinjau (previewAlt, resultAlt), bentuk tautan dari pemberitahuan watermark yang digunakan dengan licenseUrl (watermarkNoticePrefix, watermarkNoticeLink, watermarkNoticeSuffix), respons yang tidak dapat dibaca (badResponse) dan pengumuman aria-live (annReady, annUploading, annLoaded, annLoadedNoTargets, annConverting, annDone, annError).

Error JSON dari server ditampilkan sebagaimana ditulis server; serverError hanya digunakan ketika respons gagal tidak membawa error JSON, seperti 404 pada widget yang dinonaktifkan.

Tema

Widget menambahkan kelas dcw ke elemen mount‑nya dan membaca warna, radius, serta font dari properti khusus CSS, sehingga Anda dapat men‑tema‑nya tanpa menyentuh bagian internalnya:

css
#doconut-convert.dcw {
  --dcw-accent: #6b46c1;
  --dcw-radius: 12px;
  --dcw-font: "Inter", system-ui, sans-serif;
}

Bawaan: --dcw-accent: #2b6cb0, --dcw-bg: #ffffff, --dcw-fg: #1a202c, --dcw-muted: #718096, --dcw-border: #cbd5e0, --dcw-radius: 8px, dan font UI sistem untuk --dcw-font.

Bangun frontend Anda sendiri

Widget hanyalah klien untuk kontrak HTTP ini — bangun frontend Anda sendiri langsung di atasnya untuk UX yang berbeda. Ketiga rute berada di bawah cabang ASP.NET tempat UseDoconut() dipasang (biasanya /doconut), dan mereka menjawab 404 sampai AddConverterWidget() dipanggil. Kesalahan menyertakan badan JSON, { "error": "..." }, kecuali pada tabel yang menyatakan “status only”. Nilai ?convert= yang tidak dikenal menjawab 400.

RuteTujuanRespons sukses
POST ?convert=open (multipart, satu file)Mengunggah dan membuka dokumen sumber untuk pratinjau200 — { token, pages, sourceExt, allowedTargets }
POST ?token=<token>&convert=run&target=<ext>Mengonversi sumber yang disimpan ke target200 — { downloadToken, resultToken, resultPages, downloadName, watermarked }
GET ?convert=download&token=<downloadToken>Menyampaikan file yang telah dikonversi200 — byte file, Content-Disposition: attachment, Cache-Control: no-store

sourceExt dalam respons open tidak memiliki titik di depan (mis. "docx") — konvensi berlawanan dengan parameter sourceExtension pada DocumentConverter.ConvertAsync, yang memerlukannya. allowedTargets mencantumkan nama target huruf kecil ("pdf", "html", …); berikan salah satu sebagai target, yang dicocokkan tanpa memperhatikan huruf besar/kecil. open menggunakan file pertama dalam badan multipart.

resultToken adalah null, dan resultPages adalah 0, ketika hasil tidak dapat dipratinjau. downloadName adalah nama file sumber dengan ekstensi target.

Gambar pratinjau menggunakan rute gambar penampil standar, {basePath}?token={token}&page=1&thumb=1&width={px}, dengan token dari open atau resultToken dari run. Widget meminta width=240.

Byte sumber yang diunggah disimpan di sisi server dan dipertahankan selama 30 menit setelah terakhir dibaca; setelah jendela itu berakhir, run menjawab 404 dan file harus dibuka kembali. Hasil yang dikonversi berada di penyimpanan yang sama — downloadToken mendapatkan jendela 30‑menit baru ketika konversi selesai — sementara resultToken adalah token sesi penampil biasa untuk mempratinjau hasil. Ketika hasil dapat dipratinjau, downloadToken dan resultToken memiliki nilai yang sama. Menutup hasil penampil tidak menghapus penyimpanan unduhan yang masih berlaku, dan menyetel ulang widget browser tidak memperpanjang salah satu jendela.

Mode kegagalan, dikelompokkan per rute:

RuteStatusKapanIsi
any404Widget tidak diaktifkan (AddConverterWidget() tidak pernah dipanggil) — diperiksa sebelum tiga rute diprosesstatus only
any405Verba HTTP salah (open/run memerlukan POST; download memerlukan GET)status only
open400Bukan unggahan multipartExpected a multipart file upload.
open400Tidak ada file, atau file kosongNo file uploaded.
open400Ekstensi sumber tidak dapat dikonversiThis file type cannot be converted.
open403Tipe file memerlukan kemampuan yang tidak diberikan lisensi (file DICOM tanpa Dicom)Converting this file type requires the Dicom capability license.
open413File yang diunggah melebihi MaxUploadMb, diperiksa terhadap Content-Length dan saat unggahan dibacaFile is too large.
run400Token tidak valid (bukan GUID)Invalid token.
run400target yang tidak dapat diurai menjadi ConversionTargetUnknown target format.
run400target tidak ada dalam allowedTargets sumberThat target format is not available for this file.
run404Penyimpanan unggahan telah kedaluwarsa atau token tidak pernah dibukaUpload expired — please re-open the file.
open, run500Pemrosesan gagal secara internalPesan yang disaring — disaring dengan cara yang sama seperti setiap jalur kesalahan Doconut lainnya; tidak pernah mengungkap detail internal
download400Token tidak valid (bukan GUID)status only
download404Token unduhan tidak dikenal atau kedaluwarsastatus only

Sebuah perjalanan lengkap dengan fetch:

javascript
// file: File yang akan dikonversi, misalnya dari <input type="file">.
async function convertFile(file) {
  const base = '/doconut';

  // 1. open: unggah file
  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: konversi ke PDF bila diizinkan, jika tidak ke target pertama yang diizinkan
  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 sederhana yang dapat diikuti browser
  window.location.href = base + '?convert=download&token=' + encodeURIComponent(converted.downloadToken);
}

Endpoint bersifat same-origin: versi ini tidak mendukung CORS. Layani UI dan skrip widget dari asal yang sama dengan Doconut, atau lakukan reverse‑proxy kedua jalur /doconut (jalur middleware dan jalur sumber daya) di bawah asal UI Anda.

Dalam produksi

  1. Instal plugin di samping paket inti, dengan versi yang sama: dotnet add package Doconut.NETStandard.Converter.
  2. Tambahkan file lisensi. Letakkan Doconut.Viewer.Converter.lic di folder yang sama dengan Doconut.Viewer.lic.
  3. Atur batas server. MaxUploadMb di AddConverterWidget adalah batas yang diterapkan server; maxUploadMb widget hanya pemeriksaan sisi klien. Jaga keduanya tetap sama.
  4. Layani UI dari asal yang sama dengan endpoint Doconut, atau reverse-proxy mereka (lihat Bangun frontend Anda sendiri).
  5. Buang hasil konversi. Stream yang dikembalikan oleh ConvertAsync dipool; membuangnya mengembalikan buffer ke pool.

Farm web

Widget menyimpan setiap unggahan dan hasilnya di memori pada node yang melayani open. Di belakang load balancer tanpa sesi lengket, permintaan run, download atau pratinjau yang lebih lama dapat mencapai node lain dan tidak menemukan unggahan. Daftarkan penyimpanan widget terenkripsi bersama sekali, setelah AddDoconut():

csharp
byte[] farmKey = Convert.FromBase64String(builder.Configuration["Doconut:FarmKey"]);

builder.Services.AddDoconutDistributedWidgets(store =>
{
    store.RootPath = @"\\fileshare\doconut";   // sebuah folder yang dapat dibaca dan ditulis oleh setiap node
    store.FarmKey = farmKey;                   // setidaknya 32 byte, identik pada setiap node
    // store.Ttl = TimeSpan.FromMinutes(30);   // berapa lama unggahan disimpan (default)
});
  • Sebuah server tunggal tidak memerlukan apa pun: tanpa panggilan ini penyimpanan dalam memori digunakan.
  • Unggahan dan hasil dienkripsi saat disimpan pada share (AES-256, encrypt-then-MAC), dan setiap file terikat pada tokennya, sehingga satu token tidak pernah dapat membaca file token lain.
  • Pada share, sebuah unggahan atau hasil disimpan selama Ttl setelah ditulis; membacanya tidak memperpanjang jendela tersebut.
  • FarmKey harus setidaknya 32 byte dan sama pada setiap node. Muat dari penyimpanan rahasia; jangan pernah mengkodekannya secara keras. Registrasi melempar ArgumentException ketika RootPath tidak ada atau FarmKey lebih pendek dari 32 byte.
  • Arahkan RootPath ke lokasi bersama yang sama yang digunakan oleh penampil terdistribusi.

Referensi API

Facade dan opsi widget berada di namespace Doconut; ConversionTarget berada di Doconut.Configs.Conversion. ConverterPlugin berada di 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);
}

Diresolusikan melalui dependency injection; konstruktor bersifat internal. sourceExtension mencakup titik di depan. HtmlToWordAsync menulis file .doc ketika outputFormat adalah ConversionTarget.Doc, dan file .docx untuk nilai lainnya.

ConversionTarget

45 format output yang tercantum di Format target.

ConverterWidgetOptions

csharp
public sealed class ConverterWidgetOptions
{
    public int MaxUploadMb { get; set; } = 25;
}

Diatur melalui DoconutOptions.AddConverterWidget(Action<ConverterWidgetOptions>? configure = null), yang mengembalikan DoconutOptions sehingga pemanggilan dapat dirantai.

Pemecahan Masalah

GejalaPenyebabPerbaikan
AddDoconut() throws The Converter plugin is registered via AddPlugin but no active license grants Converter.Tidak ada lisensi, file TRIAL, lisensi tanpa Converter, atau lisensi berbayar di luar jendela versinyaInstal lisensi yang memberikan Converter, atau hapus AddPlugin<ConverterPlugin>()
AddDoconut() throws AddConverterWidget() was called but the Converter plugin is not registered.Widget diaktifkan tanpa pluginnyaTambahkan options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>()
Resolving DocumentConverter throws No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>().ConverterPlugin tidak terdaftarTambahkan AddPlugin<ConverterPlugin>() di dalam AddDoconut()
Stream conversion says the format is unsupportedsourceExtension tidak memiliki titik di depanGunakan ".xlsx", bukan "xlsx"
ConvertAsync throws Converting '.dcm' requires the Dicom capability license.Sumber DICOM, dan lisensi tidak memberikan DicomGunakan lisensi yang memberikan Dicom
The output is watermarkedLisensi bersifat sementara (Demo/NFR)Gunakan lisensi berbayar yang memberikan Converter
The widget loads but its requests answer 404AddConverterWidget() tidak dipanggil, atau basePath tidak cocok dengan cabang tempat UseDoconut() dipasangPanggil AddConverterWidget(); perbaiki basePath
open answers 403 Converting this file type requires the Dicom capability license.Unggahan DICOM, dan lisensi tidak memberikan DicomGunakan lisensi yang memberikan Dicom
open answers 413 File is too large.Unggahan melebihi MaxUploadMbNaikkan MaxUploadMb di AddConverterWidget; maxUploadMb widget hanya pemeriksaan sisi klien
run answers 400 That target format is not available for this file.Target bukan salah satu allowedTargets sumberTawarkan hanya allowedTargets dari open
run or download answers 404 (Upload expired — please re-open the file. from run)Jendela 30 menit telah berlalu, atau node web-farm tidak memiliki unggahanBuka file lagi; dalam farm, daftarkan AddDoconutDistributedWidgets
The widget fails when the UI is on another originEndpoint tidak mendukung CORSLayani UI dari asal yang sama, atau reverse-proxy jalur Doconut
The theme does not applyVariabel diatur pada elemen induk atau pada elemen di dalam mount; aturan .dcw milik widget menetapkannya pada mountTargetkan mount itu sendiri: #doconut-convert.dcw atau #doconut-convert

Catatan Kerangka

  • viewer.Converter.GetConverter() tidak ada di sini. Konversi tidak lagi dicapai melalui instance viewer: sisipkan Doconut.DocumentConverter sebagai gantinya.
  • Enum ConversionTarget ini mencakup setiap keluarga sumber. Perpustakaan sebelumnya memiliki tipe *ConfigConverter per‑keluarga — WordConfigConverter, ExcelConfigConverter, dan seterusnya — masing‑masing dengan enum EnTargetFormat yang bersarang, plus enum SourceFormatConverter untuk input. Semua itu sudah tidak ada; lihat panduan migrasi.
  • Hanya Windows, seperti sisanya pada paket .NET Standard.

Apakah halaman ini membantu?