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:

bash
dotnet add package Doconut.NET8.Converter

Pro připnutí pluginu k verzi, kterou tato dokumentace popisuje, předávejte verzi samostatně:

bash
dotnet add package Doconut.NET8.Converter --version 26.10.0

Udrž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:

bash
apt-get update && apt-get install -y libfontconfig1

Na 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.

csharp
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:

text
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 licenceSpuštěníVýstup převodu
Placená licence vieweru poskytující Converter, v rámci svého časového oknaSpouští seČistý — watermarked: false
Aktivní dočasná (Demo/NFR) licenceSpouští sePřevádí s evaluačním vodoznakem — watermarked: true
Expirovaná dočasná (Demo/NFR) licenceSpouští sePřevádí s evaluačním vodoznakem — watermarked: true
Žádná licence, starý soubor TRIAL, licence bez Converter, nebo placená licence mimo její časové oknoAddDoconut() 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.

csharp
// Injektujte DocumentConverter; jeho konstruktor je interní, takže jej nikdy `new` nevolejte.
Stream pdf = await converter.ConvertAsync("contract.docx", ConversionTarget.Pdf, ct: ct);
csharp
// 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);
csharp
Stream html = await converter.WordToHtmlAsync("report.docx", ct);
csharp
// 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ů:

text
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, Ico

Není 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:

csharp
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:

text
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

html
<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žnostTypVýchozíPoznámky
basePathstring/doconutZá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)
resPathstring/doconut-resPřijato pro zachování konzistence konfigurace s ostatními widgety Doconut; widget převodníku momentálně z něj nevytváří žádnou URL
maxUploadMbnumber25Pouze 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
licenseUrlstring | nullnullKdyž je nastaveno, změní upozornění vodoznaku na výsledkové obrazovce na odkaz na tuto URL
labelsobject{}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áhnoutspustí 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žephase 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:

javascript
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í
dropPromptDrag & drop a document here
dropHintPDF, Word, Excel, PowerPoint, images and more
chooseFileChoose file
uploadingUploading {name}…
page / pages1 page / {n} pages
noTargetsNo conversion targets are available for this file.
convertTo / convertConvert to / Convert
convertingConverting to {target}…
readyToDownloadReady to download
download / convertAnotherDownload / Convert another
watermarkNoticeOutput is watermarked — get a license to remove it.
retryRetry
genericErrorSomething went wrong. Please try again.
sizeLimitThat file is larger than the {mb} MB upload limit. Please choose a smaller file.
serverErrorThe server could not process this request. Please try again.
networkErrorCould 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:

css
#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áhled200 — { token, pages, sourceExt, allowedTargets }
POST ?token=<token>&convert=run&target=<ext>Převést uložený zdroj na target200 — { downloadToken, resultToken, resultPages, downloadName, watermarked }
GET ?convert=download&token=<downloadToken>Streamovat převedený soubor200 — 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:

CestaStavKdyTělo
libovolná404Widget není povolen (AddConverterWidget() nebyl nikdy zavolán) — kontrolováno před odesláním jakékoli ze tří cestpouze stav
libovolná405Špatná HTTP metoda (open/run vyžadují POST; download vyžaduje GET)pouze stav
open400Není multipart nahráníExpected a multipart file upload.
open400Žádný soubor, nebo je prázdnýNo file uploaded.
open400Zdrojová přípona, kterou nelze převéstThis file type cannot be converted.
open403Typ souboru vyžaduje schopnost, kterou licence neposkytuje (DICOM soubor bez Dicom)Converting this file type requires the Dicom capability license.
open413Nahraný soubor překračuje MaxUploadMb, kontrolováno vůči Content-Length a během čtení nahráváníFile is too large.
run400Poškozený token (není GUID)Invalid token.
run400target, který se nedá parsovat na ConversionTargetUnknown target format.
run400target není v allowedTargets zdrojeThat target format is not available for this file.
run404Uložené nahrání vypršelo nebo token nikdy nebyl otevřenUpload expired — please re-open the file.
open, run500Zpracování selhalo interněSanitizovaná zpráva — sanitizovaná stejným způsobem jako každá jiná chybová cesta Doconut; nikdy neodhaluje interní detaily
download400Poškozený token (není GUID)pouze stav
download404Neznámý nebo vypršený token ke staženípouze stav

Kompletní cyklus s fetch:

javascript
// 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

  1. Nainstalujte plugin vedle hlavního balíčku, ve stejné verzi: dotnet add package Doconut.NET8.Converter.
  2. Přidejte licenční soubor. Umístěte Doconut.Viewer.Converter.lic do stejné složky jako Doconut.Viewer.lic.
  3. Nastavte limit serveru. MaxUploadMb v AddConverterWidget je limit, který server vynucuje; maxUploadMb widgetu je jen kontrola na straně klienta. Udržujte oba stejné.
  4. Podávejte UI ze stejného původu jako Doconut endpointy, nebo je reverse-proxy (viz Vytvořte si vlastní frontend).
  5. Uvolněte výsledky konverze. Proud ConvertAsync vrací 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():

csharp
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 Ttl po jeho zápisu; čtení neprodlouží toto okno.
  • FarmKey musí 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ž RootPath chybí nebo je FarmKey kratší než 32 bajtů.
  • Nastavte RootPath na 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

csharp
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

csharp
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říznakPříčinaOprava
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é oknoNainstalujte 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 pluginuPř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ánoPřidejte AddPlugin<ConverterPlugin>() uvnitř AddDoconut()
Převod proudu říká, že formát není podporovánsourceExtension nemá úvodní tečkuPoužijte ".xlsx", ne "xlsx"
ConvertAsync vyhodí Converting '.dcm' requires the Dicom capability license.Zdroj DICOM a licence neposkytuje DicomPouž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í 404AddConverterWidget() nebylo zavoláno, nebo basePath neodpovídá větvi, kde je UseDoconut() nasazenZavolejte AddConverterWidget(); opravte basePath
open odpovídá 403 Converting this file type requires the Dicom capability license.Upload DICOM a licence neposkytuje DicomPoužijte licenci, která poskytuje Dicom
open odpovídá 413 File is too large.Upload překračuje MaxUploadMbVyvolejte 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 zdrojeNabí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á uploadOtevřete soubor znovu; ve farmě zaregistrujte AddDoconutDistributedWidgets
Widget selže, když je UI na jiném původuEndpointy nemají podporu CORSPodávejte UI ze stejného původu, nebo reverse-proxy Doconut cesty
Téma se neaplikujeProměnné jsou nastaveny na předkovi nebo na elementu uvnitř mountu; widgetovo vlastní pravidlo .dcw je nastavuje na mountuCílovat samotný mount: #doconut-convert.dcw nebo #doconut-convert

Byla tato stránka užitečná?