Konverteringsplugin
Konvertera dokument till 45 målformat
Konverteringspluginet förvandlar Doconut till en dokumentkonverteringstjänst. Det bidrar med motorn bakom den offentliga DocumentConverter-fasaden, och — på begäran — en färdig widget med eget HTTP‑kontrakt, så att du kan konvertera dokument från C#, från widgeten, eller från ett frontend‑gränssnitt som du själv skriver.
| Yta | Använd när |
|---|---|
DocumentConverter (C#) | Du konverterar på servern, utan att en webbläsare är inblandad |
Drop-in widget (doconutConverter.js) | Du vill ha en färdig uppladdnings-, konverterings- och nedladdningsskärm på din sida |
HTTP endpoints (?convert=open|run|download) | Du bygger ditt eget konverterings‑UI mot ett dokumenterat serverkontrakt |
Installera paketet
Installera den senaste stabila Konverteringspluginet:
dotnet add package Doconut.NET8.ConverterFör att låsa pluginet till den version som den här dokumentationen beskriver, ange versionen separat:
dotnet add package Doconut.NET8.Converter --version 26.10.0Behåll Konverteringspaketet på samma version som Doconut.NET8. Paket‑ID:t är Doconut.NET8.Converter; .<version> visas endast i den nedladdade filnamnet .nupkg.
Pluginets licensfil, Doconut.Viewer.Converter.lic, placeras i samma mapp som Doconut.Viewer.lic; den läses tillsammans med visningslicensen.
Plattformar. Pluginet körs där Doconut.NET8 körs: Windows och glibc‑baserad Linux på x64 (inte Alpine eller andra musl‑baserade distributioner). På Linux, installera fontkonfigurationsbiblioteket innan det första dokumentet öppnas:
apt-get update && apt-get install -y libfontconfig1På RHEL, Fedora och liknande distributioner är paketet fontconfig. Utan det misslyckas öppning av ett dokument med The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation.
Registrera pluginet
Det finns ingen AddConverter()‑metod — Doconut:s plugin‑modell är enhetlig. Varje plugin, inklusive Converter, registreras på samma sätt: anropa AddPlugin<TPlugin>() inuti AddDoconut(). ConverterPlugin levereras i sitt eget NuGet‑paket, Doconut.NET8.Converter, installerat tillsammans med bas‑visningspaketet.
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
});Det är allt som C#‑fasaden behöver. Widgeten och dess HTTP‑endpoints är ett separat val, AddConverterWidget() (se Drop-in widget).
Pluginet behöver en licens som ger Converter‑kapaciteten. Utan en sådan kastar AddDoconut() ett InvalidOperationException vid start, innan appen hanterar en begäran:
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.Det kastas för ingen licens, en äldre TRIAL‑fil, en licens utan Converter, och en betald licens som används utanför dess versionsfönster. Tillfälliga Demo/NFR‑licenser accepteras. Det finns ingen tyst gratisnivå. Se License Setup för hur licenser laddas.
Licensiering & vattenstämpel
| Licensstatus | Uppstart | Konverteringsresultat |
|---|---|---|
Betald visningslicens som ger Converter, inom dess versionsfönster | Startar | Ren — watermarked: false |
| Aktiv tillfällig (Demo/NFR) licens | Startar | Konverterar, med utvärderingsvattenstämpel — watermarked: true |
| Utgången tillfällig (Demo/NFR) licens | Startar | Konverterar, med utvärderingsvattenstämpel — watermarked: true |
Ingen licens, en äldre TRIAL‑fil, en licens utan Converter, eller en betald licens utanför dess versionsfönster | AddDoconut() kastar | — |
Båda anropsvägarna beräknar flaggan enligt samma regel: DocumentConverter‑C#‑fasaden härleder den internt från licensens IsViewerLicensed‑ och IsTemporary‑status, och widgetens ?convert=run‑hanterare gör motsvarande kontroll (IsViewerLicensed && !IsTrial && !IsTemporary) för att fylla i watermarked‑fältet som den returnerar. En integration kan byggas och testas end‑to‑end på en utvärderingslicens före köp — endast utdata‑bytena förändras.
En DICOM‑källa (.dcm, .ima) kräver också Dicom‑kapaciteten. Utan den kastar ConvertAsync ett LicenseException (Converting '.dcm' requires the Dicom capability license.) och widgetens open svarar 403.
Användning från C#
Varje konvertering returnerar ett sökbart MemoryStream placerat på 0, redo att läsas eller kopieras omedelbart. Hämta DocumentConverter från DI där du behöver det — den är stateless av design, så en enda instans är säker att återanvända över förfrågningar.
// Inject DocumentConverter; dess konstruktor är intern, så skapa den aldrig med `new`.
Stream pdf = await converter.ConvertAsync("contract.docx", ConversionTarget.Pdf, ct: ct);// sourceExtension innehåller den inledande punkten. password är null om inte dokumentet är skyddat.
Stream png = await converter.ConvertAsync(stream, ".xlsx", ConversionTarget.Png, password: null, ct: ct);Stream html = await converter.WordToHtmlAsync("report.docx", ct);// html: en Stream som innehåller HTML för att konverteras tillbaka till ett Word-dokument, till exempel resultatet av WordToHtmlAsync.
Stream docx = await converter.HtmlToWordAsync(html, ConversionTarget.Docx, ct);Två detaljer som är lätta att göra fel på: sourceExtension på ström‑överladdningen måste inkludera den inledande punkten (".xlsx", inte "xlsx") — konverteraren matchar den mot formatkatalogen och enbart filändelsen löser inte. Och trots sitt namn returnerar WordToHtmlAsync Task<Stream>, inte Task<string> — du får HTML‑dokumentet (bilder inbäddade som Base64) som en ström, samma som alla andra konverteringsresultat.
Anroparen äger den returnerade strömmen och bör avyttra den efter kopiering eller återlämnande av dess innehåll. DocumentConverter‑tjänsten själv hämtas via beroendeinjektion; bygg inte eller avyttra den manuellt.
Måletformat
ConversionTarget (namnrymd Doconut.Configs.Conversion) har 45 medlemmar:
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, IcoInte varje källa konverteras till varje mål — pluginet mappar varje källas formatfamilj (Word, Excel, PowerPoint, PDF, CAD, Image, Email, Diagram, Project/Task, PSD, webbdokument, DICOM) till sin egen fasta uppsättning tillåtna mål. Att konvertera en DICOM‑källa (.dcm, .ima) kräver också en licens som ger Dicom‑kapaciteten; dess mål är Pdf, Png, Jpeg, Bmp, Tiff och Gif. Hardkoda inte denna enum som ditt UI:s mållista: ?convert=open returnerar den faktiska allowedTargets för den fil som just laddats upp, och det är vad som bör styra en väljare.
Inbäddningsbar widget
Aktivera slutpunkterna
Widgetens ?convert=open|run|download‑slutpunkter är valfria och inaktiverade från början — säkra som standard. Aktivera dem på serversidan, tillsammans med pluginregistreringen:
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
options.AddConverterWidget(widget =>
{
widget.MaxUploadMb = 25;
});
});AddConverterWidget() utan argument aktiverar widgeten med standardvärdena (MaxUploadMb = 25). Den beviljar inte konverteringsrättigheter i sig: den behöver AddPlugin<ConverterPlugin>(), annars kastar AddDoconut():
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.Utan AddConverterWidget() svarar de tre ?convert=‑slutpunkterna med 404 — men JS‑filen själv levereras ändå (det är en enkel inbäddad statisk resurs; endast de slutpunkter den kommunicerar med är begränsade).
Bädda in den
<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) tar en CSS‑selektor eller ett element, kastar om monteringen inte hittas, och returnerar ett handtag. Widgeten laddar upp en fil, visar en förhandsgranskning av sida 1, låter användaren välja en av allowedTargets, konverterar, förhandsgranskar resultatet när det går, och erbjuder nedladdning.
Alternativ
| Alternativ | Typ | Standard | Anteckningar |
|---|---|---|---|
basePath | string | /doconut | Basväg för ?convert=-ändpunkterna; den måste matcha ASP.NET-grenen där UseDoconut() faktiskt är monterad (vanligtvis koordinerad via MiddlewarePath) |
resPath | string | /doconut-res | Accepterad för konfigurationskonsekvens med andra Doconut‑widgetar; konverteringswidgeten bygger för närvarande ingen URL från den |
maxUploadMb | number | 25 | Endast förhandskontroll på klient‑sidan — avvisar en för stor fil innan uppladdning. Servern upprätthåller sin egen gräns oberoende och svarar med 413 om den överskrids |
licenseUrl | string | null | null | När den är satt, gör vattenstämpelmeddelandet på resultatskärmen till en länk till denna URL |
labels | object | {} | Åsidosätter någon delmängd av widgetens engelska standardsträngar (släpptext, knappar, aria‑live‑meddelanden, felmeddelanden) |
Återanrop
| Återanrop | Utlöses när | Innehåll |
|---|---|---|
onReady() | Widgeten har renderat sin inaktiva/släppskärm | — |
onSourceLoaded({ token, pages, sourceExt, allowedTargets }) | ?convert=open lyckas | källsessionstoken, sidantal, källfiländelse (utan inledande punkt), tillåten mållista |
onConverted({ downloadToken, resultToken, resultPages, downloadName, watermarked, target }) | ?convert=run lyckas | samma fält som körsvaret, plus den target som begärdes |
onDownload({ downloadName, downloadToken }) | Användaren klickar på länken Ladda ner | utlöses tillsammans med webbläsarens inbyggda nedladdning — den avbryter eller ersätter den inte |
onError({ phase, message }) | En öppnings‑ eller körningsbegäran misslyckas | phase är 'open' eller 'run'; message är det sanerade serverfelet (eller ett klient‑sidomeddelande för förhandskontrollen av uppladdningsstorlek) |
Ett återanrop som kastar ett undantag fångas och loggas; det bryter aldrig widgetens flöde.
Imperativt handtag
Doconut.convert() returnerar själva widget‑instansen — behåll den för att styra widgeten programmässigt:
const conv = Doconut.convert('#doconut-convert', { basePath: '/doconut' });
const file = document.querySelector('#picker').files[0]; // en File från din egen <input type="file" id="picker">
conv.reset(); // tillbaka till idle/drop-skärmen; avfyras inte igen onReady
conv.loadFile(file); // startar flödet med ett File-objekt; no-op om inte för närvarande idle
conv.destroy(); // tar bort lyssnare, tömmer mount; instansen är oanvändbar efter dettaEtiketter
Varje sträng har en engelsk standard; labels åsidosätter någon delmängd och resten förblir på engelska. Fragment som förändras vid körning använder {placeholders}, såsom uploading: 'Uploading {name}…' och pages: '{n} pages'.
| Nyckel | Engelsk standard |
|---|---|
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. |
Ytterligare nycklar täcker drop‑zonens aria-label (dropAriaLabel), förhandsgranskningsalt‑texter (previewAlt, resultAlt), den länkade formen av vattenstämpelmeddelandet som används med licenseUrl (watermarkNoticePrefix, watermarkNoticeLink, watermarkNoticeSuffix), ett oläsligt svar (badResponse) och aria-live‑meddelandena (annReady, annUploading, annLoaded, annLoadedNoTargets, annConverting, annDone, annError).
Ett JSON‑fel från servern visas som servern skrev det; serverError används endast när ett misslyckat svar saknar JSON‑fel, såsom 404 för en inaktiverad widget.
Tematisering
Widgeten lägger till klassen dcw på sitt monterings‑element och läser sina färger, radie och typsnitt från CSS‑anpassade egenskaper, så att du kan tematisera den utan att röra dess interna delar:
#doconut-convert.dcw {
--dcw-accent: #6b46c1;
--dcw-radius: 12px;
--dcw-font: "Inter", system-ui, sans-serif;
}Standardvärden: --dcw-accent: #2b6cb0, --dcw-bg: #ffffff, --dcw-fg: #1a202c, --dcw-muted: #718096, --dcw-border: #cbd5e0, --dcw-radius: 8px, och ett system‑UI‑typsnitt för --dcw-font.
Bygg ditt eget frontend
Widgeten är bara en klient för detta HTTP‑kontrakt — bygg ditt eget frontend direkt mot det för en annan användarupplevelse. Alla tre rutter ligger under ASP.NET‑grenen där UseDoconut() är monterad (vanligtvis /doconut), och de svarar med 404 tills AddConverterWidget() anropas. Fel innehåller en JSON‑kropp, { "error": "..." }, förutom där tabellen säger "endast status". Ett okänt ?convert=‑värde svarar med 400.
| Rutt | Syfte | Framgångssvar |
|---|---|---|
POST ?convert=open (multipart, one file) | Ladda upp och öppna ett källdokument för förhandsgranskning | 200 — { token, pages, sourceExt, allowedTargets } |
POST ?token=<token>&convert=run&target=<ext> | Konvertera den lagrade källan till target | 200 — { downloadToken, resultToken, resultPages, downloadName, watermarked } |
GET ?convert=download&token=<downloadToken> | Strömma den konverterade filen | 200 — file bytes, Content-Disposition: attachment, Cache-Control: no-store |
sourceExt i open‑svaret har ingen inledande punkt (t.ex. "docx") — motsatt konvention jämfört med sourceExtension‑parametern på DocumentConverter.ConvertAsync, som kräver en. allowedTargets listar målnamn med gemener ("pdf", "html", …); skicka ett av dem som target, som matchas utan hänsyn till versaler. open använder den första filen i multipart‑kroppen.
resultToken är null, och resultPages är 0, när resultatet inte kan förhandsgranskas. downloadName är källfilens namn med målfilens filändelse.
Förhandsgranskningsbilderna använder den standardiserade bild‑ruten för visaren, {basePath}?token={token}&page=1&thumb=1&width={px}, med token från open eller resultToken från run. Widgeten begär width=240.
Uppladdade källbytes lagras på servern och behålls i 30 minuter efter att de senast lästes; när detta tidsfönster löper ut svarar run med 404 och filen måste öppnas på nytt. Det konverterade resultatet finns i samma lagring — downloadToken får sitt eget nya 30‑minutersfönster när konverteringen slutförs — medan resultToken är ett vanligt visarsession‑token för att förhandsgranska resultatet. När resultatet kan förhandsgranskas är downloadToken och resultToken samma värde. Att stänga ett visningsresultat raderar inte en fortfarande giltig nedladdningslagring, och att återställa webbläsar‑widgeten förlänger inte något av fönstren.
Felmoder, grupperade efter rutt:
| Rutt | Status | När | Kropp |
|---|---|---|---|
| any | 404 | Widgeten är inte aktiverad (AddConverterWidget() anropades aldrig) — kontrolleras innan någon av de tre rutterna dispatchas | endast status |
| any | 405 | Fel HTTP‑verb (open/run kräver POST; download kräver GET) | endast status |
open | 400 | Ingen multipart‑uppladdning | Expected a multipart file upload. |
open | 400 | Ingen fil, eller en tom fil | No file uploaded. |
open | 400 | En källfiländelse som inte kan konverteras | This file type cannot be converted. |
open | 403 | Filtypen kräver en funktion som licensen inte ger (en DICOM‑fil utan Dicom) | Converting this file type requires the Dicom capability license. |
open | 413 | Uppladdad fil överskrider MaxUploadMb, kontrolleras mot Content-Length och medan uppladdningen läses | File is too large. |
run | 400 | Felaktig token (inte ett GUID) | Invalid token. |
run | 400 | En target som inte kan parsas till en ConversionTarget | Unknown target format. |
run | 400 | target finns inte i källans allowedTargets | That target format is not available for this file. |
run | 404 | Den lagrade uppladdningen har gått ut eller token öppnades aldrig | Upload expired — please re-open the file. |
open, run | 500 | Bearbetning misslyckades internt | Ett sanerat meddelande — sanerat på samma sätt som alla andra Doconut‑felvägar; avslöjar aldrig interna detaljer |
download | 400 | Felaktig token (inte ett GUID) | endast status |
download | 404 | Okänd eller utgången nedladdningstoken | endast status |
En komplett rundresa med fetch:
// file: File att konvertera, till exempel från ett <input type="file">.
async function convertFile(file) {
const base = '/doconut';
// 1. open: ladda upp filen
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: konvertera till PDF när det är tillåtet, annars till det första tillåtna målet
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: en enkel GET som webbläsaren kan följa
window.location.href = base + '?convert=download&token=' + encodeURIComponent(converted.downloadToken);
}Slutpunkterna är same-origin: den här versionen har inget CORS‑stöd. Servera ditt UI och widget‑skriptet från samma origin som Doconut, eller reverse-proxy båda /doconut‑vägarna (middleware‑vägen och resurser‑vägen) under ditt UI:s origin.
I produktion
- Installera pluginet bredvid kärnpaketet, i samma version:
dotnet add package Doconut.NET8.Converter. - Lägg till licensfilen. Placera
Doconut.Viewer.Converter.lici samma mapp somDoconut.Viewer.lic. - Ställ in servergränsen.
MaxUploadMbiAddConverterWidgetär den gräns servern upprätthåller; widgetensmaxUploadMbär bara en klient‑sidokontroll. Håll de två lika. - Servera UI:t från samma ursprung som Doconut‑slutpunkterna, eller omvänd‑proxy dem (se Bygg ditt eget frontend).
- Disposera konverteringsresultat. Strömmen
ConvertAsyncreturnerar är poolad; att disponera den returnerar dess buffertar till poolen.
Webbfarmer
Widgeten behåller varje uppladdning och dess resultat i minnet på noden som levererade open. Bakom en lastbalanserare utan sticky‑sessioner kan en senare run, download eller förhandsgranskningsförfrågan nå en annan nod och inte hitta uppladdningen. Registrera den delade, krypterade widget‑lagringen en gång, efter AddDoconut():
byte[] farmKey = Convert.FromBase64String(builder.Configuration["Doconut:FarmKey"]);
builder.Services.AddDoconutDistributedWidgets(store =>
{
store.RootPath = @"\\fileshare\doconut"; // en mapp som varje nod kan läsa och skriva
store.FarmKey = farmKey; // minst 32 byte, identisk på varje nod
// store.Ttl = TimeSpan.FromMinutes(30); // hur länge en uppladdning behålls (standardvärdet)
});- En enskild server behöver inget: utan detta anrop används den minnesbaserade lagringen.
- Uppladdningar och resultat är krypterade i vila på delningen (AES-256, encrypt-then-MAC), och varje fil är bunden till sin token, så ingen token kan nå en annan fils data.
- På delningen behålls en uppladdning eller ett resultat i
Ttlefter att den skrivits; läsning förlänger inte detta tidsfönster. FarmKeymåste vara minst 32 byte och samma på varje nod. Ladda den från en hemlig lagring; hårdkoda den aldrig. Registrering kastar ettArgumentExceptionnärRootPathsaknas ellerFarmKeyär kortare än 32 byte.- Peka
RootPathpå samma delade plats som den distribuerade visaren använder.
API‑referens
Fasaden och widget‑alternativen finns i namnrymden Doconut; ConversionTarget finns i Doconut.Configs.Conversion. ConverterPlugin finns i 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);
}Löses via beroendeinjicering; konstruktorn är intern. sourceExtension inkluderar den inledande punkten. HtmlToWordAsync skriver en .doc‑fil när outputFormat är ConversionTarget.Doc, och en .docx‑fil för alla andra värden.
ConversionTarget
De 45 utdataformaten som listas i Målförformat.
ConverterWidgetOptions
public sealed class ConverterWidgetOptions
{
public int MaxUploadMb { get; set; } = 25;
}Ställ in via DoconutOptions.AddConverterWidget(Action<ConverterWidgetOptions>? configure = null), som returnerar DoconutOptions så att anrop kan kedjas.
Felsökning
| Symptom | Orsak | Lösning |
|---|---|---|
AddDoconut() kastar The Converter plugin is registered via AddPlugin but no active license grants Converter. | Ingen licens, en TRIAL‑fil, en licens utan Converter, eller en betald licens utanför dess versionsfönster | Installera en licens som beviljar Converter, eller ta bort AddPlugin<ConverterPlugin>() |
AddDoconut() kastar AddConverterWidget() was called but the Converter plugin is not registered. | Widgeten är aktiverad utan dess plugin | Lägg till options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>() |
Att lösa DocumentConverter kastar No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>(). | ConverterPlugin är inte registrerad | Lägg till AddPlugin<ConverterPlugin>() inuti AddDoconut() |
| Strömkonvertering säger att formatet inte stöds | sourceExtension har ingen inledande punkt | Skicka ".xlsx", inte "xlsx" |
ConvertAsync kastar Converting '.dcm' requires the Dicom capability license. | En DICOM‑källa, och licensen beviljar inte Dicom | Använd en licens som beviljar Dicom |
| Utdata är vattenstämpel | Licensen är tillfällig (Demo/NFR) | Använd en betald licens som beviljar Converter |
Widgeten laddas men dess förfrågningar svarar 404 | AddConverterWidget() anropades inte, eller basePath matchar inte grenen där UseDoconut() är monterad | Anropa AddConverterWidget(); fixa basePath |
open svarar 403 Converting this file type requires the Dicom capability license. | En DICOM‑uppladdning, och licensen beviljar inte Dicom | Använd en licens som beviljar Dicom |
open svarar 413 File is too large. | Uppladdningen överskrider MaxUploadMb | Höj MaxUploadMb i AddConverterWidget; widgetens maxUploadMb är bara en klient‑sidokontroll |
run svarar 400 That target format is not available for this file. | Målet är inte ett av källans allowedTargets | Erbjud endast allowedTargets från open |
run eller download svarar 404 (Upload expired — please re-open the file. från run) | 30‑minutersfönstret har löpt ut, eller en webbfarmsnod har inte uppladdningen | Öppna filen igen; i en farm, registrera AddDoconutDistributedWidgets |
| Widgeten misslyckas när UI:t är på en annan ursprung | Slutpunkterna har inget CORS‑stöd | Servera UI:t från samma ursprung, eller omvänd‑proxy Doconut‑vägarna |
| Temat tillämpas inte | Variablerna är satta på en förfader eller på ett element inne i mounten; widgetens egen .dcw‑regel sätter dem på mounten | Rikta in dig på själva mounten: #doconut-convert.dcw eller #doconut-convert |
Var den här sidan hjälpsam?