Plugin pro převod
Převod dokumentů 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 — volitelně — vložitelný widget 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.NETStandard.ConverterPro připnutí pluginu k verzi, kterou tato dokumentace popisuje, předávejte verzi samostatně:
dotnet add package Doconut.NETStandard.Converter --version 26.10.0Udržujte balíček Converter ve stejné verzi jako Doconut.NETStandard. ID balíčku je Doconut.NETStandard.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.
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.NETStandard.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 koncové body jsou samostatná volitelná funkce, AddConverterWidget() (viz Widget pro vložení).
Plugin vyžaduje 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í to 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 vieweru poskytující Converter, v rámci svého časového okna | Spouští | Čistý — watermarked: false |
| Aktivní dočasná (Demo/NFR) licence | Spouští | Převádí, s evaluačním vodoznakem — watermarked: true |
| Expirující dočasná (Demo/NFR) licence | Spouští | 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 získá interně 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 open widgetu odpovídá 403.
Použití v C#
Každá konverze vrací seekovatelný MemoryStream umístěný na 0, připravený okamžitě číst nebo kopírovat. DocumentConverter získáte 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.
// 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 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 v 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 po kopírování nebo vrácení jeho obsahu uvolnit. Služba DocumentConverter je sama získávána z dependency injection; neinstanciujte ji ani neuvolňujte 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, 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 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.
Widget pro vložení
Povolení koncových bodů
Koncové body ?convert=open|run|download widgetu 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 ke konverzi: potřebuje AddPlugin<ConverterPlugin>(), nebo 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 i tak poskytován (je to prostý vložený statický zdroj; pouze koncové body, ke kterým se připojuje, jsou omezené).
Vložení
<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í nalezený mount, a vrací handle. Widget nahrává soubor, zobrazuje náhled první stránky, umožní uživateli vybrat jeden z allowedTargets, převádí, náhled výsledku zobrazí, pokud může, a nabízí 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ě připojen (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 klientská předkontrola — odmítne příliš velký soubor před nahráním. Server samostatně vynutí svůj limit a vrátí 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í | Spustí se, když | Data |
|---|---|---|
onReady() | Widget vykreslil svůj nečinný/přetahovací obrazovku | — |
onSourceLoaded({ token, pages, sourceExt, allowedTargets }) | ?convert=open uspěje | 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 }) | ?convert=run uspěje | stejné pole jako odpověď běhu, 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 — neinterceptuje ani nenahrazuje jej |
onError({ phase, message }) | Požadavek na otevření nebo spuštění selže | phase je 'open' nebo 'run'; message je sanitizovaná chyba serveru (nebo zpráva na straně klienta pro předkontrolu velikosti nahrávaného souboru) |
Callback, který vyhodí výjimku, je zachycen a zalogován; 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 File z vašeho vlastního <input type="file" id="picker">
conv.reset(); // zpět na nečinnou/odhazovací obrazovku; nespustí se znovu onReady
conv.loadFile(file); // spustí tok s objektem File; no-op pokud není momentálně nečinný
conv.destroy(); // odstraní posluchače, vyprázdní mount; instance je po tomto nepoužitelnáPopisky
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).
JSON chyba ze serveru je zobrazena tak, jak ji server napsal; serverError se používá pouze když selhávající odpověď neobsahuje JSON chybu, například 404 vypnutého widgetu.
Tématizace
Widget přidá třídu dcw k elementu, do kterého 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 klientem pro tuto HTTP smlouvu — vytvořte si vlastní frontend přímo proti ní pro odlišnou uživatelskou zkušenost. Všechny tři trasy jsou umístěny pod větví ASP.NET, kde je nasazen UseDoconut() (obvykle /doconut), a odpovídají 404, dokud není zavoláno AddConverterWidget(). Chyby nesou tělo ve formátu JSON, { "error": "..." }, kromě případů, kdy tabulka uvádí „pouze stav“. Neznámá hodnota ?convert= odpovídá 400.
| Trasa | Úč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 — 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 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í; jakmile toto období vyprší, 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 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 trasy:
| Trasa | Stav | Kdy | Tělo |
|---|---|---|---|
| jakýkoli | 404 | Widget není povolen (AddConverterWidget() nebyl nikdy zavolán) — kontrolováno před odesláním jakékoli ze tří tras | pouze stav |
| jakýkoli | 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 prázdný soubor | 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 funkci, 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 nebyl nikdy otevřen | Upload expired — please re-open the file. |
open, run | 500 | Zpracování selhalo interně | Sanitizovaná zpráva — sanitizována stejným způsobem jako každá jiná chybová cesta Doconut; nikdy neprozrazuje interní podrobnosti |
download | 400 | Poškozený token (není GUID) | pouze stav |
download | 404 | Neznámý nebo vypršený token ke stažení | pouze stav |
Kompletní průchod 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 do prvního povoleného cíle
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 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 (cesta middleware a cesta zdrojů) pod původem vašeho UI.
V produkci
- Nainstalujte plugin vedle hlavního balíčku, ve stejné verzi:
dotnet add package Doconut.NETStandard.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é. - 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, 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á in-memory ú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 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í být alespoň 32 bajtů a 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ů.- Nasmerujte
RootPathna stejné sdílené umístění, které používá distribuovaný prohlížeč.
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);
}Získáno pomocí dependency injection; konstruktor je interní. sourceExtension obsahuje ú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 Cílové formáty.
ConverterWidgetOptions
public sealed class ConverterWidgetOptions
{
public int MaxUploadMb { get; set; } = 25;
}Nastavte 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() throws 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() throws 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>() |
Resolving DocumentConverter throws No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>(). | ConverterPlugin není zaregistrován | Přidejte AddPlugin<ConverterPlugin>() uvnitř AddDoconut() |
| Převod proudu uvádí, že formát není podporován | sourceExtension nemá úvodní tečku | Předávejte ".xlsx", ne "xlsx" |
ConvertAsync throws 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() nebylo zavoláno, nebo basePath neodpovídá větvi, kde je UseDoconut() nasazen | Zavolejte AddConverterWidget(); opravte basePath |
open answers 403 Converting this file type requires the Dicom capability license. | Upload DICOM a licence neposkytuje Dicom | Použijte licenci, která poskytuje Dicom |
open answers 413 File is too large. | Upload překračuje MaxUploadMb | Zvyšte MaxUploadMb v AddConverterWidget; widgetův maxUploadMb je pouze kontrola na straně klienta |
run answers 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 or download answers 404 (Upload expired — please re-open the file. from run) | 30‑minutové okno vypršelo, 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 |
| Motiv se neaplikuje | Proměnné jsou nastaveny na předka nebo na element uvnitř mountu; widgetovo vlastní pravidlo .dcw je nastavuje na mount | Cílovat samotný mount: #doconut-convert.dcw nebo #doconut-convert |
Poznámky k frameworku
viewer.Converter.GetConverter()zde neexistuje. Konverze se již nedosahuje přes instanci prohlížeče: místo toho injektujteDoconut.DocumentConverter.- Tento
ConversionTargetvýčet pokrývá každou zdrojovou rodinu. Předchozí knihovna měla pro každou rodinu typ*ConfigConverter—WordConfigConverter,ExcelConfigConvertera tak dále — každý se svým vnořeným výčtemEnTargetFormat, plus výčetSourceFormatConverterpro vstup. Všechny jsou odstraněny; viz průvodce migrací. - Pouze Windows, stejně jako zbytek balíčku .NET Standard.
Byla tato stránka užitečná?