Integrando SDKs del 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 a píxel sin importar el sistema operativo subyacente. Como el visor trabaja con streams, puede extraer un archivo de cualquier bucket en la nube, pasarlo directamente al componente 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 el archivo completo 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 la renderización 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 enfoque en la seguridad
Todo el trabajo pesado permanece en el servidor. Al usar las capacidades de procesamiento del lado del servidor de Doconut, mantiene PDFs confidenciales, contratos legales o historiales 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 imagen o fragmentos HTML que usted genera detrás de escena.
Conectando Doconut a los servicios de almacenamiento en la nube más populares
Enfoque general de integración
- Obtenga el stream del documento – Utilice el SDK del proveedor de nube elegido (Azure Blob, Amazon S3, Google Cloud Storage) para descargar el archivo en un objeto
Stream. - Pase el stream a Doconut – El visor Doconut acepta un stream junto con opciones de renderizado opcionales. Esto elimina la necesidad de archivos temporales en el servidor web.
- Genere un token del 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.
- Renderice 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 una imagen o fragmento HTML.
Dado que 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.
Gestión de almacenamiento multitenant
En un DMS SaaS, cada inquilino puede tener un bucket o prefijo separado. Como 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 se sirvan desde memoria en lugar de volver a renderizarse.
Habilitando anotaciones en tiempo real y OCR dentro de flujos de trabajo colaborativos
Complemento de anotación: convirtiendo un visor estático en un hub de revisión
Doconut incluye un Complemento de Anotación que permite a los usuarios resaltar texto, añadir notas adhesivas o dibujar formas a mano alzada. Después de abrir un documento, obtiene un administrador 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 y rectángulos delimitadores coincidentes, 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 ofrecer 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 devuelta por Doconut en 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, conservando anotaciones y capas de OCR para todos los participantes.
Conversión segura del lado del servidor e impresión controlada con Doconut
Muchas empresas necesitan convertir archivos de Word, Excel o CAD entrantes a PDF para archivado, o aplicar una política de “imprimir solo si está 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 la 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 pulsa el botón de imprimir, Doconut verifica la bandera y, según el caso, genera un stream de imagen imprimible o devuelve un mensaje amistoso 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 atraviesa el middleware de Doconut, puede engancharse al pipeline de registro de ASP.NET Core para capturar quién imprimió qué y cuándo. Guarde la entrada de auditoría en una tabla SQL o envíela a un sistema SIEM para informes de cumplimiento—crucial para soluciones legales o de salud donde cada acceso a documento debe ser trazable.
Mejores prácticas para escalar y optimizar el rendimiento en entornos multiplataforma
- Aproveche 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. - Utilice trabajos en segundo plano para conversiones masivas – Al incorporar un gran archivo, encole tareas de conversión con Hangfire o Azure Functions. La clase del visor Doconut funciona con workers
IHostedServiceporque acepta streams y devuelve tokens sin requerir un contexto HTTP. - Ajuste la resolución de imagen por dispositivo – Los dispositivos móviles se benefician de un
ImageResolutionmás bajo (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 del agente de usuario o una configuración del cliente. - Habilite la carga perezosa 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.
- Monitoree la huella de memoria – Renderizar páginas CAD de alta resolución puede consumir mucha memoria. Configure el GC de .NET para usar modo servidor en producción (
<gcServer enabled="true"/>) y establezca un tiempo de espera razonable para evitar trabajos de renderizado descontrolados. - Aplique una CDN para los recursos estáticos – Los paquetes JavaScript y CSS del visor son estáticos. Sírvalos desde Azure CDN, CloudFront o Cloudflare para recortar milisegundos del tiempo de carga inicial, especialmente para equipos distribuidos globalmente.
Siguiendo estas directrices, podrá 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 que muchos portales empresariales buscan alcanzar.
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, añadir el paquete NuGet a un nuevo proyecto ASP.NET Core y seguir la guía de inicio rápido. En cuestión de minutos tendrá un visor funcional que puede extraer documentos de Azure Blob, habilitar anotaciones, ejecutar búsquedas basadas en OCR y realizar conversiones seguras del lado del servidor. Para instrucciones paso a paso, visite la documentación de Doconut y comience a construir su experiencia de documento nativa en la nube hoy mismo.
¿Listo para transformar sus flujos de trabajo de documentos? Regístrese ahora para 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.