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:

bash
dotnet add package Doconut.NETStandard.Converter

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

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

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

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

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í 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 licenceSpuštěníVýstup převodu
Placená licence vieweru poskytující Converter, v rámci svého časového oknaSpouštíČistý — watermarked: false
Aktivní dočasná (Demo/NFR) licenceSpouštíPřevádí, s evaluačním vodoznakem — watermarked: true
Expirující dočasná (Demo/NFR) licenceSpouš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é oknoAddDoconut() 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.

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 dokument není 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 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ů:

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

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

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 ke konverzi: potřebuje AddPlugin<ConverterPlugin>(), nebo 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 i tak poskytován (je to prostý vložený statický zdroj; pouze koncové body, ke kterým se připojuje, jsou omezené).

Vložení

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í 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žnostTypVýchozíPoznámky
basePathstring/doconutZá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)
resPathstring/doconut-resPřijato pro konzistenci konfigurace s ostatními widgety Doconut; widget převodníku v současnosti nevyužívá žádnou URL z tohoto nastavení
maxUploadMbnumber25Pouze 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
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íSpustí se, kdyžData
onReady()Widget vykreslil svůj nečinný/přetahovací obrazovku—
onSourceLoaded({ token, pages, sourceExt, allowedTargets })?convert=open uspějezdrojový 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ějestejné pole jako odpověď běhu, 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 — neinterceptuje ani nenahrazuje jej
onError({ phase, message })Požadavek na otevření nebo spuštění selžephase 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:

javascript
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í
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).

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:

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 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á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 — 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:

TrasaStavKdyTělo
jakýkoli404Widget není povolen (AddConverterWidget() nebyl nikdy zavolán) — kontrolováno před odesláním jakékoli ze tří traspouze stav
jakýkoli405Š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 prázdný souborNo file uploaded.
open400Zdrojová přípona, kterou nelze převéstThis file type cannot be converted.
open403Typ souboru vyžaduje funkci, 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 nebyl nikdy otevřenUpload expired — please re-open the file.
open, run500Zpracování selhalo interněSanitizovaná zpráva — sanitizována stejným způsobem jako každá jiná chybová cesta Doconut; nikdy neprozrazuje interní podrobnosti
download400Poškozený token (není GUID)pouze stav
download404Neznámý nebo vypršený token ke staženípouze stav

Kompletní průchod 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 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

  1. Nainstalujte plugin vedle hlavního balíčku, ve stejné verzi: dotnet add package Doconut.NETStandard.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 pouze 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, 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():

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 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 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 nehardcodujte. Registrace vyhodí ArgumentException, když RootPath chybí nebo je FarmKey kratší než 32 bajtů.
  • Nasmerujte RootPath na 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

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);
}

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

csharp
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říznakPříčinaOprava
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é oknoNainstalujte 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 pluginuPř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ánPřidejte AddPlugin<ConverterPlugin>() uvnitř AddDoconut()
Převod proudu uvádí, že formát není podporovánsourceExtension nemá úvodní tečkuPředávejte ".xlsx", ne "xlsx"
ConvertAsync throws Converting '.dcm' requires the Dicom capability license.Zdroj DICOM a licence neposkytuje DicomPoužijte licenci, která poskytuje Dicom
Výstup je vodoznakemLicence je dočasná (Demo/NFR)Použijte placenou licenci, která poskytuje Converter
Widget se načte, ale jeho požadavky vracejí 404AddConverterWidget() nebylo zavoláno, nebo basePath neodpovídá větvi, kde je UseDoconut() nasazenZavolejte AddConverterWidget(); opravte basePath
open answers 403 Converting this file type requires the Dicom capability license.Upload DICOM a licence neposkytuje DicomPoužijte licenci, která poskytuje Dicom
open answers 413 File is too large.Upload překračuje MaxUploadMbZvyš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 zdrojeNabí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á 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
Motiv se neaplikujeProměnné jsou nastaveny na předka nebo na element uvnitř mountu; widgetovo vlastní pravidlo .dcw je nastavuje na mountCí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 injektujte Doconut.DocumentConverter.
  • Tento ConversionTarget výčet pokrývá každou zdrojovou rodinu. Předchozí knihovna měla pro každou rodinu typ *ConfigConverter — WordConfigConverter, ExcelConfigConverter a tak dále — každý se svým vnořeným výčtem EnTargetFormat, plus výčet SourceFormatConverter pro 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á?