Migración de soluciones de visualización de documentos heredados a SDKs modernos de bajo consumo
← Back to Blog9 min read

Migración de soluciones de visualización de documentos heredados a SDKs modernos de bajo consumo

El camino más rápido hacia un visor de documentos moderno, seguro y responsivo es reemplazar los componentes heredados con el SDK de bajo consumo de Doconut. Para portales web que usan Kendo UI, el SDK ofrece renderizado rápido, accesibilidad total y una ruta de integración enfocada. Las empresas que antes ensamblaban visores personalizados sobre bibliotecas solo de escritorio o servicios externos de conversión pronto se encuentran con problemas: los costos de mantenimiento aumentan, las dependencias del lado del cliente se vuelven frágiles y la accesibilidad queda en el olvido. Doconut derriba esas barreras al servir renderizado nativo de PDF, Office y CAD directamente desde un back‑end .NET, manteniendo el front‑end ligero y totalmente bajo su control.

En las siguientes secciones veremos por qué los visores tradicionales se convierten en pasivos, cómo la arquitectura de Doconut aborda esos puntos críticos y una hoja de ruta práctica de migración que puede comenzar a usar ahora mismo.

Migración de un visor heredado con muchas dependencias a un visor de documentos seguro del lado del servidor
Migración de un visor heredado con muchas dependencias a un visor de documentos seguro del lado del servidor

1. Visores heredados: costos ocultos detrás de interfaces familiares

La mayoría de los visores de documentos “heredados” nacieron cuando los navegadores todavía dependían de complementos, controles ActiveX o instalaciones pesadas de Office en el servidor. Los problemas aparecen de varias formas:

ProblemaImpacto en el mundo real
Dependencias del lado del clienteLos usuarios deben instalar o habilitar complementos del navegador; el TI corporativo los bloquea, rompiendo el flujo de trabajo.
Requisitos de Office del lado del servidorInstalar Microsoft Office en un servidor web viola las mejores prácticas de seguridad e infla los costos de licenciamiento.
Soporte limitado de formatosNuevos formatos CAD o de imagen (DWG, DXF, PNG) aparecen como no compatibles, obligando a soluciones alternativas o conversiones manuales.
Cuellos de botella de escalabilidadEl renderizado se ejecuta en la CPU del cliente; PDFs grandes o archivos Office multipágina provocan lentitud y bloqueos.
Brechas de accesibilidadLa navegación con teclado, el soporte para lectores de pantalla y el cumplimiento de WCAG a menudo son consideraciones posteriores, exponiendo a las empresas a riesgos de cumplimiento.
Pesadilla de mantenimientoLos SDK de proveedores que ya no se actualizan se convierten en vulnerabilidades de seguridad, y cada parche obliga a una redeplegación completa.

Sume esos costos ocultos a un sistema centrado en documentos —ya sea un DMS, portal CRM o plataforma de e‑learning— y el ROI se evapora rápidamente. Las empresas modernas necesitan un visor que no dependa de complementos del cliente, funcione sin Office y escale en el servidor. Doconut le brinda exactamente eso.


2. Renderizado del lado del servidor de bajo consumo: el visor PDF SDK ideal para aplicaciones modernas

La fortaleza principal de Doconut radica en su motor de renderizado de documentos del lado del servidor que envía imágenes rasterizadas al navegador, eliminando cualquier necesidad de un plugin del cliente. Así se alinea la arquitectura con los desafíos descritos:

a. Huella mínima del cliente para el navegador

  • El visor solo entrega HTML, CSS y una pequeña cantidad de JavaScript. No hay ActiveX, Flash ni Silverlight —solo activos web estándar entregados a navegadores compatibles.
  • Como el renderizado ocurre en el servidor, el cliente nunca necesita .NET Desktop, Office o un visor CAD instalado.

b. Cobertura integral de formatos

Doconut soporta de forma nativa más de 33 formatos entre Office, PDF, CAD, correo electrónico e imágenes —incluyendo DOC/DOCX, XLS/XLSX, PPT/PPTX, DWG, DXF, PNG, JPG y más. Eso elimina la “brecha de tipos de archivo” que obliga a los desarrolladores a combinar múltiples convertidores de terceros.

c. Anotaciones, búsqueda e impresión controlada integradas

  • Plugin de anotaciones – añada resaltados, comentarios o dibujos a mano alzada directamente en el visor.
  • Plugin de búsqueda – búsqueda de texto instantánea en todo el documento, con OCR para imágenes escaneadas.
  • Impresión controlada – aplique políticas de impresión desde la UI del visor, evitando copias no autorizadas.

d. Conversión del lado del servidor para flujos sin Office

El Plugin de conversión permite transformar archivos Word, Excel, PowerPoint y CAD a PDF, PNG o HTML en el servidor. No se necesita instalación de Microsoft Office, ni SaaS externo, y los datos nunca abandonan su firewall.

e. Accesibilidad incorporada

Doconut sigue las directrices WCAG 2.2 AA de forma predeterminada: navegación con teclado, etiquetas ARIA y marcado amigable para lectores de pantalla están integrados en el HTML del visor. Cumplir con las políticas corporativas de accesibilidad pasa a ser cuestión de activar la función, no de construirla desde cero.

f. Integración fluida con pilas .NET modernas

Ya sea que use ASP.NET Core, .NET 6 o una arquitectura de micro‑servicios, Doconut se conecta al pipeline de solicitudes con una única llamada de middleware. El visor puede integrarse con componentes Kendo UI o cualquier front‑end web compatible.


3. Plan de migración: de lo heredado a Doconut

A continuación se muestra un plan pragmático, paso a paso, que puede seguir en una aplicación web .NET existente. El objetivo es sustituir el visor antiguo por Doconut manteniendo estable la API pública para los consumidores posteriores.

