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.

TipoQuando 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

powershell
Install-Package Doconut.NETFramework.Converter

Per fissare il plugin alla versione descritta in questa documentazione:

powershell
Install-Package Doconut.NETFramework.Converter -Version 26.10.0

Mantieni 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.

csharp
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:

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.

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 licenzaAvvioOutput della 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 fuori dalla sua finestra di versioneApplication_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.

csharp
// 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);
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 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:

csharp
[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:

aspx
<%@ Page Language="C#" Async="true" CodeBehind="Convert.aspx.cs" Inherits="MyApp.Convert" %>
csharp
// 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:

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 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:

csharp
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:

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.

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 gestore DocImage.axd da Web.config.
  • Lo script e gli endpoint sono indipendenti. Il modulo di risorse serve doconutConverter.js indipendentemente dal fatto che il widget sia abilitato o meno: senza AddConverterWidget(), il widget si carica, disegna la sua zona di rilascio e appare completamente corretto — e la sua prima azione risponde 404.

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:

xml
<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

html
<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

OpzioneTipoPredefinitoNote
basePathstring/doconutL'URL del endpoint. Imposta '/DocImage.axd' su questo pacchetto
resPathstring/doconut-resAccettato per coerenza con altri widget Doconut; il widget convertitore non costruisce alcun URL da esso
maxUploadMbnumber25Solo pre-controllo lato client; il server applica il proprio limite
licenseUrlstring | nullnullTrasforma l'avviso di watermark nella schermata del risultato in un collegamento
labelsobject{}Sovrascrive qualsiasi sottoinsieme delle stringhe inglesi del widget

Callback

CallbackQuando si attivaCarico
onReady()Il widget ha renderizzato la sua schermata di drop—
onSourceLoaded({ token, pages, sourceExt, allowedTargets })?convert=open ha avuto successoToken di origine, conteggio pagine, estensione sorgente (senza punto iniziale), destinazioni consentite
onConverted({ downloadToken, resultToken, resultPages, downloadName, watermarked, target })?convert=run ha avuto successoLa risposta di esecuzione più il target richiesto
onDownload({ downloadName, downloadToken })L'utente fa clic su DownloadSi attiva insieme al download nativo del browser
onError({ phase, message })Una richiesta di apertura o esecuzione falliscephase è '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:

javascript
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 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.

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:

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

RottaScopoRisposta di successo
POST /DocImage.axd?convert=open (multipart, one file)Carica e apri un documento sorgente200 — { token, pages, sourceExt, allowedTargets }
POST /DocImage.axd?token=<token>&convert=run&target=<ext>Converti il sorgente caricato in target200 — { downloadToken, resultToken, resultPages, downloadName, watermarked }
GET /DocImage.axd?convert=download&token=<downloadToken>Trasmetti in streaming il file convertito200 — 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.

RottaStatoQuandoCorpo
qualsiasi404Il widget non è abilitato (AddConverterWidget() non è mai stato chiamato)solo stato
qualsiasi405Verbo errato (open/run richiedono POST, download richiede GET)solo stato
open400Caricamento non multipartExpected a multipart file upload.
open400Nessun file, o uno vuotoNo file uploaded.
open400Un tipo che non può essere convertitoThis 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 caricamento supera MaxUploadMb (ma non i limiti IIS)File is too large.
run400Un token malformato (non un GUID)Invalid token.
run400Un target che non si analizza in un ConversionTargetUnknown target format.
run400Un target non presente in allowedTargetsThat target format is not available for this file.
run404Il caricamento è scaduto o non è mai stato apertoUpload expired — please re-open the file.
open, run500Elaborazione fallitaUn messaggio sanificato
download400 / 404Un token di download malformato, 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 = '/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

  1. Installa il plugin accanto al pacchetto core, alla stessa versione: Install-Package Doconut.NETFramework.Converter.
  2. Aggiungi il file di licenza. Metti Doconut.Viewer.Converter.lic nella stessa cartella di Doconut.Viewer.lic.
  3. Imposta i limiti di caricamento. MaxUploadMb in AddConverterWidget è il limite imposto da Doconut; mantieni maxRequestLength e maxAllowedContentLength in Web.config al di sopra di esso (vedi Limiti di caricamento), e il maxUploadMb del widget uguale a esso.
  4. Non bloccare mai una conversione in Web Forms (vedi In Web Forms).
  5. 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:

csharp
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 Ttl dopo essere stato scritto; leggerlo non estende tale finestra.
  • FarmKey deve essere di almeno 32 byte e lo stesso su ogni server. Caricalo da un secret store; non codificarlo mai. La registrazione genera un ArgumentException quando RootPath è mancante o FarmKey è più corto di 32 byte.
  • Imposta RootPath sulla 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

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 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

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

SintomoCausaRisoluzione
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 versioneInstalla 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 pluginAggiungi 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 è registratoAggiungi AddPlugin<ConverterPlugin>() in DoconutHost.Initialize
Una conversione Web Forms non restituisce maiLa pagina si blocca su ConvertAsyncUsa Async="true" e RegisterAsyncTask
La conversione di flusso indica che il formato non è supportatosourceExtension non ha il punto inizialePassa ".xlsx", non "xlsx"
ConvertAsync genera Converting '.dcm' requires the Dicom capability license.Una sorgente DICOM, e la licenza non concede DicomUsa una licenza che conceda Dicom
L'output è contrassegnato da filigranaLa licenza è temporanea (Demo/NFR)Usa una licenza a pagamento che conceda Converter
Il widget si carica ma le sue richieste restituiscono 404AddConverterWidget() 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 widgetmaxRequestLength / maxAllowedContentLength sono al di sotto di MaxUploadMbAumenta 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 DicomUsa una licenza che conceda Dicom
run risponde 400 That target format is not available for this file.Il target non è uno dei allowedTargets della sorgenteOffri 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 caricamentoApri nuovamente il file; in un farm, registra AddDoconutDistributedWidgets
Il widget fallisce quando l'interfaccia è su un'origine diversaGli endpoint non hanno supporto CORSServi l'interfaccia dalla stessa origine, o usa un reverse-proxy per i 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 imposta loro sul mountMira 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, tramite DoconutHost.Initialize, invece di builder.Services.AddDoconut. Servizi come AddDoconutDistributedWidgets vanno nel suo secondo argomento.
  • Endpoint sono serviti da DocImage.axd e lo script da DoconutResourceModule, entrambi registrati in Web.config, invece di UseDoconut() e UseDoconutResources(). Il widget richiede basePath: '/DocImage.axd'.
  • Errori di avvio si manifestano come un 500 vuoto 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?