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.
| Komponen | Gunakan 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:
dotnet add package Doconut.NET8.ConverterUntuk mengunci plugin ke rilis yang dijelaskan dalam dokumentasi ini, berikan versi secara terpisah:
dotnet add package Doconut.NET8.Converter --version 26.10.0Pertahankan 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:
apt-get update && apt-get install -y libfontconfig1Pada 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.
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:
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 lisensi | Saat startup | Output konversi |
|---|---|---|
Lisensi penampil berbayar yang memberikan Converter, dalam jendela versinya | Mulai | Bersih — watermarked: false |
| Lisensi Sementara Aktif (Demo/NFR) | Mulai | Mengonversi, dengan watermark evaluasi — watermarked: true |
| Lisensi Sementara Kedaluwarsa (Demo/NFR) | Mulai | Mengonversi, dengan watermark evaluasi — watermarked: true |
Tidak ada lisensi, file legacy TRIAL, lisensi tanpa Converter, atau lisensi berbayar di luar jendela versinya | AddDoconut() 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.
// Suntikkan DocumentConverter; konstruktornya internal, jadi jangan pernah `new` itu.
Stream pdf = await converter.ConvertAsync("contract.docx", ConversionTarget.Pdf, ct: ct);// sourceExtension mencakup titik di depannya. password bernilai null kecuali dokumen dilindungi.
Stream png = await converter.ConvertAsync(stream, ".xlsx", ConversionTarget.Png, password: null, ct: ct);Stream html = await converter.WordToHtmlAsync("report.docx", ct);// 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:
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, IcoTidak 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:
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:
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
<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
| Opsi | Tipe | Bawaan | Catatan |
|---|---|---|---|
basePath | string | /doconut | Jalur dasar untuk endpoint ?convert=; harus cocok dengan cabang ASP.NET tempat UseDoconut() sebenarnya dipasang (biasanya dikoordinasikan melalui MiddlewarePath) |
resPath | string | /doconut-res | Diterima untuk konsistensi konfigurasi dengan widget Doconut lainnya; widget konverter saat ini tidak membangun URL apa pun darinya |
maxUploadMb | number | 25 | Hanya pemeriksaan pra-sisi klien — menolak file yang terlalu besar sebelum diunggah. Server menerapkan batasnya sendiri secara independen dan menjawab 413 jika terlampaui |
licenseUrl | string | null | null | Jika diatur, mengubah pemberitahuan watermark pada layar hasil menjadi tautan ke URL ini |
labels | object | {} | Mengesampingkan sebagian subset string bawaan bahasa Inggris widget (teks drop, tombol, pengumuman aria‑live, pesan kesalahan) |
Panggilan balik
| Callback | Terjadi ketika | Muatan |
|---|---|---|
onReady() | Widget telah merender layar idle/drop | — |
onSourceLoaded({ token, pages, sourceExt, allowedTargets }) | ?convert=open berhasil | token sesi sumber, jumlah halaman, ekstensi sumber (tanpa titik di depan), daftar target yang diizinkan |
onConverted({ downloadToken, resultToken, resultPages, downloadName, watermarked, target }) | ?convert=run berhasil | field yang sama dengan respons run, plus target yang diminta |
onDownload({ downloadName, downloadToken }) | Pengguna mengklik tautan Unduh | dipicu bersamaan dengan unduhan asli browser — tidak menyela atau menggantinya |
onError({ phase, message }) | Permintaan open atau run gagal | phase 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:
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 iniLabel
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'.
| Kunci | Default bahasa Inggris |
|---|---|
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. |
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:
#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.
| Rute | Tujuan | Respons sukses |
|---|---|---|
POST ?convert=open (multipart, satu file) | Unggah dan buka dokumen sumber untuk pratinjau | 200 — { token, pages, sourceExt, allowedTargets } |
POST ?token=<token>&convert=run&target=<ext> | Konversi sumber yang disimpan ke target | 200 — { downloadToken, resultToken, resultPages, downloadName, watermarked } |
GET ?convert=download&token=<downloadToken> | Alirkan file yang telah dikonversi | 200 — 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:
| Rute | Status | Kapan | Badan |
|---|---|---|---|
| apa saja | 404 | Widget tidak diaktifkan (AddConverterWidget() tidak pernah dipanggil) — diperiksa sebelum salah satu dari tiga rute diproses | hanya status |
| apa saja | 405 | Verba HTTP salah (open/run memerlukan POST; download memerlukan GET) | hanya status |
open | 400 | Bukan unggahan multipart | Expected a multipart file upload. |
open | 400 | Tidak ada file, atau file kosong | No file uploaded. |
open | 400 | Ekstensi sumber yang tidak dapat dikonversi | This file type cannot be converted. |
open | 403 | Tipe file membutuhkan kemampuan yang tidak diberikan lisensi (file DICOM tanpa Dicom) | Converting this file type requires the Dicom capability license. |
open | 413 | File yang diunggah melebihi MaxUploadMb, diperiksa terhadap Content-Length dan saat unggahan dibaca | File is too large. |
run | 400 | Token tidak terbentuk dengan benar (bukan GUID) | Invalid token. |
run | 400 | Sebuah target yang tidak dapat diurai menjadi ConversionTarget | Unknown target format. |
run | 400 | target tidak ada dalam allowedTargets sumber | That target format is not available for this file. |
run | 404 | Unggahan yang disimpan telah kedaluwarsa atau token tidak pernah dibuka | Upload expired — please re-open the file. |
open, run | 500 | Pemrosesan gagal secara internal | Pesan yang disaring — disaring dengan cara yang sama seperti setiap jalur kesalahan Doconut lainnya; tidak pernah mengungkap detail internal |
download | 400 | Token tidak terbentuk dengan benar (bukan GUID) | hanya status |
download | 404 | Token unduhan tidak dikenal atau kedaluwarsa | hanya status |
Sebuah perjalanan lengkap dengan fetch:
// 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
- Pasang plugin di samping paket inti, dengan versi yang sama:
dotnet add package Doconut.NET8.Converter. - Tambahkan file lisensi. Letakkan
Doconut.Viewer.Converter.licdi folder yang sama denganDoconut.Viewer.lic. - Atur batas server.
MaxUploadMbdiAddConverterWidgetadalah batas yang diterapkan server;maxUploadMbwidget hanya pemeriksaan sisi klien. Jaga keduanya tetap sama. - Layani UI dari asal yang sama dengan endpoint Doconut, atau lakukan reverse-proxy (lihat Bangun frontend Anda sendiri).
- Buang hasil konversi. Stream yang dikembalikan oleh
ConvertAsyncdipool; 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():
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
Ttlsetelah ditulis; membacanya tidak memperpanjang jendela tersebut. FarmKeyharus setidaknya 32 byte dan sama pada setiap node. Muat dari penyimpanan rahasia; jangan pernah menuliskannya secara keras. Pendaftaran melemparArgumentExceptionketikaRootPathtidak ada atauFarmKeylebih pendek dari 32 byte.- Arahkan
RootPathke 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
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
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
| Gejala | Penyebab | Solusi |
|---|---|---|
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 versinya | Pasang lisensi yang memberikan Converter, atau hapus AddPlugin<ConverterPlugin>() |
AddDoconut() melempar AddConverterWidget() was called but the Converter plugin is not registered. | Widget diaktifkan tanpa plugin-nya | Tambahkan 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 terdaftar | Tambahkan AddPlugin<ConverterPlugin>() di dalam AddDoconut() |
| Konversi stream mengatakan format tidak didukung | sourceExtension tidak memiliki titik di depan | Berikan ".xlsx", bukan "xlsx" |
ConvertAsync melempar Converting '.dcm' requires the Dicom capability license. | Sumber DICOM, dan lisensi tidak memberikan Dicom | Gunakan lisensi yang memberikan Dicom |
| Output berwatermark | Lisensi bersifat sementara (Demo/NFR) | Gunakan lisensi berbayar yang memberikan Converter |
Widget dimuat tetapi permintaannya menjawab 404 | AddConverterWidget() tidak dipanggil, atau basePath tidak cocok dengan cabang tempat UseDoconut() dipasang | Panggil AddConverterWidget(); perbaiki basePath |
open menjawab 403 Converting this file type requires the Dicom capability license. | Unggahan DICOM, dan lisensi tidak memberikan Dicom | Gunakan lisensi yang memberikan Dicom |
open menjawab 413 File is too large. | Unggahan melebihi MaxUploadMb | Naikkan 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 sumber | Tawarkan 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 unggahan | Buka file lagi; di farm, daftarkan AddDoconutDistributedWidgets |
| Widget gagal ketika UI berada pada asal lain | Endpoint tidak mendukung CORS | Layani UI dari asal yang sama, atau reverse-proxy jalur Doconut |
| Tema tidak diterapkan | Variabel diatur pada elemen induk atau pada elemen di dalam mount; aturan .dcw milik widget menetapkannya pada mount | Targetkan mount itu sendiri: #doconut-convert.dcw atau #doconut-convert |
Apakah halaman ini membantu?