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 completa 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 aún dependían de complementos, controles ActiveX o instalaciones pesadas de Office en el servidor. Los problemas aparecen de varias maneras:

ProblemaImpacto real
Dependencias del lado del clienteLos usuarios deben instalar o habilitar complementos del navegador; el departamento de TI corporativo los bloquea, interrumpiendo 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 incrementa los costos de licencias.
Soporte limitado de formatosLos nuevos formatos CAD o de imagen (DWG, DXF, PNG) aparecen sin soporte, obligando a soluciones alternativas o conversiones manuales.
Cuellos de botella de escalabilidadEl renderizado se ejecuta en la CPU del cliente; PDFs grandes o archivos de Office de varias páginas 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 riesgos 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 SDK de visor PDF ideal para aplicaciones modernas

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

a. Huella mínima del cliente para el navegador

  • El visor entrega solo HTML, CSS y una pequeña cantidad de JavaScript. No hay ActiveX, Flash ni Silverlight—solo recursos 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 categorías 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. Anotación, búsqueda e impresión controlada integradas

  • Plugin de anotación – añada resaltados, comentarios o dibujos a mano alzada directamente en el visor.
  • Plugin de búsqueda – búsqueda instantánea de texto 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 conversor le permite transformar archivos Word, Excel, PowerPoint y CAD a PDF, PNG o HTML en el servidor. No se requiere 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 desarrollarla 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 downstream.

Paso 1: Preparar el entorno

  1. Añada el paquete NuGet de Doconut a su solución.
  2. Asegúrese de que su 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 anotación), cárguelas mediante la API correspondiente de Doconut.

Paso 4: Reemplazar llamadas de renderizado antiguas

Identifique los lugares donde el código heredado renderiza una página de documento a bitmap o a un 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 Anotación y Búsqueda de Doconut. Ambos plugins exponen métodos simples del lado del servidor que devuelven payloads JSON, los cuales su front‑end puede consumir.

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

Dado que 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 transició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. Mejora de accesibilidad y UX 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 estándar tabindex. Los usuarios pueden desplazarse por el documento usando solo el teclado, un requisito indispensable para la conformidad con 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úmeros de página y nivel de zoom a las tecnologías asistivas. No necesita 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? Un visor totalmente navegable con teclado que se siente nativo al resto de su aplicación.


5. Futuro a prueba de tiempo: 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 anotaciónResaltar, 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 conversorConversión del lado del servidor Office → PDF/HTMLPipelines de ingestión 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, licencias y escalado. Añadir un nuevo plugin es tan simple como cargar su licencia y llamar a la API correspondiente—no se requiere recompilación del front‑end.


Conclusión

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

  • Amplio soporte de formatos sin conversores externos.
  • Anotación, búsqueda e impresión controlada integradas 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 vea 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