Plugin di Conversione

Converti documenti in 45 formati di destinazione

Il plugin Converter trasforma Doconut in un servizio di conversione di documenti. Contribuisce al motore dietro la facciata pubblica DocumentConverter, e — opzionale — un widget integrabile con il proprio contratto HTTP, così puoi convertire documenti da C#, dal widget o da un frontend che scrivi tu stesso.

SuperficieQuando usarlo
DocumentConverter (C#)Converti sul server, senza coinvolgere il browser
Drop-in widget (doconutConverter.js)Vuoi una schermata pronta per caricare, convertire e scaricare nella tua pagina
HTTP endpoints (?convert=open|run|download)Costruisci la tua interfaccia di conversione contro un contratto server documentato

Installa il pacchetto

Installa l'ultimo plugin Converter stabile:

bash
dotnet add package Doconut.NET8.Converter

Per fissare il plugin alla versione descritta in questa documentazione, passa la versione separatamente:

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

Mantieni il pacchetto Converter alla stessa versione di Doconut.NET8. L'ID del pacchetto è Doconut.NET8.Converter; .<version> appare solo nel nome file scaricato .nupkg.

Il file di licenza del plugin, Doconut.Viewer.Converter.lic, va nella stessa cartella di Doconut.Viewer.lic; viene letto insieme alla licenza del visualizzatore.

Piattaforme. Il plugin funziona ovunque Doconut.NET8 funzioni: Windows e Linux basato su glibc su x64 (non Alpine o altre distribuzioni basate su musl). Su Linux, installa la libreria di configurazione dei font prima che il primo documento si apra:

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

Su RHEL, Fedora e distribuzioni simili il pacchetto è fontconfig. Senza di esso, l'apertura di un documento fallisce con The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation.

Registra il plugin

Non esiste un metodo AddConverter() — il modello di plugin di Doconut è uniforme. Ogni plugin, incluso Converter, si registra allo stesso modo: chiama AddPlugin<TPlugin>() all'interno di AddDoconut(). ConverterPlugin è fornito nel suo pacchetto NuGet, Doconut.NET8.Converter, installato accanto al pacchetto del visualizzatore di base.

csharp
builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
    options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
});

Questo è tutto ciò di cui ha bisogno la facciata C#. Il widget e i suoi endpoint HTTP sono un'opzione separata, AddConverterWidget() (vedi Widget integrabile).

Il plugin necessita di una licenza che conceda la capacità Converter. Senza di essa, AddDoconut() genera un InvalidOperationException all'avvio, prima che l'app risponda a una richiesta:

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.

Viene generato per assenza di licenza, per un file legacy TRIAL, per una licenza priva di Converter, e per una licenza a pagamento usata al di fuori della sua finestra di versione. Le licenze temporanee Demo/NFR sono accettate. Non esiste un livello gratuito silenzioso. Vedi Configurazione licenza per come vengono caricate le licenze.

Licenze e filigrana

Stato licenzaAvvioOutput di conversione
Licenza viewer a pagamento che concede Converter, entro la sua finestra di versioneAvviaPulito — watermarked: false
Licenza temporanea attiva (Demo/NFR)AvviaConverte, con la filigrana di valutazione — watermarked: true
Licenza temporanea scaduta (Demo/NFR)AvviaConverte, con la filigrana di valutazione — watermarked: true
Nessuna licenza, un file legacy TRIAL, una licenza senza Converter, o una licenza a pagamento al di fuori della sua finestra di versioneAddDoconut() genera—

Entrambi i percorsi di chiamata calcolano il flag dalla stessa regola: la facciata C# DocumentConverter lo deriva internamente dallo stato IsViewerLicensed e IsTemporary della licenza, e il gestore ?convert=run del widget esegue il controllo equivalente (IsViewerLicensed && !IsTrial && !IsTemporary) per riempire il campo watermarked che restituisce. Un'integrazione può essere costruita e testata end-to-end su una licenza di valutazione prima dell'acquisto — solo i byte di output cambiano.

Una sorgente DICOM (.dcm, .ima) necessita anche della capacità Dicom. Senza di essa, ConvertAsync genera un LicenseException (Converting '.dcm' requires the Dicom capability license.) e le risposte del open del widget sono 403.

Utilizzo da C#

Ogni conversione restituisce un MemoryStream seekable posizionato a 0, pronto per essere letto o copiato immediatamente. Risolvi DocumentConverter dal DI ovunque ne abbia bisogno — è senza stato per progettazione, quindi una singola istanza è sicura da riutilizzare tra le richieste.

