Plugin Konverter

Konversi dokumen ke 45 format target

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

KomponenGunakan 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

Instal paket

Instal plugin Converter terbaru yang stabil:

bash
dotnet add package Doconut.NET8.Converter

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

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

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

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

Platform. Plugin berjalan di mana pun Doconut.NET8 berjalan: Windows, dan Linux berbasis glibc pada x64 (bukan Alpine atau distribusi berbasis musl lainnya). Di Linux, instal pustaka konfigurasi font sebelum dokumen pertama dibuka:

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

Pada RHEL, Fedora, dan distribusi serupa paketnya adalah fontconfig. Tanpa itu, membuka dokumen gagal dengan The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation.

Daftarkan plugin

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

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

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

Plugin memerlukan lisensi yang memberikan kemampuan Converter. Tanpa lisensi, AddDoconut() melempar 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 melempar karena tidak ada lisensi, file legacy TRIAL, lisensi tanpa Converter, dan lisensi berbayar yang digunakan di luar jendela versinya. Lisensi Demo/NFR sementara diterima. Tidak ada tingkat 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, file legacy TRIAL, lisensi tanpa Converter, atau lisensi berbayar di luar jendela versinyaAddDoconut() melempar—

Kedua jalur pemanggilan menghitung flag dari aturan yang sama: antarmuka C# DocumentConverter menurunkannya secara internal dari IsViewerLicensed dan status 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 melempar LicenseException (Converting '.dcm' requires the Dicom capability license.) dan jawaban open widget adalah 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 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 berisi 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 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 menghardcode enum ini sebagai daftar target UI Anda: ?convert=open mengembalikan allowedTargets aktual untuk file apa pun yang baru saja diunggah, dan itulah yang harus menjadi penggerak 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:

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 dilayani apa pun (itu adalah sumber daya statis yang disematkan biasa; hanya endpoint yang diaksesnya yang dibatasi).

Sematkan

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) menerima sebuah 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 menerapkan batasnya sendiri secara independen dan menjawab 413 jika terlampaui
licenseUrlstring | nullnullJika diatur, mengubah pemberitahuan watermark pada layar hasil menjadi tautan ke URL ini
labelsobject{}Mengesampingkan sebagian subset string bawaan bahasa Inggris widget (teks drop, tombol, pengumuman aria‑live, pesan kesalahan)

Panggilan balik

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 asli 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 — simpanlah untuk mengendalikan widget secara programatik:

javascript
const conv = Doconut.convert('#doconut-convert', { basePath: '/doconut' });
const file = document.querySelector('#picker').files[0]; // 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; no-op kecuali saat ini idle
conv.destroy();       // menghapus listener, mengosongkan mount; instance tidak dapat digunakan lagi setelah ini

Label

Setiap string memiliki default bahasa Inggris; labels menggantikan sebagian subset dan sisanya tetap bahasa Inggris. Fragmen yang berubah pada waktu berjalan 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 pratinjau alt (previewAlt, resultAlt), bentuk tertaut 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 dituliskan 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‑nya dari properti khusus CSS, sehingga Anda dapat menata temanya tanpa menyentuh bagian internalnya:

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

Default: --dcw-accent: #2b6cb0, --dcw-bg: #ffffff, --dcw-fg: #1a202c, --dcw-muted: #718096, --dcw-border: #cbd5e0, --dcw-radius: 8px, dan sebuah 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 pengalaman pengguna (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 bila tabel menyatakan "hanya status". Nilai ?convert= yang tidak dikenal menjawab 400.

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

sourceExt dalam respons open tidak memiliki titik di depan (misalnya "docx") — konvensi yang berlawanan dengan parameter sourceExtension pada DocumentConverter.ConvertAsync, yang memerlukan satu. allowedTargets mencantumkan nama target huruf kecil ("pdf", "html", …); berikan salah satunya 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 konversi berada di dalam 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 valid, dan mereset widget browser tidak memperpanjang salah satu jendela.

