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 — opcionalmente — un widget listo para usar con su propio contrato HTTP, de modo que pueda convertir documentos desde C#, desde el widget, o desde un frontend que usted mismo escriba.
| Superficie | Úselo cuando |
|---|---|
DocumentConverter (C#) | Usted convierte en el servidor, sin navegador involucrado |
Widget integrado (doconutConverter.js) | Quiere una pantalla lista para subir, convertir y descargar en su página |
Puntos finales HTTP (?convert=open|run|download) | Construye su propia interfaz de conversión contra un contrato de servidor documentado |
Instalar el paquete
Instale el último plugin Converter estable:
dotnet add package Doconut.NET6.ConverterPara fijar el plugin a la versión que describe esta documentación, pase la versión por separado:
dotnet add package Doconut.NET6.Converter --version 26.10.0Mantenga el paquete Converter en la misma versión que Doconut.NET6. El ID del paquete es
Doconut.NET6.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 se ejecuta dondequiera que Doconut.NET6 se ejecute: Windows y Linux basado en glibc en x64 (no Alpine ni otras distribuciones basadas en musl). En Linux, instale 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: llame a AddPlugin<TPlugin>() dentro de AddDoconut(). ConverterPlugin se entrega en su propio paquete NuGet, Doconut.NET6.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 puntos finales HTTP son una opción separada, AddConverterWidget() (ver Widget integrado).
El plugin necesita una licencia que conceda 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 produce cuando no hay 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. No hay un nivel gratuito silencioso. Consulte License Setup para saber cómo se cargan las licencias.
Licenciamiento 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 heredado 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.
// Inyecta DocumentConverter; 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 convertir en un documento Word, como el resultado de WordToHtmlAsync.
Stream docx = await converter.HtmlToWordAsync(html, ConversionTarget.Docx, ct);Dos detalles que son fáciles de equivocarse: sourceExtension en la sobrecarga de stream 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 stream, igual que cualquier otro resultado de conversión.
El llamador posee el stream devuelto y debe desecharlo después de copiar o devolver su contenido. El servicio DocumentConverter se resuelve mediante inyección de dependencias; no lo construyas ni lo deseches 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 plugin 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 subir, y eso es lo que debe impulsar un selector.
Widget integrable
Habilitar los endpoints
Los endpoints ?convert=open|run|download del widget son opcionales y están deshabilitados por defecto — seguros por defecto. Habilítalos del lado del servidor, junto con el registro del plugin:
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 widget 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 endpoints ?convert= responden 404 — pero el archivo JS sigue sirviéndose de todos modos (es un recurso estático incrustado simple; solo los endpoints 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) recibe un selector CSS o un elemento, lanza una excepción si el montaje no se encuentra, 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 es posible y ofrece la descarga.
Opciones
| Opción | Tipo | Predeterminado | Notas |
|---|---|---|---|
basePath | string | /doconut | Ruta base para los endpoints ?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 mantener la consistencia de configuración con otros widgets Doconut; el widget conversor 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 solicitado |
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 apertura o ejecución 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 es capturada y registrada; nunca interrumpe el flujo del widget.
Manejo 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 File de tu propio <input type="file" id="picker">
conv.reset(); // volver a la pantalla idle/drop; no vuelve a disparar onReady
conv.loadFile(file); // inicia el flujo con un objeto File; no-op a menos que esté actualmente inactivo
conv.destroy(); // elimina los listeners, vacía el mount; la instancia es inutilizable 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 dcw clase 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 del sistema UI para --dcw-font.
Construye tu propio frontend
El widget es solo un cliente para este contrato HTTP — construye tu propio frontend directamente contra él 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 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 ?convert=open (multipart, one file) | 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 requiere uno. allowedTargets enumera nombres de objetivo en minúsculas ("pdf", "html", …); pasa uno de ellos como target, que se compara sin distinción de mayú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, {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 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 se completa — mientras que resultToken es un token de sesión de visor ordinario para previsualizar el resultado. Cuando el resultado puede previsualizarse, downloadToken y resultToken tienen 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 fue llamado) — verificado antes de que cualquiera de las tres rutas se despache | status only |
| any | 405 | Verbo HTTP incorrecto (open/run requieren POST; download requiere GET) | status only |
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 origen 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 | El procesamiento falló internamente | Un mensaje sanitizado — sanitizado de la misma manera que cualquier otro camino de error de Doconut; nunca expone detalles internos |
download | 400 | Token malformado (no es un GUID) | status only |
download | 404 | Token de descarga desconocido o expirado | status only |
Un recorrido completo con fetch:
// file: el File a convertir, por ejemplo desde un <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 same-origin: esta versión no tiene soporte CORS. Sirve tu UI y el script del widget desde el mismo origen que Doconut, o haz reverse-proxy de ambos caminos /doconut (la ruta del middleware y la ruta de recursos) bajo el origen de tu UI.
En producción
- Instala el plugin junto al paquete central, en la misma versión:
dotnet add package Doconut.NET6.Converter. - Añade el archivo de licencia. Coloca
Doconut.Viewer.Converter.licen la misma carpeta queDoconut.Viewer.lic. - Establece el límite del servidor.
MaxUploadMbenAddConverterWidgetes el límite que impone el servidor; elmaxUploadMbdel widget es solo una verificación del lado del cliente. Mantén ambos iguales. - Sirve la UI desde el mismo origen que los endpoints de Doconut, o haz un reverse-proxy de ellos (ver Construye tu propio frontend).
- Descarta los resultados de conversión. El stream que devuelve
ConvertAsyncestá en un pool; descartarlo 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. Registra el almacén de widget compartido y cifrado 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 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 nodo. Cárgalo desde un almacén secreto; nunca lo codifiques directamente. El registro lanza unArgumentExceptioncuandoRootPathfalta oFarmKeyes más corto que 32 bytes.- Apunta
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. | Sin licencia, un archivo TRIAL, una licencia sin Converter, o una licencia paga fuera de su ventana de versión | Instala una licencia que conceda Converter, o elimina AddPlugin<ConverterPlugin>() |
AddDoconut() lanza AddConverterWidget() was called but the Converter plugin is not registered. | El widget está habilitado sin su plugin | Añade 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ñade AddPlugin<ConverterPlugin>() dentro de AddDoconut() |
| La conversión de stream indica que el formato no es compatible | sourceExtension no tiene punto inicial | Pasa ".xlsx", no "xlsx" |
ConvertAsync lanza Converting '.dcm' requires the Dicom capability license. | Una fuente DICOM, y la licencia no concede Dicom | Usa una licencia que conceda Dicom |
| La salida tiene marca de agua | La licencia es temporal (Demo/NFR) | Usa una licencia paga que conceda Converter |
El widget se carga pero sus solicitudes responden 404 | AddConverterWidget() no fue llamado, o basePath no coincide con la rama donde UseDoconut() está montado | Llama a AddConverterWidget(); corrige basePath |
open responde 403 Converting this file type requires the Dicom capability license. | Una carga DICOM, y la licencia no concede Dicom | Usa una licencia que conceda Dicom |
open responde 413 File is too large. | La carga supera MaxUploadMb | Genera 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 | Ofrece solo los allowedTargets de open |
run o download responden 404 (Upload expired — please re-open the file. de run) | Han pasado los 30 minutos, o un nodo de la granja web no tiene la carga | Abre el archivo de nuevo; en una granja, registra AddDoconutDistributedWidgets |
| El widget falla cuando la UI está en otro origen | Los endpoints no tienen soporte CORS | Sirve la UI desde el mismo origen, o haz 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 del propio widget las establece en el montaje | Apunta al propio montaje: #doconut-convert.dcw o #doconut-convert |
¿Fue útil esta página?