csharp
// Inietta DocumentConverter; il suo costruttore è interno, quindi non usare mai `new`.
Stream pdf = await converter.ConvertAsync("contract.docx", ConversionTarget.Pdf, ct: ct);
csharp
// sourceExtension include il punto iniziale. password è null a meno che il documento non sia protetto.
Stream png = await converter.ConvertAsync(stream, ".xlsx", ConversionTarget.Png, password: null, ct: ct);
csharp
Stream html = await converter.WordToHtmlAsync("report.docx", ct);
csharp
// html: uno Stream che contiene l'HTML da riconvertire in un documento Word, ad esempio il risultato di WordToHtmlAsync.
Stream docx = await converter.HtmlToWordAsync(html, ConversionTarget.Docx, ct);

Due dettagli facili da sbagliare: sourceExtension sull'overload dello stream deve includere il punto iniziale (".xlsx", non "xlsx") — il convertitore lo confronta con il catalogo dei formati e un'estensione senza punto non verrà risolta. E nonostante il nome, WordToHtmlAsync restituisce Task<Stream>, non Task<string> — ottieni il documento HTML (immagini incorporate come Base64) come stream, lo stesso di ogni altro risultato di conversione.

Il chiamante possiede lo stream restituito e dovrebbe eliminarlo dopo averlo copiato o restituito il suo contenuto. Il servizio DocumentConverter stesso viene risolto tramite dependency injection; non costruirlo né eliminarlo manualmente.

Formati di destinazione

ConversionTarget (namespace Doconut.Configs.Conversion) ha 45 membri:

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

Non tutte le sorgenti si convertono in tutti i target — il plugin mappa la famiglia di formati di ciascuna sorgente (Word, Excel, PowerPoint, PDF, CAD, Image, Email, Diagram, Project/Task, PSD, documento web, DICOM) al proprio insieme fisso di target consentiti. Convertire una sorgente DICOM (.dcm, .ima) richiede anche una licenza che conceda la capacità Dicom; i suoi target sono Pdf, Png, Jpeg, Bmp, Tiff e Gif. Non codificare in modo statico questo enum come elenco di target della tua UI: ?convert=open restituisce il allowedTargets reale per qualsiasi file appena caricato, ed è questo che dovrebbe guidare il selettore.

Widget integrabile

Abilita gli endpoint

Gli endpoint ?convert=open|run|download del widget sono opzionali e disabilitati di default — sicuri per impostazione predefinita. Abilitali lato server, insieme alla registrazione del plugin:

csharp
builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
    options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
    options.AddConverterWidget(widget =>
    {
        widget.MaxUploadMb = 25;
    });
});

AddConverterWidget() senza argomenti abilita il widget con le impostazioni predefinite (MaxUploadMb = 25). Non concede i diritti di conversione da solo: necessita di AddPlugin<ConverterPlugin>(), altrimenti AddDoconut() genera un'eccezione:

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.

Senza AddConverterWidget(), i tre endpoint ?convert= rispondono con 404 — ma il file JS viene comunque servito (è una semplice risorsa statica incorporata; solo gli endpoint a cui si collega sono protetti).

Incorporalo

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) accetta un selettore CSS o un elemento, genera un'eccezione se il mount non viene trovato e restituisce un handle. Il widget carica un file, mostra un'anteprima della pagina 1, consente all'utente di scegliere uno dei allowedTargets, converte, visualizza l'anteprima del risultato quando possibile e offre il download.

Opzioni

OpzioneTipoPredefinitoNote
basePathstring/doconutPercorso base per gli endpoint ?convert=; deve corrispondere al ramo ASP.NET dove UseDoconut() è effettivamente montato (normalmente coordinato tramite MiddlewarePath)
resPathstring/doconut-resAccettato per coerenza di configurazione con altri widget Doconut; il widget convertitore attualmente non genera alcun URL da esso
maxUploadMbnumber25Solo pre‑controllo lato client — rifiuta un file troppo grande prima del caricamento. Il server applica il proprio limite in modo indipendente e risponde 413 se viene superato
licenseUrlstring | nullnullQuando impostato, trasforma l'avviso di filigrana nella schermata dei risultati in un collegamento a questo URL
labelsobject{}Sovrascrive qualsiasi sottoinsieme delle stringhe predefinite in inglese del widget (testo di drop, pulsanti, annunci aria‑live, messaggi di errore)

Callback

