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.
| Permukaan | 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 |
Pasang paket
Pasang plugin Konverter stabil terbaru:
dotnet add package Doconut.NETStandard.ConverterUntuk mengunci plugin ke rilis yang dijelaskan dalam dokumentasi ini, berikan versi secara terpisah:
dotnet add package Doconut.NETStandard.Converter --version 26.10.0Pertahankan 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.
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:
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 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, berkas legacy TRIAL, lisensi tanpa Converter, atau lisensi berbayar di luar jendela versinya | AddDoconut() 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.
// 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 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:
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 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:
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:
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
<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
| 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 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 atau seluruh string default bahasa Inggris widget (teks drop, tombol, pengumuman aria‑live, pesan kesalahan) |
Callback
| 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 native 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 — simpan untuk mengendalikan widget secara programatik:
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 iniLabel
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'.
| 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 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:
#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.
| Rute | Tujuan | Respons sukses |
|---|---|---|
POST ?convert=open (multipart, satu file) | Mengunggah dan membuka dokumen sumber untuk pratinjau | 200 — { token, pages, sourceExt, allowedTargets } |
POST ?token=<token>&convert=run&target=<ext> | Mengonversi sumber yang disimpan ke target | 200 — { downloadToken, resultToken, resultPages, downloadName, watermarked } |
GET ?convert=download&token=<downloadToken> | Menyampaikan file yang telah dikonversi | 200 — 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:
| Rute | Status | Kapan | Isi |
|---|---|---|---|
| any | 404 | Widget tidak diaktifkan (AddConverterWidget() tidak pernah dipanggil) — diperiksa sebelum tiga rute diproses | status only |
| any | 405 | Verba HTTP salah (open/run memerlukan POST; download memerlukan GET) | status only |
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 tidak dapat dikonversi | This file type cannot be converted. |
open | 403 | Tipe file memerlukan 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 valid (bukan GUID) | Invalid token. |
run | 400 | 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 | Penyimpanan unggahan 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 valid (bukan GUID) | status only |
download | 404 | Token unduhan tidak dikenal atau kedaluwarsa | status only |
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 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
- Instal plugin di samping paket inti, dengan versi yang sama:
dotnet add package Doconut.NETStandard.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 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 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 mengkodekannya secara keras. Registrasi melemparArgumentExceptionketikaRootPathtidak ada atauFarmKeylebih pendek dari 32 byte.- Arahkan
RootPathke 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
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
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 | Perbaikan |
|---|---|---|
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 versinya | Instal lisensi yang memberikan Converter, atau hapus AddPlugin<ConverterPlugin>() |
AddDoconut() throws AddConverterWidget() was called but the Converter plugin is not registered. | Widget diaktifkan tanpa pluginnya | Tambahkan 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 terdaftar | Tambahkan AddPlugin<ConverterPlugin>() di dalam AddDoconut() |
| Stream conversion says the format is unsupported | sourceExtension tidak memiliki titik di depan | Gunakan ".xlsx", bukan "xlsx" |
ConvertAsync throws Converting '.dcm' requires the Dicom capability license. | Sumber DICOM, dan lisensi tidak memberikan Dicom | Gunakan lisensi yang memberikan Dicom |
| The output is watermarked | Lisensi bersifat sementara (Demo/NFR) | Gunakan lisensi berbayar yang memberikan Converter |
The widget loads but its requests answer 404 | AddConverterWidget() tidak dipanggil, atau basePath tidak cocok dengan cabang tempat UseDoconut() dipasang | Panggil AddConverterWidget(); perbaiki basePath |
open answers 403 Converting this file type requires the Dicom capability license. | Unggahan DICOM, dan lisensi tidak memberikan Dicom | Gunakan lisensi yang memberikan Dicom |
open answers 413 File is too large. | Unggahan melebihi MaxUploadMb | Naikkan 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 sumber | Tawarkan 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 unggahan | Buka file lagi; dalam farm, daftarkan AddDoconutDistributedWidgets |
| The widget fails when the UI is on another origin | Endpoint tidak mendukung CORS | Layani UI dari asal yang sama, atau reverse-proxy jalur Doconut |
| The theme does not apply | 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 |
Catatan Kerangka
viewer.Converter.GetConverter()tidak ada di sini. Konversi tidak lagi dicapai melalui instance viewer: sisipkanDoconut.DocumentConvertersebagai gantinya.- Enum
ConversionTargetini mencakup setiap keluarga sumber. Perpustakaan sebelumnya memiliki tipe*ConfigConverterper‑keluarga —WordConfigConverter,ExcelConfigConverter, dan seterusnya — masing‑masing dengan enumEnTargetFormatyang bersarang, plus enumSourceFormatConverteruntuk input. Semua itu sudah tidak ada; lihat panduan migrasi. - Hanya Windows, seperti sisanya pada paket .NET Standard.
Apakah halaman ini membantu?