Plugin de 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 — de forma opcional — un widget listo para usar con su propio contrato HTTP, de modo que puedes convertir documentos desde C#, desde el widget, o desde un frontend que escribas tú mismo.
| Superficie | Úsalo cuando |
|---|---|
DocumentConverter (C#) | Conviertes en el servidor, sin navegador involucrado |
Drop-in widget (doconutConverter.js) | Quieres una pantalla lista para subir, convertir y descargar en tu página |
HTTP endpoints (?convert=open|run|download) | Construyes tu propia UI de conversión contra un contrato de servidor documentado |
Instalar el paquete
Instala el plugin Converter más reciente y estable:
dotnet add package Doconut.NET8.ConverterPara fijar el plugin a la versión que describe esta documentación, pasa la versión por separado:
dotnet add package Doconut.NET8.Converter --version 26.10.0Mantén el paquete Converter en la misma versión que Doconut.NET8. El ID del paquete es
Doconut.NET8.Converter; .<version> aparece solo en el nombre de archivo .nupkg descargado.
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.
Plataformas. El plugin funciona dondequiera que Doconut.NET8 se ejecute: Windows y Linux basado en glibc en x64 (no Alpine ni otras distribuciones basadas en musl). En Linux, instala la biblioteca de configuración de fuentes antes de que se abra el primer documento:
apt-get update && apt-get install -y libfontconfig1En RHEL, Fedora y distribuciones similares el paquete es fontconfig. Sin él, abrir un documento falla con The system library libfontconfig1 is missing. Install it (Debian/Ubuntu: apt-get install -y libfontconfig1) and see the Linux section of the Doconut documentation.
Registrar el plugin
No existe un método AddConverter() — el modelo de plugins de Doconut es uniforme. Cada plugin, incluido Converter, se registra de la misma manera: llama a AddPlugin<TPlugin>() dentro de AddDoconut(). ConverterPlugin se entrega en su propio paquete NuGet, Doconut.NET8.Converter, instalado junto al paquete base del visor.
builder.Services.AddDoconut(options =>
{
options.LicensePath = "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 listo para usar).
El plugin necesita una licencia que otorgue la capacidad Converter. Sin ella, AddDoconut() lanza un InvalidOperationException al iniciar, antes de que la aplicación sirva una solicitud:
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.Se lanza por falta de licencia, un archivo legado TRIAL, una licencia sin Converter, y una licencia paga usada fuera de su ventana de versión. Se aceptan licencias temporales Demo/NFR. No hay un nivel gratuito silencioso. Ver Configuración de Licencia para saber cómo se cargan las licencias.
Licencias y marca de agua
| Estado de la licencia | Inicio | Salida de conversión |
|---|---|---|
Licencia de visor paga que otorga Converter, dentro de su ventana de versión | Inicia | Limpio — watermarked: false |
| Licencia Temporal Activa (Demo/NFR) | Inicia | Convierte, con la marca de agua de evaluación — watermarked: true |
| Licencia Temporal Expirada (Demo/NFR) | Inicia | Convierte, con la marca de agua de evaluación — watermarked: true |
Sin licencia, un archivo legado TRIAL, una licencia sin Converter, o una licencia paga fuera de su ventana de versión | AddDoconut() lanza | — |
Ambas rutas de llamada calculan la bandera a partir de la misma regla: la fachada C# DocumentConverter la deriva internamente del estado IsViewerLicensed y IsTemporary de la licencia, y el manejador ?convert=run del widget realiza la comprobación equivalente (IsViewerLicensed && !IsTrial && !IsTemporary) para rellenar el campo watermarked que devuelve. Se puede construir e intentar 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, listo para leer o copiar inmediatamente. Resuelve DocumentConverter desde DI donde lo necesites — es sin estado por diseño, por lo que una única instancia es segura de reutilizar en múltiples solicitudes.
// Inyecte DocumentConverter; su constructor es interno, así que nunca lo `new` it.
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 convertir 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 flujo debe incluir el punto inicial (".xlsx", no "xlsx") — el convertidor lo compara con el catálogo de formatos y una extensión sin punto no se resolverá. Y a pesar de su nombre, WordToHtmlAsync devuelve Task<Stream>, no Task<string> — obtienes el documento HTML (imágenes incrustadas como Base64) como un flujo, igual que cualquier otro resultado de conversión.
El llamador posee el flujo devuelto y debe disponerlo después de copiar o devolver su contenido. El servicio DocumentConverter se resuelve mediante inyección de dependencias; no lo construyas ni lo dispongas manualmente.
Formatos de destino
ConversionTarget (namespace 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 — el complemento asigna cada familia de formato de origen (Word, Excel, PowerPoint, PDF, CAD, Image, Email, Diagram, Project/Task, PSD, documento web, DICOM) a su propio conjunto fijo 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 real para el archivo que se acaba de cargar, y eso es lo que debe impulsar un selector.
Componente integrable
Habilitar los puntos finales
Los puntos finales ?convert=open|run|download del componente son optativos y están deshabilitados por defecto — seguros por defecto. Habilítalos del lado del servidor, junto con el registro del complemento:
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
options.AddConverterWidget(widget =>
{
widget.MaxUploadMb = 25;
});
});AddConverterWidget() sin argumentos habilita el componente con los valores predeterminados (MaxUploadMb = 25). No otorga derechos de conversión por sí mismo: necesita AddPlugin<ConverterPlugin>(), o AddDoconut() lanza:
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.Sin AddConverterWidget(), los tres puntos finales ?convert= responden 404 — pero el archivo JS sigue sirviéndose de todos modos (es un recurso estático incrustado simple; solo los puntos finales a los que se comunica están restringidos).
Insertarlo
<div id="doconut-convert"></div>
<script src="/doconut-res/js/doconutConverter.js"></script>
<script>
Doconut.convert('#doconut-convert', { basePath: '/doconut', resPath: '/doconut-res', maxUploadMb: 25 });
</script>Doconut.convert(selectorOrElement, options) acepta un selector CSS o un elemento, lanza una excepción si no se encuentra el punto de montaje, y devuelve un manejador. El componente 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 | Ruta base para los puntos finales ?convert=; debe coincidir con la rama ASP.NET donde UseDoconut() está realmente montado (normalmente coordinado a través de MiddlewarePath) |
resPath | string | /doconut-res | Aceptado para la consistencia de configuración con otros widgets Doconut; el widget convertidor actualmente no genera ninguna URL a partir de él |
maxUploadMb | number | 25 | Solo verificación previa del lado del cliente — rechaza un archivo demasiado grande antes de subirlo. El servidor impone su propio límite de forma independiente y responde 413 si se supera |
licenseUrl | string | null | null | Cuando se establece, convierte el aviso de marca de agua en la pantalla de resultados en un enlace a esta URL |
labels | object | {} | Sobrescribe cualquier subconjunto de las cadenas predeterminadas en inglés del widget (texto de arrastre, botones, anuncios aria‑live, mensajes de error) |
Retrollamadas
| Retrollamada | Se dispara cuando | Carga útil |
|---|---|---|
onReady() | El widget ha renderizado su pantalla de inactividad/arrastre | — |
onSourceLoaded({ token, pages, sourceExt, allowedTargets }) | ?convert=open tiene éxito | token de sesión de origen, recuento de páginas, extensión de origen (sin punto inicial), lista de destinos permitidos |
onConverted({ downloadToken, resultToken, resultPages, downloadName, watermarked, target }) | ?convert=run tiene éxito | mismos campos que la respuesta de ejecución, más el target que se solicitó |
onDownload({ downloadName, downloadToken }) | El usuario hace clic en el enlace Descargar | se dispara junto con la descarga nativa del navegador — no la intercepta ni la reemplaza |
onError({ phase, message }) | Una solicitud de abrir o ejecutar falla | phase es 'open' o 'run'; message es el error del servidor sanitizado (o un mensaje del lado del cliente para la verificación previa del tamaño de carga) |
Una retrollamada que lanza una excepción se captura y registra; nunca interrumpe el flujo del widget.
Manejador imperativo
Doconut.convert() devuelve la propia instancia del widget — guárdala para controlar el widget programáticamente:
const conv = Doconut.convert('#doconut-convert', { basePath: '/doconut' });
const file = document.querySelector('#picker').files[0]; // un Archivo de tu propio <input type="file" id="picker">
conv.reset(); // volver a la pantalla de inactividad/soltar; no vuelve a disparar onReady
conv.loadFile(file); // inicia el flujo con un objeto File; no hace nada a menos que esté inactivo
conv.destroy(); // elimina los listeners, vacía el mount; la instancia no es usable 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 un 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 puedes 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 UI del sistema para --dcw-font.
Construye tu propio frontend
El widget es solo un cliente para este contrato HTTP — construye tu propio frontend contra él directamente para una UX diferente. Las tres rutas se encuentran bajo la rama ASP.NET donde UseDoconut() está montado (normalmente /doconut), y responden 404 hasta que se llama a AddConverterWidget(). Los errores llevan un cuerpo JSON, { "error": "..." }, excepto donde la tabla indica "solo estado". Un valor desconocido de ?convert= responde 400.
| Ruta | Propósito | Respuesta de éxito |
|---|---|---|
POST ?convert=open (multipart, un archivo) | Subir y abrir un documento fuente para vista previa | 200 — { token, pages, sourceExt, allowedTargets } |
POST ?token=<token>&convert=run&target=<ext> | Convertir la fuente almacenada a target | 200 — { downloadToken, resultToken, resultPages, downloadName, watermarked } |
GET ?convert=download&token=<downloadToken> | Transmitir el archivo convertido | 200 — bytes del archivo, Content-Disposition: attachment, Cache-Control: no-store |
sourceExt en la respuesta open no tiene punto inicial (p. ej. "docx") — la convención opuesta al parámetro sourceExtension en DocumentConverter.ConvertAsync, que lo requiere. 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 destino.
Las imágenes de vista previa usan la ruta estándar de imágenes del visor, {basePath}?token={token}&page=1&thumb=1&width={px}, con el token de open o el resultToken de run. El widget solicita width=240.
Los bytes de la fuente subidos se almacenan del lado del servidor y se conservan durante 30 minutos después de la última lectura; una vez que esa ventana expira, run responde 404 y el archivo debe volver a abrirse. El resultado convertido vive en el mismo almacén — downloadToken obtiene su propia ventana fresca de 30 minutos cuando la conversión finaliza — mientras que resultToken es un token de sesión de visor ordinario para previsualizar el resultado. Cuando el resultado puede previsualizarse, downloadToken y resultToken son el mismo valor. Cerrar un resultado del visor no elimina un almacén de descarga aún válido, y reiniciar el widget del navegador no extiende ninguna de las dos ventanas.
Modos de falla, agrupados por ruta:
| Ruta | Estado | Cuándo | Cuerpo |
|---|---|---|---|
| any | 404 | El widget no está habilitado (AddConverterWidget() nunca se llamó) — verificado antes de que cualquiera de las tres rutas se despache | solo estado |
| any | 405 | Verbo HTTP 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 | Una extensión de fuente 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 | El archivo subido supera MaxUploadMb, verificado contra Content-Length y mientras se lee la carga | File is too large. |
run | 400 | Token malformado (no es un GUID) | Invalid token. |
run | 400 | Un target que no se analiza a un ConversionTarget | Unknown target format. |
run | 400 | target no está en el allowedTargets de la fuente | That target format is not available for this file. |
run | 404 | La carga almacenada ha expirado o el token nunca se abrió | Upload expired — please re-open the file. |
open, run | 500 | Falló el procesamiento internamente | Un mensaje sanitizado — sanitizado de la misma manera que cualquier otra ruta de error de Doconut; nunca expone detalles internos |
download | 400 | Token malformado (no es un GUID) | solo estado |
download | 404 | Token de descarga desconocido o expirado | solo estado |
Un recorrido completo con fetch:
// file: the File to convert, for example from an <input type="file">.
async function convertFile(file) {
const base = '/doconut';
// 1. open: subir 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 solicitud GET que el navegador pueda 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 haz proxy inverso de ambas rutas /doconut (la ruta del middleware y la ruta de recursos) bajo el origen de tu UI.
En producción
- Instalar el plugin junto al paquete central, en la misma versión:
dotnet add package Doconut.NET8.Converter. - Agregar el archivo de licencia. Coloque
Doconut.Viewer.Converter.licen la misma carpeta queDoconut.Viewer.lic. - Establecer el límite del servidor.
MaxUploadMbenAddConverterWidgetes el límite que impone el servidor; elmaxUploadMbdel widget es solo una verificación del lado del cliente. Mantenga ambos iguales. - Sirva la UI desde el mismo origen que los endpoints de Doconut, o haga un reverse-proxy de ellos (vea Construya su propio frontend).
- Desechar los resultados de conversión. El stream 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 nodo 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 nodo y no encontrar la carga. Registre el almacén compartido y cifrado del widget una sola vez, después de AddDoconut():
byte[] farmKey = Convert.FromBase64String(builder.Configuration["Doconut:FarmKey"]);
builder.Services.AddDoconutDistributedWidgets(store =>
{
store.RootPath = @"\\fileshare\doconut"; // una carpeta que cada nodo puede leer y escribir
store.FarmKey = farmKey; // al menos 32 bytes, idéntico en cada nodo
// store.Ttl = TimeSpan.FromMinutes(30); // cuánto tiempo se mantiene una carga (el predeterminado)
});- Un solo servidor no necesita nada: sin esta llamada se usa el almacén en memoria.
- Las cargas y 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 nodo. Cárguelo desde un almacén secreto; nunca lo codifique directamente. El registro lanza unArgumentExceptioncuandoRootPathfalta oFarmKeyes más corto que 32 bytes.- Apunte
RootPatha la misma ubicación compartida que usa 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 mediante inyección de dependencias; 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.
Solución de problemas
| Síntoma | Causa | Solución |
|---|---|---|
AddDoconut() lanza The Converter plugin is registered via AddPlugin but no active license grants Converter. | No hay licencia, un archivo TRIAL, una licencia sin Converter, o una licencia paga fuera de su ventana de versión | Instale una licencia que conceda Converter, o elimine AddPlugin<ConverterPlugin>() |
AddDoconut() lanza AddConverterWidget() was called but the Converter plugin is not registered. | El widget está habilitado sin su plugin | Añada 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 | Añada AddPlugin<ConverterPlugin>() dentro de AddDoconut() |
| 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 concede Dicom | Use una licencia que conceda Dicom |
| La salida tiene marca de agua | La licencia es temporal (Demo/NFR) | Use una licencia paga que conceda Converter |
El widget se carga pero sus solicitudes responden 404 | No se llamó a AddConverterWidget(), o basePath no coincide con la rama donde UseDoconut() está montado | Llame a AddConverterWidget(); corrija basePath |
open responde 403 Converting this file type requires the Dicom capability license. | Una carga DICOM, y la licencia no concede Dicom | Use una licencia que conceda Dicom |
open responde 413 File is too large. | La carga supera MaxUploadMb | Aumente MaxUploadMb en AddConverterWidget; el maxUploadMb del widget es solo una verificación del lado del cliente |
run responde 400 That target format is not available for this file. | El objetivo no es uno de los allowedTargets del origen | Ofrezca solo el allowedTargets de open |
run o download responde 404 (Upload expired — please re-open the file. de run) | La ventana de 30 minutos ha expirado, o un nodo de la granja web no tiene la carga | Abra el archivo nuevamente; en una granja, 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 haga reverse-proxy de las rutas Doconut |
| El tema no se aplica | Las variables están establecidas 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 |
¿Fue útil esta página?