Trabajando con la Biblioteca Document Viewer – compatible con PDF, Office y formatos CAD con anotaciones integradas, búsqueda e impresión: Guía Práctica
← Back to Blog9 min read

Trabajando con la Biblioteca Document Viewer – compatible con PDF, Office y formatos CAD con anotaciones integradas, búsqueda e impresión: Guía Práctica

La Biblioteca Document Viewer en Doconut le permite renderizar archivos PDF, Office y CAD, anotarlos, buscar en su contenido e imprimir, todo desde un único componente .NET.
Si está construyendo un portal centrado en documentos, un gestor de casos legal‑tech o una herramienta de revisión de planos de ingeniería, necesita un visor que funcione como lo hacen sus usuarios: instantáneo, seguro y sin servicios externos. Doconut ofrece esa experiencia on‑premise, dentro de su aplicación ASP.NET o .NET Core, manteniendo la base de código limpia y la huella de despliegue pequeña.

En esta guía práctica recorreremos el flujo de trabajo central de la Biblioteca Document Viewer, le mostraremos cómo incrustarla y demostraremos los tres pilares que la hacen indispensable—anotación, búsqueda (incluido OCR) e impresión controlada. Al final, tendrá un prototipo listo para ejecutar y una visión clara de cómo Doconut puede convertirse en la columna vertebral de cualquier solución empresarial con gran carga documental.

Visor empresarial seguro que muestra archivos PDF, Office y CAD con herramientas de anotación e impresión
Visor empresarial seguro que muestra archivos PDF, Office y CAD con herramientas de anotación e impresión

Implementación en Windows y Opciones de Prueba Gratuita

La biblioteca de Doconut funciona con .NET 6 y cuenta con soporte total en entornos Windows. Ya sea que aloje su aplicación en Azure, AWS o on‑premise, ofrece un rendimiento constante de renderizado y anotación.

Para comenzar rápidamente, Doconut ofrece una prueba gratuita que incluye acceso completo al motor de anotaciones, búsqueda con OCR y funciones de impresión controlada. Regístrese en el sitio oficial, descargue la licencia de prueba y siga los pasos de integración a continuación para ver la biblioteca en acción en cuestión de minutos.


Por Qué la Biblioteca Document Viewer Es un Cambio de Juego para Empresas .NET

Las empresas que gestionan contratos, esquemas de ingeniería o expedientes de empleados enfrentan tres desafíos recurrentes:

  1. Diversidad de formatos – PDFs, documentos Word, hojas de cálculo Excel y dibujos CAD coexisten en el mismo repositorio.
  2. Revisión colaborativa – Los usuarios de negocio necesitan resaltar, comentar o estampar un documento sin salir de la aplicación.
  3. Acceso regulado – La impresión debe ser auditable y el texto buscable debe estar disponible incluso para imágenes escaneadas.

La Biblioteca Document Viewer de Doconut resuelve los tres con un único componente .NET del lado del servidor que soporta más de 33 tipos de archivo—incluidos DOCX, XLSX, PPTX, DWG y DXF—listo para usar. La biblioteca renderiza cada formato de forma nativa, evitando la necesidad de Microsoft Office, Acrobat o servicios externos de conversión. Como el renderizado ocurre en el servidor, mantiene los datos sensibles detrás de su firewall, lo cual es esencial para entornos de salud, legal y financiero.

El motor de anotaciones integrado le permite agregar resaltados, dibujos a mano alzada o aprobaciones estampadas directamente en el lienzo del visor. Las anotaciones se almacenan como XML liviano, facilitando su persistencia en una base de datos o en un sistema de control de versiones. El complemento de búsqueda ofrece búsqueda instantánea de texto en cualquier documento abierto; cuando la fuente es una imagen escaneada, el motor OCR extrae cadenas buscables al vuelo. Finalmente, la función de impresión controlada le brinda la capacidad de imponer límites de rango de páginas, marcas de agua o registros de auditoría de impresión, todo mediante una única llamada API.

Juntas, estas capacidades le permiten reemplazar una pila enredada de visores de terceros, complementos JavaScript y servicios de conversión externos con una única biblioteca mantenible que escala desde unos pocos usuarios hasta despliegues empresariales.


Incrustando el Visor: Integración Paso a Paso en ASP.NET Core

A continuación se describe de forma concisa los pasos necesarios para integrar la Biblioteca Document Viewer de Doconut en una aplicación ASP.NET Core:

  1. Registrar el middleware de Doconut – configure el middleware UseDoconut para manejar el endpoint interno de mosaicos de imágenes (DocImage.axd). Este endpoint transmite páginas renderizadas como mosaicos PNG, manteniendo la UI responsiva incluso para archivos CAD grandes.
  2. Cargar la licencia – proporcione el archivo de licencia de Doconut (por ejemplo, DoconutLicense.xml) ya sea como archivo en disco o como flujo. La biblioteca lee la licencia automáticamente durante la creación de la primera instancia del visor.
  3. Crear una instancia del visor – instancie la clase Viewer, pasando los servicios requeridos como una caché distribuida o un accessor de contexto HTTP.
  4. Configurar opciones de renderizado – configure un objeto de configuración (por ejemplo, PdfConfig) para controlar el comportamiento de renderizado predeterminado, la extracción de hipervínculos y la resolución raster para dibujos CAD.
  5. Abrir un documento – invoque el método OpenDocument con la ruta del archivo (o flujo) y la configuración previamente definida. El método devuelve un token seguro que el front‑end JavaScript usa para solicitar imágenes de página, anotaciones y resultados de búsqueda.

