Plugin Conversor

Convertir documentos a 45 formatos de destino

El plugin Converter convierte Doconut en un servicio de conversión de documentos. Contribuye con el motor detrás de la fachada pública DocumentConverter y — opcionalmente — un widget insertable servido por DocImage.axd, para que pueda convertir documentos desde C#, desde el widget, o desde un frontend que usted mismo escriba.

SurfaceUse it when
DocumentConverter (C#)Convierte en el servidor, sin que intervenga el navegador
Drop-in widget (doconutConverter.js)Desea una pantalla lista para subir, convertir y descargar en su página
HTTP endpoints on DocImage.axd (?convert=open|run|download)Construye su propia interfaz de conversión contra un contrato de servidor documentado

Instalar el paquete

powershell
Install-Package Doconut.NETFramework.Converter

Para fijar el plugin a la versión que describe esta documentación:

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

Mantenga el paquete Converter en la misma versión que Doconut.NETFramework.

El archivo de licencia del plugin, Doconut.Viewer.Converter.lic, se coloca en la misma carpeta que Doconut.Viewer.lic; se lee junto con la licencia del visor.

Registrar el plugin

Cada plugin se registra de la misma manera: AddPlugin<TPlugin>() en DoconutHost.Initialize, llamado desde Application_Start.

csharp
Doconut.DoconutHost.Initialize(options =>
{
    options.LicensePath = HostingEnvironment.MapPath("~/wwwroot/Doconut.Viewer.lic");
    options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
});

Eso es todo lo que necesita la fachada C#. El widget y sus endpoints HTTP son una opción separada, AddConverterWidget() (ver Widget insertable).

El plugin necesita una licencia que otorgue la capacidad Converter. Sin ella, DoconutHost.Initialize lanza una excepción desde 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.

En System.Web eso significa que cada solicitud responde con un 500 vacío, y la razón solo está en el registro de eventos de Windows (fuente ASP.NET). Lanza por falta de licencia, un archivo heredado TRIAL, una licencia sin Converter, y una licencia paga usada fuera de su ventana de versión. Se aceptan licencias temporales Demo/NFR. Ver Configuración de licencia.

Licenciamiento y marca de agua

License stateStartupConversion output
Paid viewer license granting Converter, within its version windowStartsClean — watermarked: false
Active Temporary (Demo/NFR) licenseStartsConverts, with the evaluation watermark — watermarked: true
Expired Temporary (Demo/NFR) licenseStartsConverts, with the evaluation watermark — watermarked: true
No license, a legacy TRIAL file, a license without Converter, or a paid license outside its version windowApplication_Start throws; every request answers an empty 500—

La fachada DocumentConverter y el manejador ?convert=run del widget aplican la misma regla. Se puede construir e probar una integración de extremo a extremo con una licencia de evaluación antes de la compra — solo cambian los bytes de salida.

Una fuente DICOM (.dcm, .ima) también necesita la capacidad Dicom. Sin ella, ConvertAsync lanza un LicenseException (Converting '.dcm' requires the Dicom capability license.) y el open del widget responde 403.

Uso desde C#

Cada conversión devuelve un MemoryStream buscable posicionado en 0. DocumentConverter es sin estado: resuélvalo desde DoconutHost.Services donde lo necesite y reutilícelo libremente.

csharp
// Resuelve DocumentConverter de DoconutHost.Services; su constructor es interno, así que nunca lo `new`.
Stream pdf = await converter.ConvertAsync("contract.docx", ConversionTarget.Pdf, ct: ct);
csharp
// sourceExtension incluye el punto inicial. password es null a menos que el documento esté protegido.
Stream png = await converter.ConvertAsync(stream, ".xlsx", ConversionTarget.Png, password: null, ct: ct);
csharp
Stream html = await converter.WordToHtmlAsync("report.docx", ct);
csharp
// html: un Stream que contiene el HTML para volver a convertirlo en un documento Word, como el resultado de WordToHtmlAsync.
Stream docx = await converter.HtmlToWordAsync(html, ConversionTarget.Docx, ct);

Dos detalles que es fácil equivocarse: sourceExtension en la sobrecarga de stream debe incluir el punto inicial (".xlsx", no "xlsx"), o no se resuelve. Y a pesar de su nombre, WordToHtmlAsync devuelve Task<Stream>, no Task<string> — el documento HTML (imágenes incrustadas como Base64) llega como un stream, como cualquier otro resultado.

El llamador posee el MemoryStream que devuelve una conversión y debe desecharlo después de copiarlo o devolverlo (el File(stream, …) de MVC lo desecha por usted). No construya ni deseche DocumentConverter usted mismo — su constructor es interno.

En un controlador MVC 5

Haz que la acción sea asíncrona y await la conversión:

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");
}

