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 — a un widget integrabile servito da DocImage.axd, 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 |
Widget integrabile (doconutConverter.js) | Vuoi una schermata pronta per caricare, convertire e scaricare nella tua pagina |
Endpoint HTTP su DocImage.axd (?convert=open|run|download) | Costruisci la tua interfaccia di conversione contro un contratto server documentato |
Installa il pacchetto
Install-Package Doconut.NETFramework.ConverterPer fissare il plugin alla versione descritta in questa documentazione:
Install-Package Doconut.NETFramework.Converter -Version 26.10.0Mantieni il pacchetto Converter alla stessa versione di Doconut.NETFramework.
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
Tutti i plugin si registrano allo stesso modo: AddPlugin<TPlugin>() in DoconutHost.Initialize, chiamato da Application_Start.
Doconut.DoconutHost.Initialize(options =>
{
options.LicensePath = HostingEnvironment.MapPath("~/wwwroot/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, DoconutHost.Initialize genera un'eccezione da Application_Start:
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.In System.Web ciò significa che ogni richiesta restituisce un 500 vuoto, e il motivo è solo nel registro eventi di Windows (origine ASP.NET). Genera un'eccezione per mancanza di licenza, un file legacy TRIAL, una licenza senza Converter, e una licenza a pagamento usata fuori dalla sua finestra di versione. Le licenze temporanee Demo/NFR sono accettate. Vedi Configurazione licenza.
Licenze e filigrana
| Stato della licenza | Avvio | Output della 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 fuori dalla sua finestra di versione | Application_Start genera un'eccezione; ogni richiesta restituisce un 500 vuoto | — |
La facciata DocumentConverter e il gestore ?convert=run del widget applicano la stessa regola. 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 il open del widget risponde 403.
Uso da C#
Ogni conversione restituisce un MemoryStream ricercabile posizionato a 0. DocumentConverter è senza stato: risolvilo da DoconutHost.Services ovunque ne hai bisogno e riutilizzalo liberamente.
// Risolvi DocumentConverter da DoconutHost.Services; 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 trasformare nuovamente in un documento Word, come il risultato di WordToHtmlAsync.
Stream docx = await converter.HtmlToWordAsync(html, ConversionTarget.Docx, ct);Due dettagli facili da sbagliare: sourceExtension sul sovraccarico dello stream deve includere il punto iniziale (".xlsx", non "xlsx"), altrimenti non si risolve. E nonostante il nome, WordToHtmlAsync restituisce Task<Stream>, non Task<string> — il documento HTML (immagini incorporate come Base64) arriva come stream, come ogni altro risultato.
Il chiamante possiede il MemoryStream restituito da una conversione e dovrebbe eliminarlo dopo averlo copiato o restituito (l'File(stream, …) di MVC lo elimina per te). Non costruire o eliminare DocumentConverter da solo — il suo costruttore è interno.
In un controller MVC 5
Rendi l'azione asincrona e await la conversione:
[HttpPost]
public async Task<ActionResult> ToPdf(HttpPostedFileBase file)
{
var converter = Doconut.DoconutHost.Services.GetRequiredService<DocumentConverter>();
Stream pdf = await converter.ConvertAsync(
file.InputStream, Path.GetExtension(file.FileName), ConversionTarget.Pdf,
password: null, ct: Response.ClientDisconnectedToken);
return File(pdf, "application/pdf", Path.GetFileNameWithoutExtension(file.FileName) + ".pdf");
}In Web Forms: non bloccare mai una conversione
Una pagina Web Forms viene eseguita in un contesto di richiesta a thread singolo. ConvertAsync riprende su quel contesto al completamento, quindi una pagina che lo attende in modo sincrono — .Result, .Wait(), .GetAwaiter().GetResult() — trattiene il thread di cui la conversione ha bisogno per terminare. La richiesta non ritorna mai. Il browser continua a girare, IIS non registra nulla, e il resto del sito continua a funzionare, quindi sembra una conversione lenta piuttosto che un deadlock.
Segna la pagina Async="true" e avvia la conversione come attività asincrona della pagina:
<%@ Page Language="C#" Async="true" CodeBehind="Convert.aspx.cs" Inherits="MyApp.Convert" %>// Web Forms: la direttiva @Page richiede Async="true" e la conversione viene eseguita come un'attività asincrona della pagina.
// Bloccare su di esso invece (.Result, .Wait(), .GetAwaiter().GetResult()) causa un deadlock nella richiesta:
// non ritorna mai e non viene registrato nulla.
protected void Page_Load(object sender, EventArgs e)
{
if (!IsPostBack) return;
RegisterAsyncTask(new PageAsyncTask(async ct =>
{
var converter = Doconut.DoconutHost.Services.GetRequiredService<DocumentConverter>();
using (var pdf = await converter.ConvertAsync(
Server.MapPath("~/App_Data/contract.docx"), ConversionTarget.Pdf, ct: ct))
using (var ms = new MemoryStream())
{
if (pdf.CanSeek) pdf.Position = 0;
await pdf.CopyToAsync(ms);
Response.ContentType = "application/pdf";
Response.AddHeader("Content-Disposition", "attachment; filename=contract.pdf");
Response.BinaryWrite(ms.ToArray());
// Context, non HttpContext.Current: dopo un await quest'ultimo può essere null.
Context.ApplicationInstance.CompleteRequest();
}
}));
}Senza Async="true" nella direttiva @Page, RegisterAsyncTask viene ignorato silenziosamente. Dopo un await, usa il Context della pagina; HttpContext.Current può essere null lì.
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 formati di destinazione: ogni famiglia di formati della sorgente (Word, Excel, PowerPoint, PDF, CAD, Image, Email, Diagram, Project, PSD, documento web, DICOM) ha il proprio insieme di destinazioni consentite. Convertire una sorgente DICOM (.dcm, .ima) richiede anche una licenza che conceda la capacità Dicom; le sue destinazioni sono Pdf, Png, Jpeg, Bmp, Tiff e Gif. Non codificare in modo rigido questo enum come elenco di destinazioni della tua UI: ?convert=open restituisce il allowedTargets per il file caricato, e questo è ciò che dovrebbe guidare un selettore.
Widget integrabile
Abilita gli endpoint
Gli endpoint ?convert=open|run|download del widget sono forniti da DocImage.axd e sono disattivati per impostazione predefinita. Abilitali accanto alla registrazione del plugin:
Doconut.DoconutHost.Initialize(options =>
{
options.LicensePath = HostingEnvironment.MapPath("~/wwwroot/Doconut.Viewer.lic");
options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
options.AddConverterWidget(widget =>
{
widget.MaxUploadMb = 25;
});
});
// System.Web legge l'intero upload prima che Doconut lo veda: mantieni maxRequestLength (KB) e
// maxAllowedContentLength (byte) in Web.config al di sopra del MaxUploadMb del widget.AddConverterWidget() senza argomenti abilita il widget con i valori predefiniti (MaxUploadMb = 25). Non concede i diritti di conversione da solo: necessita di AddPlugin<ConverterPlugin>(), o DoconutHost.Initialize 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.Due cose da verificare quando il widget si comporta in modo errato:
basePath: '/DocImage.axd'. Il valore predefinito del widget,/doconut, è l'endpoint ASP.NET Core. In questo pacchetto, gli endpoint sono il gestoreDocImage.axddaWeb.config.- Lo script e gli endpoint sono indipendenti. Il modulo di risorse serve
doconutConverter.jsindipendentemente dal fatto che il widget sia abilitato o meno: senzaAddConverterWidget(), il widget si carica, disegna la sua zona di rilascio e appare completamente corretto — e la sua prima azione risponde404.
Limiti di caricamento
ASP.NET legge l'intero corpo della richiesta prima che DocImage.axd venga eseguito. Un caricamento superiore a MaxUploadMb ma inferiore ai limiti dell'host ottiene il JSON 413 del widget (File is too large.). Un caricamento superiore ai limiti dell'host viene prima rifiutato da IIS, con una pagina di errore che il widget non può leggere. Mantieni entrambi i limiti dell'host in Web.config al di sopra del limite del widget:
<system.web>
<httpRuntime maxRequestLength="30720" /> <!-- KILOBYTES: 30 MB -->
</system.web>
<system.webServer>
<security>
<requestFiltering>
<requestLimits maxAllowedContentLength="31457280" /> <!-- BYTES: 30 MB -->
</requestFiltering>
</security>
</system.webServer>Incorporalo
<div id="doconut-convert"></div>
<script src="/doconut-res/js/doconutConverter.js"></script>
<script>
Doconut.convert('#doconut-convert', { basePath: '/DocImage.axd', 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 | L'URL del endpoint. Imposta '/DocImage.axd' su questo pacchetto |
resPath | string | /doconut-res | Accettato per coerenza con altri widget Doconut; il widget convertitore non costruisce alcun URL da esso |
maxUploadMb | number | 25 | Solo pre-controllo lato client; il server applica il proprio limite |
licenseUrl | string | null | null | Trasforma l'avviso di watermark nella schermata del risultato in un collegamento |
labels | object | {} | Sovrascrive qualsiasi sottoinsieme delle stringhe inglesi del widget |
Callback
| Callback | Quando si attiva | Carico |
|---|---|---|
onReady() | Il widget ha renderizzato la sua schermata di drop | — |
onSourceLoaded({ token, pages, sourceExt, allowedTargets }) | ?convert=open ha avuto successo | Token di origine, conteggio pagine, estensione sorgente (senza punto iniziale), destinazioni consentite |
onConverted({ downloadToken, resultToken, resultPages, downloadName, watermarked, target }) | ?convert=run ha avuto successo | La risposta di esecuzione più il target richiesto |
onDownload({ downloadName, downloadToken }) | L'utente fa clic su Download | Si attiva insieme al download nativo del browser |
onError({ phase, message }) | Una richiesta di apertura o esecuzione fallisce | phase è 'open' o 'run'; message è l'errore del server sanitizzato |
Un callback che genera un'eccezione viene catturato e registrato; non interrompe mai il flusso del widget.
Handle imperativo
Doconut.convert() restituisce l'istanza del widget:
const conv = Doconut.convert('#doconut-convert', { basePath: '/DocImage.axd' });
const file = document.querySelector('#picker').files[0]; // un File dal tuo <input type="file" id="picker">
conv.reset(); // torna alla schermata di drop; non riattiva onReady
conv.loadFile(file); // avvia il flusso con un File; no-op a meno che il widget non sia nella sua schermata di drop
conv.destroy(); // rimuove i listener, svuota il mount; l'istanza è inutilizzabile 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 watermark 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ì come lo ha scritto il 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 è un client per questo contratto HTTP su DocImage.axd. Le rotte rispondono con 404 fino a quando AddConverterWidget() viene chiamato. Gli errori includono un corpo JSON, { "error": "..." }, eccetto dove la tabella indica "status only". Un valore ?convert= sconosciuto risponde con 400.
| Rotta | Scopo | Risposta di successo |
|---|---|---|
POST /DocImage.axd?convert=open (multipart, one file) | Carica e apri un documento sorgente | 200 — { token, pages, sourceExt, allowedTargets } |
POST /DocImage.axd?token=<token>&convert=run&target=<ext> | Converti il sorgente caricato in target | 200 — { downloadToken, resultToken, resultPages, downloadName, watermarked } |
GET /DocImage.axd?convert=download&token=<downloadToken> | Trasmetti in streaming il file convertito | 200 — il file, Content-Disposition: attachment, Cache-Control: no-store |
sourceExt nella risposta open non ha il punto iniziale ("docx") — l'opposto del parametro sourceExtension di ConvertAsync. allowedTargets elenca i nomi dei 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 usano la rotta standard dell'immagine del visualizzatore, /DocImage.axd?token={token}&page=1&thumb=1&width={px}, con il token da open o il resultToken da run. Il widget richiede width=240.
Le sorgenti caricate sono conservate per 30 minuti dopo l'ultimo accesso; dopo di ciò, run risponde con 404 e il file deve essere aperto nuovamente. downloadToken ottiene la propria finestra di 30 minuti al completamento della conversione. resultToken è un token di visualizzatore ordinario per l'anteprima del risultato; quando il risultato può essere visualizzato in anteprima, ha lo stesso valore di downloadToken.
| Rotta | Stato | Quando | Corpo |
|---|---|---|---|
| qualsiasi | 404 | Il widget non è abilitato (AddConverterWidget() non è mai stato chiamato) | solo stato |
| qualsiasi | 405 | Verbo 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 uno vuoto | No file uploaded. |
open | 400 | Un tipo che non può essere convertito | 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 caricamento supera MaxUploadMb (ma non i limiti IIS) | File is too large. |
run | 400 | Un token malformato (non un GUID) | Invalid token. |
run | 400 | Un target che non si analizza in un ConversionTarget | Unknown target format. |
run | 400 | Un target non presente in allowedTargets | That target format is not available for this file. |
run | 404 | Il caricamento è scaduto o non è mai stato aperto | Upload expired — please re-open the file. |
open, run | 500 | Elaborazione fallita | Un messaggio sanificato |
download | 400 / 404 | Un token di download malformato, 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 = '/DocImage.axd';
// 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 nel 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 utilizza un reverse-proxy per il gestore e i percorsi delle risorse sotto l'origine della tua UI.
In produzione
- Installa il plugin accanto al pacchetto core, alla stessa versione:
Install-Package Doconut.NETFramework.Converter. - Aggiungi il file di licenza. Metti
Doconut.Viewer.Converter.licnella stessa cartella diDoconut.Viewer.lic. - Imposta i limiti di caricamento.
MaxUploadMbinAddConverterWidgetè il limite imposto da Doconut; mantienimaxRequestLengthemaxAllowedContentLengthinWeb.configal di sopra di esso (vedi Limiti di caricamento), e ilmaxUploadMbdel widget uguale a esso. - Non bloccare mai una conversione in Web Forms (vedi In Web Forms).
- Rilascia i risultati della conversione. Lo stream restituito da
ConvertAsyncè in pool; rilasciandolo si restituiscono i suoi buffer al pool.
Web farm
La widget conserva ogni caricamento e il suo risultato in memoria sul server che ha servito open. Dietro un bilanciatore di carico senza sessioni sticky, una successiva richiesta run, download o di anteprima può raggiungere un altro server e non trovare il caricamento. Registra lo store widget condiviso e crittografato tramite il secondo argomento di DoconutHost.Initialize:
byte[] farmKey = Convert.FromBase64String(System.Configuration.ConfigurationManager.AppSettings["Doconut:FarmKey"]);
Doconut.DoconutHost.Initialize(
options =>
{
options.LicensePath = HostingEnvironment.MapPath("~/wwwroot/Doconut.Viewer.lic");
options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
options.AddConverterWidget();
},
services => services.AddDoconutDistributedWidgets(store =>
{
store.RootPath = @"\\fileshare\doconut"; // una cartella che ogni server può leggere e scrivere
store.FarmKey = farmKey; // almeno 32 byte, identico su ogni server
// store.Ttl = TimeSpan.FromMinutes(30); // per quanto tempo viene mantenuto un upload (il valore predefinito)
}));- Un singolo server non ha bisogno di nulla: senza questa chiamata viene usato lo store 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; leggerlo non estende tale finestra. FarmKeydeve essere di almeno 32 byte e lo stesso su ogni server. Caricalo da un secret store; non codificarlo mai. 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 da DoconutHost.Services; 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 | Risoluzione |
|---|---|---|
Ogni richiesta restituisce un 500 vuoto dopo aver aggiunto il plugin; il registro eventi di Windows (origine ASP.NET) mostra 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 conceda Converter, o rimuovi AddPlugin<ConverterPlugin>() |
Ogni richiesta restituisce un 500 vuoto; il registro eventi mostra AddConverterWidget() was called but the Converter plugin is not registered. | Il widget è abilitato senza il suo plugin | Aggiungi options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>() |
La risoluzione di DocumentConverter genera No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>(). | ConverterPlugin non è registrato | Aggiungi AddPlugin<ConverterPlugin>() in DoconutHost.Initialize |
| Una conversione Web Forms non restituisce mai | La pagina si blocca su ConvertAsync | Usa Async="true" e RegisterAsyncTask |
| La conversione di flusso 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 conceda Dicom |
| L'output è contrassegnato da filigrana | La licenza è temporanea (Demo/NFR) | Usa una licenza a pagamento che conceda Converter |
Il widget si carica ma le sue richieste restituiscono 404 | AddConverterWidget() non è stato chiamato, o basePath non è '/DocImage.axd' | Chiama AddConverterWidget(); imposta basePath: '/DocImage.axd' |
| Un caricamento grande mostra una pagina di errore IIS invece del messaggio del widget | maxRequestLength / maxAllowedContentLength sono al di sotto di MaxUploadMb | Aumenta i limiti di Web.config sopra MaxUploadMb |
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 conceda Dicom |
run risponde 400 That target format is not available for this file. | Il target non è uno dei allowedTargets della sorgente | Offri solo il allowedTargets da convert=open |
run o download risponde 404 (Upload expired — please re-open the file. da run) | La finestra di 30 minuti è scaduta, o un altro server in un farm non ha il caricamento | Apri nuovamente il file; in un farm, registra AddDoconutDistributedWidgets |
| Il widget fallisce quando l'interfaccia è su un'origine diversa | Gli endpoint non hanno supporto CORS | Servi l'interfaccia dalla stessa origine, o 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 imposta loro sul mount | Mira direttamente al mount: #doconut-convert.dcw o #doconut-convert |
Note sul framework
Rispetto ai pacchetti ASP.NET Core, questo pacchetto differisce solo nell'hosting; l'API, il contratto dell'endpoint, lo script del widget e le regole di licenza sono gli stessi.
- Registrazione è in
Application_Start, tramiteDoconutHost.Initialize, invece dibuilder.Services.AddDoconut. Servizi comeAddDoconutDistributedWidgetsvanno nel suo secondo argomento. - Endpoint sono serviti da
DocImage.axde lo script daDoconutResourceModule, entrambi registrati inWeb.config, invece diUseDoconut()eUseDoconutResources(). Il widget richiedebasePath: '/DocImage.axd'. - Errori di avvio si manifestano come un
500vuoto ad ogni richiesta, con la ragione nel registro eventi di Windows. - Caricamenti sono letti completamente da ASP.NET prima che Doconut li veda, quindi i limiti di IIS devono essere superiori a
MaxUploadMb. - Web Forms le pagine non devono bloccare una conversione; vedere In Web Forms.
- Solo Windows, come il resto del pacchetto .NET Framework.
Questa pagina è stata utile?