Estos pasos generan un visor del lado del servidor para entornos Windows ejecutándose con .NET 6. El enfoque basado en tokens mantiene el cliente liviano: el front‑end solo necesita referenciar el componente visor de Doconut alojado en https://doconut.app.


Anotaciones Integradas para Flujos de Trabajo de Revisión en Tiempo Real

Las anotaciones convierten un visor pasivo en un espacio de trabajo colaborativo. El gestor de anotaciones de Doconut opera por página y almacena todo como XML, lo que permite versionar, auditar o fusionar cambios fácilmente en una base de datos.

Flujo típico de anotación

  1. Recupere el gestor de anotaciones para la página actual llamando al método GetAnnotationManager del visor, proporcionando las dimensiones de la página.
  2. Cree un objeto de anotación (por ejemplo, un sello de imagen, resaltado o dibujo a mano alzada) y establezca su posición, tamaño y propiedades visuales.
  3. Añada la anotación al gestor.
  4. Persista el XML de anotación usando GetAnnotationXml y guárdelo en su almacén de datos.
  5. Cuando el documento se vuelva a abrir, cargue el XML guardado en el visor con LoadAnnotationXML.

Escenarios empresariales

  • Legal Tech – Los abogados colocan un sello de “Firma” sobre un contrato y envían el XML a un servicio de gestión de casos para auditoría.
  • Revisión de Ingeniería – Los diseñadores añaden dibujos de corrección en rojo directamente sobre una página DWG; el XML de anotación se almacena junto al historial de revisiones.
  • RR.HH. y Reclutamiento – Los reclutadores resaltan secciones clave de un currículum, añaden comentarios y envían la versión anotada al perfil del candidato.

Como los datos de anotación residen en el servidor, mantiene control total sobre quién puede editar, ver o imprimir. La API es deliberadamente ligera: solo necesita los métodos de obtención del gestor, añadir y cargar, y puede construir funcionalidades UI adicionales (deshacer/rehacer, herramientas personalizadas) sin incorporar dependencias extra.


Búsqueda Instantánea y OCR: Haciendo Cada Documento Encontrable

Un repositorio de documentos solo es valioso cuando los usuarios pueden localizar la información que necesitan en segundos. El complemento de búsqueda de Doconut ofrece búsqueda instantánea de texto completo en cualquier archivo abierto. Para PDFs solo raster o dibujos CAD escaneados, el motor OCR integrado extrae texto bajo demanda, convirtiendo imágenes en contenido buscable sin una etapa de preprocesamiento separada.

Flujo típico de búsqueda

  1. Llame al método de búsqueda del visor (expuesto por el Search Plugin) con la palabra clave deseada.
  2. Reciba una lista de números de página coincidentes y las coordenadas de cada coincidencia.
  3. Para cada coincidencia, obtenga el gestor de anotaciones de la página y añada una anotación de resaltado temporal para mostrar al usuario dónde aparece el término.

Cuando un usuario abre un PDF escaneado de una factura, el visor ejecuta automáticamente OCR en cada página al renderizarla. El texto extraído se indexa en memoria, haciendo que búsquedas posteriores sean instantáneas. Este enfoque elimina la necesidad de un servicio OCR externo, reduce la latencia y garantiza que el texto buscable nunca abandone su entorno seguro.

Beneficios empresariales

  • Portales de clientes pueden mostrar cláusulas relevantes de un contrato con una sola pulsación de tecla.
  • Herramientas de reporte financiero permiten a los analistas localizar una partida en decenas de estados escaneados.
  • Sistemas de registros de salud se vuelven buscables por nombres de medicamentos dentro de notas médicas escaneadas, mejorando la seguridad del paciente.

Todo esto se logra sin dependencias de terceros, manteniendo la pila ligera y la superficie de cumplimiento pequeña.


Impresión Controlada desde el Visor – Seguridad y Conveniencia

La impresión suele ser el eslabón más débil en la seguridad documental. La función de impresión controlada de Doconut le otorga la autoridad para decidir qué, cuándo y cómo se puede imprimir un documento, mientras sigue ofreciendo un cuadro de diálogo de impresión familiar en el navegador.

Flujo típico de impresión

  1. Defina un objeto PrintConfig que especifique opciones como límites de rango de páginas, marcas de agua y si se debe registrar cada solicitud de impresión.
  2. Pase la configuración junto con el token del documento al método Print del visor.
  3. El visor renderiza las páginas seleccionadas en el servidor, aplica las marcas de agua y transmite el PDF imprimible al navegador del cliente.
  4. Se crea automáticamente una entrada de auditoría, permitiendo a los administradores rastrear quién imprimió qué y cuándo.

Al manejar la impresión en el servidor, Doconut garantiza que el documento original nunca salga de su entorno protegido y mantiene una visibilidad total sobre la actividad de impresión—un requisito crítico para industrias reguladas.


Conclusión

La Biblioteca Document Viewer de Doconut brinda a los equipos .NET un componente único, seguro y rico en funciones para renderizar PDFs, archivos Office y dibujos CAD, enriquecidos con anotaciones, búsqueda con OCR e impresión controlada. Con procesamiento del lado del servidor, conversión integrada y soporte para más de 33 formatos de archivo, puede eliminar costosas dependencias de terceros y mantener los datos sensibles bajo su control directo.

¿Listo para modernizar su flujo de trabajo documental empresarial? Comience su prueba gratuita de Doconut hoy, descargue la biblioteca y siga los pasos de integración descritos arriba para aportar potentes capacidades de visualización, anotación y búsqueda a su aplicación .NET en minutos.

#Doconut#.NET#Document Viewer#Enterprise Development#PDF#CAD#Annotation#Visor de Documentos#Desarrollo Empresarial#Anotación