CallbackScatta quandoDati
onReady()Il widget ha renderizzato la sua schermata inattiva/drop—
onSourceLoaded({ token, pages, sourceExt, allowedTargets })?convert=open ha successotoken di sessione sorgente, conteggio pagine, estensione sorgente (senza punto iniziale), elenco dei target consentiti
onConverted({ downloadToken, resultToken, resultPages, downloadName, watermarked, target })?convert=run ha successostessi campi della risposta di esecuzione, più il target richiesto
onDownload({ downloadName, downloadToken })L'utente fa clic sul collegamento Downloadsi attiva insieme al download nativo del browser — non lo intercetta né lo sostituisce
onError({ phase, message })Una richiesta di apertura o esecuzione falliscephase è 'open' o 'run'; message è l'errore del server sanificato (o un messaggio lato client per il pre‑controllo della dimensione di upload)

Un callback che genera un'eccezione viene catturato e registrato; non interrompe mai il flusso del widget.

Gestore imperativo

Doconut.convert() restituisce l'istanza stessa del widget — tienila a portata di mano per controllare il widget programmaticamente:

javascript
const conv = Doconut.convert('#doconut-convert', { basePath: '/doconut' });
const file = document.querySelector('#picker').files[0]; // un File dal tuo <input type="file" id="picker">
conv.reset();         // torna alla schermata idle/drop; non riattiva onReady
conv.loadFile(file);  // avvia il flusso con un oggetto File; nessuna operazione a meno che non sia attualmente idle
conv.destroy();       // rimuove i listener, svuota il mount; l'istanza non è più utilizzabile dopo questo

Etichette

Ogni stringa ha un valore predefinito in inglese; labels sovrascrive qualsiasi sottoinsieme e il resto rimane in inglese. I frammenti che cambiano a runtime usano {placeholders}, come uploading: 'Uploading {name}…' e pages: '{n} pages'.

ChiavePredefinito inglese
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.

Altre chiavi coprono il aria-label della zona di drop (dropAriaLabel), i testi di anteprima alt (previewAlt, resultAlt), la forma collegata dell'avviso di filigrana usata con licenseUrl (watermarkNoticePrefix, watermarkNoticeLink, watermarkNoticeSuffix), una risposta illeggibile (badResponse) e gli annunci aria-live (annReady, annUploading, annLoaded, annLoadedNoTargets, annConverting, annDone, annError).

Un errore JSON dal server viene mostrato così com'è stato scritto dal server; serverError è usato solo quando una risposta fallita non contiene un errore JSON, come il 404 di un widget disabilitato.

Tematizzazione

Il widget aggiunge la classe dcw al suo elemento di montaggio e legge i suoi colori, raggio e font dalle proprietà personalizzate CSS, così puoi tematizzarlo senza toccare i suoi componenti interni:

css
#doconut-convert.dcw {
  --dcw-accent: #6b46c1;
  --dcw-radius: 12px;
  --dcw-font: "Inter", system-ui, sans-serif;
}

Valori predefiniti: --dcw-accent: #2b6cb0, --dcw-bg: #ffffff, --dcw-fg: #1a202c, --dcw-muted: #718096, --dcw-border: #cbd5e0, --dcw-radius: 8px, e un font di sistema UI per --dcw-font.

Costruisci il tuo frontend

Il widget è solo un client per questo contratto HTTP — costruisci il tuo frontend direttamente contro di esso per un'esperienza utente diversa. Tutte e tre le rotte si trovano sotto il ramo ASP.NET dove UseDoconut() è montato (normalmente /doconut), e rispondono 404 fino a quando AddConverterWidget() viene chiamato. Gli errori includono un corpo JSON, { "error": "..." }, tranne dove la tabella indica "status only". Un valore ?convert= sconosciuto risponde 400.

RottaScopoRisposta di successo
POST ?convert=open (multipart, one file)Carica e apri un documento sorgente per l'anteprima200 — { token, pages, sourceExt, allowedTargets }
POST ?token=<token>&convert=run&target=<ext>Converti la sorgente archiviata in target200 — { downloadToken, resultToken, resultPages, downloadName, watermarked }
GET ?convert=download&token=<downloadToken>Trasmetti in streaming il file convertito200 — file bytes, Content-Disposition: attachment, Cache-Control: no-store

sourceExt nella risposta open non ha il punto iniziale (ad es. "docx") — è l'opposto della convenzione del parametro sourceExtension su DocumentConverter.ConvertAsync, che ne richiede uno. allowedTargets elenca i nomi target in minuscolo ("pdf", "html", …); passa uno di essi come target, che viene confrontato senza distinzione tra maiuscole e minuscole. open utilizza il primo file nel corpo multipart.

