Dönüştürücü Eklentisi
Belgeleri 45 hedef formata dönüştürün
Dönüştürücü eklentisi, Doconut'u bir belge-dönüştürme hizmetine dönüştürür. Genel DocumentConverter arayüzünün arkasındaki motoru sağlar ve — opt-in — kendi HTTP sözleşmesine sahip bir drop-in widget sunar, böylece belgeleri C#'tan, widget'tan veya kendinizin yazdığı bir ön uçtan dönüştürebilirsiniz.
| Yüzey | Ne zaman kullanılır |
|---|---|
DocumentConverter (C#) | Sunucuda, tarayıcı kullanılmadan dönüştürürsünüz |
Drop-in widget (doconutConverter.js) | Sayfanızda hazır bir yükleme, dönüştürme ve indirme ekranı istiyorsunuz |
HTTP endpoints (?convert=open|run|download) | Belgelendirilmiş bir sunucu sözleşmesine karşı kendi dönüştürme UI'nizi oluşturursunuz |
Paketi kurun
En son kararlı Dönüştürücü eklentisini kurun:
dotnet add package Doconut.NET8.ConverterBu belgenin açıkladığı sürüme eklentiyi sabitlemek için, sürümü ayrı olarak geçin:
dotnet add package Doconut.NET8.Converter --version 26.10.0Doconut.NET8 ile aynı sürümde Dönüştürücü paketini tutun. Paket kimliği Doconut.NET8.Converter; .<version> yalnızca indirilen .nupkg dosya adında görünür.
Eklentinin lisans dosyası Doconut.Viewer.Converter.lic, Doconut.Viewer.lic ile aynı klasöre konur; bu dosya görüntüleyici lisansı ile birlikte okunur.
Platformlar. Eklenti, Doconut.NET8 çalıştığı her yerde çalışır: Windows ve x64 üzerindeki glibc tabanlı Linux (Alpine veya diğer musl tabanlı dağıtımlar değil). Linux'ta, ilk belge açılmadan önce font yapılandırma kütüphanesini kurun:
apt-get update && apt-get install -y libfontconfig1RHEL, Fedora ve benzeri dağıtımlarda paket fontconfig'dir. Olmadan, bir belge açma The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation. hatasıyla başarısız olur.
Eklentiyi kaydedin
AddConverter() yöntemi yoktur — Doconut'un eklenti modeli tekdüzeldir. Her eklenti, Dönüştürücü dahil, aynı şekilde kaydedilir: AddDoconut() içinde AddPlugin<TPlugin>() çağırın. ConverterPlugin kendi NuGet paketinde, Doconut.NET8.Converter, temel görüntüleyici paketinin yanında kurulur.
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
});Bu, C# arayüzünün ihtiyaç duyduğu her şeydir. Widget ve HTTP uç noktaları ayrı bir isteğe bağlı, AddConverterWidget(), (bkz. Drop-in widget).
Eklenti, Converter yeteneğini veren bir lisansa ihtiyaç duyar. Olmadan, AddDoconut(), uygulama bir istek hizmet etmeden önce başlangıçta bir InvalidOperationException fırlatır:
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.Lisansa sahip olmama, eski bir TRIAL dosyası, Converter içermeyen bir lisans ve sürüm penceresinin dışındaki ücretli bir lisans için fırlatır. Geçici Demo/NFR lisansları kabul edilir. Sessiz bir ücretsiz katman yoktur. Lisansların nasıl yüklendiği için Lisans Kurulumu bölümüne bakın.
Lisanslama & filigran
| Lisans durumu | Başlangıç | Dönüştürme çıktısı |
|---|---|---|
Ücretli görüntüleyici lisansı Converter verir, sürüm penceresi içinde | Başlar | Temiz — watermarked: false |
| Etkin Geçici (Demo/NFR) lisans | Başlar | Dönüştürür, değerlendirme filigranı — watermarked: true |
| Süresi dolmuş Geçici (Demo/NFR) lisans | Başlar | Dönüştürür, değerlendirme filigranı — watermarked: true |
Lisans yok, eski bir TRIAL dosyası, Converter içermeyen bir lisans veya sürüm penceresinin dışındaki ücretli bir lisans | AddDoconut() fırlatır | — |
Her iki çağrı yolu da aynı kuraldan bayrağı hesaplar: DocumentConverter C# arayüzü, lisansın IsViewerLicensed ve IsTemporary durumundan dahili olarak türetir, ve widget'ın ?convert=run işleyicisi eşdeğer kontrolü (IsViewerLicensed && !IsTrial && !IsTemporary) yaparak döndürdüğü watermarked alanını doldurur. Bir entegrasyon, satın almadan önce değerlendirme lisansı ile uçtan uca oluşturulup test edilebilir — yalnızca çıktı baytları değişir.
Bir DICOM kaynağı (.dcm, .ima) ayrıca Dicom yeteneğine ihtiyaç duyar. Olmadan, ConvertAsync bir LicenseException (Converting '.dcm' requires the Dicom capability license.) fırlatır ve widget'ın open yanıtı 403.
C#'dan Kullanım
Her dönüşüm, 0 konumunda konumlandırılmış, hemen okuma veya kopyalama için hazır bir arama yapılabilir MemoryStream döndürür. DocumentConverter'yi ihtiyacınız olan her yerde DI'dan çözün — tasarım gereği durum bilgisizdir, bu yüzden tek bir örnek istekler arasında yeniden kullanılabilir.
// DocumentConverter'ı enjekte edin; yapıcı içsel olduğundan, asla `new` yapmayın.
Stream pdf = await converter.ConvertAsync("contract.docx", ConversionTarget.Pdf, ct: ct);// sourceExtension, baştaki noktayı içerir. belge korunmuyorsa password null olur.
Stream png = await converter.ConvertAsync(stream, ".xlsx", ConversionTarget.Png, password: null, ct: ct);Stream html = await converter.WordToHtmlAsync("report.docx", ct);// html: Word belgesine geri dönüştürülecek HTML'i tutan bir Stream, örneğin WordToHtmlAsync sonucunda elde edilen.
Stream docx = await converter.HtmlToWordAsync(html, ConversionTarget.Docx, ct);Yanlış anlaşılması kolay iki detay: akış aşırı yüklemesindeki sourceExtension, baştaki noktayı (".xlsx", "xlsx" değil) içermelidir — dönüştürücü bunu format kataloğuna karşı kontrol eder ve yalnız bir uzantı çözülemez. Ve adının aksine, WordToHtmlAsync Task<Stream> döndürür, Task<string> değil — HTML belgesini (görseller Base64 olarak gömülmüş) bir akış olarak alırsınız, diğer tüm dönüşüm sonuçları gibi.
Çağıran, döndürülen akışın sahibidir ve içeriği kopyaladıktan veya döndürdükten sonra serbest bırakmalıdır. DocumentConverter hizmeti ise bağımlılık enjeksiyonundan çözülür; elle oluşturmayın veya serbest bırakmayın.
Hedef formatlar
ConversionTarget (namespace Doconut.Configs.Conversion) 45 üyeye sahiptir:
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, IcoHer kaynak her hedefe dönüştürülmez — eklenti, her kaynağın format ailesini (Word, Excel, PowerPoint, PDF, CAD, Image, Email, Diagram, Project/Task, PSD, web document, DICOM) kendi sabit izin verilen hedef kümesine eşler. Bir DICOM kaynağını (.dcm, .ima) dönüştürmek ayrıca Dicom yeteneğini veren bir lisans gerektirir; hedefleri Pdf, Png, Jpeg, Bmp, Tiff ve Gif'dır. Bu enum'ı UI'nizin hedef listesi olarak sabit kodlamayın: ?convert=open, yeni yüklenen dosya için gerçek allowedTargets'ı döndürür ve bu, seçim aracını yönlendirmelidir.
Yerleştirilebilir widget
Uç noktaları etkinleştir
Widget'ın ?convert=open|run|download uç noktaları isteğe bağlıdır ve kutudan çıktığında devre dışıdır — varsayılan olarak güvenlidir. Sunucu tarafında, eklenti kaydıyla birlikte etkinleştirin:
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
options.AddConverterWidget(widget =>
{
widget.MaxUploadMb = 25;
});
});AddConverterWidget() argümansız olarak widget'ı varsayılanlarla etkinleştirir (MaxUploadMb = 25). Tek başına dönüşüm hakları vermez: AddPlugin<ConverterPlugin>() gerekir, aksi takdirde AddDoconut() hata verir:
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.AddConverterWidget() olmadan, üç ?convert= uç nokta 404 yanıt verir — ancak JS dosyası yine de sunulur (bu, basit gömülü statik bir kaynaktır; yalnızca iletişim kurduğu uç noktalar kısıtlanmıştır).
Göm
<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) bir CSS seçicisi ya da bir element alır, bağlama bulunamazsa hata fırlatır ve bir tutamaç döndürür. Widget bir dosya yükler, sayfa 1'in önizlemesini gösterir, kullanıcıya allowedTargets'den birini seçme imkanı verir, dönüştürür, mümkün olduğunda sonucu önizler ve indirme seçeneği sunar.
Seçenekler
| Seçenek | Tür | Varsayılan | Notlar |
|---|---|---|---|
basePath | string | /doconut | ?convert= uç noktaları için temel yol; UseDoconut()'in gerçekte bağlandığı ASP.NET dalıyla eşleşmelidir (genellikle MiddlewarePath aracılığıyla koordine edilir) |
resPath | string | /doconut-res | Diğer Doconut widget'larıyla yapılandırma tutarlılığı için kabul edilir; dönüştürücü widget şu anda ondan herhangi bir URL oluşturmaz |
maxUploadMb | number | 25 | Yalnızca istemci tarafı ön kontrol — yüklemeden önce aşırı büyük bir dosyayı reddeder. Sunucu kendi sınırını bağımsız olarak uygular ve aşılırsa 413 yanıtını verir |
licenseUrl | string | null | null | Ayarlandığında, sonuç ekranındaki filigran bildirimini bu URL'ye bir bağlantı haline getirir |
labels | object | {} | Widget'ın İngilizce varsayılan dizelerinin (bırakma metni, düğmeler, aria-live duyuruları, hata mesajları) herhangi bir alt kümesini geçersiz kılar |
Geri Çağrılar
| Geri Çağrı | Ne zaman tetiklenir | Yük |
|---|---|---|
onReady() | Widget boş/ bırakma ekranını render ettiğinde | — |
onSourceLoaded({ token, pages, sourceExt, allowedTargets }) | ?convert=open başarılı olduğunda | kaynak oturum belirteci, sayfa sayısı, kaynak uzantısı (başında nokta olmadan), izin verilen hedef listesi |
onConverted({ downloadToken, resultToken, resultPages, downloadName, watermarked, target }) | ?convert=run başarılı olduğunda | çalıştırma yanıtındaki aynı alanlar, ayrıca istenen target |
onDownload({ downloadName, downloadToken }) | Kullanıcı İndir bağlantısına tıkladığında | tarayıcının yerel indirmesiyle birlikte tetiklenir — engellemez veya değiştirmez |
onError({ phase, message }) | Açma veya çalıştırma isteği başarısız olduğunda | phase, 'open' veya 'run''dır; message, temizlenmiş sunucu hatasıdır (veya yük‑boyutu ön‑kontrolü için istemci tarafı mesajı) |
Atılan bir geri çağrı yakalanır ve kaydedilir; widget akışını asla bozmaz.
Zorunlu tutamak
Doconut.convert(), widget örneğini kendisini döndürür — programlı olarak widget'ı kontrol etmek için tutun:
const conv = Doconut.convert('#doconut-convert', { basePath: '/doconut' });
const file = document.querySelector('#picker').files[0]; // kendi dosyanızdan bir File <input type="file" id="picker">
conv.reset(); // idle/drop ekranına geri dön; onReady yeniden tetiklenmez
conv.loadFile(file); // akışı bir File nesnesiyle başlatır; no-op yalnızca şu anda idle ise
conv.destroy(); // dinleyicileri kaldırır, mount'ı boşaltır; bu işlemden sonra örnek kullanılamazEtiketler
Her dize bir İngilizce varsayılanına sahiptir; labels herhangi bir alt kümeyi geçersiz kılar ve geri kalanlar İngilizce kalır. Çalışma zamanında değişen parçalar {placeholders} kullanır, örneğin uploading: 'Uploading {name}…' ve pages: '{n} pages'.
| Anahtar | İngilizce varsayılan |
|---|---|
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. |
Diğer anahtarlar, bırakma bölgesinin aria-label (dropAriaLabel), ön izleme alt metinlerini (previewAlt, resultAlt), licenseUrl ile kullanılan filigran bildiriminin bağlantılı biçimini (watermarkNoticePrefix, watermarkNoticeLink, watermarkNoticeSuffix), okunamayan bir yanıtı (badResponse) ve aria-live duyurularını (annReady, annUploading, annLoaded, annLoadedNoTargets, annConverting, annDone, annError) kapsar.
Sunucudan gelen bir JSON hatası, sunucunun yazdığı şekilde gösterilir; serverError yalnızca başarısız bir yanıt JSON hatası içermediğinde, örneğin devre dışı bırakılmış bir widget'ın 404'ı gibi, kullanılır.
Tema Oluşturma
Widget, mount öğesine dcw sınıfını ekler ve renklerini, yarıçapını ve yazı tipini CSS özel özelliklerinden okur, böylece iç yapısına dokunmadan temalandırabilirsiniz:
#doconut-convert.dcw {
--dcw-accent: #6b46c1;
--dcw-radius: 12px;
--dcw-font: "Inter", system-ui, sans-serif;
}Varsayılanlar: --dcw-accent: #2b6cb0, --dcw-bg: #ffffff, --dcw-fg: #1a202c, --dcw-muted: #718096, --dcw-border: #cbd5e0, --dcw-radius: 8px ve --dcw-font için bir sistem UI yazı tipi.
Kendi ön ucunuzu oluşturun
Widget, bu HTTP sözleşmesi için yalnızca bir istemcidir — farklı bir kullanıcı deneyimi için doğrudan ona karşı kendi ön ucunuzu oluşturun. Üç rota da UseDoconut()'nin monte edildiği ASP.NET dalı altında bulunur (genellikle /doconut), ve AddConverterWidget() çağrılana kadar 404 yanıt verirler. Hatalar bir JSON gövdesi taşır, { "error": "..." }, tablo "yalnızca durum" dediği yerler hariç. Bilinmeyen bir ?convert= değeri 400 yanıt verir.
| Rota | Amaç | Başarılı yanıt |
|---|---|---|
POST ?convert=open (multipart, one file) | Bir kaynak belgeyi ön izleme için yükleyin ve açın | 200 — { token, pages, sourceExt, allowedTargets } |
POST ?token=<token>&convert=run&target=<ext> | Saklanan kaynağı target'a dönüştür | 200 — { downloadToken, resultToken, resultPages, downloadName, watermarked } |
GET ?convert=download&token=<downloadToken> | Dönüştürülmüş dosyayı akış olarak gönder | 200 — dosya baytları, Content-Disposition: attachment, Cache-Control: no-store |
sourceExt, open yanıtında başta nokta olmadan gelir (ör. "docx") — DocumentConverter.ConvertAsync üzerindeki sourceExtension parametresinin ters konvansiyonudur, bu parametre bir nokta gerektirir. allowedTargets, küçük harf hedef adlarını listeler ("pdf", "html", …); bunlardan birini target olarak geçirin, büyük/küçük harfe duyarsız eşleşir. open, multipart gövdesindeki ilk dosyayı kullanır.
resultToken, sonuç ön izlenemediğinde null'dır, ve resultPages, 0'dır. downloadName, hedefin uzantısıyla birlikte kaynak dosya adıdır.
Ön izleme görüntüleri standart görüntüleyici resim rotasını, {basePath}?token={token}&page=1&thumb=1&width={px}, kullanır; open'den gelen token veya run'den gelen resultToken ile. Widget, width=240 ister.
Yüklenen kaynak baytları sunucu tarafında saklanır ve son okunduktan 30 dakika boyunca tutulur; bu süre dolduğunda, run 404 yanıt verir ve dosya yeniden açılmalıdır. Dönüştürülmüş sonuç aynı saklamada bulunur — dönüşüm tamamlandığında downloadToken kendi yeni 30 dakikalık süresini alır — aynı zamanda resultToken sonuç ön izleme için normal bir görüntüleyici oturum tokenıdır. Sonuç ön izlenebildiğinde, downloadToken ve resultToken aynı değerdir. Bir görüntüleyici sonucu kapatmak geçerli bir indirme saklamasını silmez ve tarayıcı widget'ını sıfırlamak hiçbir pencereyi uzatmaz.
Başarısızlık modları, rotaya göre gruplanmıştır:
| Rota | Durum | Ne Zaman | Gövde |
|---|---|---|---|
| herhangi | 404 | Widget etkinleştirilmemiş (AddConverterWidget() hiç çağrılmadı) — üç rotadan herhangi biri yönlendirilmeden önce kontrol edilir | yalnızca durum |
| herhangi | 405 | Yanlış HTTP fiili (open/run POST gerektirir; download GET gerektirir) | yalnızca durum |
open | 400 | Multipart olmayan yükleme | Expected a multipart file upload. |
open | 400 | Dosya yok veya boş | No file uploaded. |
open | 400 | Dönüştürülemeyen bir kaynak uzantısı | This file type cannot be converted. |
open | 403 | Dosya türü, lisansın vermediği bir yetenek gerektiriyor (Dicom içermeyen bir DICOM dosyası) | Converting this file type requires the Dicom capability license. |
open | 413 | Yüklenen dosya MaxUploadMb'ı aşıyor, Content-Length'a karşı kontrol edilir ve yükleme okunurken | File is too large. |
run | 400 | Geçersiz token (GUID değil) | Invalid token. |
run | 400 | Bir target, bir ConversionTarget'a ayrıştırılamıyor | Unknown target format. |
run | 400 | target, kaynağın allowedTargets içinde yok | That target format is not available for this file. |
run | 404 | Saklanan yükleme süresi dolmuş veya token hiç açılmamış | Upload expired — please re-open the file. |
open, run | 500 | İşlem dahili olarak başarısız oldu | Sanitizasyon uygulanmış bir mesaj — diğer tüm Doconut hata yolları gibi aynı şekilde sanitizasyon uygulanır; iç detayları asla ortaya çıkarmaz |
download | 400 | Geçersiz token (GUID değil) | yalnızca durum |
download | 404 | Bilinmeyen veya süresi dolmuş indirme tokenı | yalnızca durum |
Tam bir tur fetch ile:
// file: the File to convert, for example from an <input type="file">.
async function convertFile(file) {
const base = '/doconut';
// 1. open: dosyayı yükle
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: PDF'ye dönüştür, izin verildiğinde, aksi takdirde ilk izin verilen hedefe
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: tarayıcının takip edebileceği basit bir GET
window.location.href = base + '?convert=download&token=' + encodeURIComponent(converted.downloadToken);
}Uç noktalar aynı kökenli: bu sürüm CORS desteği içermez. UI'nizi ve widget betiğini Doconut ile aynı kökenden sunun, ya da her iki /doconut yolunu (middleware yolu ve kaynak yolu) UI'nizin kökeni altında ters proxy yapın.
Üretimde
- Eklentiyi kurun çekirdek paketinin yanına, aynı sürümde:
dotnet add package Doconut.NET8.Converter. - Lisans dosyasını ekleyin.
Doconut.Viewer.Converter.licdosyasınıDoconut.Viewer.licile aynı klasöre koyun. - Sunucu sınırını ayarlayın.
MaxUploadMb,AddConverterWidgetiçinde sunucunun uyguladığı sınırdır; widget'ınmaxUploadMbsadece istemci tarafı bir kontroldür. İkisini eşit tutun. - UI'yi aynı origin'den sunun Doconut uç noktalarıyla aynı origin'den, ya da ters proxy yapın (bkz. Kendi ön ucunuzu oluşturun).
- Dönüştürme sonuçlarını serbest bırakın.
ConvertAsyncakışı havuzlanmıştır; onu serbest bırakmak tamponlarını havuza geri verir.
Web çiftlikleri
Widget, her yüklemeyi ve sonucunu, open hizmet veren düğümde bellekte tutar. Yapışkan oturumları olmayan bir yük dengeleyicinin arkasında, daha sonraki bir run, download veya ön izleme isteği başka bir düğüme ulaşabilir ve yüklemeyi bulamaz. Paylaşılan, şifreli widget deposunu bir kez, AddDoconut() sonrası kaydedin:
byte[] farmKey = Convert.FromBase64String(builder.Configuration["Doconut:FarmKey"]);
builder.Services.AddDoconutDistributedWidgets(store =>
{
store.RootPath = @"\\fileshare\doconut"; // her düğümün okuyup yazabileceği bir klasör
store.FarmKey = farmKey; // en az 32 bayt, her düğümde aynı
// store.Ttl = TimeSpan.FromMinutes(30); // bir yüklemenin ne kadar süre saklandığı (varsayılan)
});- Tek bir sunucu hiçbir şeye ihtiyaç duymaz: bu çağrı olmadan bellek içi mağaza kullanılır.
- Yüklemeler ve sonuçlar paylaşılda (AES-256, encrypt-then-MAC) dinlenirken şifrelenir ve her dosya token'ına bağlanır, böylece bir token başka birinin dosyasını asla okuyamaz.
- Paylaşılda, bir yükleme veya sonuç, yazıldıktan sonra
Ttlsüreyle tutulur; okuma bu pencereyi uzatmaz. FarmKeyen az 32 bayt olmalı ve her düğümde aynı olmalıdır. Gizli bir depodan yükleyin; asla sabit kodlamayın. Kayıt,RootPatheksik olduğunda veyaFarmKey32 bayttan kısa olduğunda birArgumentExceptionfırlatır.RootPath'i dağıtılmış görüntüleyicinin kullandığı aynı paylaşılan konuma yönlendirin.
API referansı
Facade ve widget seçenekleri Doconut ad alanındadır; ConversionTarget Doconut.Configs.Conversion içinde. ConverterPlugin Doconut.Plugins.Converter içinde.
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);
}Dependency injection'dan çözülür; yapıcı içtedir. sourceExtension baştaki noktayı içerir. HtmlToWordAsync, outputFormat ConversionTarget.Doc olduğunda bir .doc dosyası yazar ve diğer tüm değerler için bir .docx dosyası yazar.
ConversionTarget
45 çıktı formatı Hedef formatlar içinde listelenmiştir.
ConverterWidgetOptions
public sealed class ConverterWidgetOptions
{
public int MaxUploadMb { get; set; } = 25;
}DoconutOptions.AddConverterWidget(Action<ConverterWidgetOptions>? configure = null) aracılığıyla ayarlayın, bu DoconutOptions döndürür, böylece çağrılar zincirlenebilir.
Sorun Giderme
| Semptom | Neden | Çözüm |
|---|---|---|
AddDoconut() fırlatır The Converter plugin is registered via AddPlugin but no active license grants Converter. | Lisans yok, bir TRIAL dosyası, Converter içermeyen bir lisans veya sürüm penceresinin dışındaki ücretli bir lisans | Converter sağlayan bir lisans kurun, ya da AddPlugin<ConverterPlugin>() kaldırın |
AddDoconut() fırlatır AddConverterWidget() was called but the Converter plugin is not registered. | Widget, eklentisi olmadan etkinleştirildi | options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>() ekleyin |
Çözümleme DocumentConverter fırlatır No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>(). | ConverterPlugin kayıtlı değil | AddDoconut() içinde AddPlugin<ConverterPlugin>() ekleyin |
| Akış dönüşümü formatın desteklenmediğini söylüyor | sourceExtension başta nokta yok | ".xlsx" geçirin, "xlsx" değil |
ConvertAsync fırlatır Converting '.dcm' requires the Dicom capability license. | Bir DICOM kaynağı ve lisans Dicom sağlamıyor | Dicom sağlayan bir lisans kullanın |
| Çıktı su işareti taşıyor | Lisans geçicidir (Demo/NFR) | Converter sağlayan ücretli bir lisans kullanın |
Widget yükleniyor ancak istekleri 404 yanıt veriyor | AddConverterWidget() çağrılmadı veya basePath, UseDoconut()'nin monte edildiği dal ile eşleşmiyor | AddConverterWidget() çağırın; basePath düzeltin |
open 403 Converting this file type requires the Dicom capability license. yanıt veriyor | Bir DICOM yüklemesi ve lisans Dicom sağlamıyor | Dicom sağlayan bir lisans kullanın |
open 413 File is too large. yanıt veriyor | Yükleme MaxUploadMb aşıyor | AddConverterWidget içinde MaxUploadMb yükseltin; widget'ın maxUploadMb sadece istemci tarafı bir kontroldür |
run 400 That target format is not available for this file. yanıt veriyor | Hedef, kaynağın allowedTargets'lerinden biri değil | open'den sadece allowedTargets sunun |
run veya download 404 yanıt veriyor (Upload expired — please re-open the file. run'den) | 30 dakikalık pencere geçti veya bir web-çiftlik düğümünde yükleme yok | Dosyayı tekrar açın; bir çiftlikte, AddDoconutDistributedWidgets kaydedin |
| UI başka bir origin'de olduğunda widget başarısız olur | Uç noktalar CORS desteği sunmuyor | UI'yi aynı origin'den sunun, ya da Doconut yollarını ters proxy yapın |
| Tema uygulanmıyor | Değişkenler bir üst öğede veya mount içinde bir öğede ayarlanmış; widget'ın kendi .dcw kuralı onları mount üzerine ayarlar | Mount'u doğrudan hedefleyin: #doconut-convert.dcw veya #doconut-convert |
Bu sayfa yardımcı oldu mu?