En Web Forms: nunca bloquear una conversión

Una página Web Forms se ejecuta en un contexto de solicitud de un solo subproceso. ConvertAsync se reanuda en ese contexto cuando termina, por lo que una página que lo espera de forma sincrónica — .Result, .Wait(), .GetAwaiter().GetResult() — ocupa el propio subproceso que la conversión necesita para finalizar. La solicitud nunca regresa. El navegador sigue girando, IIS no registra nada, y el resto del sitio sigue funcionando, por lo que parece una conversión lenta en lugar de un interbloqueo.

Marca la página Async="true" y ejecuta la conversión como una tarea asíncrona de página:

aspx
<%@ Page Language="C#" Async="true" CodeBehind="Convert.aspx.cs" Inherits="MyApp.Convert" %>
csharp
// Web Forms: la directiva @Page necesita Async="true", y la conversión se ejecuta como una tarea asíncrona de página.
// Bloquearlo de esa manera (.Result, .Wait(), .GetAwaiter().GetResult()) bloquea la solicitud:
// nunca devuelve, y no se registra nada.
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, no HttpContext.Current: después de un await, este último puede ser nulo.
            Context.ApplicationInstance.CompleteRequest();
        }
    }));
}

Sin Async="true" en la directiva @Page, RegisterAsyncTask se ignora silenciosamente. Después de un await, usa el Context de la página; HttpContext.Current puede ser null allí.

Formatos de destino

ConversionTarget (espacio de nombres Doconut.Configs.Conversion) tiene 45 miembros:

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

No todas las fuentes se convierten a todos los destinos: cada familia de formato de fuente (Word, Excel, PowerPoint, PDF, CAD, Imagen, Correo electrónico, Diagrama, Project, PSD, documento web, DICOM) tiene su propio conjunto de destinos permitidos. Convertir una fuente DICOM (.dcm, .ima) también requiere una licencia que otorgue la capacidad Dicom; sus destinos son Pdf, Png, Jpeg, Bmp, Tiff y Gif. No codifiques este enum como la lista de destinos de tu UI: ?convert=open devuelve el allowedTargets para el archivo subido, y eso es lo que debe impulsar un selector.

Widget integrable

Habilitar los puntos finales

Los puntos finales ?convert=open|run|download del widget son servidos por DocImage.axd y están desactivados por defecto. Habilítalos junto al registro 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 lee toda la carga antes de que Doconut la vea: mantén maxRequestLength (KB) y
// maxAllowedContentLength (bytes) en Web.config por encima del MaxUploadMb del widget.

AddConverterWidget() sin argumentos habilita el widget con los valores predeterminados (MaxUploadMb = 25). No otorga derechos de conversión por sí mismo: necesita AddPlugin<ConverterPlugin>(), o DoconutHost.Initialize lanza una excepción:

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.

Dos cosas a verificar cuando el widget se comporta mal:

  • basePath: '/DocImage.axd'. El predeterminado del widget, /doconut, es el punto final ASP.NET Core. En este paquete, los puntos finales son el controlador DocImage.axd de Web.config.
  • El script y los puntos finales son independientes. El módulo de recursos sirve doconutConverter.js tanto si el widget está habilitado como si no. Sin AddConverterWidget(), el widget se carga, pinta su zona de arrastre y se ve completamente correcto — y su primera acción responde 404.

Límites de carga

ASP.NET lee todo el cuerpo de la solicitud antes de que DocImage.axd se ejecute. Una carga superior a MaxUploadMb pero por debajo de los límites del host obtiene el JSON propio del widget 413 (File is too large.). Una carga que supera los límites del host es rechazada primero por IIS, con una página de error que el widget no puede leer. Mantenga ambos límites del host en Web.config por encima del límite 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>

Incrústalo

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) acepta un selector CSS o un elemento, lanza una excepción si no se encuentra el montaje, y devuelve un manejador. El widget sube un archivo, muestra una vista previa de la página 1, permite al usuario elegir uno de los allowedTargets, convierte, previsualiza el resultado cuando puede, y ofrece la descarga.

Opciones

OpciónTipoPredeterminadoNotas
basePathstring/doconutLa URL del endpoint. Establezca '/DocImage.axd' en este paquete
resPathstring/doconut-resAceptado por consistencia con otros widgets de Doconut; el widget conversor no construye ninguna URL a partir de él
maxUploadMbnumber25Solo pre‑verificación del lado del cliente; el servidor impone su propio límite
licenseUrlstring | nullnullConvierte el aviso de marca de agua en la pantalla de resultados en un enlace
labelsobject{}Sobrescribe cualquier subconjunto de las cadenas en inglés del widget