resultToken è null, e resultPages è 0, quando il risultato non può essere visualizzato in anteprima. downloadName è il nome del file sorgente con l'estensione del target.

Le immagini di anteprima utilizzano la rotta standard dell'immagine del visualizzatore, {basePath}?token={token}&page=1&thumb=1&width={px}, con il token da open o il resultToken da run. Il widget richiede width=240.

I byte della sorgente caricata vengono archiviati sul server e conservati per 30 minuti dopo l'ultima lettura; una volta scaduto questo intervallo, run risponde 404 e il file deve essere riaperto. Il risultato convertito vive nello stesso archivio — downloadToken ottiene la sua nuova finestra di 30 minuti al completamento della conversione — mentre resultToken è un normale token di sessione del visualizzatore per l'anteprima del risultato. Quando il risultato può essere visualizzato in anteprima, downloadToken e resultToken hanno lo stesso valore. Chiudere un risultato del visualizzatore non elimina un archivio di download ancora valido, e il reset del widget del browser non estende nessuna delle due finestre.

Modalità di errore, raggruppate per rotta:

RottaStatoQuandoCorpo
qualsiasi404Il widget non è abilitato (AddConverterWidget() non è mai stato chiamato) — verificato prima che una delle tre rotte venga inviatasolo stato
qualsiasi405Verbo HTTP errato (open/run richiedono POST; download richiede GET)solo stato
open400Caricamento non multipartExpected a multipart file upload.
open400Nessun file, o un file vuotoNo file uploaded.
open400Un'estensione sorgente che non può essere convertitaThis file type cannot be converted.
open403Il tipo di file richiede una capacità che la licenza non concede (un file DICOM senza Dicom)Converting this file type requires the Dicom capability license.
open413Il file caricato supera MaxUploadMb, verificato rispetto a Content-Length e durante la lettura del caricamentoFile is too large.
run400Token malformato (non è un GUID)Invalid token.
run400Un target che non si analizza in un ConversionTargetUnknown target format.
run400target non è presente nel allowedTargets della sorgenteThat target format is not available for this file.
run404Il caricamento archiviato è scaduto o il token non è mai stato apertoUpload expired — please re-open the file.
open, run500Elaborazione fallita internamenteUn messaggio sanificato — sanificato allo stesso modo di tutti gli altri percorsi di errore Doconut; non espone mai dettagli interni
download400Token malformato (non è un GUID)solo stato
download404Token di download sconosciuto o scadutosolo stato

Un ciclo completo con fetch:

javascript
// file: il File da convertire, ad esempio da un <input type="file">.
async function convertFile(file) {
  const base = '/doconut';

  // 1. open: carica il file
  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: converti in PDF quando è consentito, altrimenti al primo target consentito
  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: un semplice GET che il browser può seguire
  window.location.href = base + '?convert=download&token=' + encodeURIComponent(converted.downloadToken);
}

Gli endpoint sono same-origin: questa versione non supporta CORS. Servi la tua UI e lo script del widget dalla stessa origine di Doconut, oppure fai il reverse-proxy di entrambi i percorsi /doconut (il percorso del middleware e il percorso delle risorse) sotto l'origine della tua UI.

In produzione

  1. Installa il plugin accanto al pacchetto core, alla stessa versione: dotnet add package Doconut.NET8.Converter.
  2. Aggiungi il file di licenza. Metti Doconut.Viewer.Converter.lic nella stessa cartella di Doconut.Viewer.lic.
  3. Imposta il limite del server. MaxUploadMb in AddConverterWidget è il limite imposto dal server; il maxUploadMb del widget è solo un controllo lato client. Mantieni i due uguali.
  4. Fornisci l'interfaccia utente dalla stessa origine dei endpoint Doconut, o effettua un reverse-proxy (vedi Crea la tua interfaccia).
  5. Rilascia i risultati della conversione. Lo stream ConvertAsync restituito è in pool; rilasciandolo si restituiscono i buffer al pool.

Web farm

Il widget conserva ogni caricamento e il relativo risultato in memoria sul nodo che ha servito open. Dietro un bilanciatore di carico senza sessioni sticky, una successiva richiesta run, download o di anteprima può raggiungere un altro nodo e non trovare il caricamento. Registra il negozio widget condiviso e crittografato una sola volta, dopo AddDoconut():

csharp
byte[] farmKey = Convert.FromBase64String(builder.Configuration["Doconut:FarmKey"]);

