
Integrando SDKs de Visor de Documentos con Almacenamiento en la Nube y Plataformas de Colaboración

Por qué la visualización de documentos nativa en la nube es importante para las aplicaciones .NET modernas
Consistencia multiplataforma con un único núcleo .NET
Las empresas se están alejando de las herramientas de documentos solo de escritorio y adoptando experiencias web‑first que se ejecutan en Windows. El motor de renderizado del lado del servidor de Doconut funciona en .NET 6 y versiones posteriores, garantizando la misma salida píxel‑perfecta sin importar el sistema operativo subyacente. Como el visor trabaja con streams, puede obtener un archivo de cualquier bucket en la nube, alimentarlo directamente al componente visor de Doconut y devolver páginas renderizadas o miniaturas al cliente sin escribir nunca el archivo en disco.
Reducción de latencia y ancho de banda
Cuando un documento reside en Azure Blob Storage, descargar todo el archivo al cliente solo para ver la primera página genera latencia innecesaria. Doconut admite la generación de miniaturas bajo demanda, lo que le permite solicitar primero una vista previa de baja resolución y obtener el renderizado de página completa solo cuando el usuario se desplaza. Este patrón es especialmente valioso para dibujos CAD grandes (DWG, DXF) que pueden alcanzar cientos de megabytes.
Procesamiento con prioridad de seguridad
Todo el procesamiento intensivo permanece en el servidor. Al usar las capacidades de procesamiento del lado del servidor de Doconut, mantiene los PDFs confidenciales, contratos legales o registros médicos dentro de su VNet privada o detrás de un firewall corporativo. No se llama a ningún SaaS de terceros, y el visor nunca transmite bytes crudos al motor del navegador, solo mosaicos de imágenes o fragmentos HTML que usted genera en segundo plano.
Conectando Doconut a Servicios de Almacenamiento en la Nube Populares
Enfoque general de integración
- Obtener el stream del documento – Utilice el SDK de su proveedor de nube elegido (Azure Blob, Amazon S3, Google Cloud Storage) para descargar el archivo en un objeto
Stream. - Pasar el stream a Doconut – El visor de Doconut acepta un stream junto con opciones de renderizado opcionales. Esto elimina la necesidad de archivos temporales en el servidor web.
- Generar un token de visor – Doconut devuelve un token que identifica de forma única el documento abierto para la sesión actual. El token puede devolverse al front‑end como JSON y usarse en solicitudes posteriores de renderizado de página o anotación.
- Renderizar páginas bajo demanda – El front‑end llama al endpoint de Doconut con el token y el número de página deseado; Doconut devuelve un flujo con una imagen o fragmento HTML.
Como el flujo de trabajo depende únicamente de streams, cambiar el código de Azure por Amazon S3 o Google Cloud Storage solo requiere modificar la llamada al SDK de la nube que crea el stream; el resto de la canalización de Doconut permanece idéntico.
Manejo de almacenamiento multi‑inquilino
En un DMS SaaS, cada inquilino puede tener un bucket o prefijo separado. Dado que Doconut trabaja con streams, puede resolver el bucket correcto en tiempo de ejecución, abrir el documento y mantener el token limitado a las reclamaciones del usuario actual. La caché interna de Doconut (IDistributedCache) puede configurarse para usar Redis o Azure Cache for Redis, garantizando que las solicitudes repetidas de la misma página accedan a la memoria en lugar de volver a renderizar.
Habilitando Anotaciones en Tiempo Real y OCR dentro de Flujos de Trabajo Colaborativos
Complemento de anotación: convirtiendo un visor estático en un centro de revisión
Doconut incluye un Complemento de Anotación que permite a los usuarios resaltar texto, agregar notas adhesivas o dibujar formas a mano alzada. Después de abrir un documento, obtiene un gestor de anotaciones del visor, agrega o modifica objetos de anotación y persiste el estado de la anotación como XML. Almacenar el XML junto al registro del documento permite historiales de revisión versionados, y cargar el XML en aperturas posteriores restaura el estado visual exacto.
Búsqueda impulsada por OCR para PDFs escaneados
Los contratos, recibos o imágenes médicas escaneados a menudo llegan como PDFs solo de imagen. El Complemento de Búsqueda de Doconut ejecuta automáticamente OCR en el servidor cuando lo habilita en la configuración del visor. El motor OCR reside dentro de la pila del lado del servidor, por lo que el texto extraído nunca abandona su entorno protegido. Una vez completado el OCR, puede llamar a la API de búsqueda para obtener los números de página coincidentes y los rectángulos delimitadores, que la UI puede resaltar. Como el OCR se ejecuta en el servidor, también puede indexar el texto extraído en Azure Cognitive Search, Elasticsearch o cualquier otro servicio de búsqueda para proporcionar búsqueda de texto completo instantánea en todo su repositorio.
Colaboración mediante tokens compartidos
En integraciones con Teams o SharePoint, normalmente genera un token de corta duración que codifica el ID del documento, los permisos del usuario y una marca de tiempo. La cadena de token de Doconut devuelta por la llamada OpenDocument puede envolver‑se en un JWT o almacenarse en una entrada de caché. Cuando otro usuario hace clic en el enlace compartido, se usa el mismo token para rehidratar el visor, preservando anotaciones y capas de OCR para todos los involucrados.
Conversión Segura del Lado del Servidor e Impresión Controlada con Doconut
Muchas empresas necesitan convertir archivos entrantes de Word, Excel o CAD a PDF para archivado, o aplicar una política de “imprimir‑solo‑si‑aprobado”. El Complemento de Conversor de Doconut maneja estos escenarios sin requerir Microsoft Office ni servicios de terceros. Invoca la API de conversión en el servidor, pasando la ruta del archivo fuente (o stream) y el formato de salida deseado. La conversión se ejecuta completamente en el back‑end, produciendo un PDF que puede almacenarse en su repositorio de documentos.
Una vez que el PDF existe, puede habilitar Impresión Controlada directamente en la UI del visor. Doconut expone un método para establecer permisos de impresión para un token de documento dado. Cuando el usuario hace clic en el botón de imprimir, Doconut verifica la bandera y renderiza un stream de imagen imprimible o devuelve un mensaje amigable de “impresión deshabilitada”. Este enfoque elimina la necesidad de JavaScript personalizado para bloquear el cuadro de diálogo de impresión del navegador.
Auditoría de la actividad de impresión
Como la solicitud de impresión pasa por el middleware de Doconut, puede engancharse al pipeline de registro de ASP.NET Core para capturar quién imprimió qué y cuándo. Almacene la entrada de auditoría en una tabla SQL o envíela a un sistema SIEM para informes de cumplimiento, lo cual es crítico para soluciones de tecnología legal o sanitaria donde cada acceso a documentos debe ser rastreable.
Mejores Prácticas para Escalar y Rendimiento en Entornos Multiplataforma
- Aprovechar la caché distribuida – La caché interna de mosaicos de página de Doconut puede respaldarse con Redis, Azure Cache o cualquier implementación de
IDistributedCache. Incluya el hash de versión del documento en las claves de caché para evitar servir imágenes obsoletas después de una conversión. - Utilizar trabajos en segundo plano para conversiones masivas – Al incorporar un archivo grande, encole tareas de conversión con Hangfire o Azure Functions. La clase visor de Doconut funciona con workers
IHostedServiceporque acepta streams y devuelve tokens sin requerir un contexto HTTP. - Ajustar la resolución de imagen por dispositivo – Los dispositivos móviles se benefician de una
ImageResolutionmás baja (150‑200 DPI), mientras que las estaciones de trabajo de escritorio pueden solicitar 300 DPI para detalle CAD. Ajuste la resolución según la cadena user‑agent o una configuración del lado del cliente. - Habilitar carga diferida de anotaciones – Almacene el XML de anotaciones en una tabla separada y cárguelo solo cuando el usuario abra el panel de anotaciones. Esto reduce la carga inicial y acelera el renderizado de la primera página.
- Monitorear la huella de memoria – Renderizar páginas CAD de alta resolución puede consumir mucha memoria. Configure el GC de .NET para usar el modo servidor en producción (
<gcServer enabled="true"/>) y establezca un tiempo de espera razonable para evitar trabajos de renderizado descontrolados. - Aplicar una CDN para activos estáticos – Los paquetes JavaScript y CSS del visor son estáticos. Sírvalos desde Azure CDN, CloudFront o Cloudflare para reducir milisegundos en la carga inicial de la página, especialmente para equipos distribuidos globalmente.
Siguiendo estas directrices, puede soportar miles de usuarios concurrentes en todos los continentes mientras mantiene la latencia por debajo de 200 ms para la primera página, un punto de referencia al que aspiran muchos portales empresariales.
Comenzando Rápidamente con la Prueba Gratuita de Doconut
La forma más rápida de evaluar Doconut es descargar la prueba gratuita desde el sitio oficial, agregar el paquete NuGet a un nuevo proyecto ASP.NET Core y seguir la guía de inicio rápido. En pocos minutos tendrá un visor funcional que puede extraer documentos de Azure Blob, habilitar anotaciones, ejecutar búsqueda basada en OCR y realizar conversiones seguras del lado del servidor. Para instrucciones paso a paso, visite la documentación de Doconut y comience a crear su experiencia de documentos nativa en la nube hoy mismo.
¿Listo para transformar sus flujos de trabajo de documentos? Regístrese ahora en la prueba gratuita de Doconut y vea lo fácil que es ofrecer experiencias de documentos seguras, buscables y colaborativas en cualquier aplicación .NET.