Paso 1: Preparar el entorno

  1. Añada el paquete NuGet de Doconut a su solución.
  2. Asegúrese de que el servidor ejecute .NET 6 (o superior); el optimizador de dependencias de Doconut brilla con el runtime más reciente.

Paso 2: Registrar el middleware de Doconut

Inserte el middleware de Doconut temprano en el pipeline de ASP.NET para que las solicitudes de imágenes de documentos renderizadas sean interceptadas y procesadas por el motor de Doconut.

Paso 3: Cargar la licencia

Al iniciar la aplicación, cargue el archivo de licencia de Doconut (o documento XML) una sola vez. Si dispone de licencias específicas de plugins (p. ej., para el Plugin de anotaciones), cárguelas mediante la API correspondiente de Doconut.

Paso 4: Reemplazar llamadas de renderizado antiguas

Identifique los lugares donde el código heredado genera una página del documento como bitmap o arreglo de bytes. Sustituya esas llamadas por el flujo de apertura de documentos de Doconut, que devuelve un token que representa el documento abierto. Use el token para solicitar imágenes de página o miniaturas a través de los endpoints de servicio de imágenes de Doconut.

Paso 5: Habilitar anotaciones y búsqueda

Mapee cualquier funcionalidad existente de “añadir comentario” o “buscar” a los plugins de Anotaciones y Búsqueda de Doconut. Ambos plugins exponen métodos simples del lado del servidor que devuelven payloads JSON, consumibles por su front‑end.

Paso 6: Actualizar la integración del front‑end

Como Doconut transmite imágenes renderizadas, el front‑end solo necesita una etiqueta <img> por página o un visor basado en canvas. Para Kendo UI, vincule las URLs de imágenes a un Kendo Carousel para una navegación fluida entre páginas.

Paso 7: Probar, optimizar, desplegar

  • Rendimiento – mida el tiempo hasta la primera página; el renderizado rasterizado del lado del servidor de Doconut suele ofrecer resultados en menos de un segundo para PDFs estándar.
  • Seguridad – verifique que ningún dato del documento se filtre al cliente más allá de las imágenes renderizadas.
  • Accesibilidad – realice una auditoría con lector de pantalla; el marcado de Doconut ya incluye roles ARIA.

Cuando la suite de pruebas sea satisfactoria, reemplace la ruta del visor heredado por el nuevo endpoint de Doconut y despliegue la actualización.


4. Mejorando la accesibilidad y la experiencia de usuario con Doconut y Kendo UI

La accesibilidad ya no es opcional; es un requisito en muchas industrias reguladas (salud, finanzas, sector público). El cumplimiento “out‑of‑the‑box” de Doconut le ayuda a alcanzar esos estándares sin escribir código personalizado.

Cada elemento interactivo —navegación de páginas, controles de zoom, herramientas de anotación— expone atributos tabindex estándar. Los usuarios pueden desplazarse por el documento usando solo el teclado, un requisito indispensable para el cumplimiento de la Sección 508.

Etiquetas ARIA y lectores de pantalla

El HTML del visor incluye role="document" y atributos descriptivos aria-label que comunican número de página y nivel de zoom a las tecnologías asistivas. No es necesario añadir scripts ARIA adicionales.

Modo de alto contraste

Doconut puede reflejar las preferencias de alto contraste configuradas en la interfaz del visor. La UI puede cambiar a un esquema oscuro‑sobre‑claro, manteniendo la legibilidad para usuarios con discapacidad visual.

Integración con Kendo UI

Los widgets accesibles de Kendo UI (p. ej., kendoButton, kendoSlider) pueden superponerse al renderizado de imágenes de Doconut. El resultado es un visor fluido, totalmente navegable con teclado, que se siente nativo dentro del resto de su aplicación.


5. Preparando el futuro: ampliando el visor con plugins

La arquitectura modular de plugins de Doconut permite comenzar con la visualización básica y activar capacidades adicionales a medida que evolucionan las necesidades del negocio.

PluginBeneficio principalUso típico en la empresa
Plugin de anotacionesResaltar, comentar, dibujarRevisión legal, órdenes de cambio de ingeniería
Plugin de búsquedaBúsqueda de texto completo, con OCRBúsqueda de registros de salud, auditoría financiera
Plugin de conversiónConversión Office → PDF/HTML del lado del servidorIngesta en DMS, generación automática de informes
Impresión controladaCuotas de impresión, marcas de aguaContratos confidenciales, presentaciones reguladas

Como todos los plugins se ejecutan en el servidor, mantiene control centralizado sobre el manejo de datos, licenciamiento y escalado. Añadir un nuevo plugin es tan simple como cargar su licencia y llamar a la API correspondiente, sin necesidad de recompilar el front‑end.


Conclusión

Modernizar su pila de visualización de documentos no tiene por qué ser una reforma costosa y arriesgada. Adoptando el motor de renderizado del lado del servidor y bajo consumo de Doconut obtiene:

  • Amplio soporte de formatos sin convertidores externos.
  • Anotaciones, búsqueda e impresión controlada integrados que cumplen con normativas.
  • Accesibilidad empresarial lista para usar.
  • Integración fluida con proyectos .NET y Kendo UI existentes.

¿Listo para retirar los visores heredados y ofrecer a sus usuarios una experiencia más rápida y segura? Comience su migración con Doconut hoy: descargue el SDK, siga la hoja de ruta de migración y note la diferencia en minutos.

#document rendering#PDF Viewer SDK#legacy migration#enterprise .NET#Doconut#renderizado de documentos#SDK de visor PDF#migración heredada#empresa .NET