Retrollamadas

RetrollamadaSe dispara cuandoCarga
onReady()El widget ha renderizado su pantalla de arrastre—
onSourceLoaded({ token, pages, sourceExt, allowedTargets })?convert=open tiene éxitoToken de origen, recuento de páginas, extensión de origen (sin punto inicial), destinos permitidos
onConverted({ downloadToken, resultToken, resultPages, downloadName, watermarked, target })?convert=run tiene éxitoLa respuesta de ejecución más el target solicitado
onDownload({ downloadName, downloadToken })El usuario hace clic en DescargarSe dispara junto con la propia descarga del navegador
onError({ phase, message })Una solicitud de abrir o ejecutar fallaphase es 'open' o 'run'; message es el error del servidor sanitizado

Una retrollamada que lanza una excepción es capturada y registrada; nunca interrumpe el flujo del widget.

Manejador imperativo

Doconut.convert() devuelve la instancia del widget:

javascript
const conv = Doconut.convert('#doconut-convert', { basePath: '/DocImage.axd' });
const file = document.querySelector('#picker').files[0]; // un Archivo de tu propio <input type="file" id="picker">
conv.reset();         // volver a la pantalla de arrastre; no vuelve a disparar onReady
conv.loadFile(file);  // inicia el flujo con un Archivo; no-op a menos que el widget esté en su pantalla de arrastre
conv.destroy();       // elimina los listeners, vacía el mount; la instancia no es utilizable después de esto

Etiquetas

Cada cadena tiene un valor predeterminado en inglés; labels sobrescribe cualquier subconjunto y el resto permanece en inglés. Los fragmentos que cambian en tiempo de ejecución usan {placeholders}, como uploading: 'Uploading {name}…' y pages: '{n} pages'.

ClavePredeterminado en inglés
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.

Otras claves cubren el aria-label de la zona de arrastre (dropAriaLabel), los textos de vista previa alt (previewAlt, resultAlt), la forma enlazada del aviso de marca de agua usado con licenseUrl (watermarkNoticePrefix, watermarkNoticeLink, watermarkNoticeSuffix), una respuesta ilegible (badResponse) y los anuncios aria-live (annReady, annUploading, annLoaded, annLoadedNoTargets, annConverting, annDone, annError).

Un error JSON del servidor se muestra tal como lo escribió el servidor; serverError se usa solo cuando una respuesta fallida no lleva error JSON, como el 404 de un widget deshabilitado.

Tematización

El widget agrega la clase dcw a su elemento de montaje y lee sus colores, radio y fuente de las propiedades personalizadas de CSS, de modo que puedas tematizarlo sin tocar sus internos:

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

Valores predeterminados: --dcw-accent: #2b6cb0, --dcw-bg: #ffffff, --dcw-fg: #1a202c, --dcw-muted: #718096, --dcw-border: #cbd5e0, --dcw-radius: 8px, y una fuente de interfaz del sistema para --dcw-font.

Construye tu propio frontend

El widget es un cliente de este contrato HTTP en DocImage.axd. Las rutas responden 404 hasta que se llama a AddConverterWidget(). Los errores incluyen un cuerpo JSON, { "error": "..." }, excepto donde la tabla indica "status only". Un valor desconocido de ?convert= responde 400.

RutaPropósitoRespuesta exitosa
POST /DocImage.axd?convert=open (multipart, one file)Subir y abrir un documento fuente200 — { token, pages, sourceExt, allowedTargets }
POST /DocImage.axd?token=<token>&convert=run&target=<ext>Convertir el origen subido a target200 — { downloadToken, resultToken, resultPages, downloadName, watermarked }
GET /DocImage.axd?convert=download&token=<downloadToken>Transmitir el archivo convertido200 — el archivo, Content-Disposition: attachment, Cache-Control: no-store

sourceExt en la respuesta open no tiene punto inicial ("docx") — lo contrario del parámetro sourceExtension de ConvertAsync. allowedTargets enumera nombres de destino en minúsculas ("pdf", "html", …); pasa uno de ellos como target, que se compara sin distinguir mayúsculas y minúsculas. open usa el primer archivo en el cuerpo multipart.

resultToken es null, y resultPages es 0, cuando el resultado no puede previsualizarse. downloadName es el nombre del archivo fuente con la extensión del objetivo.