builder.Services.AddDoconutDistributedWidgets(store =>
{
    store.RootPath = @"\\fileshare\doconut";   // una cartella che ogni nodo può leggere e scrivere
    store.FarmKey = farmKey;                   // almeno 32 byte, identico su ogni nodo
    // store.Ttl = TimeSpan.FromMinutes(30);   // per quanto tempo un upload viene conservato (il valore predefinito)
});
  • Un singolo server non ha bisogno di nulla: senza questa chiamata viene usato il negozio in memoria.
  • I caricamenti e i risultati sono crittografati a riposo sulla condivisione (AES-256, encrypt-then-MAC), e ogni file è legato al suo token, quindi un token non può mai leggere il file di un altro.
  • Sulla condivisione, un caricamento o un risultato viene conservato per Ttl dopo essere stato scritto; la lettura non estende tale intervallo.
  • FarmKey deve essere di almeno 32 byte e identico su ogni nodo. Caricalo da un archivio segreto; non codificarlo mai direttamente. La registrazione genera un ArgumentException quando RootPath è mancante o FarmKey è più corto di 32 byte.
  • Imposta RootPath sulla stessa posizione condivisa utilizzata dal visualizzatore distribuito.

Riferimento API

La facciata e le opzioni del widget si trovano nello spazio dei nomi Doconut; ConversionTarget è in Doconut.Configs.Conversion. ConverterPlugin è in 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);
}

Risolto tramite iniezione delle dipendenze; il costruttore è interno. sourceExtension include il punto iniziale. HtmlToWordAsync scrive un file .doc quando outputFormat è ConversionTarget.Doc, e un file .docx per qualsiasi altro valore.

ConversionTarget

I 45 formati di output elencati in Formati di destinazione.

ConverterWidgetOptions

csharp
public sealed class ConverterWidgetOptions
{
    public int MaxUploadMb { get; set; } = 25;
}

Impostato tramite DoconutOptions.AddConverterWidget(Action<ConverterWidgetOptions>? configure = null), che restituisce il DoconutOptions così le chiamate possono essere concatenate.

Risoluzione dei problemi

SintomoCausaSoluzione
AddDoconut() lancia The Converter plugin is registered via AddPlugin but no active license grants Converter.Nessuna licenza, un file TRIAL, una licenza senza Converter, o una licenza a pagamento al di fuori della sua finestra di versioneInstalla una licenza che concede Converter, oppure rimuovi AddPlugin<ConverterPlugin>()
AddDoconut() lancia AddConverterWidget() was called but the Converter plugin is not registered.Il widget è abilitato senza il suo pluginAggiungi options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>()
Risoluzione di DocumentConverter lancia No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>().ConverterPlugin non è registratoAggiungi AddPlugin<ConverterPlugin>() all'interno di AddDoconut()
La conversione dello stream indica che il formato non è supportatosourceExtension non ha il punto inizialePassa ".xlsx", non "xlsx"
ConvertAsync lancia Converting '.dcm' requires the Dicom capability license.Una sorgente DICOM, e la licenza non concede DicomUsa una licenza che concede Dicom
L'output è contrassegnato da filigranaLa licenza è temporanea (Demo/NFR)Usa una licenza a pagamento che concede Converter
Il widget si carica ma le sue richieste rispondono 404AddConverterWidget() non è stato chiamato, o basePath non corrisponde al ramo dove UseDoconut() è montatoChiama AddConverterWidget(); correggi basePath
open risponde 403 Converting this file type requires the Dicom capability license.Un caricamento DICOM, e la licenza non concede DicomUsa una licenza che concede Dicom
open risponde 413 File is too large.Il caricamento supera MaxUploadMbGenera MaxUploadMb in AddConverterWidget; il maxUploadMb del widget è solo un controllo lato client
run risponde 400 That target format is not available for this file.La destinazione non è una delle allowedTargets della sorgenteOffri solo le allowedTargets da open
run o download risponde 404 (Upload expired — please re-open the file. da run)La finestra di 30 minuti è scaduta, o un nodo della web farm non ha il caricamentoApri nuovamente il file; in una farm, registra AddDoconutDistributedWidgets
Il widget fallisce quando l'interfaccia è su un'altra origineGli endpoint non supportano CORSFornisci l'interfaccia dalla stessa origine, o effettua un reverse-proxy dei percorsi Doconut
Il tema non viene applicatoLe variabili sono impostate su un antenato o su un elemento all'interno del mount; la regola .dcw del widget le imposta sul mountMira direttamente il mount: #doconut-convert.dcw o #doconut-convert

Questa pagina è stata utile?