Plugin pro převod
Převádějte dokumenty do 45 cílových formátů
Plugin Converter promění Doconut na službu pro převod dokumentů. Přispívá k motoru stojícímu za veřejnou DocumentConverter fasádou a — opt‑in — poskytuje vložitelný widget se svým vlastním HTTP kontraktem, takže můžete převádět dokumenty z C#, z widgetu nebo z frontendu, který si vytvoříte.
| Rozhraní | Kdy použít |
|---|---|
DocumentConverter (C#) | Převádíte na serveru, bez zapojení prohlížeče |
Drop-in widget (doconutConverter.js) | Chcete připravenou obrazovku pro nahrání, převod a stažení ve své stránce |
HTTP endpoints (?convert=open|run|download) | Vytvoříte si vlastní UI převodu podle zdokumentovaného serverového kontraktu |
Instalace balíčku
Nainstalujte nejnovější stabilní plugin Converter:
dotnet add package Doconut.NET6.ConverterPro připnutí pluginu k verzi, kterou tato dokumentace popisuje, předávejte verzi samostatně:
dotnet add package Doconut.NET6.Converter --version 26.10.0Udržujte balíček Converter ve stejné verzi jako Doconut.NET6. ID balíčku je Doconut.NET6.Converter; .<version> se objevuje pouze v názvu staženého souboru .nupkg.
Licenční soubor pluginu, Doconut.Viewer.Converter.lic, umístěte do stejné složky jako Doconut.Viewer.lic; je načten spolu s licencí prohlížeče.
Platformy. Plugin běží kdekoliv běží Doconut.NET6: Windows a Linux založený na glibc na x64 (ne Alpine ani jiné distribuce založené na musl). Na Linuxu nainstalujte knihovnu pro konfiguraci fontů před otevřením prvního dokumentu:
apt-get update && apt-get install -y libfontconfig1Na distribucích RHEL, Fedora a podobných je balíček fontconfig. Bez něj selže otevření dokumentu s chybou The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation.
Registrace pluginu
Neexistuje metoda AddConverter() – model pluginů Doconut je jednotný. Každý plugin, včetně Converter, se registruje stejným způsobem: zavolejte AddPlugin<TPlugin>() uvnitř AddDoconut(). ConverterPlugin je součástí vlastního NuGet balíčku, Doconut.NET6.Converter, nainstalovaného vedle základního balíčku prohlížeče.
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
});To je vše, co potřebuje C# fasáda. Widget a jeho HTTP koncové body jsou samostatná volitelná funkce, AddConverterWidget() (viz Vložitelný widget).
Plugin potřebuje licenci, která poskytuje schopnost Converter. Bez ní AddDoconut() vyhodí InvalidOperationException při spuštění, ještě před tím, než aplikace obslouží požadavek:
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.Vyhodí chybu při chybějící licenci, starém souboru TRIAL, licenci bez Converter a placené licenci použití mimo její časové okno. Dočasné licence Demo/NFR jsou akceptovány. Neexistuje tichá bezplatná úroveň. Viz Nastavení licence pro způsob načítání licencí.
Licencování a vodoznak
| Stav licence | Spuštění | Výstup převodu |
|---|---|---|
Placená licence pro prohlížeč poskytující Converter, v rámci jejího časového okna | Spouští se | Čistý — watermarked: false |
| Aktivní dočasná (Demo/NFR) licence | Spouští se | Převádí s evaluačním vodoznakem — watermarked: true |
| Expirující dočasná (Demo/NFR) licence | Spouští se | Převádí s evaluačním vodoznakem — watermarked: true |
Žádná licence, starý soubor TRIAL, licence bez Converter, nebo placená licence mimo její časové okno | AddDoconut() vyhodí | — |
Obě cesty volání vypočítají příznak podle stejného pravidla: C# fasáda DocumentConverter jej interně odvozuje z IsViewerLicensed a stavu IsTemporary licence, a handler widgetu ?convert=run provádí ekvivalentní kontrolu (IsViewerLicensed && !IsTrial && !IsTemporary) pro vyplnění pole watermarked, které vrací. Integraci lze postavit a otestovat end-to-end na evaluační licenci před nákupem – mění se jen výstupní bajty.
Zdroj DICOM (.dcm, .ima) také vyžaduje schopnost Dicom. Bez ní ConvertAsync vyhodí LicenseException (Converting '.dcm' requires the Dicom capability license.) a widgetova open odpovídá 403.
Použití z C#
Každá konverze vrací vyhledávatelný MemoryStream umístěný na 0, připravený okamžitě číst nebo kopírovat. Získejte DocumentConverter z DI kdekoliv jej potřebujete — je navržen jako bezstavový, takže jedna instance je bezpečná pro opakované použití napříč požadavky.
// Vložte DocumentConverter; jeho konstruktor je interní, takže jej nikdy `new` nevolejte.
Stream pdf = await converter.ConvertAsync("contract.docx", ConversionTarget.Pdf, ct: ct);// sourceExtension obsahuje úvodní tečku. password je null, pokud dokument není chráněn.
Stream png = await converter.ConvertAsync(stream, ".xlsx", ConversionTarget.Png, password: null, ct: ct);Stream html = await converter.WordToHtmlAsync("report.docx", ct);// html: Stream obsahující HTML, které se má převést zpět do dokumentu Word, například výsledek WordToHtmlAsync.
Stream docx = await converter.HtmlToWordAsync(html, ConversionTarget.Docx, ct);Dva detaily, které se snadno špatně pochopí: sourceExtension u přetížení streamu musí obsahovat úvodní tečku (".xlsx", ne "xlsx") — převodník ji porovnává s katalogem formátů a samotná přípona se nevyřeší. A navzdory svému názvu, WordToHtmlAsync vrací Task<Stream>, ne Task<string> — získáte HTML dokument (obrázky vložené jako Base64) jako stream, stejně jako každý jiný výsledek konverze.
Volající vlastní vrácený stream a měl by jej uvolnit po kopírování nebo po vrácení jeho obsahu. Služba DocumentConverter je sama získávána z injekce závislostí; nevyvíjejte ji ani ji ručně neuvolňujte.
Cílové formáty
ConversionTarget (namespace Doconut.Configs.Conversion) má 45 členů:
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, IcoNe každý zdroj se převádí na každý cíl — plugin mapuje každou rodinu formátů zdroje (Word, Excel, PowerPoint, PDF, CAD, Image, Email, Diagram, Project/Task, PSD, webový dokument, DICOM) na vlastní pevně danou sadu povolených cílů. Převod DICOM zdroje (.dcm, .ima) také vyžaduje licenci, která poskytuje schopnost Dicom; jeho cíle jsou Pdf, Png, Jpeg, Bmp, Tiff a Gif. Nezakódovávejte tuto výčtovou hodnotu jako seznam cílů ve vašem UI: ?convert=open vrací skutečný allowedTargets pro jakýkoli soubor, který byl právě nahrán, a to by mělo řídit výběr.
Widget pro vložení
Povolení koncových bodů
Koncové body widgetu ?convert=open|run|download jsou volitelné a ve výchozím nastavení zakázané — zabezpečené ve výchozím nastavení. Povolte je na straně serveru, spolu s registrací pluginu:
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
options.AddConverterWidget(widget =>
{
widget.MaxUploadMb = 25;
});
});AddConverterWidget() bez argumentu povolí widget s výchozími hodnotami (MaxUploadMb = 25). Samotné nepřiděluje práva k převodu: potřebuje AddPlugin<ConverterPlugin>(), jinak AddDoconut() vyvolá výjimku:
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.Bez AddConverterWidget(), tři koncové body ?convert= vrací 404 — ale samotný JS soubor je i tak poskytován (je to prostý vložený statický zdroj; pouze koncové body, ke kterým se připojuje, jsou omezené).
Vložte jej
<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) přijímá CSS selektor nebo element, vyhodí výjimku, pokud není montáž nalezena, a vrátí handle. Widget nahrává soubor, zobrazuje náhled první stránky, umožní uživateli vybrat jeden z allowedTargets, provede převod, náhled výsledku zobrazí, pokud je to možné, a nabídne stažení.
Možnosti
| Možnost | Typ | Výchozí | Poznámky |
|---|---|---|---|
basePath | string | /doconut | Základní cesta pro koncové body ?convert=; musí odpovídat větvi ASP.NET, kde je UseDoconut() skutečně nasazeno (obvykle koordinováno přes MiddlewarePath) |
resPath | string | /doconut-res | Přijato pro konzistenci konfigurace s ostatními widgety Doconut; widget převodníku v současnosti nevyužívá žádnou URL z tohoto nastavení |
maxUploadMb | number | 25 | Pouze předběžná kontrola na straně klienta — odmítne příliš velký soubor před nahráním. Server nezávisle vynutí svůj vlastní limit a odpoví 413, pokud je překročen |
licenseUrl | string | null | null | Když je nastaveno, změní oznámení vodoznaku na výsledkové obrazovce na odkaz na tuto URL |
labels | object | {} | Přepíše libovolnou podmnožinu výchozích anglických řetězců widgetu (text pro přetažení, tlačítka, oznámení aria-live, chybové zprávy) |
Zpětné volání
| Zpětné volání | Spouští se, když | Data |
|---|---|---|
onReady() | Widget vykreslil svou nečinnou/přetahovací obrazovku | — |
onSourceLoaded({ token, pages, sourceExt, allowedTargets }) | Úspěšně proběhne ?convert=open | zdrojový token relace, počet stránek, přípona zdroje (bez úvodní tečky), seznam povolených cílů |
onConverted({ downloadToken, resultToken, resultPages, downloadName, watermarked, target }) | Úspěšně proběhne ?convert=run | stejné pole jako odpověď na spuštění, plus požadovaný target |
onDownload({ downloadName, downloadToken }) | Uživatel klikne na odkaz Stáhnout | spustí se spolu s nativním stažením prohlížeče — nezasahuje ani nenahrazuje jej |
onError({ phase, message }) | Požadavek na otevření nebo spuštění selže | phase je 'open' nebo 'run'; message je očištěná chyba serveru (nebo zpráva na straně klienta pro předběžnou kontrolu velikosti nahrávaného souboru) |
Zpětné volání, které vyhodí výjimku, je zachyceno a zaznamenáno; nikdy neporuší tok widgetu.
Imperativní ovladač
Doconut.convert() vrací samotnou instanci widgetu — uchovejte si ji pro programové ovládání widgetu:
const conv = Doconut.convert('#doconut-convert', { basePath: '/doconut' });
const file = document.querySelector('#picker').files[0]; // soubor typu File z vašeho vlastního <input type="file" id="picker">
conv.reset(); // zpět na nečinnou/odhazovací obrazovku; nespustí znovu onReady
conv.loadFile(file); // spustí tok s objektem File; žádná operace, pokud není aktuálně nečinný
conv.destroy(); // odstraní posluchače, vyprázdní mount; instance po tomto není použitelnáŠtítky
Každý řetězec má výchozí anglickou verzi; labels přepíše libovolnou podmnožinu a zbytek zůstane v angličtině. Fragmenty, které se mění za běhu, používají {placeholders}, například uploading: 'Uploading {name}…' a pages: '{n} pages'.
| Klíč | Anglický výchozí |
|---|---|
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. |
Další klíče pokrývají aria-label zóny pro přetažení (dropAriaLabel), texty náhledu alt (previewAlt, resultAlt), propojenou formu oznámení vodoznaku používanou s licenseUrl (watermarkNoticePrefix, watermarkNoticeLink, watermarkNoticeSuffix), nečitelné odpovědi (badResponse) a oznámení aria-live (annReady, annUploading, annLoaded, annLoadedNoTargets, annConverting, annDone, annError).
Chyba JSON ze serveru je zobrazena tak, jak ji server napsal; serverError se používá jen když neúspěšná odpověď neobsahuje chybu JSON, například 404 zakázaného widgetu.
Tématizace
Widget přidá třídu dcw k elementu, kde je namontován, a načte jeho barvy, poloměr a písmo z CSS vlastních vlastností, takže jej můžete tematizovat, aniž byste zasahovali do jeho vnitřní struktury:
#doconut-convert.dcw {
--dcw-accent: #6b46c1;
--dcw-radius: 12px;
--dcw-font: "Inter", system-ui, sans-serif;
}Výchozí hodnoty: --dcw-accent: #2b6cb0, --dcw-bg: #ffffff, --dcw-fg: #1a202c, --dcw-muted: #718096, --dcw-border: #cbd5e0, --dcw-radius: 8px a systémové UI písmo pro --dcw-font.
Vytvořte si vlastní frontend
Widget je jen klient pro tuto HTTP smlouvu — vytvořte si vlastní frontend, který s ní bude komunikovat přímo pro odlišný uživatelský zážitek. Všechny tři cesty jsou umístěny pod větví ASP.NET, kde je namontováno UseDoconut() (normálně /doconut) a odpovídají 404, dokud není zavoláno AddConverterWidget(). Chyby obsahují JSON tělo, { "error": "..." }, kromě případů, kdy tabulka uvádí „pouze stav“. Neznámá hodnota ?convert= odpovídá 400.
| Cesta | Účel | Úspěšná odpověď |
|---|---|---|
POST ?convert=open (multipart, jeden soubor) | Nahrát a otevřít zdrojový dokument pro náhled | 200 — { token, pages, sourceExt, allowedTargets } |
POST ?token=<token>&convert=run&target=<ext> | Převést uložený zdroj na target | 200 — { downloadToken, resultToken, resultPages, downloadName, watermarked } |
GET ?convert=download&token=<downloadToken> | Streamovat převedený soubor | 200 — bajty souboru, Content-Disposition: attachment, Cache-Control: no-store |
sourceExt v odpovědi open nemá úvodní tečku (např. "docx") — opačná konvence oproti parametru sourceExtension na DocumentConverter.ConvertAsync, který tečku vyžaduje. allowedTargets uvádí názvy cílových formátů malými písmeny ("pdf", "html", …); předávejte jeden z nich jako target, který se porovnává bez ohledu na velikost písmen. open používá první soubor v multipart těle.
resultToken je null a resultPages je 0, když výsledek nelze náhlednout. downloadName je název zdrojového souboru s příponou cíle.
Náhledové obrázky používají standardní cestu pro obrázky prohlížeče, {basePath}?token={token}&page=1&thumb=1&width={px}, s token z open nebo resultToken z run. Widget žádá o width=240.
Nahrané bajty zdroje jsou uloženy na serveru a uchovávány po dobu 30 minut od posledního čtení; po uplynutí tohoto intervalu run odpovídá 404 a soubor je nutné znovu otevřít. Převedený výsledek žije ve stejném úložišti — downloadToken získá vlastní čerstvé 30‑minutové okno po dokončení převodu — zatímco resultToken je běžný token relace prohlížeče pro náhled výsledku. Když lze výsledek náhlednout, downloadToken a resultToken mají stejnou hodnotu. Uzavření výsledku v prohlížeči neodstraňuje stále platné úložiště ke stažení a resetování widgetu v prohlížeči neprodloužuje žádné z oken.
Režimy selhání, seskupené podle cesty:
| Cesta | Stav | Kdy | Tělo |
|---|---|---|---|
| any | 404 | Widget není povolen (AddConverterWidget() nebylo nikdy zavoláno) — kontrolováno před dispatchem jakékoli z třech cest | pouze stav |
| any | 405 | Nesprávný HTTP verb (open/run vyžadují POST; download vyžaduje GET) | pouze stav |
open | 400 | Není multipart upload | Expected a multipart file upload. |
open | 400 | Žádný soubor nebo prázdný soubor | No file uploaded. |
open | 400 | Přípona zdroje, kterou nelze převést | This file type cannot be converted. |
open | 403 | Typ souboru vyžaduje schopnost, kterou licence neposkytuje (DICOM soubor bez Dicom) | Converting this file type requires the Dicom capability license. |
open | 413 | Nahraný soubor překračuje MaxUploadMb, kontrolováno proti Content-Length a během čtení uploadu | File is too large. |
run | 400 | Špatně formátovaný token (není GUID) | Invalid token. |
run | 400 | target, který se nedá parsovat na ConversionTarget | Unknown target format. |
run | 400 | target není v allowedTargets zdroje | That target format is not available for this file. |
run | 404 | Uložený upload vypršel nebo token nikdy nebyl otevřen | Upload expired — please re-open the file. |
open, run | 500 | Interní selhání zpracování | Sanitizovaná zpráva — sanitizovaná stejným způsobem jako každá jiná cesta chyby Doconut; nikdy neprozrazuje interní detaily |
download | 400 | Špatně formátovaný token (není GUID) | pouze stav |
download | 404 | Neznámý nebo vypršelý token ke stažení | pouze stav |
Kompletní round‑trip s fetch:
// file: soubor k převodu, například z <input type="file">.
async function convertFile(file) {
const base = '/doconut';
// 1. open: nahrajte soubor
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: převést do PDF, pokud je to povoleno, jinak na první povolený cíl
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: prostý GET, který může prohlížeč následovat
window.location.href = base + '?convert=download&token=' + encodeURIComponent(converted.downloadToken);
}Endpointy jsou same-origin: tato verze nepodporuje CORS. Servírujte své UI a skript widgetu ze stejného původu jako Doconut, nebo reverzní proxy oba /doconut cesty (cestu middleware a cestu zdrojů) pod původem vašeho UI.
V produkci
- Nainstalujte plugin vedle hlavního balíčku, ve stejné verzi:
dotnet add package Doconut.NET6.Converter. - Přidejte licenční soubor. Umístěte
Doconut.Viewer.Converter.licdo stejné složky jakoDoconut.Viewer.lic. - Nastavte limit serveru.
MaxUploadMbvAddConverterWidgetje limit, který server vynucuje;maxUploadMbwidgetu je pouze kontrola na straně klienta. Udržujte oba stejné. - Poskytněte UI ze stejného původu jako Doconut koncové body, nebo je reverse-proxy (viz Vytvořte si vlastní frontend).
- Uvolněte výsledky konverze. Proud, který vrací
ConvertAsync, je sdílený; jeho uvolněním se vrátí buffery do poolu.
Webové farmy
Widget uchovává každý upload a jeho výsledek v paměti na uzlu, který obsloužil open. Za load balancerem bez sticky session může pozdější run, download nebo požadavek na náhled dorazit na jiný uzel a nenajít upload. Zaregistrujte sdílené, šifrované úložiště widgetu jednou, po AddDoconut():
byte[] farmKey = Convert.FromBase64String(builder.Configuration["Doconut:FarmKey"]);
builder.Services.AddDoconutDistributedWidgets(store =>
{
store.RootPath = @"\\fileshare\doconut"; // složka, kterou může každý uzel číst a zapisovat
store.FarmKey = farmKey; // alespoň 32 bytes, identické na každém uzlu
// store.Ttl = TimeSpan.FromMinutes(30); // jak dlouho je nahrání uchováno (výchozí)
});- Jeden server nepotřebuje nic: bez tohoto volání se používá paměťové úložiště.
- Uploady a výsledky jsou šifrovány v klidu na sdíleném úložišti (AES-256, encrypt-then-MAC) a každý soubor je svázán se svým tokenem, takže jeden token nikdy nemůže číst soubor jiného.
- Na sdíleném úložišti je upload nebo výsledek uchován po dobu
Ttlpo jeho zápisu; čtení neprodlouží toto okno. FarmKeymusí mít alespoň 32 bajtů a být stejný na každém uzlu. Načtěte jej z tajného úložiště; nikdy jej nehardcodujte. Registrace vyhodíArgumentException, kdyžRootPathchybí nebo jeFarmKeykratší než 32 bajtů.- Nastavte
RootPathna stejné sdílené umístění, které používá distribuovaný prohlížeč.
Reference API
Fasáda a možnosti widgetu jsou v jmenném prostoru Doconut; ConversionTarget je v Doconut.Configs.Conversion. ConverterPlugin je v 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);
}Získáno z injekce závislostí; konstruktor je interní. sourceExtension zahrnuje úvodní tečku. HtmlToWordAsync zapíše soubor .doc, když je outputFormat ConversionTarget.Doc, a soubor .docx pro jakoukoli jinou hodnotu.
ConversionTarget
45 výstupních formátů uvedených v Formáty cíle.
ConverterWidgetOptions
public sealed class ConverterWidgetOptions
{
public int MaxUploadMb { get; set; } = 25;
}Nastavuje se pomocí DoconutOptions.AddConverterWidget(Action<ConverterWidgetOptions>? configure = null), který vrací DoconutOptions, takže lze volání řetězit.
Řešení problémů
| Příznak | Příčina | Oprava |
|---|---|---|
AddDoconut() vyvolá The Converter plugin is registered via AddPlugin but no active license grants Converter. | Žádná licence, soubor TRIAL, licence bez Converter, nebo placená licence mimo její časové okno verze | Nainstalujte licenci, která poskytuje Converter, nebo odstraňte AddPlugin<ConverterPlugin>() |
AddDoconut() vyvolá AddConverterWidget() was called but the Converter plugin is not registered. | Widget je povolen bez svého pluginu | Přidejte options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>() |
Řešení DocumentConverter vyvolá No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>(). | ConverterPlugin není registrován | Přidejte AddPlugin<ConverterPlugin>() uvnitř AddDoconut() |
| Převod proudu říká, že formát není podporován | sourceExtension nemá úvodní tečku | Předávejte ".xlsx", ne "xlsx" |
ConvertAsync vyvolá Converting '.dcm' requires the Dicom capability license. | Zdroj DICOM a licence neposkytuje Dicom | Použijte licenci, která poskytuje Dicom |
| Výstup je vodoznakem | Licence je dočasná (Demo/NFR) | Použijte placenou licenci, která poskytuje Converter |
Widget se načte, ale jeho požadavky vracejí 404 | AddConverterWidget() nebyl zavolán, nebo basePath neodpovídá větvi, kde je UseDoconut() nasazen | Zavolejte AddConverterWidget(); opravte basePath |
open odpovídá 403 Converting this file type requires the Dicom capability license. | Upload DICOM a licence neposkytuje Dicom | Použijte licenci, která poskytuje Dicom |
open odpovídá 413 File is too large. | Upload překračuje MaxUploadMb | Zvyšte MaxUploadMb v AddConverterWidget; maxUploadMb widgetu je pouze kontrola na straně klienta |
run odpovídá 400 That target format is not available for this file. | Cíl není jedním z allowedTargets zdroje | Nabídněte pouze allowedTargets z open |
run nebo download odpovídá 404 (Upload expired — please re-open the file. z run) | 30minutové okno uplynulo, nebo uzel webové farmy nemá upload | Otevřete soubor znovu; ve farmě zaregistrujte AddDoconutDistributedWidgets |
| Widget selže, když je UI na jiném původu | Koncové body nemají podporu CORS | Poskytněte UI ze stejného původu, nebo reverse-proxy Doconut cesty |
| Motiv se neaplikuje | Proměnné jsou nastaveny na předkovi nebo na elementu uvnitř mountu; vlastní pravidlo .dcw widgetu je nastavuje na mountu | Cílový mount samotný: #doconut-convert.dcw nebo #doconut-convert |
Byla tato stránka užitečná?