Las imágenes de vista previa usan la ruta estándar de imágenes del visor, /DocImage.axd?token={token}&page=1&thumb=1&width={px}, con el token de open o el resultToken de run. El widget solicita width=240.

Los fuentes subidos se conservan durante 30 minutos después de la última lectura; después de eso, run responde 404 y el archivo debe abrirse nuevamente. downloadToken obtiene su propia ventana de 30 minutos cuando la conversión se completa. resultToken es un token de visor ordinario para previsualizar el resultado; cuando el resultado puede previsualizarse, tiene el mismo valor que downloadToken.

RutaEstadoCuándoCuerpo
cualquiera404El widget no está habilitado (AddConverterWidget() nunca se llamó)solo estado
cualquiera405Verbo incorrecto (open/run requieren POST, download requiere GET)solo estado
open400No es una carga multipartExpected a multipart file upload.
open400No hay archivo, o está vacíoNo file uploaded.
open400Un tipo que no puede convertirseThis file type cannot be converted.
open403El tipo de archivo necesita una capacidad que la licencia no otorga (un archivo DICOM sin Dicom)Converting this file type requires the Dicom capability license.
open413La carga supera MaxUploadMb (pero no los límites de IIS)File is too large.
run400Un token malformado (no es un GUID)Invalid token.
run400Un target que no se analiza a un ConversionTargetUnknown target format.
run400Un objetivo que no está en allowedTargetsThat target format is not available for this file.
run404La carga expiró o nunca se abrióUpload expired — please re-open the file.
open, run500El procesamiento fallóUn mensaje sanitizado
download400 / 404Un token de descarga malformado, desconocido o expiradosolo estado

Un recorrido completo con fetch:

javascript
// file: el File a convertir, por ejemplo desde un <input type="file">.
async function convertFile(file) {
  const base = '/DocImage.axd';

  // 1. open: cargar el archivo
  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: convertir a PDF cuando está permitido, de lo contrario al primer objetivo permitido
  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: una simple GET que el navegador puede seguir
  window.location.href = base + '?convert=download&token=' + encodeURIComponent(converted.downloadToken);
}

Los puntos finales son misma origen: esta versión no tiene soporte CORS. Sirve tu UI y el script del widget desde el mismo origen que Doconut, o utiliza un reverse-proxy para el manejador y las rutas de recursos bajo el origen de tu UI.

En producción

  1. Instalar el complemento junto al paquete central, en la misma versión: Install-Package Doconut.NETFramework.Converter.
  2. Agregar el archivo de licencia. Coloque Doconut.Viewer.Converter.lic en la misma carpeta que Doconut.Viewer.lic.
  3. Establecer los límites de carga. MaxUploadMb en AddConverterWidget es el límite que impone Doconut; mantenga maxRequestLength y maxAllowedContentLength en Web.config por encima de él (ver Límites de carga), y el maxUploadMb del widget igual a él.
  4. Nunca bloquee una conversión en Web Forms (ver En Web Forms).
  5. Desechar los resultados de conversión. El flujo que devuelve ConvertAsync está en un pool; desecharlo devuelve sus buffers al pool.

Granjas web

El widget mantiene cada carga y su resultado en memoria en el servidor que sirvió open. Detrás de un balanceador de carga sin sesiones persistentes, una solicitud posterior de run, download o de vista previa puede llegar a otro servidor y no encontrar la carga. Registre el almacén compartido y cifrado del widget mediante el segundo argumento de 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 carpeta que cada servidor puede leer y escribir
        store.FarmKey = farmKey;                   // al menos 32 bytes, idéntico en cada servidor
        // store.Ttl = TimeSpan.FromMinutes(30);   // cuánto tiempo se conserva una carga (el predeterminado)
    }));
  • Un solo servidor no necesita nada: sin esta llamada se utiliza el almacén en memoria.
  • Las cargas y los resultados están cifrados en reposo en el recurso compartido (AES-256, encrypt-then-MAC), y cada archivo está vinculado a su token, de modo que un token nunca puede leer el archivo de otro.
  • En el recurso compartido, una carga o un resultado se conserva durante Ttl después de haber sido escrito; leerlo no extiende esa ventana.
  • FarmKey debe tener al menos 32 bytes y ser idéntico en cada servidor. Cárguelo desde un almacén secreto; nunca lo codifique de forma rígida. El registro lanza un ArgumentException cuando RootPath falta o FarmKey es más corto que 32 bytes.
  • Apunte RootPath a la misma ubicación compartida que utiliza el visor distribuido.

