La visualización de documentos incrustada debe sentirse como parte de la aplicación, no como una transferencia a una antigua extensión del navegador o a un programa de escritorio instalado localmente. Para proyectos ASP.NET y .NET basados en Windows, Doconut ofrece un SDK de visor de documentos que puede renderizar documentos empresariales dentro de su aplicación web.
Esta guía explica la arquitectura de una experiencia de visualización sin complementos sin presentar código fuente no documentado de Doconut.
Qué Significa “Sin Complementos”
Un visor sin complementos no solicita al usuario final que instale tecnologías como ActiveX, Flash, Silverlight o una extensión personalizada del navegador antes de abrir un documento.
Eso reduce varias fuentes de fricción:
- Los usuarios no necesitan permisos de instalación local.
- Los equipos de TI no necesitan distribuir y actualizar un complemento del lado del cliente.
- La aplicación mantiene el flujo de visualización dentro de su propia interfaz.
- Las dependencias de complementos heredados no se convierten en una condición para abrir un archivo.
Sin complementos no significa sin dependencias. El servidor aún necesita el SDK correcto, tiempo de ejecución, fuentes, acceso al almacenamiento, configuración y licencia. La aplicación también sigue siendo responsable de la autenticación, autorización, retención y monitoreo.
Por Qué la Renderización de Documentos en el Servidor Ayuda
Los documentos empresariales son más complejos que el contenido web ordinario. Los archivos de Office, dibujos CAD, mensajes de correo electrónico e imágenes de alta resolución requieren cada uno un procesamiento consciente del formato.
Un componente .NET del lado del servidor puede manejar ese procesamiento mientras la aplicación web presenta la experiencia de visualización resultante. Esto evita solicitar a cada usuario que instale el software de autoría original.
Doconut está diseñado para este rol. Su información de producto actual describe soporte para tipos de documentos que incluyen PDF, documentos de Office, dibujos CAD, archivos de correo electrónico e imágenes. Confirme los formatos exactos y las características requeridas por su aplicación en la página del visor Doconut.
Planifique el Flujo de Visualización
Una solicitud de documento segura normalmente sigue estos pasos:
- El usuario selecciona un documento usando un identificador de la aplicación.
- ASP.NET autentica la solicitud.
- El servidor verifica el acceso a ese documento específico.
- La aplicación resuelve la ubicación de almacenamiento protegida.
- El documento se pasa a la capa de visualización usando el método de integración soportado.
- La aplicación registra el resultado y libera los recursos temporales.
El cliente nunca debe recibir credenciales de almacenamiento, rutas de servidor sin restricciones, o más información del documento de la que requiere la sesión autorizada.
Use los Límites de Seguridad Estándar de ASP.NET
La página de visualización debe protegerse como cualquier otro recurso sensible.
Mecanismos estándar de .NET pueden incluir:
- Middleware de autenticación
- El atributo
[Authorize] - Políticas y reclamaciones de autorización
- Autorización basada en recursos
- Inyección de dependencias para servicios de almacenamiento y visualización
- Registro estructurado con filtrado de datos sensibles
La autorización debe evaluarse en el servidor. Ocultar una acción de la barra de herramientas o una ruta en la interfaz de usuario no impide que un cliente determinado la solicite directamente.
Mantenga el Acceso al SDK Detrás de un Servicio de Aplicación
Evite distribuir llamadas específicas del visor a lo largo de controladores y páginas. Un servicio de aplicación dedicado puede:
- Resolver identificadores de documentos autorizados
- Abrir un
Streamcontrolado - Aplicar configuración para la versión del SDK instalada
- Liberar recursos de archivo y stream
- Convertir fallas técnicas en errores de aplicación seguros
- Registrar tiempos y diagnósticos sanitizados
Este límite hace que la aplicación sea más fácil de probar y reduce el impacto de futuras actualizaciones del SDK.
Use los recursos oficiales de descarga y documentación de Doconut para la instalación de paquetes y la guía de API específica por versión.
Construya un Host de Visor Útil
El contenedor del visor, propiedad de la aplicación, debe disponer de suficiente espacio para documentos reales. Evite tarjetas estrechas y anchos de escritorio fijos.
.viewer-workspace {
display: grid;
grid-template-rows: auto minmax(0, 1fr);
width: 100%;
min-height: 36rem;
height: calc(100dvh - 4rem);
}
.viewer-host {
min-width: 0;
min-height: 0;
overflow: hidden;
}
Este es CSS estándar para la página circundante, no una configuración de Doconut. No apunte a selectores internos no documentados ni invente opciones del SDK.
La página también debe proporcionar:
- Un estado de carga claro
- Un mensaje de error seguro
- Un título de documento visible
- Una forma de volver al flujo de trabajo principal
- Controles de aplicación accesibles
- Suficiente espacio para hojas de cálculo anchas y dibujos detallados
Valide los Documentos Antes de Renderizar
Si los usuarios cargan archivos, verifique:
- Tamaño del archivo
- Extensión y firma del archivo
- Formato soportado
- Requisitos de contraseña o cifrado
- Restricciones específicas del negocio
- Nombre de almacenamiento generado por el servidor
No construya rutas del servidor directamente a partir del nombre de archivo original. Almacene un identificador de aplicación seguro y resuélvalo a través de un servicio autorizado del lado del servidor.
Prepare el Servidor Windows
El comportamiento de renderizado puede depender del entorno del servidor. Confirme:
- Versiones compatibles de Windows y .NET
- Fuentes requeridas
- Ubicación y permisos del almacenamiento temporal
- CPU, memoria y capacidad de disco disponibles
- Tamaño máximo de documento y sesiones concurrentes
- Configuración de licencia
- Procedimientos de limpieza
Pruebe documentos representativos de clientes en un entorno que coincida con la producción.
Lista de Verificación de Seguridad y Privacidad
Antes del lanzamiento:
- Autenticar las solicitudes de visualización donde sea necesario.
- Autorizar al usuario para el documento específico.
- Mantener las rutas de almacenamiento y credenciales en el servidor.
- Restringir los permisos de archivos temporales.
- Definir la retención de originales, datos temporales y exportaciones.
- Sanitizar los errores mostrados a los usuarios.
- Excluir el contenido de los documentos y secretos de los registros.
- Aplicar límites de carga y concurrencia.
- Mantener el SDK y las dependencias de la aplicación actualizadas.
Las afirmaciones sobre cumplimiento deben reflejar el sistema completo desplegado y los procesos de su organización, no un solo componente de UI.
Pruebe Más Allá del Camino Feliz
Su biblioteca de pruebas debe incluir:
- PDFs de varias páginas
- Hojas de cálculo grandes
- Dibujos CAD detallados
- Presentaciones con fuentes poco comunes
- Archivos de correo electrónico con adjuntos
- Imágenes grandes
- Archivos dañados y no soportados
- Solicitudes no autorizadas
- Sesiones de visualización concurrentes
- Solicitudes interrumpidas y reinicios de la aplicación
Confirme que los fallos no revelen rutas del servidor, rastros de pila o URLs de almacenamiento.
Dónde Encaja Doconut
Doconut suministra la capacidad de visualización de documentos incrustada dentro de una aplicación web .NET. Su aplicación proporciona la seguridad circundante, almacenamiento, flujo de trabajo, diseño responsivo y controles operacionales.
Esa separación permite a los equipos reemplazar flujos de trabajo dependientes de complementos heredados sin pretender que el manejo de documentos se vuelva sin esfuerzo o sin responsabilidad.
Explore el SDK verificado del visor de documentos .NET de Doconut, luego use la página de descarga oficial para las instrucciones que coincidan con la versión seleccionada.
Conclusión
Una experiencia de documentos sin complementos reduce la fricción de instalación y mantiene a los usuarios dentro de su aplicación. Constrúyala sobre un flujo de documentos autorizado por el servidor, aísle el acceso al SDK, proporcione un host de visor amplio y pruebe archivos reales bajo una carga similar a la producción.
Para aplicaciones ASP.NET y .NET basadas en Windows, Doconut puede proporcionar la capa de visualización de documentos mientras su equipo mantiene el control de la aplicación y del ciclo de vida del documento.