Plugin Konverter
Ubah dokumen menjadi 45 format target
Plugin Converter 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 tulis sendiri.
| Permukaan | Gunakan ketika |
|---|---|
DocumentConverter (C#) | Anda mengonversi di server, tanpa melibatkan peramban |
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 stabil terbaru:
dotnet add package Doconut.NET6.ConverterUntuk mengunci plugin ke rilis yang dijelaskan dalam dokumentasi ini, berikan versi secara terpisah:
dotnet add package Doconut.NET6.Converter --version 26.10.0Pertahankan paket Converter pada versi yang sama dengan Doconut.NET6. ID paketnya adalah
Doconut.NET6.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; ia dibaca bersama dengan lisensi penampil.
Platform. Plugin berjalan di mana pun Doconut.NET6 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, didaftarkan dengan cara yang sama: panggil AddPlugin<TPlugin>() di dalam AddDoconut(). ConverterPlugin dikirim dalam paket NuGet-nya sendiri, Doconut.NET6.Converter, dipasang bersamaan dengan paket penampil dasar.
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 itu, AddDoconut() melemparkan 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 melemparkan kesalahan 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 tingkatan 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 Kadaluarsa (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 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 pada 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 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 bersifat 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 menyimpan 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 hasil konversi lainnya.
Pemanggil memiliki stream yang dikembalikan dan harus membuangnya setelah menyalin atau mengembalikan isinya. Layanan DocumentConverter 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 yang sebenarnya untuk file apa pun yang baru saja diunggah, dan itulah yang harus mengendalikan 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 memerlukan AddPlugin<ConverterPlugin>(), atau AddDoconut() akan 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 disajikan (itu adalah sumber daya statis yang disematkan secara sederhana; hanya endpoint yang diakses 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 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 menegakkan 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 | {} | Menimpa sebagian subset string bawaan bahasa Inggris widget (teks drop, tombol, pengumuman aria‑live, pesan kesalahan) |
Callback
| Callback | Dipicu ketika | Muatan |
|---|---|---|
onReady() | Widget telah merender layar idle/drop-nya | — |
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 | bidang yang sama seperti 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 buka atau jalankan 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; itu tidak pernah memutus alur widget.
Penanganan Imperatif
Doconut.convert() mengembalikan instance widget itu sendiri — simpan 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; tidak melakukan apa-apa kecuali saat ini idle
conv.destroy(); // menghapus pendengar, mengosongkan mount; instance tidak dapat digunakan setelah iniLabel
Setiap string memiliki default bahasa Inggris; labels menimpa sebagian subset dan sisanya tetap bahasa Inggris. Fragmen yang berubah pada runtime 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 tautan 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 menata temanya tanpa menyentuh bagian internalnya:
#doconut-convert.dcw {
--dcw-accent: #6b46c1;
--dcw-radius: 12px;
--dcw-font: "Inter", system-ui, sans-serif;
}Nilai 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 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, one 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 — file bytes, 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 memerlukan satu. 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 stash 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 stash 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 selama 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 | Sebuah pesan yang disanitasi — disanitasi 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 ketika 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 sama asal: versi ini tidak mendukung CORS. Layani UI Anda dan skrip widget dari origin yang sama dengan Doconut, atau reverse-proxy kedua jalur /doconut (jalur middleware dan jalur sumber daya) di bawah origin UI Anda.
Dalam produksi
- Pasang plugin di samping paket inti, pada versi yang sama:
dotnet add package Doconut.NET6.Converter. - Tambahkan file lisensi. Letakkan
Doconut.Viewer.Converter.licdi folder yang sama denganDoconut.Viewer.lic. - Atur batas server.
MaxUploadMbdiAddConverterWidgetadalah batas yang ditegakkan server;maxUploadMbwidget hanya pemeriksaan sisi klien. Jaga keduanya tetap sama. - Layani UI dari asal yang sama sebagai endpoint Doconut, atau reverse-proxy mereka (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 sticky, 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-apa: 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 mengkodekannya secara keras. Registrasi melemparkanArgumentExceptionketikaRootPathtidak ada atauFarmKeylebih pendek dari 32 byte.- Arahkan
RootPathke lokasi bersama yang sama yang digunakan oleh penampil terdistribusi.
Referensi API
Fasad 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 dari dependency injection; konstruktor bersifat internal. sourceExtension mencakup titik di depan. HtmlToWordAsync menulis file .doc ketika outputFormat adalah ConversionTarget.Doc, dan file .docx untuk nilai lain apa pun.
ConversionTarget
45 format output yang tercantum dalam Format target.
ConverterWidgetOptions
public sealed class ConverterWidgetOptions
{
public int MaxUploadMb { get; set; } = 25;
}Ditetapkan melalui DoconutOptions.AddConverterWidget(Action<ConverterWidgetOptions>? configure = null), yang mengembalikan DoconutOptions sehingga pemanggilan dapat dirantai.
Pemecahan Masalah
| Gejala | Penyebab | Perbaikan |
|---|---|---|
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 | Gunakan ".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 memiliki dukungan 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?