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.
| Superficie | 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 Converter stabile:
dotnet add package Doconut.NET8.ConverterPer fissare il plugin alla versione descritta in questa documentazione, passa la versione separatamente:
dotnet add package Doconut.NET8.Converter --version 26.10.0Mantieni 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:
apt-get update && apt-get install -y libfontconfig1Su 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.
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:
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 licenza | Avvio | Output di conversione |
|---|---|---|
Licenza viewer 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 | — |
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.
// Inietta DocumentConverter; il suo costruttore è interno, quindi non usare mai `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 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:
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 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:
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:
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
<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
| 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 genera 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 dei risultati 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 | Scatta quando | Dati |
|---|---|---|
onReady() | Il widget ha renderizzato la sua schermata inattiva/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 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:
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 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. |
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:
#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.
| 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 — 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:
| Rotta | Stato | Quando | Corpo |
|---|---|---|---|
| qualsiasi | 404 | Il widget non è abilitato (AddConverterWidget() non è mai stato chiamato) — verificato prima che una delle tre rotte venga inviata | 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, verificato 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 | Il caricamento 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: 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
- Installa il plugin accanto al pacchetto core, alla stessa versione:
dotnet add package Doconut.NET8.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. - Fornisci l'interfaccia utente dalla stessa origine dei endpoint Doconut, o effettua un reverse-proxy (vedi Crea la tua interfaccia).
- Rilascia i risultati della conversione. Lo stream
ConvertAsyncrestituito è 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():
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
Ttldopo essere stato scritto; la lettura non estende tale intervallo. FarmKeydeve essere di almeno 32 byte e identico su ogni nodo. Caricalo da un archivio segreto; non codificarlo mai direttamente. La registrazione genera unArgumentExceptionquandoRootPathè mancante oFarmKeyè più corto di 32 byte.- Imposta
RootPathsulla 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
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
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 | Soluzione |
|---|---|---|
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 versione | Installa 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 plugin | Aggiungi 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 è registrato | Aggiungi AddPlugin<ConverterPlugin>() all'interno di AddDoconut() |
| La conversione dello stream indica che il formato non è supportato | sourceExtension non ha il punto iniziale | Passa ".xlsx", non "xlsx" |
ConvertAsync lancia 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. | La destinazione non è una delle allowedTargets della sorgente | Offri 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 caricamento | Apri nuovamente il file; in una farm, registra AddDoconutDistributedWidgets |
| Il widget fallisce quando l'interfaccia è su un'altra origine | Gli endpoint non supportano CORS | Fornisci l'interfaccia dalla stessa origine, o effettua un reverse-proxy dei 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 |
Questa pagina è stata utile?