Plugin pro převodník
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 enginu stojícímu za veřejnou DocumentConverter fasádou a — po opt-in — vložitelným widgetem s vlastním HTTP kontraktem, takže můžete převádět dokumenty z C#, z widgetu nebo z frontendu, který si vytvoříte sami.
| 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 pro převod podle zdokumentovaného serverového kontraktu |
Instalace balíčku
Nainstalujte nejnovější stabilní plugin Converter:
dotnet add package Doconut.NET8.ConverterPro připnutí pluginu k verzi, kterou tato dokumentace popisuje, předávejte verzi samostatně:
dotnet add package Doconut.NET8.Converter --version 26.10.0Udržujte balíček Converter ve stejné verzi jako Doconut.NET8. ID balíčku je Doconut.NET8.Converter; .<version> se objevuje pouze v názvu staženého souboru .nupkg.
Licenční soubor pluginu, Doconut.Viewer.Converter.lic, se umístí do stejné složky jako Doconut.Viewer.lic; je načten spolu s licencí prohlížeče.
Platformy. Plugin běží kdekoliv Doconut.NET8 běží: 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 RHEL, Fedora a podobných distribucí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.NET8.Converter, nainstalovaného vedle základního balíčku vieweru.
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
});To je vše, co C# fasáda potřebuje. Widget a jeho HTTP endpointy jsou samostatná volitelná funkce, AddConverterWidget() (viz Widget k vložení).
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é Demo/NFR licence 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 vieweru poskytující Converter, v rámci své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 |
| Expirovaná 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čítávají příznak ze stejného pravidla: C# fasáda DocumentConverter získává jej interně ze stavu IsViewerLicensed a 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é potřebuje schopnost Dicom. Bez ní ConvertAsync vyhodí LicenseException (Converting '.dcm' requires the Dicom capability license.) a handler widgetu open odpovídá 403.
Použití z C#
Každá konverze vrací seekovatelný MemoryStream umístěný na 0, připravený okamžitě číst nebo kopírovat. Získejte DocumentConverter z DI kdekoliv jej potřebujete — je bezstavový podle návrhu, takže jedna instance je bezpečná pro opakované použití napříč požadavky.
// Injektujte DocumentConverter; jeho konstruktor je interní, takže jej nikdy `new` nevolejte.
Stream pdf = await converter.ConvertAsync("contract.docx", ConversionTarget.Pdf, ct: ct);// sourceExtension zahrnuje úvodní tečku. password je null, pokud není dokument 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 na přetížení streamu musí obsahovat úvodní tečku (".xlsx", ne "xlsx") — konvertor 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í; neinstanciujte ani neuvolňujte ji ručně.
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, IcoNení každý zdroj konvertovatelný 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ů. Konverze DICOM zdroje (.dcm, .ima) také vyžaduje licenci, která poskytuje schopnost Dicom; její cíle jsou Pdf, Png, Jpeg, Bmp, Tiff a Gif. Nezakódovávejte tento výčet jako seznam cílů ve vašem UI: ?convert=open vrací skutečný allowedTargets pro jakýkoli právě nahraný soubor, a to by mělo řídit výběr.
Vkládací widget
Povolení koncových bodů
Koncové body widgetu ?convert=open|run|download jsou volitelné a ve výchozím nastavení zakázané — zabezpečené jako výchozí. Povolit je na 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 na konverzi: potřebuje AddPlugin<ConverterPlugin>(), jinak AddDoconut() vyhodí 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= odpovídají 404 — ale samotný JS soubor je stále 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í umístění nalezeno, a vrátí handle. Widget nahrává soubor, zobrazuje náhled první stránky, umožní uživateli vybrat jeden z allowedTargets, provede konverzi, náhled výsledku pokud je 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ě nasazen (obvykle koordinováno přes MiddlewarePath) |
resPath | string | /doconut-res | Přijato pro zachování konzistence konfigurace s ostatními widgety Doconut; widget převodníku momentálně z něj nevytváří žádnou URL |
maxUploadMb | number | 25 | Pouze předběžná kontrola na klientovi — 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í upozornění 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 svůj nečinný/přetahovací obrazovku | — |
onSourceLoaded({ token, pages, sourceExt, allowedTargets }) | ?convert=open úspěšně dokončí | token relace zdroje, počet stránek, přípona zdroje (bez úvodní tečky), seznam povolených cílů |
onConverted({ downloadToken, resultToken, resultPages, downloadName, watermarked, target }) | ?convert=run úspěšně dokončí | stejné pole jako odpověď 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 }) | Otevření nebo spuštění požadavku selže | phase je 'open' nebo 'run'; message je sanitizovaná 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]; // File od vás <input type="file" id="picker">
conv.reset(); // zpět na obrazovku idle/drop; nespouští znovu onReady
conv.loadFile(file); // spouští tok s objektem File; no-op, pokud není aktuálně nečinný
conv.destroy(); // odstraňuje posluchače, vyprázdní mount; instance je po tomto nepouž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 upozornění 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 se zobrazí 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 připojen, a načte jeho barvy, poloměr a písmo z vlastních CSS 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 přímo proti ní pro odlišnou uživatelskou zkušenost. Všechny tři cesty leží pod větví ASP.NET, kde je nasazen UseDoconut() (běžně /doconut) a odpovídají 404, dokud není zavoláno AddConverterWidget(). Chyby nesou 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, one file) | 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 — souborové bajty, 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ílů malými písmeny ("pdf", "html", …); předávejte jeden z nich jako target, který se porovnává bez rozlišení velikosti 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 požaduje 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řevod výsledku ž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 prohlížeče neodstraní stále platné úložiště ke stažení a resetování widgetu v prohlížeči neprodlouží žádné z oken.
Režimy selhání, seskupené podle cesty:
| Cesta | Stav | Kdy | Tělo |
|---|---|---|---|
| libovolná | 404 | Widget není povolen (AddConverterWidget() nebyl nikdy zavolán) — kontrolováno před odesláním jakékoli ze tří cest | pouze stav |
| libovolná | 405 | Špatná HTTP metoda (open/run vyžadují POST; download vyžaduje GET) | pouze stav |
open | 400 | Není multipart nahrání | Expected a multipart file upload. |
open | 400 | Žádný soubor, nebo je prázdný | No file uploaded. |
open | 400 | Zdrojová přípona, 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 vůči Content-Length a během čtení nahrávání | File is too large. |
run | 400 | Poškozený 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é nahrání vypršelo nebo token nikdy nebyl otevřen | Upload expired — please re-open the file. |
open, run | 500 | Zpracování selhalo interně | Sanitizovaná zpráva — sanitizovaná stejným způsobem jako každá jiná chybová cesta Doconut; nikdy neodhaluje interní detaily |
download | 400 | Poškozený token (není GUID) | pouze stav |
download | 404 | Neznámý nebo vypršený token ke stažení | pouze stav |
Kompletní cyklus s fetch:
// file: Soubor k převodu, například z <input type="file">.
async function convertFile(file) {
const base = '/doconut';
// 1. open: nahrát 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: jednoduchý GET, který může prohlížeč následovat
window.location.href = base + '?convert=download&token=' + encodeURIComponent(converted.downloadToken);
}Endpointy jsou stejný původ: tato verze nemá podporu CORS. Servírujte své UI a skript widgetu ze stejného původu jako Doconut, nebo použijte reverse‑proxy na obě cesty /doconut (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.NET8.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 jen kontrola na straně klienta. Udržujte oba stejné. - Podávejte UI ze stejného původu jako Doconut endpointy, nebo je reverse-proxy (viz Vytvořte si vlastní frontend).
- Uvolněte výsledky konverze. Proud
ConvertAsyncvrací 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 sessions 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 i zapisovat
store.FarmKey = farmKey; // alespoň 32 bajtů, identické na každém uzlu
// store.Ttl = TimeSpan.FromMinutes(30); // jak dlouho je nahrává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 na sdíleném úložišti šifrovány v klidu (AES-256, encrypt-then-MAC) a každý soubor je vázán na svůj token, 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í být alespoň 32 bajtů a stejný na každém uzlu. Načtěte jej z tajného úložiště; nikdy jej nezakódujte přímo. Registrace vyhodíArgumentException, kdyžRootPathchybí nebo jeFarmKeykratší než 32 bajtů.- Nastavte
RootPathna stejné sdílené umístění, které používá distribuovaný viewer.
Referenční 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);
}Vyřešeno pomocí dependency injection; konstruktor je interní. sourceExtension zahrnuje úvodní tečku. HtmlToWordAsync zapisuje soubor .doc, když je outputFormat ConversionTarget.Doc, a soubor .docx pro jakoukoli jinou hodnotu.
ConversionTarget
45 výstupních formátů uvedených v Cílové formáty.
ConverterWidgetOptions
public sealed class ConverterWidgetOptions
{
public int MaxUploadMb { get; set; } = 25;
}Nastaveno přes DoconutOptions.AddConverterWidget(Action<ConverterWidgetOptions>? configure = null), který vrací DoconutOptions, takže volání lze řetězit.
Řešení problémů
| Příznak | Příčina | Oprava |
|---|---|---|
AddDoconut() vyhodí 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 | Nainstalujte licenci, která poskytuje Converter, nebo odstraňte AddPlugin<ConverterPlugin>() |
AddDoconut() vyhodí 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>() |
Vyřešení DocumentConverter vyhodí No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>(). | ConverterPlugin není zaregistrováno | Přidejte AddPlugin<ConverterPlugin>() uvnitř AddDoconut() |
| Převod proudu říká, že formát není podporován | sourceExtension nemá úvodní tečku | Použijte ".xlsx", ne "xlsx" |
ConvertAsync vyhodí Converting '.dcm' requires the Dicom capability license. | Zdroj DICOM a licence neposkytuje Dicom | Použijte licenci, která poskytuje Dicom |
| Výstup je vodoznakovaný | Licence je dočasná (Demo/NFR) | Použijte placenou licenci, která poskytuje Converter |
Widget se načte, ale jeho požadavky odpovídají 404 | AddConverterWidget() nebylo zavoláno, 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 | Vyvolejte MaxUploadMb v AddConverterWidget; widgetův maxUploadMb je jen 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) | Uplynulo 30‑minutové okno, 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 | Endpointy nemají podporu CORS | Podávejte UI ze stejného původu, nebo reverse-proxy Doconut cesty |
| Téma se neaplikuje | Proměnné jsou nastaveny na předkovi nebo na elementu uvnitř mountu; widgetovo vlastní pravidlo .dcw je nastavuje na mountu | Cílovat samotný mount: #doconut-convert.dcw nebo #doconut-convert |
Byla tato stránka užitečná?