Mode kegagalan, dikelompokkan berdasarkan rute:

RuteStatusKapanBadan
apa saja404Widget tidak diaktifkan (AddConverterWidget() tidak pernah dipanggil) — diperiksa sebelum salah satu dari tiga rute diproseshanya status
apa saja405Verba HTTP salah (open/run memerlukan POST; download memerlukan GET)hanya status
open400Bukan unggahan multipartExpected a multipart file upload.
open400Tidak ada file, atau file kosongNo file uploaded.
open400Ekstensi sumber yang tidak dapat dikonversiThis file type cannot be converted.
open403Tipe file membutuhkan 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 terbentuk dengan benar (bukan GUID)Invalid token.
run400Sebuah target yang tidak dapat diurai menjadi ConversionTargetUnknown target format.
run400target tidak ada dalam allowedTargets sumberThat target format is not available for this file.
run404Unggahan yang disimpan 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 terbentuk dengan benar (bukan GUID)hanya status
download404Token unduhan tidak dikenal atau kedaluwarsahanya status

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 biasa yang dapat diikuti browser
  window.location.href = base + '?convert=download&token=' + encodeURIComponent(converted.downloadToken);
}

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

Dalam produksi

  1. Pasang plugin di samping paket inti, dengan versi yang sama: dotnet add package Doconut.NET8.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 lakukan reverse-proxy (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 menuliskannya secara keras. Pendaftaran melempar ArgumentException ketika RootPath tidak ada atau FarmKey lebih pendek dari 32 byte.
  • Arahkan RootPath ke lokasi bersama yang sama yang digunakan oleh viewer 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 dalam 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

GejalaPenyebabSolusi
AddDoconut() melempar 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 versinyaPasang lisensi yang memberikan Converter, atau hapus AddPlugin<ConverterPlugin>()
AddDoconut() melempar AddConverterWidget() was called but the Converter plugin is not registered.Widget diaktifkan tanpa plugin-nyaTambahkan options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>()
Menyelesaikan DocumentConverter melempar No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>().ConverterPlugin tidak terdaftarTambahkan AddPlugin<ConverterPlugin>() di dalam AddDoconut()
Konversi stream mengatakan format tidak didukungsourceExtension tidak memiliki titik di depanBerikan ".xlsx", bukan "xlsx"
ConvertAsync melempar Converting '.dcm' requires the Dicom capability license.Sumber DICOM, dan lisensi tidak memberikan DicomGunakan lisensi yang memberikan Dicom
Output berwatermarkLisensi bersifat sementara (Demo/NFR)Gunakan lisensi berbayar yang memberikan Converter
Widget dimuat tetapi permintaannya menjawab 404AddConverterWidget() tidak dipanggil, atau basePath tidak cocok dengan cabang tempat UseDoconut() dipasangPanggil AddConverterWidget(); perbaiki basePath
open menjawab 403 Converting this file type requires the Dicom capability license.Unggahan DICOM, dan lisensi tidak memberikan DicomGunakan lisensi yang memberikan Dicom
open menjawab 413 File is too large.Unggahan melebihi MaxUploadMbNaikkan MaxUploadMb di AddConverterWidget; maxUploadMb widget hanya pemeriksaan sisi klien
run menjawab 400 That target format is not available for this file.Target bukan salah satu allowedTargets sumberTawarkan hanya allowedTargets dari open
run atau download menjawab 404 (Upload expired — please re-open the file. dari run)Jendela 30 menit telah berlalu, atau node web-farm tidak memiliki unggahanBuka file lagi; di farm, daftarkan AddDoconutDistributedWidgets
Widget gagal ketika UI berada pada asal lainEndpoint tidak mendukung CORSLayani UI dari asal yang sama, atau reverse-proxy jalur Doconut
Tema tidak diterapkanVariabel 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

Apakah halaman ini membantu?