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.
| Surface | Use 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
Install-Package Doconut.NETFramework.ConverterPara fijar el plugin a la versión que describe esta documentación:
Install-Package Doconut.NETFramework.Converter -Version 26.10.0Mantenga 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.
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:
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 state | Startup | Conversion output |
|---|---|---|
Paid viewer license granting Converter, within its version window | Starts | Clean — watermarked: false |
| Active Temporary (Demo/NFR) license | Starts | Converts, with the evaluation watermark — watermarked: true |
| Expired Temporary (Demo/NFR) license | Starts | Converts, with the evaluation watermark — watermarked: true |
No license, a legacy TRIAL file, a license without Converter, or a paid license outside its version window | Application_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.
// 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);// 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);Stream html = await converter.WordToHtmlAsync("report.docx", ct);// 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:
[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:
<%@ Page Language="C#" Async="true" CodeBehind="Convert.aspx.cs" Inherits="MyApp.Convert" %>// 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:
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, IcoNo 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:
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:
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 controladorDocImage.axddeWeb.config.- El script y los puntos finales son independientes. El módulo de recursos sirve
doconutConverter.jstanto si el widget está habilitado como si no. SinAddConverterWidget(), el widget se carga, pinta su zona de arrastre y se ve completamente correcto — y su primera acción responde404.
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:
<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
<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ón | Tipo | Predeterminado | Notas |
|---|---|---|---|
basePath | string | /doconut | La URL del endpoint. Establezca '/DocImage.axd' en este paquete |
resPath | string | /doconut-res | Aceptado por consistencia con otros widgets de Doconut; el widget conversor no construye ninguna URL a partir de él |
maxUploadMb | number | 25 | Solo pre‑verificación del lado del cliente; el servidor impone su propio límite |
licenseUrl | string | null | null | Convierte el aviso de marca de agua en la pantalla de resultados en un enlace |
labels | object | {} | Sobrescribe cualquier subconjunto de las cadenas en inglés del widget |
Retrollamadas
| Retrollamada | Se dispara cuando | Carga |
|---|---|---|
onReady() | El widget ha renderizado su pantalla de arrastre | — |
onSourceLoaded({ token, pages, sourceExt, allowedTargets }) | ?convert=open tiene éxito | Token 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 éxito | La respuesta de ejecución más el target solicitado |
onDownload({ downloadName, downloadToken }) | El usuario hace clic en Descargar | Se dispara junto con la propia descarga del navegador |
onError({ phase, message }) | Una solicitud de abrir o ejecutar falla | phase 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:
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 estoEtiquetas
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'.
| Clave | Predeterminado en inglés |
|---|---|
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. |
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:
#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.
| Ruta | Propósito | Respuesta exitosa |
|---|---|---|
POST /DocImage.axd?convert=open (multipart, one file) | Subir y abrir un documento fuente | 200 — { token, pages, sourceExt, allowedTargets } |
POST /DocImage.axd?token=<token>&convert=run&target=<ext> | Convertir el origen subido a target | 200 — { downloadToken, resultToken, resultPages, downloadName, watermarked } |
GET /DocImage.axd?convert=download&token=<downloadToken> | Transmitir el archivo convertido | 200 — 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.
| Ruta | Estado | Cuándo | Cuerpo |
|---|---|---|---|
| cualquiera | 404 | El widget no está habilitado (AddConverterWidget() nunca se llamó) | solo estado |
| cualquiera | 405 | Verbo incorrecto (open/run requieren POST, download requiere GET) | solo estado |
open | 400 | No es una carga multipart | Expected a multipart file upload. |
open | 400 | No hay archivo, o está vacío | No file uploaded. |
open | 400 | Un tipo que no puede convertirse | This file type cannot be converted. |
open | 403 | El 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. |
open | 413 | La carga supera MaxUploadMb (pero no los límites de IIS) | File is too large. |
run | 400 | Un token malformado (no es un GUID) | Invalid token. |
run | 400 | Un target que no se analiza a un ConversionTarget | Unknown target format. |
run | 400 | Un objetivo que no está en allowedTargets | That target format is not available for this file. |
run | 404 | La carga expiró o nunca se abrió | Upload expired — please re-open the file. |
open, run | 500 | El procesamiento falló | Un mensaje sanitizado |
download | 400 / 404 | Un token de descarga malformado, desconocido o expirado | solo estado |
Un recorrido completo con fetch:
// 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
- Instalar el complemento junto al paquete central, en la misma versión:
Install-Package Doconut.NETFramework.Converter. - Agregar el archivo de licencia. Coloque
Doconut.Viewer.Converter.licen la misma carpeta queDoconut.Viewer.lic. - Establecer los límites de carga.
MaxUploadMbenAddConverterWidgetes el límite que impone Doconut; mantengamaxRequestLengthymaxAllowedContentLengthenWeb.configpor encima de él (ver Límites de carga), y elmaxUploadMbdel widget igual a él. - Nunca bloquee una conversión en Web Forms (ver En Web Forms).
- Desechar los resultados de conversión. El flujo que devuelve
ConvertAsyncestá 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:
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
Ttldespués de haber sido escrito; leerlo no extiende esa ventana. FarmKeydebe 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 unArgumentExceptioncuandoRootPathfalta oFarmKeyes más corto que 32 bytes.- Apunte
RootPatha 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
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
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íntoma | Causa | Solució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ón | Instale 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 plugin | Agregue 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á registrado | Agregue AddPlugin<ConverterPlugin>() en DoconutHost.Initialize |
| Una conversión de Web Forms nunca devuelve | La página se bloquea en ConvertAsync | Use Async="true" y RegisterAsyncTask |
| La conversión de flujo indica que el formato no es compatible | sourceExtension no tiene punto inicial | Pase ".xlsx", no "xlsx" |
ConvertAsync lanza Converting '.dcm' requires the Dicom capability license. | Una fuente DICOM, y la licencia no otorga Dicom | Utilice una licencia que otorgue Dicom |
| La salida tiene marca de agua | La licencia es temporal (Demo/NFR) | Utilice una licencia paga que otorgue Converter |
El widget se carga pero sus solicitudes devuelven 404 | AddConverterWidget() 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 widget | maxRequestLength / maxAllowedContentLength están por debajo de MaxUploadMb | Aumente 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 Dicom | Utilice 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 fuente | Ofrezca 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 carga | Abra el archivo nuevamente; en un clúster, registre AddDoconutDistributedWidgets |
| El widget falla cuando la UI está en otro origen | Los endpoints no tienen soporte CORS | Sirva la UI desde el mismo origen, o use un proxy inverso para las rutas Doconut |
| El tema no se aplica | Las variables se establecen en un ancestro o en un elemento dentro del montaje; la regla .dcw propia del widget las establece en el montaje | Apunte 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 deDoconutHost.Initialize, en lugar debuilder.Services.AddDoconut. Servicios comoAddDoconutDistributedWidgetsvan en su segundo argumento. - Endpoints son servidos por
DocImage.axdy el script porDoconutResourceModule, ambos registrados enWeb.config, en lugar deUseDoconut()yUseDoconutResources(). El widget necesitabasePath: '/DocImage.axd'. - Fallos de inicio aparecen como un
500vací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?