Referencia de API

La fachada y las opciones del widget están en el espacio de nombres Doconut; ConversionTarget está en Doconut.Configs.Conversion. ConverterPlugin está en 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);
}

Resuelto a partir de DoconutHost.Services; el constructor es interno. sourceExtension incluye el punto inicial. HtmlToWordAsync escribe un archivo .doc cuando outputFormat es ConversionTarget.Doc, y un archivo .docx para cualquier otro valor.

ConversionTarget

Los 45 formatos de salida listados en Formatos de destino.

ConverterWidgetOptions

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

Establecido a través de DoconutOptions.AddConverterWidget(Action<ConverterWidgetOptions>? configure = null), que devuelve el DoconutOptions para que las llamadas puedan encadenarse.

Troubleshooting

SíntomaCausaSolución
Cada solicitud responde con un 500 vacío después de agregar el plugin; el registro de eventos de Windows (fuente ASP.NET) muestra The Converter plugin is registered via AddPlugin but no active license grants Converter.Sin licencia, un archivo TRIAL, una licencia sin Converter, o una licencia paga fuera de su ventana de versiónInstale una licencia que otorgue Converter, o elimine AddPlugin<ConverterPlugin>()
Cada solicitud responde con un 500 vacío; el registro de eventos muestra AddConverterWidget() was called but the Converter plugin is not registered.El widget está habilitado sin su pluginAgregue options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>()
Resolver DocumentConverter lanza No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>().ConverterPlugin no está registradoAgregue AddPlugin<ConverterPlugin>() en DoconutHost.Initialize
Una conversión de Web Forms nunca devuelveLa página se bloquea en ConvertAsyncUse Async="true" y RegisterAsyncTask
La conversión de flujo indica que el formato no es compatiblesourceExtension no tiene punto inicialPase ".xlsx", no "xlsx"
ConvertAsync lanza Converting '.dcm' requires the Dicom capability license.Una fuente DICOM, y la licencia no otorga DicomUtilice una licencia que otorgue Dicom
La salida tiene marca de aguaLa licencia es temporal (Demo/NFR)Utilice una licencia paga que otorgue Converter
El widget se carga pero sus solicitudes devuelven 404AddConverterWidget() no se llamó, o basePath no es '/DocImage.axd'Llame a AddConverterWidget(); establezca basePath: '/DocImage.axd'
Una carga grande muestra una página de error de IIS en lugar del mensaje del widgetmaxRequestLength / maxAllowedContentLength están por debajo de MaxUploadMbAumente los límites de Web.config por encima de MaxUploadMb
open responde 403 Converting this file type requires the Dicom capability license.Una carga DICOM, y la licencia no otorga DicomUtilice una licencia que otorgue Dicom
run responde 400 That target format is not available for this file.El objetivo no es uno de los allowedTargets de la fuenteOfrezca solo el allowedTargets de convert=open
run o download responde 404 (Upload expired — please re-open the file. de run)La ventana de 30 minutos expiró, o otro servidor en un clúster no tiene la cargaAbra el archivo nuevamente; en un clúster, registre AddDoconutDistributedWidgets
El widget falla cuando la UI está en otro origenLos endpoints no tienen soporte CORSSirva la UI desde el mismo origen, o use un proxy inverso para las rutas Doconut
El tema no se aplicaLas variables se establecen en un ancestro o en un elemento dentro del montaje; la regla .dcw propia del widget las establece en el montajeApunte al propio montaje: #doconut-convert.dcw o #doconut-convert

Notas del framework

En comparación con los paquetes ASP.NET Core, este paquete difiere solo en el alojamiento; la API, el contrato del endpoint, el script del widget y las reglas de licenciamiento son los mismos.

  • Registro está en Application_Start, a través de DoconutHost.Initialize, en lugar de builder.Services.AddDoconut. Servicios como AddDoconutDistributedWidgets van en su segundo argumento.
  • Endpoints son servidos por DocImage.axd y el script por DoconutResourceModule, ambos registrados en Web.config, en lugar de UseDoconut() y UseDoconutResources(). El widget necesita basePath: '/DocImage.axd'.
  • Fallos de inicio aparecen como un 500 vacío en cada solicitud, con la razón en el registro de eventos de Windows.
  • Cargas son leídas completamente por ASP.NET antes de que Doconut las vea, por lo que los límites de IIS deben estar por encima de MaxUploadMb.
  • Páginas Web Forms no deben bloquearse en una conversión; vea En Web Forms.
  • Solo Windows, como el resto del paquete .NET Framework.

¿Fue útil esta página?