Konverteringsplugin
Konvertera dokument till 45 målformat
Konverteringspluginet gör Doconut till en dokumentkonverteringstjänst. Det bidrar med motorn bakom det offentliga DocumentConverter‑gränssnittet, 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 du själv skriver.
| Yta | Använd den när |
|---|---|
DocumentConverter (C#) | Du konverterar på servern, utan någon webbläsare inblandad |
Inbäddad widget (doconutConverter.js) | Du vill ha en färdig uppladdnings‑, konverterings‑ och nedladdningsskärm i din sida |
HTTP‑slutpunkter (?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.NET6.ConverterFör att låsa pluginet till den version som denna dokumentation beskriver, ange versionen separat:
dotnet add package Doconut.NET6.Converter --version 26.10.0Behåll Konverteringspaketet på samma version som Doconut.NET6. Paket‑ID:t är
Doconut.NET6.Converter; .<version> visas endast i det 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.NET6 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.NET6.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#‑gränssnittet behöver. Widgeten och dess HTTP‑slutpunkter är ett separat val, AddConverterWidget() (se Inbäddad widget).
Pluginet krä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 Licensinställning 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#‑gränssnittet 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 innan köp — endast utdata‑bytarna 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 en sökbar MemoryStream placerad på 0, redo att läsas eller kopieras omedelbart. Hämta DocumentConverter från DI där du behöver den — 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å `new` den aldrig.
Stream pdf = await converter.ConvertAsync("contract.docx", ConversionTarget.Pdf, ct: ct);// sourceExtension inkluderar 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 som ska omvandlas 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å stream‑ö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 stream, samma som varje annat konverteringsresultat.
Anroparen äger den returnerade streamen och bör disponera den efter kopiering eller återlämnande av dess innehåll. DocumentConverter‑tjänsten själv löses upp från beroendeinjektion; konstruera eller disponera den inte manuellt.
Målformat
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, Bild, E‑post, Diagram, Projekt/Uppgift, PSD, webb‑dokument, 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 laddades upp, och det är vad som bör styra en väljare.
Inbäddningswidget
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 plugin‑registreringen:
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 av sig själv: 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‑selector 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 konfigurationskonsistens med andra Doconut-widgets; konverteringswidgeten bygger för närvarande ingen URL från den |
maxUploadMb | number | 25 | Endast förhandskontroll på klientsidan — avvisar en för stor fil innan uppladdning. Servern verkställer sin egen gräns oberoende och svarar 413 om den överskrids |
licenseUrl | string | null | null | När den är satt omvandlas 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) |
Återuppringningar
| Återuppringning | Utlöses när | Data |
|---|---|---|
onReady() | Widgeten har renderat sin inaktiva/släppskärm | — |
onSourceLoaded({ token, pages, sourceExt, allowedTargets }) | ?convert=open lyckas | källsessionstoken, sidantal, källa filä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 avlyssnar inte eller ersätter den |
onError({ phase, message }) | En öppna‑ eller kör‑begäran misslyckas | phase är 'open' eller 'run'; message är det sanerade serverfelet (eller ett klientmeddelande för förhandskontrollen av uppladdningsstorlek) |
En återuppringning som kastar ett undantag fångas och loggas; den bryter aldrig widgetens flöde.
Imperativt handtag
Doconut.convert() returnerar själva widget‑instansen — håll fast vid 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 på nytt onReady
conv.loadFile(file); // startar flödet med ett File-objekt; ingen operation om inte för närvarande idle
conv.destroy(); // tar bort lyssnare, tömmer mount; instance är oanvändbar efter dettaEtiketter
Varje sträng har en engelsk standard; labels åsidosätter någon delmängd och resten förblir engelska. Fragment som ä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‑texterna (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 exakt 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‑avtal — 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 "status only". Ett okänt ?convert=‑värde svarar med 400.
| Rutt | Syfte | Lyckat svar |
|---|---|---|
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 visnings‑bild‑rutten, {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 det tidsfönstret 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 fräscha 30‑minutersfönster när konverteringen slutförs — medan resultToken är ett vanligt visnings‑sessions‑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.
Felmodeller, grupperade per rutt:
| Rutt | Status | När | Kropp |
|---|---|---|---|
| alla | 404 | Widgeten är inte aktiverad (AddConverterWidget() anropades aldrig) — kontrolleras innan någon av de tre rutterna skickas | endast status |
| alla | 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 | No file uploaded. |
open | 400 | En källfilsextension som inte kan konverteras | This file type cannot be converted. |
open | 403 | Filtypen kräver en funktion som licensen inte beviljar (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 | Felaktigt 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 | Felaktigt token (inte ett GUID) | endast status |
download | 404 | Okänt eller utgånget nedladdningstoken | endast status |
En komplett rundresa med fetch:
// file: filen som ska konverteras, till exempel från en <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);
}Endpoints ä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‑proxya 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.NET6.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 som servern upprätthåller; widgetensmaxUploadMbär bara en klient‑sidokontroll. Håll de två lika. - Servera UI:t från samma ursprung som Doconut‑ändpunkterna, eller omvänd‑proxy dem (se Bygg ditt eget frontend).
- Disposera konverteringsresultaten. Strömmen
ConvertAsyncreturnerar är poolad; att disponera den returnerar dess buffertar till poolen.
Webbfarmar
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örhandsgranskningsbegäran 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 sparas (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 innehåll.
- På delningen behålls en uppladdning eller ett resultat i
Ttlefter att den skrivits; läsning förlänger inte detta fönster. FarmKeymåste vara minst 32 byte och identisk 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
Facaden och widget‑alternativen finns i namnrymden Doconut; ConversionTarget är i Doconut.Configs.Conversion. ConverterPlugin är 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);
}Hämtas via beroendeinjektion; 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älls 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 ger Converter, eller ta bort AddPlugin<ConverterPlugin>() |
AddDoconut() kastar AddConverterWidget() was called but the Converter plugin is not registered. | Widgeten är aktiverad utan sitt plugin | Lägg till options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>() |
Uppslagning av 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 ger inte Dicom | Använd en licens som ger Dicom |
| Utdata är vattenmärkt | Licensen är tillfällig (Demo/NFR) | Använd en betald licens som ger Converter |
Widgeten laddas men dess förfrågningar svarar 404 | AddConverterWidget() anropades inte, eller basePath matchar inte den gren 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 ger inte Dicom | Använd en licens som ger 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 gått ut, eller en webbfarmnod har inte uppladdningen | Öppna filen igen; i en farm, registrera AddDoconutDistributedWidgets |
| Widgeten misslyckas när UI:t är på en annan ursprung | Ändpunkterna 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 | Mikra mounten själv: #doconut-convert.dcw eller #doconut-convert |
Var den här sidan hjälpsam?