Plugin Convertitore
Converti documenti in 45 formati di destinazione
Il plugin Convertitore trasforma Doconut in un servizio di conversione di documenti. Contribuisce al motore dietro la facciata pubblica DocumentConverter, e — su opt-in — un widget incorporabile con il proprio contratto HTTP, così puoi convertire documenti da C#, dal widget, o da un frontend che scrivi tu stesso.
| Tipo | Quando 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 Convertitore stabile:
dotnet add package Doconut.NETStandard.ConverterPer fissare il plugin alla versione descritta in questa documentazione, passa la versione separatamente:
dotnet add package Doconut.NETStandard.Converter --version 26.10.0Mantieni il pacchetto Convertitore alla stessa versione di Doconut.NETStandard. L'ID del pacchetto è
Doconut.NETStandard.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.
Registra il plugin
Non esiste un metodo AddConverter() — il modello di plugin di Doconut è uniforme. Ogni plugin, incluso Convertitore, si registra allo stesso modo: chiama AddPlugin<TPlugin>() all'interno di AddDoconut(). ConverterPlugin è fornito nel suo pacchetto NuGet, Doconut.NETStandard.Converter, installato insieme al pacchetto base del visualizzatore.
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 opt-in separato, AddConverterWidget() (vedi Widget incorporabile).
Il plugin richiede una licenza che conceda la capacità Converter. Senza di essa, AddDoconut() genera un InvalidOperationException all'avvio, prima che l'app gestisca una richiesta:
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.Genera l'errore per assenza di licenza, un file legacy TRIAL, una licenza senza Converter, e 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 Impostazione licenza per come vengono caricate le licenze.
Licenze e filigrana
| Stato della licenza | Avvio | Output di conversione |
|---|---|---|
Licenza visualizzatore a pagamento che concede Converter, entro la sua finestra di versione | Avvia | Pulito — watermarked: false |
| Licenza temporanea attiva (Demo/NFR) | Avvia | Converte, con la filigrana di valutazione — watermarked: true |
| Licenza temporanea scaduta (Demo/NFR) | Avvia | Converte, 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 versione | AddDoconut() genera un errore | — |
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) richiede anche la capacità Dicom. Senza di essa, ConvertAsync genera un LicenseException (Converting '.dcm' requires the Dicom capability license.) e il open del widget risponde 403.
Utilizzo da C#
Ogni conversione restituisce un MemoryStream ricercabile 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.
// Inietta DocumentConverter; il suo costruttore è interno, quindi non usarlo mai con `new`.
Stream pdf = await converter.ConvertAsync("contract.docx", ConversionTarget.Pdf, ct: ct);// 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);Stream html = await converter.WordToHtmlAsync("report.docx", ct);// 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 nella sovraccarico 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, allo stesso modo 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 è risolto tramite l'iniezione delle dipendenze; non costruirlo né eliminarlo manualmente.
Formati di destinazione
ConversionTarget (namespace Doconut.Configs.Conversion) ha 45 membri:
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, IcoNon tutte le sorgenti si convertono in tutti i target — il plugin mappa la famiglia di formato di ogni sorgente (Word, Excel, PowerPoint, PDF, CAD, Immagine, Email, Diagramma, Progetto/Attività, 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 rigidamente questo enum come elenco di target della tua interfaccia: ?convert=open restituisce il reale allowedTargets per il file appena caricato, ed è questo che dovrebbe guidare un 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:
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 i valori predefiniti (MaxUploadMb = 25). Non concede diritti di conversione da solo: necessita AddPlugin<ConverterPlugin>(), altrimenti AddDoconut() genera un'eccezione:
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 stesso viene comunque servito (è una semplice risorsa statica incorporata; solo gli endpoint a cui si collega sono protetti).
Incorporalo
<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) prende 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, anteprima il risultato quando è possibile e offre il download.
Opzioni
| Opzione | Tipo | Predefinito | Note |
|---|---|---|---|
basePath | string | /doconut | Percorso base per gli endpoint ?convert=; deve corrispondere al ramo ASP.NET dove UseDoconut() è effettivamente montato (normalmente coordinato tramite MiddlewarePath) |
resPath | string | /doconut-res | Accettato per coerenza di configurazione con altri widget Doconut; il widget convertitore attualmente non costruisce alcun URL da esso |
maxUploadMb | number | 25 | Solo 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 |
licenseUrl | string | null | null | Quando impostato, trasforma l'avviso di filigrana nella schermata del risultato in un collegamento a questo URL |
labels | object | {} | Sovrascrive qualsiasi sottoinsieme delle stringhe predefinite in inglese del widget (testo di drop, pulsanti, annunci aria-live, messaggi di errore) |
Callback
| Callback | Scatena quando | Dati |
|---|---|---|
onReady() | Il widget ha renderizzato la sua schermata idle/drop | — |
onSourceLoaded({ token, pages, sourceExt, allowedTargets }) | ?convert=open ha successo | token di sessione sorgente, conteggio pagine, estensione sorgente (senza punto iniziale), elenco dei target consentiti |
onConverted({ downloadToken, resultToken, resultPages, downloadName, watermarked, target }) | ?convert=run ha successo | stessi campi della risposta di esecuzione, più il target richiesto |
onDownload({ downloadName, downloadToken }) | L'utente fa clic sul collegamento Download | si attiva insieme al download nativo del browser — non lo intercetta né lo sostituisce |
onError({ phase, message }) | Una richiesta di apertura o esecuzione fallisce | phase è 'open' o 'run'; message è l'errore del server sanitizzato (o un messaggio lato client per il pre-controllo della dimensione di upload) |
Una callback che genera un'eccezione viene catturata e registrata; non interrompe mai il flusso del widget.
Gestore imperativo
Doconut.convert() restituisce l'istanza del widget stessa — tienila per controllare il widget programmaticamente:
const conv = Doconut.convert('#doconut-convert', { basePath: '/doconut' });
const file = document.querySelector('#picker').files[0]; // un File dal tuo proprio <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 questoEtichette
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'.
| Chiave | Predefinito inglese |
|---|---|
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. |
Altri 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 carattere dalle proprietà personalizzate CSS, così puoi tematizzarlo senza toccare il suo interno:
#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 carattere 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 con 404 finché non viene chiamato AddConverterWidget(). Gli errori includono un corpo JSON, { "error": "..." }, tranne dove la tabella indica “solo stato”. Un valore ?convert= sconosciuto risponde con 400.
| Rotta | Scopo | Risposta di successo |
|---|---|---|
POST ?convert=open (multipart, one file) | Carica e apri un documento sorgente per l'anteprima | 200 — { token, pages, sourceExt, allowedTargets } |
POST ?token=<token>&convert=run&target=<ext> | Converti la sorgente archiviata in target | 200 — { downloadToken, resultToken, resultPages, downloadName, watermarked } |
GET ?convert=download&token=<downloadToken> | Trasmetti in streaming il file convertito | 200 — byte del file, Content-Disposition: attachment, Cache-Control: no-store |
sourceExt nella risposta open non ha il punto iniziale (es. "docx") — la convenzione opposta rispetto al 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 sorgente caricati vengono archiviati sul server e conservati per 30 minuti dopo l'ultima lettura; una volta scaduto questo intervallo, run risponde con 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:
| Rotta | Stato | Quando | Corpo |
|---|---|---|---|
| qualsiasi | 404 | Il widget non è abilitato (AddConverterWidget() non è mai stato chiamato) — verificato prima che venga invocata una delle tre rotte | solo stato |
| qualsiasi | 405 | Verbo HTTP errato (open/run richiedono POST; download richiede GET) | solo stato |
open | 400 | Caricamento non multipart | Expected a multipart file upload. |
open | 400 | Nessun file, o un file vuoto | No file uploaded. |
open | 400 | Un'estensione sorgente che non può essere convertita | This file type cannot be converted. |
open | 403 | Il 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. |
open | 413 | Il file caricato supera MaxUploadMb, controllato rispetto a Content-Length e durante la lettura del caricamento | File is too large. |
run | 400 | Token malformato (non è un GUID) | Invalid token. |
run | 400 | Un target che non si analizza in un ConversionTarget | Unknown target format. |
run | 400 | target non è presente nel allowedTargets della sorgente | That target format is not available for this file. |
run | 404 | L'upload archiviato è scaduto o il token non è mai stato aperto | Upload expired — please re-open the file. |
open, run | 500 | Elaborazione fallita internamente | Un messaggio sanificato — sanificato allo stesso modo di tutti gli altri percorsi di errore Doconut; non espone mai dettagli interni |
download | 400 | Token malformato (non è un GUID) | solo stato |
download | 404 | Token di download sconosciuto o scaduto | solo stato |
Un ciclo completo con fetch:
// file: the File to convert, for example from an <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 stessa origine: questa versione non supporta CORS. Servi la tua UI e lo script del widget dalla stessa origine di Doconut, oppure fai da reverse-proxy a entrambi i percorsi /doconut (il percorso del middleware e il percorso delle risorse) sotto l'origine della tua UI.
In produzione
- Installa il plugin accanto al pacchetto core, alla stessa versione:
dotnet add package Doconut.NETStandard.Converter. - Aggiungi il file di licenza. Metti
Doconut.Viewer.Converter.licnella stessa cartella diDoconut.Viewer.lic. - Imposta il limite del server.
MaxUploadMbinAddConverterWidgetè il limite imposto dal server; ilmaxUploadMbdel widget è solo un controllo lato client. Mantieni i due uguali. - Servi l'interfaccia UI dalla stessa origine dei endpoint Doconut, oppure usa un reverse-proxy (vedi Costruisci il tuo frontend).
- Rilascia i risultati della conversione. Lo stream
ConvertAsyncrestituito è in pool; rilasciandolo i suoi buffer tornano 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 una sola volta il negozio widget condiviso e criptato, dopo AddDoconut():
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 caricamento viene conservato (il valore predefinito)
});- Un singolo server non ha bisogno di nulla: senza questa chiamata viene usato lo store in memoria.
- Caricamenti e risultati sono criptati a riposo sulla condivisione (AES-256, encrypt-then-MAC), e ogni file è legato al suo token, così un token non può mai leggere il file di un altro.
- Sulla condivisione, un caricamento o un risultato viene conservato per
Ttldopo essere stato scritto; leggerlo non estende tale finestra. FarmKeydeve essere di almeno 32 byte e identico su ogni nodo. Caricalo da un secret store; non codificarlo mai in modo statico. La registrazione genera unArgumentExceptionquandoRootPathè mancante oFarmKeyè più corto di 32 byte.- Imposta
RootPathsulla stessa posizione condivisa usata 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
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 dependency injection; 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
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
| Sintomo | Causa | Correzione |
|---|---|---|
AddDoconut() genera 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 versione | Installa una licenza che concede Converter, o rimuovi AddPlugin<ConverterPlugin>() |
AddDoconut() genera AddConverterWidget() was called but the Converter plugin is not registered. | Il widget è abilitato senza il suo plugin | Aggiungi options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>() |
Risoluzione di DocumentConverter genera No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>(). | ConverterPlugin non è registrato | Aggiungi AddPlugin<ConverterPlugin>() dentro AddDoconut() |
| La conversione dello stream indica che il formato non è supportato | sourceExtension non ha il punto iniziale | Passa ".xlsx", non "xlsx" |
ConvertAsync genera Converting '.dcm' requires the Dicom capability license. | Una sorgente DICOM, e la licenza non concede Dicom | Usa una licenza che concede Dicom |
| L'output è contrassegnato da filigrana | La licenza è temporanea (Demo/NFR) | Usa una licenza a pagamento che concede Converter |
Il widget si carica ma le sue richieste rispondono 404 | AddConverterWidget() non è stato chiamato, o basePath non corrisponde al ramo dove UseDoconut() è montato | Chiama AddConverterWidget(); correggi basePath |
open risponde 403 Converting this file type requires the Dicom capability license. | Un caricamento DICOM, e la licenza non concede Dicom | Usa una licenza che concede Dicom |
open risponde 413 File is too large. | Il caricamento supera MaxUploadMb | Genera MaxUploadMb in AddConverterWidget; il maxUploadMb del widget è solo un controllo lato client |
run risponde 400 That target format is not available for this file. | Il target non è uno dei allowedTargets della sorgente | Offri solo i 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 caricamento | Apri nuovamente il file; in una farm, registra AddDoconutDistributedWidgets |
| Il widget fallisce quando l'UI è su un'altra origine | Gli endpoint non supportano CORS | Servi l'UI dalla stessa origine, oppure usa un reverse-proxy per i percorsi Doconut |
| Il tema non viene applicato | Le variabili sono impostate su un antenato o su un elemento all'interno del mount; la regola .dcw del widget le imposta sul mount | Mira direttamente il mount: #doconut-convert.dcw o #doconut-convert |
Note sul framework
viewer.Converter.GetConverter()non esiste qui. La conversione non è più raggiunta tramite l'istanza del visualizzatore: iniettareDoconut.DocumentConverterinvece.- Questo enum
ConversionTargetcopre ogni famiglia di sorgente. La libreria precedente aveva un tipo*ConfigConverterper famiglia —WordConfigConverter,ExcelConfigConverter, e così via — ognuno con il proprio enum annidatoEnTargetFormat, più un enumSourceFormatConverterper l'input. Tutti sono scomparsi; vedi la guida alla migrazione. - Solo Windows, come il resto del pacchetto .NET Standard.
Questa pagina è stata utile?