Subsecciones de Instalación
Requisitos del sistema
Los SDK de Documentize están diseñados para integrarse con aplicaciones .NET y soportar varios sistemas operativos y entornos de desarrollo. A continuación se presentan los requisitos clave del sistema:
Sistemas Operativos Soportados
Windows
- Windows 7 (x64, x86)
- Windows 8, 8.1 (x64, x86)
- Windows 10 (x64, x86)
- Windows 11 (x64, x86)
- Windows Server 2003 a Windows Server 2022 (x64, x86)
- Nube: Microsoft Azure
macOS
- macOS 10.12 (Sierra) y posterior
Linux
- Compatible con múltiples distribuciones de Linux:
- Ubuntu (16.04, 18.04, 20.04, 22.04)
- CentOS (7, 8)
- Debian (9, 10)
- OpenSUSE (Leap 15+, SLES 12+)
Android
- Soporta Android 8.0 (Oreo) y posterior.
Entornos de Desarrollo
- Microsoft Visual Studio:
- Visual Studio 2010 y posterior (incluyendo 2019 y 2022)
- Soporta cualquier entorno de desarrollo que apunte a plataformas .NET.
Marcos de .NET Soportados
- .NET Framework 4.0 y superior
- .NET Standard 2.0 (.NET Core 3.1+)
- .NET 6.0, .NET 7.0, .NET 8.0
Notas Adicionales
- Adobe Acrobat no es necesario para ejecutar los SDK de Documentize, pero se recomienda para ver PDFs.
Declaración
Los SDKs de Documentize.com requieren un conjunto de permisos de Confianza Total cuando se utilizan dentro de aplicaciones .NET. Este nivel de permiso es esencial para que los SDKs realicen ciertas operaciones a nivel de sistema, como acceder a configuraciones del registro, archivos del sistema y analizar fuentes.
Por qué se Requiere Confianza Total
Los SDKs de Documentize utilizan clases del sistema .NET core, que a menudo necesitan permisos elevados por las siguientes razones:
- Acceso al Registro: Algunas operaciones pueden requerir leer o escribir en el registro del sistema.
- Archivos del Sistema: Puede ser necesario acceder a archivos del sistema más allá del directorio virtual de la aplicación para ciertas tareas, como manejar fuentes o realizar operaciones con archivos.
En entornos de alojamiento que imponen seguridad de Confianza Media, varios permisos importantes están restringidos o no disponibles. Esto podría impedir que los SDKs funcionen correctamente en tales entornos. Las siguientes restricciones se aplican bajo Confianza Media:
- OleDbPermission: No se puede utilizar el proveedor de datos OLE DB administrado de ADO.NET para acceder a bases de datos.
- EventLogPermission: El acceso al Registro de Eventos de Windows está prohibido.
- ReflectionPermission: Se impide el uso de reflexión, lo que puede afectar ciertas operaciones dinámicas.
- RegistryPermission: El acceso al registro del sistema está denegado.
- WebPermission: La comunicación está restringida a direcciones o rangos predefinidos según lo configurado en el elemento
<trust>
. - FileIOPermission: El acceso a los archivos está limitado a aquellos dentro del directorio virtual de la aplicación.
Non-Windows Environment
Los SDKs de Documentize son compatibles con .NET Standard 2.0, lo que permite su uso en aplicaciones .NET Core que se ejecutan en Linux u otros entornos que no son Windows. Para garantizar un rendimiento óptimo y un renderizado de texto correcto, sigue los pasos a continuación:
Configuración Recomendada para Linux
1. Instala el Paquete libgdiplus
Este paquete proporciona la funcionalidad GDI+ necesaria, que es crítica para renderizar y procesar PDFs. Puedes instalarlo ejecutando el siguiente comando en tu terminal:
sudo apt-get install libgdiplus
2. Instala Fuentes Compatibles con Microsoft
Para un renderizado de texto correcto, instala las fuentes TrueType de Microsoft usando el comando:
sudo apt-get install ttf-mscorefonts-installer
Estas fuentes deben colocarse en el directorio /usr/share/fonts/truetype/msttcorefonts
. Si tu sistema almacena fuentes en un directorio diferente, actualiza la ruta en tu código antes de realizar operaciones con los SDKs de Documentize:
Documentize.Text.FontRepository.Sources.Add(new FolderFontSource("<path to ms fonts>"));
Consejo
Al asegurar que estas instalaciones estén completas y configurando correctamente la ruta de las fuentes, podrás maximizar el rendimiento de los SDKs de Documentize en Linux u otros sistemas que no son Windows.
License and Evaluation
Evalúe Documentize para .NET
Cuando comience a trabajar con los productos de Documentize, podrá utilizarlos de inmediato con una licencia de evaluación gratuita. Esta licencia permite a desarrolladores y empresas explorar, probar e integrar las características de Documentize en sus aplicaciones antes de realizar una compra.
¿Qué es una Licencia de Evaluación?
La licencia de evaluación es un modo de prueba incorporado y sin límite de tiempo incluido en cada producto de Documentize. Le da acceso a la mayoría de las funciones principales para que pueda evaluar completamente las capacidades del producto en escenarios del mundo real. Ya sea que esté generando, editando o convirtiendo documentos, puede probar el rendimiento y la integración con su pila.
Características Clave de la Licencia de Evaluación
- ✅ No se necesita instalación – Simplemente descargue y comience a usar los productos de Documentize.
- 🧪 Explorar la funcionalidad básica – Pruebe características esenciales como conversión, manipulación y exportación de documentos.
- 💻 Amigable para desarrolladores – Ideal para pruebas de concepto (POC), pruebas de integración o evaluaciones técnicas.
- 🔁 Fácil de actualizar – Cambie a una licencia completa en cualquier momento sin cambiar su implementación.
Si desea actualizar a una licencia completa, necesita agregar el siguiente código:
License.Set("path_to_your_license_file.lic");
Limitaciones del Modo de Evaluación
Si bien las licencias de evaluación ofrecen un amplio acceso, hay algunas limitaciones diseñadas para proteger el producto licenciado:
- Todas las páginas en los documentos PDF generados están marcadas.
- En la versión de evaluación, solo puede procesar las primeras cuatro páginas de un documento.
- Las licencias de evaluación no están destinadas para producción o implementación comercial.
Para acceso completo sin restricciones, necesitará comprar una licencia válida de Documentize y aplicarla dentro de su proyecto.
Cómo Comenzar a Usar la Licencia de Evaluación
No se requiere configuración especial. Simplemente descargue su SDK de Documentize deseado y comience a trabajar con él. Si no se aplica ningún archivo de licencia, el producto se ejecuta automáticamente en modo de evaluación.
Para probar el comportamiento con una licencia válida, también puede solicitar una licencia temporal de todas las funciones para evaluaciones detalladas.
Cuándo Usar la Licencia de Evaluación
Debería usar una licencia de evaluación si:
- Está explorando las capacidades de Documentize por primera vez.
- Desea confirmar la compatibilidad con su aplicación o plataforma.
- Necesita construir un prototipo o prueba de concepto antes de comprar.
- Está comparando soluciones de automatización de documentos.
Comience con Documentize Hoy
Evalúe los productos de Documentize sin riesgo y vea cómo pueden mejorar sus flujos de trabajo de documentos. Cuando esté listo para pasar a producción, actualizar a una licencia completa es rápido y sin complicaciones.
📘 ¿Necesita ayuda? Visite nuestra Documentación o Contáctenos para obtener asistencia.
Subsecciones de Guía del Desarrollador
HTML Converter
El Convertidor HTML de Documentize para .NET proporciona capacidades robustas para convertir documentos entre formatos PDF y HTML, ideal para aplicaciones web, archivado y generación de informes. Con múltiples opciones para manejar recursos y diseños, el convertidor se adapta a varios requisitos de proyecto.
Conversión de PDF a HTML
Convierte archivos PDF a HTML para que los documentos sean accesibles para visualización en la web o integración en aplicaciones donde se prefiera el formato HTML.
Conversión de HTML a PDF
Transforma contenido HTML en PDFs de alta calidad, perfectos para generar informes imprimibles, archivar contenido web o crear formatos de documentos compartibles.
Conviviendo PDF a HTML
Para convertir un PDF a HTML:
- Configurar opciones: Usa
PdfToHtmlOptions
para personalizar la salida, eligiendo recursos incrustados o externos. - Definir rutas de entrada y salida: Establece las rutas para tu PDF de entrada y el HTML de salida.
- Ejecutar la conversión: Llama al método
Process
de HtmlConverter
para convertir el archivo.
Ejemplo: Convertir PDF a HTML con Recursos Incrustados
1// Paso 1: Configurar opciones para la conversión de PDF a HTML
2var options = new PdfToHtmlOptions(PdfToHtmlOptions.SaveDataType.FileWithEmbeddedResources);
3
4// Paso 2: Establecer rutas de archivos
5options.AddInput(new FileDataSource("input.pdf"));
6options.AddOutput(new FileDataSource("output.html"));
7
8// Paso 3: Ejecutar la conversión
9HtmlConverter.Process(options);
Opciones Disponibles para la Conversión de PDF a HTML
- SaveDataType:
FileWithEmbeddedResources
: Genera un solo archivo HTML con todos los recursos incrustados.FileWithExternalResources
: Guarda recursos por separado, ideal para archivos HTML grandes.
Conviviendo HTML a PDF
Para convertir un documento HTML a PDF, sigue estos pasos:
- Configurar opciones: Usa
HtmlToPdfOptions
para definir la configuración del diseño y los medios. - Especificar rutas: Establecer las rutas de archivo HTML de entrada y PDF de salida.
- Ejecutar la conversión: Ejecutar el método
Process
de HtmlConverter
para convertir el archivo.
Ejemplo: Convertir HTML a PDF
1// Paso 1: Configurar opciones para la conversión de HTML a PDF
2var options = new HtmlToPdfOptions();
3
4// Paso 2: Establecer rutas de archivos
5options.AddInput(new FileDataSource("input.html"));
6options.AddOutput(new FileDataSource("output.pdf"));
7
8// Paso 3: Ejecutar la conversión
9HtmlConverter.Process(options);
Opciones Adicionales para la Conversión de HTML a PDF
Tipo de Medio:
HtmlMediaType.Print
: Ideal para generar PDFs adecuados para impresión.HtmlMediaType.Screen
: Usar al convertir contenido diseñado para visualización digital.
Ajustes de Diseño:
PageLayoutOption
: Ajusta cómo el contenido HTML se ajusta al diseño del PDF, como ScaleToPageWidth
para asegurar que el contenido se escale al ancho del PDF.IsRenderToSinglePage
: Permite renderizar todo el contenido HTML en una sola página PDF si es necesario para presentaciones concisas.
Este convertidor es versátil para una variedad de aplicaciones, desde la generación de informes PDF basados en contenido web hasta la conversión de archivos de documentos PDF para accesibilidad en la web. Para configuraciones más avanzadas, consulta la documentación completa de Documentize.
PDF Security
El Documentize PDF Security para .NET es una herramienta poderosa diseñada para mejorar la seguridad de sus documentos PDF al proporcionar capacidades de encriptación y desencriptación. Asegura que su información sensible permanezca confidencial y protegida contra accesos no autorizados.
Cómo Encriptar un PDF
Para encriptar un documento PDF, siga estos pasos:
- Cree una instancia de
EncryptionOptions
con las contraseñas de usuario y propietario deseadas. - Agregue el archivo PDF de entrada utilizando el método
AddInput
. - Agregue el archivo PDF de salida utilizando el método
AddOutput
. - Ejecute la encriptación utilizando el método
Process
de la clase Security
.
1// Crear objeto EncryptionOptions para establecer instrucciones
2var options = new EncryptionOptions("123456", "qwerty");
3// Agregar ruta del archivo de entrada
4options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
5// Establecer ruta del archivo de salida
6options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
7// Realizar el proceso
8Security.Process(options);
Cómo Desencriptar un PDF
Para desencriptar un documento PDF, siga estos pasos:
- Cree una instancia de
DecryptionOptions
con la contraseña necesaria. - Agregue el archivo PDF de entrada utilizando el método
AddInput
. - Agregue el archivo PDF de salida utilizando el método
AddOutput
. - Ejecute la desencriptación utilizando el método
Process
de la clase Security
.
1// Crear objeto DecryptionOptions para establecer instrucciones
2var options = new DecryptionOptions("123456");
3// Agregar ruta del archivo de entrada
4options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
5// Establecer ruta del archivo de salida
6options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
7// Realizar el proceso
8Security.Process(options);
Características Clave:
- Encriptar Documentos PDF: Asegure sus archivos PDF añadiendo contraseñas de usuario y propietario.
- Desencriptar Documentos PDF: Elimine la encriptación de los PDFs cuando sea necesario.
- Automatización: Integre la encriptación y desencriptación en sus aplicaciones .NET para flujos de trabajo automatizados.
- Cumplimiento: Asegúrese de que sus documentos cumplan con los estándares de la industria para la seguridad de documentos.
PDF Optimizer
El Optimización de PDF de Documentize es un complemento integral que mejora los documentos PDF a través de técnicas avanzadas de optimización. Está diseñado para ayudar a reducir el tamaño de los archivos, rotar páginas, recortar contenido y cambiar el tamaño de los documentos. Estas operaciones mejoran la calidad y manejabilidad de los archivos PDF, facilitando su almacenamiento, compartición y visualización.
Optimizar PDF
Los siguientes pasos demuestran cómo optimizar un documento PDF reduciendo su tamaño de archivo mientras se mantiene la calidad.
- Crea un objeto OptimizeOptions para configurar las opciones de optimización.
- Agrega el(los) archivo(s) PDF de entrada y establece una ubicación de salida para el archivo optimizado.
- Ejecuta el método
Process
de Optimizer
para realizar la optimización.
1// Crear objeto OptimizeOptions para establecer instrucciones
2var options = new OptimizeOptions();
3// Agregar ruta del archivo de entrada
4options.AddInput(new FileDataSource("ruta_a_tu_archivo_pdf.pdf"));
5// Establecer ruta del archivo de salida
6options.AddOutput(new FileDataSource("ruta_al_archivo_pdf_resultante.pdf"));
7// Realizar el proceso
8Optimizer.Process(options);
Rotar PDF
Utiliza la clase RotateOptions para ajustar la orientación de las páginas en un archivo PDF.
- Crea un objeto RotateOptions y configura el ángulo de rotación.
- Agrega el archivo PDF de entrada y especifica la ubicación del archivo de salida.
- Establece el ángulo de rotación (por ejemplo, 90 grados) utilizando el método SetRotation.
- Ejecuta el método
Process
de Optimizer
.
1// Crear objeto RotateOptions para establecer instrucciones
2var options = new RotateOptions();
3// Establecer nueva Rotación
4options.Rotation = Rotation.On90;
5// Agregar ruta del archivo de entrada
6options.AddInput(new FileDataSource("ruta_a_tu_archivo_pdf.pdf"));
7// Establecer ruta del archivo de salida
8options.AddOutput(new FileDataSource("ruta_al_archivo_pdf_resultante.pdf"));
9// Realizar el proceso
10Optimizer.Process(options);
Cambiar tamaño PDF
Para cambiar el tamaño de un documento PDF, se utiliza la clase ResizeOptions para especificar el nuevo tamaño de página para el documento.
- Crea un objeto ResizeOptions para definir el tamaño de la página.
- Agrega el archivo de entrada y establece la ubicación de salida deseada.
- Utiliza el método SetPageSize para especificar el nuevo tamaño (por ejemplo, A4).
- Ejecuta el método
Process
de Optimizer
.
1// Crear objeto ResizeOptions para establecer instrucciones
2var options = new ResizeOptions();
3// Establecer nuevo PageSize
4options.PageSize = PageSize.A3;
5// Agregar ruta del archivo de entrada
6options.AddInput(new FileDataSource("ruta_a_tu_archivo_pdf.pdf"));
7// Establecer ruta del archivo de salida
8options.AddOutput(new FileDataSource("ruta_al_archivo_pdf_resultante.pdf"));
9// Realizar el proceso
10Optimizer.Process(options);
Comprimir PDF
Comprime el documento PDF cuando sea posible eliminando recursos de página no utilizados, fusionando activos idénticos y desechando objetos redundantes.
- Crea un objeto CompressOptions para configurar las opciones de optimización.
- Agrega el archivo de entrada y especifica la ubicación del archivo de salida.
- Utiliza el método SetCropBox para definir el área de recorte.
- Ejecuta el método
Process
de Optimizer
.
1// Crear objeto CompressOptions para establecer instrucciones
2var options = new CompressOptions();
3// Agregar ruta del archivo de entrada
4options.AddInput(new FileDataSource("ruta_a_tu_archivo_pdf.pdf"));
5// Establecer ruta del archivo de salida
6options.AddOutput(new FileDataSource("ruta_al_archivo_pdf_resultante.pdf"));
7// Realizar el proceso
8Optimizer.Process(options);
Características Clave:
- Optimización: Reduce el tamaño del archivo PDF sin perder calidad.
- Rotación: Ajusta la orientación de las páginas PDF.
- Redimensionar: Redimensiona páginas a dimensiones específicas (por ejemplo, A4, Carta).
- Compresión: Elimina recursos y objetos de página no utilizados del documento.
PDF Merger
El Documentize PDF Merger para .NET es una herramienta versátil diseñada para fusionar múltiples documentos PDF en un solo archivo. Simplifica la consolidación de archivos PDF, asegurando que tus documentos se fusionen de manera eficiente y manteniendo la consistencia en el contenido. El complemento maneja recursos internos como fuentes e imágenes para optimizar el documento fusionado.
Cómo Fusionar PDF
Para fusionar múltiples documentos PDF en un solo archivo, sigue estos pasos:
- Crea una instancia de
MergeOptions
para configurar el proceso de fusión. - Agrega los archivos PDF de entrada usando el método
AddInput
. - Agrega el archivo PDF de salida usando el método
AddOutput
. - Ejecuta la fusión usando el método
Process
de la clase Merger
.
1// Crea un objeto MergeOptions para establecer instrucciones
2var options = new MergeOptions();
3// Agrega las rutas de los archivos de entrada
4options.AddInput(new FileDataSource("path_to_your_pdf_file_1.pdf"));
5options.AddInput(new FileDataSource("path_to_your_pdf_file_2.pdf"));
6// Establece la ruta del archivo de salida
7options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
8// Realiza el proceso
9Merger.Process(options);
Características clave:
- Fusionar Múltiples PDFs: Combina fácilmente múltiples archivos PDF en uno.
- Optimización de Recursos: Elimina fuentes e imágenes duplicadas durante la fusión.
- Procesamiento por Lotes: Fusiona grandes lotes de documentos PDF de una vez.
PDF Table Generator
El Generador de Tablas Documentize para .NET es un plugin versátil diseñado para optimizar la integración de tablas en documentos PDF. Ya sea que estés organizando datos, diseñando formularios o mejorando la legibilidad de documentos, este plugin simplifica el proceso mientras mantiene precisión y eficiencia. Su API intuitiva admite tanto flujos de trabajo de documentos individuales como de procesamiento por lotes, lo que lo convierte en una herramienta esencial para desarrolladores que trabajan con datos estructurados.
Creando un PDF con Tablas
Sigue estos pasos para crear tablas estructuradas en un PDF utilizando la clase TableGenerator
:
- Instancia la clase
TableGenerator
. - Configura el objeto
TableOptions
para definir la estructura de la tabla, el contenido y los archivos de entrada/salida. - Agrega tablas, filas y celdas a tu PDF.
- Finaliza el proceso de generación de tablas utilizando el método
Process
.
Aquí hay un ejemplo:
1var generator = new TableGenerator();
2var options = new TableOptions();
3
4// Especifica los archivos PDF de entrada y salida
5options.AddInput(new FileDataSource("input.pdf"));
6options.AddOutput(new FileDataSource("output.pdf"));
7
8// Define una tabla con filas y celdas
9options
10 .InsertPageAfter(1) // Agrega la tabla después de la primera página
11 .AddTable()
12 .AddRow()
13 .AddCell().AddParagraph(new TextFragment("Celda 1"))
14 .AddCell().AddParagraph(new TextFragment("Celda 2"))
15 .AddCell().AddParagraph(new TextFragment("Celda 3"));
16
17// Genera la tabla en el documento
18generator.Process(options);
Agregando Contenido Rico a las Tablas
Las tablas en documentos PDF pueden incluir una variedad de tipos de contenido para mejorar su funcionalidad y apariencia. A continuación se muestra un ejemplo de cómo agregar contenido HTML a las celdas de la tabla:
1options
2 .AddTable()
3 .AddRow()
4 .AddCell().AddParagraph(new HtmlFragment("<h1>Encabezado 1</h1>"))
5 .AddCell().AddParagraph(new HtmlFragment("<h2>Encabezado 2</h2>"))
6 .AddCell().AddParagraph(new HtmlFragment("<h3>Encabezado 3</h3>"));
Tipos de Contenido Soportados en Tablas
El Generador de Tablas PDF soporta varios tipos de contenido, lo que permite a los desarrolladores personalizar las tablas para una amplia gama de casos de uso:
- HtmlFragment: Agregar contenido basado en HTML, como encabezados, listas y texto formateado.
- TeXFragment: Incluir contenido basado en LaTeX para ecuaciones matemáticas y notación científica.
- TextFragment: Insertar texto simple o formateado.
- Image: Incrustar imágenes directamente en las celdas de la tabla.
Personalizando el Diseño y Estructura de la Tabla
El plugin proporciona flexibilidad para ajustar la estructura de la tabla, incluyendo la altura de las filas, el ancho de las columnas y la alineación de las celdas. Estas opciones de personalización te permiten diseñar tablas que coincidan con el diseño y las necesidades de estilo de tu documento.
Procesando la Generación de Tablas
Después de agregar todo el contenido y personalizar la estructura de la tabla, finaliza el proceso llamando al método Process
. Este método genera las tablas y actualiza el documento PDF. Así es como manejar los resultados:
1var resultContainer = generator.Process(options);
2
3// Muestra el número de resultados generados
4Console.WriteLine("Número de resultados: " + resultContainer.ResultCollection.Count);
Casos de Uso para el Generador de Tablas PDF
- Reportes de Datos: Presenta análisis, informes financieros o resultados de encuestas en un formato claro y organizado.
- Diseño de Formularios: Crea formularios interactivos con diseños de tabla estructurados.
- Mejora de Documentos: Mejora la legibilidad y usabilidad de manuales de usuario, guías o materiales instructivos.
- Procesamiento por Lotes: Automatiza la generación de tablas para múltiples documentos PDF.
Características Clave:
- Creación de Tablas Dinámicas: Genera fácilmente tablas estructuradas en documentos PDF.
- Soporte de Contenido Rico: Población de tablas con texto, HTML, imágenes y contenido LaTeX.
- Colocación de Páginas: Inserta tablas en ubicaciones específicas dentro de un PDF con precisión.
- Diseño Personalizable: Ajusta la estructura de la tabla, alineación de celdas y estilo.
- Procesamiento por Lotes: Procesa múltiples documentos simultáneamente para máxima eficiencia.
PDF TOC Generator
El Documentize PDF TOC Generator para .NET es un poderoso complemento diseñado para mejorar la organización y navegación de documentos PDF generando dinámicamente una Tabla de Contenidos (TOC). Este complemento simplifica el proceso de agregar TOCs a tus PDFs, haciendo que los documentos sean más fáciles de navegar y gestionar.
Cómo generar un TOC para un PDF
Para crear una Tabla de Contenidos en un archivo PDF, sigue estos pasos:
- Crea una instancia de la clase
TocGenerator
. - Crea una instancia de
TocOptions
para configurar la configuración de generación del TOC. - Agrega el archivo PDF de entrada utilizando el método
AddInput
. - Especifica el archivo PDF de salida con el TOC utilizando el método
AddOutput
. - Llama al método
Process
para generar el TOC.
1var tocGenerator = new TocGenerator();
2var tocOptions = new TocOptions();
3
4// Agregar archivos de entrada y salida
5tocOptions.AddInput(new FileDataSource(@"C:\Samples\input.pdf"));
6tocOptions.AddOutput(new FileDataSource(@"C:\Samples\output_with_toc.pdf"));
7
8// Generar el TOC
9tocGenerator.Process(tocOptions);
Personalizando el TOC
Puedes personalizar la Tabla de Contenidos modificando la clase TocOptions
. Por ejemplo, puedes controlar el nivel de profundidad para las entradas del TOC, establecer opciones de formato específicas y más:
1var tocOptions = new TocOptions
2{
3 Depth = 3, // Establecer el nivel de profundidad del TOC en 3
4 FontSize = 12, // Establecer el tamaño de fuente para las entradas del TOC
5 Title = "Tabla de Contenidos" // Personalizar el título del TOC
6};
7
8// Agregar archivos de entrada y salida
9tocOptions.AddInput(new FileDataSource(@"C:\Samples\input.pdf"));
10tocOptions.AddOutput(new FileDataSource(@"C:\Samples\output_with_toc.pdf"));
11
12// Generar el TOC con opciones personalizadas
13tocGenerator.Process(tocOptions);
Cómo manejar los resultados
Después del procesamiento, el método Process
devuelve un objeto ResultContainer
que contiene detalles sobre la generación del TOC. Puedes recuperar e imprimir los detalles de salida:
1var resultContainer = tocGenerator.Process(tocOptions);
2
3// Acceder a la colección de resultados e imprimir la ruta del archivo de salida
4var result = resultContainer.ResultCollection[0];
5Console.WriteLine(result);
Procesamiento por lotes para múltiples PDFs
El complemento PDF TOC Generator admite el procesamiento por lotes, lo que te permite agregar TOCs a múltiples documentos PDF simultáneamente.
1var tocGenerator = new TocGenerator();
2var tocOptions = new TocOptions();
3
4// Agregar múltiples PDFs de entrada
5tocOptions.AddInput(new FileDataSource(@"C:\Samples\file1.pdf"));
6tocOptions.AddInput(new FileDataSource(@"C:\Samples\file2.pdf"));
7
8// Agregar los PDFs de salida con TOC
9tocOptions.AddOutput(new FileDataSource(@"C:\Samples\output1_with_toc.pdf"));
10tocOptions.AddOutput(new FileDataSource(@"C:\Samples\output2_with_toc.pdf"));
11
12// Procesar la generación de TOC por lotes
13tocGenerator.Process(tocOptions);
Características clave:
- Generación dinámica de TOC: Crea un TOC para cualquier archivo PDF con entradas generadas automáticamente basadas en encabezados o marcadores.
- Procesamiento por lotes: Genera TOCs para múltiples documentos PDF a la vez.
- Personalización: Controla la apariencia y estructura del TOC, incluyendo estilos, formato y niveles de profundidad.
- Flujo de trabajo eficiente: Minimiza el tiempo dedicado a crear manualmente TOCs, especialmente para documentos grandes o complejos.
PDF Signature
El plugin Documentize PDF Signature para .NET permite a los usuarios firmar digitalmente documentos PDF. Ofrece un proceso simplificado para agregar firmas, asegurando autenticidad y asegurando el contenido del PDF. El plugin admite tanto firmas visibles como invisibles y proporciona opciones para personalizar la posición de la firma, la razón, la información de contacto y más.
Cómo Firmar Documentos PDF
Para firmar un documento PDF usando un archivo PFX, sigue estos pasos:
- Instancia la clase
SignOptions
con la ruta del archivo PFX y la contraseña. - Agrega el PDF de entrada y el archivo de salida a las opciones.
- Ejecuta el método
Process
para aplicar la firma.
1// Crear objeto SignOptions para establecer instrucciones
2var options = new SignOptions("ruta_a_tu_archivo_pfx.pfx", "contraseña_de_tu_archivo_pfx");
3// Agregar ruta del archivo de entrada
4options.AddInput(new FileDataSource("ruta_a_tu_archivo_pdf.pdf"));
5// Establecer ruta del archivo de salida
6options.AddOutput(new FileDataSource("ruta_a_archivo_pdf_resultante.pdf"));
7// Realizar el proceso
8Signature.Process(options);
Cómo Usar un Stream para el Archivo PFX
También puedes firmar un PDF utilizando un certificado PFX proporcionado como un stream en lugar de una ruta de archivo. Esto permite un manejo más flexible del almacenamiento del certificado.
- Instancia
SignOptions
con un stream que contenga el PFX y la contraseña. - Agrega los archivos de entrada y salida.
- Ejecuta el método
Process
para aplicar la firma.
1using var pfxStream = File.OpenRead(@"ruta_a_tu_archivo_pfx.pfx");
2var options = new SignOptions(pfxStream, "contraseña_de_tu_archivo_pfx");
3options.AddInput(new FileDataSource("ruta_a_tu_archivo_pdf.pdf"));
4options.AddOutput(new FileDataSource("ruta_a_archivo_pdf_resultante.pdf"));
5// Realizar el proceso
6Signature.Process(options);
Cómo Aplicar Firmas Invisibles
Para agregar una firma invisible (una que asegura el documento sin mostrar la firma en el documento), simplemente establece la propiedad Visible
en false
.
- Crea una instancia de
SignOptions
. - Establece
Visible
en false
. - Agrega archivos de entrada y salida.
- Llama a
Process
para aplicar la firma invisible.
1var options = new SignOptions("ruta_a_tu_archivo_pfx.pfx", "contraseña_de_tu_archivo_pfx");
2options.AddInput(new FileDataSource("ruta_a_tu_archivo_pdf.pdf"));
3options.AddOutput(new FileDataSource("ruta_a_archivo_pdf_resultante.pdf"));
4// Configurar firma invisible
5signOptions.Visible = false;
6// Realizar el proceso
7Signature.Process(options);
Cómo usar opciones adicionales para la firma de Documentos PDF
Puedes usar opciones adicionales al agregar una firma a un archivo PFX como Razón, Contacto, Ubicación, Número de Página.
- Instancia la clase
SignOptions
con la ruta del archivo PFX y la contraseña. - Agrega el PDF de entrada y el archivo de salida a las opciones.
- Establece valores para tus opciones.
- Ejecuta el método
Process
para aplicar la firma.
1var options = new SignOptions("ruta_a_tu_archivo_pfx.pfx", "contraseña_de_tu_archivo_pfx");
2options.AddInput(new FileDataSource("ruta_a_tu_archivo_pdf.pdf"));
3options.AddOutput(new FileDataSource("ruta_a_archivo_pdf_resultante.pdf"));
4// Parámetros opcionales
5options.Reason = "mi Razón";
6options.Contact = "mi Contacto";
7options.Location = "mi Ubicación";
8options.PageNumber = 3;
9// Realizar el proceso
10Signature.Process(options);
Características Clave:
- Firmar Digitalmente Documentos PDF: Asegura tus documentos con firmas digitales visibles o invisibles.
- Soporte PFX: Firma archivos PDF utilizando un certificado PFX.
- Opciones Personalizables: Configura ajustes de firma como razón, ubicación y detalles de contacto.
- Firmas Visibles e Invisibles: Elige si la firma es visible en el documento.
PDF Splitter
El Documentize PDF Splitter para .NET es una herramienta poderosa que simplifica el proceso de dividir documentos PDF grandes en archivos más pequeños y manejables. Ya sea que necesites extraer páginas individuales o dividir un documento en secciones específicas, este complemento te permite lograrlo de manera eficiente y con un esfuerzo mínimo.
Cómo dividir un PDF
Para dividir un documento PDF en páginas individuales, sigue estos pasos:
- Crea una instancia de
SplitOptions
para configurar las opciones de división. - Agrega el archivo PDF de entrada utilizando el método
AddInput
. - Agrega archivos de salida para cada página dividida utilizando el método
AddOutput
. - Ejecuta el método
Process
en la clase Splitter
para dividir el documento.
1var splitOptions = new SplitOptions();
2
3// Agregar el archivo PDF de entrada
4splitOptions.AddInput(new FileDataSource(@"C:\Samples\input.pdf"));
5
6// Especificar archivos de salida para cada página
7splitOptions.AddOutput(new FileDataSource(@"C:\Samples\output_page_1.pdf"));
8splitOptions.AddOutput(new FileDataSource(@"C:\Samples\output_page_2.pdf"));
9splitOptions.AddOutput(new FileDataSource(@"C:\Samples\output_page_3.pdf"));
10
11// Procesar la operación de división
12Splitter.Process(splitOptions);
Características clave:
- Dividir PDF por página: Descomponer un documento PDF en páginas individuales.
- Procesamiento por lotes: Dividir grandes lotes de PDFs de una sola vez.
- Opciones de división personalizadas: Configurar el proceso de división según tus requisitos.
- Salida organizada: Gestionar fácilmente los archivos de salida para cada página o sección dividida.
PDF ChatGPT
El plugin Documentize ChatGPT para .NET es una herramienta poderosa diseñada para integrar la API de ChatGPT con aplicaciones PDF. Este plugin permite a los desarrolladores generar respuestas de chat basadas en mensajes de entrada y guardar la salida en formato PDF, lo que lo hace adecuado para crear interfaces conversacionales o informes de análisis directamente dentro de documentos PDF.
Generar Respuestas de Chat
Para generar respuestas de chat y guardarlas en un archivo PDF utilizando el plugin ChatGPT, sigue estos pasos:
- Crea una instancia de la clase
PdfChatGptRequestOptions
para configurar las opciones de la solicitud. - Agrega archivos PDF de entrada y salida.
- Establece la clave de API y especifica parámetros como el recuento máximo de tokens y la consulta para el modelo ChatGPT.
- Ejecuta el método
ProcessAsync
para generar la finalización del chat.
1var options = new PdfChatGptRequestOptions();
2options.ApiKey = "sk-******"; // Establece tu clave de API
3options.MaxTokens = 1000; // Establece el número máximo de tokens
4options.Query = "Analiza este texto para temas clave.";
5
6// Agrega el archivo PDF de entrada
7options.AddInput(new FileDataSource("input.pdf"));
8
9// Especifica dónde guardar el PDF de salida con respuestas de chat
10options.AddOutput(new FileDataSource("output.pdf"));
11
12// Crea una instancia del plugin PdfChatGpt
13var plugin = new PdfChatGpt();
14
15// Ejecuta el proceso de manera asincrónica
16var result = await plugin.ProcessAsync(options);
Características Clave:
- Finalizaciones de Chat: Genera respuestas utilizando la API de ChatGPT basada en entradas personalizadas.
- Mensajes del Sistema y del Usuario: Proporciona contexto del sistema y entrada del usuario para crear conversaciones dinámicas.
- Salida PDF: Guarda las finalizaciones de chat generadas en un archivo PDF estructurado para un uso posterior.
- Procesamiento Asincrónico: Asegura aplicaciones receptivas procesando las finalizaciones de chat de manera asincrónica.
Añadiendo Mensajes del Sistema y del Usuario
Para crear una conversación más interactiva, puedes agregar tanto mensajes del sistema como del usuario. Estos mensajes ayudan a dar forma al contexto de la conversación.
- Agrega un mensaje del sistema que establezca el contexto para ChatGPT.
- Agrega un mensaje del usuario que represente la entrada del usuario para la conversación.
1var options = new PdfChatGptRequestOptions();
2options.ApiKey = "sk-******"; // Establece tu clave de API
3
4// Agrega un mensaje del sistema para el contexto
5options.AddSystemMessage("Eres una IA entrenada para resumir texto.");
6
7// Agrega un mensaje del usuario para consultar el modelo ChatGPT
8options.AddUserMessage("Por favor, resume el documento adjunto.");
9
10// Agrega PDFs de entrada y salida
11options.AddInput(new FileDataSource("input.pdf"));
12options.AddOutput(new FileDataSource("output.pdf"));
13
14// Procesa la solicitud de manera asincrónica
15var plugin = new PdfChatGpt();
16var result = await plugin.ProcessAsync(options);
El Documentize PDF Image Extractor para .NET permite extraer imágenes de documentos PDF sin esfuerzo. Escanea tus archivos PDF, identifica imágenes incrustadas y las extrae mientras mantiene su calidad y formato originales. Esta herramienta mejora la accesibilidad del contenido visual y simplifica el proceso de recuperación de imágenes de los PDFs.
Para extraer imágenes de un archivo PDF, sigue estos pasos:
- Crea una instancia de la clase
ImageExtractorOptions
. - Agrega la ruta del archivo de entrada a las opciones utilizando el método
AddInput
. - Establece la ruta del directorio de salida para las imágenes utilizando el método
AddOutput
. - Procesa la extracción de imágenes utilizando el plugin.
- Recupera las imágenes extraídas del contenedor de resultados.
1// Crear ImageExtractorOptions para establecer instrucciones
2var options = new ImageExtractorOptions();
3// Agregar ruta del archivo de entrada
4options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
5// Establecer ruta del directorio de salida
6options.AddOutput(new DirectoryDataSource("path_to_results_directory"));
7// Realizar el proceso
8var results = ImageExtractor.Process(options);
9// Obtener ruta del resultado de la imagen
10var imageExtracted = results.ResultCollection[0].ToFile();
El plugin ImageExtractor admite la opción de guardar en streams, lo que te permite extraer imágenes de archivos PDF en streams sin usar carpetas temporales.
1// Crear ImageExtractorOptions para establecer instrucciones
2var options = new ImageExtractorOptions();
3// Agregar ruta del archivo de entrada
4options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
5// No establecer salida - escribirá resultados en streams
6// Realizar el proceso
7var results = ImageExtractor.Process(options);
8// Obtener Stream
9var ms = results.ResultCollection[0].ToStream();
10// Copiar datos a archivo para demostración
11ms.Seek(0, SeekOrigin.Begin);
12using (var fs = File.Create("test_file.png"))
13{
14 ms.CopyTo(fs);
15}
Características Clave:
- Extraer Imágenes Incrustadas: Identifica y extrae imágenes de documentos PDF.
- Preservar la Calidad de la Imagen: Asegura que las imágenes extraídas mantengan su calidad original.
- Salida Flexible: Guarda las imágenes extraídas en el formato o ubicación que prefieras.
El Extractor de Texto PDF de Documentize para .NET simplifica la extracción de texto de documentos PDF. Ya sea que necesites texto puro, crudo o plano, este complemento te permite extraer texto de manera eficiente mientras preserva el formato o lo omite según tus necesidades.
Para extraer texto de un documento PDF, sigue estos pasos:
- Crea una instancia de
TextExtractorOptions
para configurar las opciones de extracción. - Agrega el archivo PDF de entrada utilizando el método
AddInput
. - Ejecuta el método
Process
para extraer el texto. - Accede al texto extraído utilizando
ResultContainer.ResultCollection
.
1// Crea un objeto TextExtractorOptions para establecer las instrucciones
2var options = new TextExtractorOptions();
3// Agrega la ruta del archivo de entrada
4options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
5// Realiza el proceso
6var results = TextExtractor.Process(options);
7// Obtén el texto extraído del objeto ResultContainer
8var textExtracted = results.ResultCollection[0].ToString();
El complemento TextExtractor ofrece tres modos de extracción, proporcionando flexibilidad según tus necesidades.
- Modo Puro: Preserva el formato original, incluyendo espacios y alineación.
- Modo Crudo: Extrae el texto sin formato, útil para el procesamiento de datos en bruto.
- Modo Aplanado: Representa el contenido PDF con fragmentos de texto posicionados por sus coordenadas.
1// Crea un objeto TextExtractorOptions para establecer TextFormattingMode
2var options = new TextExtractorOptions(TextFormattingMode.Pure);
3// Agrega la ruta del archivo de entrada
4options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
5// Realiza el proceso
6var results = TextExtractor.Process(options);
7// Obtén el texto extraído del objeto ResultContainer
8var textExtracted = results.ResultCollection[0].ToString();
Características Clave:
- Modo Puro: Extrae texto mientras preserva su formato original.
- Modo Crudo: Extrae texto sin ningún formato.
- Modo Aplanado: Extrae texto sin caracteres especiales o formatos.
PDF Timestamp Adder
El Documentize PDF Timestamp Adder para .NET es una herramienta poderosa diseñada para añadir marcas de tiempo seguras a tus documentos PDF. Mejora la integridad y autenticidad de tus documentos al proporcionar una referencia de tiempo confiable, asegurando el cumplimiento con los estándares de firma digital.
Cómo agregar una marca de tiempo a un PDF
Para agregar una marca de tiempo segura a un documento PDF, sigue estos pasos:
- Crea una instancia de la clase
Timestamp
. - Crea una instancia de
AddTimestampOptions
para configurar el proceso de marcaje de tiempo. - Agrega el archivo PDF de entrada utilizando el método
AddInput
. - Establece la ruta del archivo de salida utilizando
AddOutput
. - Ejecuta el proceso de marcaje de tiempo utilizando el método
Process
.
1// Instanciar el plugin Timestamp
2var plugin = new Timestamp();
3
4// Configurar las opciones de marcaje de tiempo
5var opt = new AddTimestampOptions("ruta_al_pfx", "contraseña_del_pfx", "url_del_servidor_de_marcado");
6
7// Agregar archivo PDF de entrada
8opt.AddInput(new FileDataSource("ruta_al_pdf"));
9
10// Especificar el archivo PDF de salida
11opt.AddOutput(new FileDataSource("ruta_al_pdf_resultado"));
12
13// Realizar el proceso de marcaje de tiempo
14plugin.Process(opt);
Cómo usar autenticación personalizada con el servidor de marcas de tiempo
Puedes proporcionar credenciales de autenticación básica al conectarte al servidor de marcas de tiempo. Esto te permite autenticarte con servidores que requieren un nombre de usuario y contraseña.
- Crea una instancia de la clase
Timestamp
. - Crea una instancia de
AddTimestampOptions
, incluyendo las serverBasicAuthCredentials
. - Agrega las rutas del archivo de entrada y del archivo de salida.
- Llama al método
Process
.
1// Instanciar el plugin Timestamp
2var plugin = new Timestamp();
3
4// Configurar las opciones de marcaje de tiempo con autenticación
5var opt = new AddTimestampOptions("ruta_al_pfx", "contraseña_del_pfx", "url_del_servidor_de_marcado", "usuario:contraseña");
6
7// Agregar archivo PDF de entrada
8opt.AddInput(new FileDataSource("ruta_al_pdf"));
9
10// Especificar el archivo PDF de salida
11opt.AddOutput(new FileDataSource("ruta_al_pdf_resultado"));
12
13// Realizar el proceso de marcaje de tiempo
14plugin.Process(opt);
Manejo de archivos PFX y contraseñas
La clase AddTimestampOptions
te permite usar un archivo PFX para la firma digital junto con la contraseña.
- Flujo o ruta del archivo PFX: Puedes proporcionar un flujo o ruta de archivo al archivo PFX.
- Protección por contraseña: Asegúrate de gestionar de manera segura la contraseña del archivo PFX.
Características clave:
- Agregar marcas de tiempo seguras: Agrega fácilmente marcas de tiempo seguras a tus documentos PDF.
- Servidores de marcas de tiempo personalizables: Usa URLs de servidores de marcas de tiempo personalizadas y credenciales de autenticación.
- Automatización: Integra el marcaje de tiempo en tus aplicaciones .NET para flujos de trabajo automatizados.
- Cumplimiento: Asegura que tus documentos cumplan con los estándares de la industria para firmas digitales y marcas de tiempo.
PDF/A Converter
El Convertidor PDF/A de Documentize para .NET es una herramienta poderosa diseñada para convertir documentos PDF al formato PDF/A, asegurando que tu contenido siga cumpliendo con los estándares de archivo a largo plazo. Este complemento también admite la validación de documentos PDF existentes para el cumplimiento con PDF/A, ofreciendo tanto funciones de conversión como de validación en una sola solución.
Cómo convertir PDF a PDF/A
Para convertir un documento PDF al formato PDF/A, sigue estos pasos:
- Crea una instancia de la clase
PdfAConverter
. - Crea una instancia de
PdfAConvertOptions
para configurar la conversión. - Especifica la versión de PDF/A deseada (por ejemplo, PDF/A-3B).
- Agrega el archivo PDF de entrada usando el método
AddInput
. - Agrega el archivo de salida para el PDF/A resultante usando el método
AddOutput
. - Llama al método
Process
para ejecutar la conversión.
1var pdfAConverter = new PdfAConverter();
2var pdfAOptions = new PdfAConvertOptions
3{
4 PdfAVersion = PdfAStandardVersion.PDF_A_3B
5};
6
7// Agrega el archivo PDF de entrada
8pdfAOptions.AddInput(new FileDataSource(@"C:\Samples\input.pdf"));
9
10// Especifica el archivo PDF/A de salida
11pdfAOptions.AddOutput(new FileDataSource(@"C:\Samples\output_pdfa.pdf"));
12
13// Procesa la conversión
14pdfAConverter.Process(pdfAOptions);
Validando el cumplimiento con PDF/A
Puedes validar archivos PDF existentes para el cumplimiento con PDF/A usando la clase PdfAValidateOptions
.
1var pdfAConverter = new PdfAConverter();
2var validationOptions = new PdfAValidateOptions
3{
4 PdfAVersion = PdfAStandardVersion.PDF_A_1A
5};
6
7// Agrega el archivo PDF a validar
8validationOptions.AddInput(new FileDataSource(@"C:\Samples\input.pdf"));
9
10// Ejecuta el proceso de validación
11var resultContainer = pdfAConverter.Process(validationOptions);
12
13// Verifica el resultado de la validación
14var validationResult = (PdfAValidationResult)resultContainer.ResultCollection[0].Data;
15Console.WriteLine("Validación PDF/A aprobada: " + validationResult.IsValid);
Procesamiento por lotes para conversión a PDF/A
Este complemento admite el procesamiento por lotes, lo que te permite convertir o validar múltiples archivos PDF para el cumplimiento con PDF/A a la vez.
1var pdfAConverter = new PdfAConverter();
2var pdfAOptions = new PdfAConvertOptions
3{
4 PdfAVersion = PdfAStandardVersion.PDF_A_3B
5};
6
7// Agrega múltiples PDFs de entrada
8pdfAOptions.AddInput(new FileDataSource(@"C:\Samples\file1.pdf"));
9pdfAOptions.AddInput(new FileDataSource(@"C:\Samples\file2.pdf"));
10
11// Especifica archivos de salida para los PDF/A convertidos
12pdfAOptions.AddOutput(new FileDataSource(@"C:\Samples\file1_pdfa.pdf"));
13pdfAOptions.AddOutput(new FileDataSource(@"C:\Samples\file2_pdfa.pdf"));
14
15// Procesa la conversión por lotes
16pdfAConverter.Process(pdfAOptions);
Características clave:
- Convertir a PDF/A: Transforma sin problemas archivos PDF al formato PDF/A (como PDF/A-1a, PDF/A-2b, PDF/A-3b) para asegurar el cumplimiento con los estándares de archivo.
- Validar cumplimiento con PDF/A: Verifica documentos PDF existentes para su conformidad con los estándares PDF/A e identifica problemas si no cumplen.
- Procesamiento por lotes: Procesa múltiples archivos a la vez para conversión o validación.
- Flujo de trabajo eficiente: Minimiza tiempo y esfuerzo con procesos de conversión rápidos y confiables.
PDF to XLS Converter
El Convertidor de PDF a XLS de Documentize para .NET es una herramienta versátil y poderosa para convertir documentos PDF en hojas de cálculo de Excel (XLSX/XLS/CSV/XLSM/ODS). Al aprovechar este complemento, los desarrolladores pueden transformar sin problemas los datos estáticos de PDF en hojas de cálculo dinámicas y editables, simplificando la manipulación, análisis y compartición de datos.
Cómo Convertir PDF a Excel
Para convertir un documento PDF en un archivo de Excel (XLSX), sigue estos pasos:
- Configura las opciones de conversión utilizando la clase
PdfToXlsOptions
. - Agrega archivos PDF de entrada utilizando el método
AddInput
. - Especifica la ruta del archivo de salida utilizando el método
AddOutput
. - Ejecuta el método
Process
para iniciar la conversión.
1// Crea un objeto PdfToXlsOptions para establecer instrucciones
2var options = new PdfToXlsOptions();
3// Agrega la ruta del archivo de entrada
4options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
5// Establece la ruta del archivo de salida
6options.AddOutput(new FileDataSource("path_to_result_file.xlsx"));
7// Realiza el proceso
8XlsConverter.Process(options);
Personalizando la Conversión de PDF a Excel
La clase PdfToXlsOptions
te permite personalizar el proceso de conversión. Por ejemplo, para convertir el PDF en un archivo XLS y habilitar opciones de formato avanzadas:
1// Crea un objeto PdfToXlsOptions para establecer instrucciones
2var options = new PdfToXlsOptions();
3// Agrega la ruta del archivo de entrada
4options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
5// Especifica el formato XLS
6options.Format = PdfToXlsOptions.ExcelFormat.XMLSpreadSheet2003;
7options.InsertBlankColumnAtFirst = true;
8options.MinimizeTheNumberOfWorksheets = true;
9// Establece la ruta del archivo de salida
10options.AddOutput(new FileDataSource("path_to_result_xlsx_file.xls"));
11// Realiza el proceso
12XlsConverter.Process(options);
El enum PdfToXlsOptions.ExcelFormat
proporciona una variedad de formatos de salida:
- XLSX: Formato de archivo Office Open XML (.xlsx) (predeterminado).
- XLSM: Formato de Excel habilitado para macros.
- CSV: Valores separados por comas.
- ODS: Hoja de cálculo de documento abierto.
- XMLSpreadSheet2003: Formato de archivo Excel 2003 XML (.xls).
Características Clave:
- Opciones de Conversión Flexibles: Convierte archivos PDF en XLSX, XLS, CSV u otros formatos.
- Preservación del Contenido: Mantiene la estructura, diseño y formato originales.
- Formateo Avanzado: Inserta columnas en blanco o minimiza el número de hojas de cálculo.
PDF to DOC Converter
El Convertidor de PDF a DOC de Documentize para .NET es una herramienta poderosa diseñada para convertir documentos PDF en formatos DOC o DOCX. Este plugin transforma sin problemas las páginas PDF en documentos de Microsoft Word editables, facilitando la reutilización, edición y compartición de contenido en múltiples plataformas.
Cómo Convertir PDF a DOC/DOCX
Para convertir un documento PDF a formato DOC/DOCX, sigue estos pasos:
- Crea una instancia de la clase
DocConverter
. - Crea una instancia de
DocConversionOptions
para configurar el proceso de conversión. - Agrega el archivo PDF de entrada usando el método
AddInput
. - Agrega la ruta del archivo de salida para el archivo DOC/DOCX resultante usando el método
AddOutput
. - Ejecuta el método
Process
para llevar a cabo la conversión.
1var docConverter = new DocConverter();
2var options = new DocConversionOptions()
3{
4 SaveFormat = SaveFormat.DocX, // Formato de salida como DOCX
5 ConversionMode = ConversionMode.EnhancedFlow // Optimizar el diseño y formato
6};
7
8// Agregar el archivo PDF de entrada
9options.AddInput(new FileDataSource(@"C:\Samples\input.pdf"));
10
11// Agregar la ruta del documento de Word de salida
12options.AddOutput(new FileDataSource(@"C:\Samples\output.docx"));
13
14// Procesar la conversión
15docConverter.Process(options);
Conversión de PDF a DOC con Opciones Personalizadas
El plugin Convertidor de PDF a DOC proporciona varias opciones para personalizar tu proceso de conversión. Puedes elegir entre diferentes modos para controlar cómo se maneja el diseño y la estructura del PDF durante la conversión.
1var docConverter = new DocConverter();
2var options = new DocConversionOptions()
3{
4 SaveFormat = SaveFormat.Doc, // Formato de salida como DOC
5 ConversionMode = ConversionMode.Precise // Mantener el diseño original del PDF lo más fiel posible
6};
7
8// Agregar el archivo PDF de entrada
9options.AddInput(new FileDataSource(@"C:\Samples\input.pdf"));
10
11// Agregar la ruta del documento de Word de salida
12options.AddOutput(new FileDataSource(@"C:\Samples\output.doc"));
13
14// Procesar la conversión
15docConverter.Process(options);
Procesamiento por Lotes de Conversión de PDF a DOC/DOCX
El Convertidor de PDF a DOC admite el procesamiento por lotes, permitiéndote convertir múltiples archivos PDF a la vez. Aquí tienes un ejemplo de conversión por lotes:
1var docConverter = new DocConverter();
2var options = new DocConversionOptions()
3{
4 SaveFormat = SaveFormat.DocX
5};
6
7// Agregar múltiples archivos PDF de entrada
8options.AddInput(new FileDataSource(@"C:\Samples\file1.pdf"));
9options.AddInput(new FileDataSource(@"C:\Samples\file2.pdf"));
10
11// Agregar rutas de archivos de salida para los archivos DOCX resultantes
12options.AddOutput(new FileDataSource(@"C:\Samples\output_file1.docx"));
13options.AddOutput(new FileDataSource(@"C:\Samples\output_file2.docx"));
14
15// Procesar la conversión por lotes
16docConverter.Process(options);
Características Clave:
- Conversión DOC/DOCX: Convierte documentos PDF a formatos editables de Microsoft Word (DOC o DOCX).
- Mantener Formato: Retiene el diseño original, el texto y el formato durante el proceso de conversión.
- Procesamiento por Lotes: Convierte múltiples archivos PDF a la vez.
- Opciones de Conversión Personalizadas: Ajusta el proceso de conversión con diferentes modos, como Flujo Mejorado, para un mejor diseño.
PDF to JPEG Converter
El Conversor de PDF a JPEG de Documentize para .NET es una herramienta poderosa que simplifica la conversión de documentos PDF en imágenes JPEG de alta calidad. Este complemento está diseñado para hacer que tu contenido sea más accesible en diferentes plataformas al transformar las páginas PDF en formatos de imagen ampliamente utilizados.
Cómo convertir páginas PDF a JPEG
Para convertir un documento PDF en imágenes JPEG, sigue estos pasos:
- Crea una instancia de
PdfToJpegOptions
para configurar el proceso de conversión. - Agrega el archivo PDF de entrada utilizando el método
AddInput
. - Establece la ruta del directorio de salida para las imágenes JPEG utilizando el método
AddOutput
. - Ejecuta el método
Process
para convertir las páginas PDF en imágenes JPEG.
1// Crear objeto PdfToJpegOptions para establecer instrucciones
2var options = new PdfToJpegOptions();
3// Agregar ruta del archivo de entrada
4options.AddInput(new FileDataSource("path_to_input.pdf"));
5// Establecer ruta del directorio de salida
6options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
7// Realizar el proceso
8JpegConverter.Process(options);
Personalizando la conversión de PDF a JPEG
Puedes personalizar el proceso de conversión ajustando la resolución, seleccionando rangos de páginas o estableciendo la calidad de la imagen. Aquí te mostramos cómo convertir la primera página de un PDF a 200 DPI:
1// Crear objeto PdfToJpegOptions para establecer instrucciones
2var options = new PdfToJpegOptions();
3// Procesar solo la primera página
4options.PageList = new List<int> { 1 };
5// Establecer resolución de salida a 200 DPI
6options.OutputResolution = 200;
7// Establecer calidad de salida a 50
8options.Quality = 50;
9// Agregar ruta del archivo de entrada
10options.AddInput(new FileDataSource("path_to_input.pdf"));
11// Establecer ruta del directorio de salida
12options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
13// Realizar el proceso
14JpegConverter.Process(options);
El método Process devuelve un objeto ResultContainer
que contiene información sobre los resultados de la conversión. Puedes obtener flujos de los archivos JPEG convertidos como se muestra a continuación:
1// Crear objeto PdfToJpegOptions para establecer instrucciones
2var options = new PdfToJpegOptions();
3// Agregar ruta del archivo de entrada
4options.AddInput(new FileDataSource("path_to_input.pdf"));
5// Realizar el proceso
6var results = JpegConverter.Process(options);
7// Obtener resultados en forma de flujo
8foreach (var result in results.ResultCollection)
9{
10 var streamResultPage1 = result.ToStream();
11}
Características clave:
- Convertir PDF a JPEG: Convierte fácilmente documentos PDF completos o páginas específicas en imágenes JPEG.
- Resolución personalizada: Ajusta la resolución (por ejemplo, 300 dpi) para obtener salidas de alta calidad.
- Conjunto de páginas: Selecciona páginas específicas para la conversión.
- Conversión rápida: Proceso rápido y eficiente con un esfuerzo mínimo.
PDF a PNG Converter
El Convertidor de PDF a PNG de Documentize para .NET es una herramienta avanzada que te permite convertir documentos PDF en imágenes PNG de alta calidad. Este plugin está diseñado para hacer que tu contenido sea más versátil, accesible y fácil de compartir al transformar páginas PDF en formatos de imagen ampliamente soportados.
Cómo Convertir PDF a PNG
Para convertir un documento PDF en imágenes PNG, sigue estos pasos:
- Crea una instancia de
PdfToPngOptions
para configurar el proceso de conversión. - Agrega el archivo PDF de entrada usando el método
AddInput
. - Establece la ruta del directorio de salida para las imágenes PNG usando el método
AddOutput
. - Ejecuta el método
Process
para convertir las páginas PDF en imágenes PNG.
1
2// Crea un objeto PdfToPngOptions para establecer instrucciones
3var options = new PdfToPngOptions();
4// Agrega la ruta del archivo de entrada
5options.AddInput(new FileDataSource("path_to_input.pdf"));
6// Establece la ruta del directorio de salida
7options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
8// Realiza el proceso
9PngConverter.Process(options);
Personalizando la Conversión de PDF a PNG
Puedes personalizar la conversión ajustando la resolución y seleccionando páginas específicas. Por ejemplo, para convertir solo la primera página de un PDF a 200 DPI:
1
2// Crea un objeto PdfToPngOptions para establecer instrucciones
3var options = new PdfToPngOptions()
4// Procesa solo la primera página
5options.PageList = new List<int> { 1 };
6// Establece la resolución de salida a 200 dpi
7options.OutputResolution = 200;
8// Agrega la ruta del archivo de entrada
9options.AddInput(new FileDataSource("path_to_input.pdf"));
10// Establece la ruta del directorio de salida
11options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
12// Realiza el proceso
13PngConverter.Process(options);
Manejo de Resultados de Conversión
El método Process devuelve un objeto ResultContainer
que contiene información sobre los resultados de la conversión. Puedes obtener flujos de los archivos PNG convertidos como se muestra a continuación:
1
2// Crea un objeto PdfToJpegOptions para establecer instrucciones
3var options = new PdfToPngOptions();
4// Agrega la ruta del archivo de entrada
5options.AddInput(new FileDataSource("path_to_input.pdf"));
6// Realiza el proceso
7var results = PngConverter.Process(options);
8// Obtiene los resultados de los flujos
9foreach (var result in results.ResultCollection)
10{
11 var streamResultPage1 = result.ToStream();
12}
Características Clave:
- Convertir PDF a PNG: Convierte rápida y eficientemente documentos PDF completos o páginas específicas en imágenes PNG.
- Resolución Personalizable: Establece el DPI deseado (por ejemplo, 300 DPI) para una salida de imagen de alta calidad.
- Conjunto de Páginas: Selecciona páginas específicas para la conversión.
- Gestión Sencilla de Salida: Especifica directorios de salida para cada archivo PNG convertido.
- Conversión Rápida: Rápida, eficiente y requiere un mínimo esfuerzo para configurar.
PDF a TIFF Converter
El Convertidor de PDF a TIFF de Documentize para .NET es una herramienta potente diseñada para convertir documentos PDF en imágenes TIFF de alta calidad. Este complemento garantiza que tu contenido sea accesible en varias plataformas manteniendo una excelente fidelidad y versatilidad. Puedes personalizar el proceso de conversión ajustando la resolución, habilitando la salida de múltiples páginas o seleccionando páginas específicas.
Cómo convertir PDF a TIFF
Para convertir un documento PDF en imágenes TIFF, sigue estos pasos:
- Crea una instancia de
PdfToTiffOptions
para configurar el proceso de conversión. - Agrega el archivo PDF de entrada usando el método
AddInput
. - Especifica la ruta del archivo de salida para las imágenes TIFF usando el método
AddOutput
. - Ejecuta el método
Process
para convertir las páginas del PDF en imágenes TIFF.
1// Crea el objeto PdfToTiffOptions para establecer las instrucciones
2var options = new PdfToTiffOptions();
3// Agrega la ruta del archivo de entrada
4options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
5// Establece la ruta del directorio de salida
6options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
7// Realiza el proceso
8TiffConverter.Process(options);
Personalizando las Páginas y DPI de la Conversión de PDF a TIFF
Así es como convertir 2 páginas de un PDF a 400 DPI en un archivo TIFF:
1// Crea el objeto PdfToTiffOptions para establecer las instrucciones
2var options = new PdfToTiffOptions();
3// Agrega la ruta del archivo de entrada
4options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
5// Establece la ruta del directorio de salida
6options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
7// Establece las Páginas
8options.PageList = [1, 3];
9// Establece la Resolución de la imagen resultante
10options.OutputResolution = 400;
11// Realiza el proceso
12TiffConverter.Process(options);
Creación de TIFF de Múltiples Páginas
El complemento Convertidor de PDF a TIFF admite la generación de TIFF de múltiples páginas, lo que te permite combinar varias páginas de PDF en un solo archivo TIFF para un archivo o impresión eficiente.
1// Crea el objeto PdfToTiffOptions para establecer las instrucciones
2var options = new PdfToTiffOptions();
3// Agrega la ruta del archivo de entrada
4options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
5// Establece la ruta del directorio de salida
6options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
7// Habilita la salida de TIFF de múltiples páginas
8options.MultiPage = true;
9// Realiza el proceso
10TiffConverter.Process(options);
Personalizando las Páginas y DPI de la Conversión de PDF a TIFF
Así es como convertir 2 páginas de un PDF a 400 DPI en un archivo TIFF:
1// Crea el objeto PdfToTiffOptions para establecer las instrucciones
2var options = new PdfToTiffOptions();
3// Agrega la ruta del archivo de entrada
4options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
5// Establece la ruta del directorio de salida
6options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
7// Establece la Compresión y la Profundidad de Color
8options.Compression = TiffCompression.RLE;
9options.ColorDepth = TiffColorDepth.Format24bpp;
10// Realiza el proceso
11TiffConverter.Process(options);
Cómo Manejar los Resultados de Conversión
El método Process devuelve un objeto ResultContainer
que proporciona detalles sobre los resultados de la conversión. Puedes obtener flujos de los archivos TIFF convertidos como se muestra a continuación:
1// Crea el objeto PdfToTiffOptions para establecer las instrucciones
2var options = new PdfToTiffOptions();
3// Agrega la ruta del archivo de entrada
4options.AddInput(new FileDataSource("path_to_input.pdf"));
5// Realiza el proceso
6var results = TiffConverter.Process(options);
7// Obtén los resultados de los flujos
8foreach (var result in results.ResultCollection)
9{
10 var streamResultPage1 = result.ToStream();
11}
Características Clave:
- Convertir PDF a TIFF: Convierte sin esfuerzo documentos PDF completos o páginas específicas en imágenes TIFF.
- Resolución Personalizada: Ajusta la resolución (por ejemplo, 300 dpi) para salidas de calidad superior.
- TIFF de Múltiples Páginas: Combina múltiples páginas de PDF en un solo archivo TIFF de múltiples páginas.
- Conjunto de Páginas: Selecciona páginas específicas para la conversión.
- Conversión Rápida: Proceso rápido y eficiente con un esfuerzo mínimo.
El Documentize PDF Form Flattener para .NET es un complemento diseñado para convertir formularios PDF interactivos en documentos no editables, haciéndolos seguros contra modificaciones no autorizadas. Esta herramienta transforma los campos del formulario en contenido estático, mejorando la seguridad de tus documentos PDF. Es particularmente útil cuando necesitas asegurar contratos, acuerdos o cualquier documento donde los campos del formulario deben permanecer sin cambios.
Para aplanar campos de formulario en un documento PDF, sigue estos pasos:
- Crea una instancia de la clase
FormFlattenerOptions
. - Agrega los archivos de entrada y salida a las opciones.
- Llama al método
Process
para realizar la operación de aplanamiento.
1// Crear objeto FormFlattenerOptions para establecer instrucciones
2var options = new FormFlattenerOptions();
3// Agregar ruta del archivo de entrada
4options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
5// Establecer ruta del archivo de salida
6options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
7// Realizar el proceso
8FormFlattener.Process(options);
Cómo Obtener todos los Campos en un PDF
Puedes obtener información sobre cuántos campos contiene un documento.
1// Obtener Nombres de los Campos
2var fieldNames = FormFlattener.GetFieldNames("path_to_your_pdf_file.pdf");
Cómo Aplanar todo excepto el Primer Campo en un PDF
Puedes aplanar selectivamente solo campos de formulario específicos en función de criterios como la posición o el nombre del campo.
1// Obtener Nombres de los Campos
2var fieldNames = FormFlattener.GetFieldNames("path_to_your_pdf_file.pdf");
3// Crear objeto FormFlattenerOptions para establecer instrucciones
4var options = new FormFlattenerOptions();
5options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
6options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
7// Omitir 1 campo.
8options.SkipFields.Add(fieldNames[0]);
9// Realizar el proceso
10FormFlattener.Process(options);
Características Clave:
- Aplana Todos los Campos de Formulario: Convierte campos de formulario interactivos en contenido estático no editable.
- Aplana Campos Seleccionados: Opcionalmente aplana campos específicos en un PDF mientras mantienes otros editables.
- Aplana Obtener Nombres de Campos: Obtén los nombres de los campos en un PDF.
FAQs
Este FAQ proporciona información completa sobre las características y funcionalidades de Documentize .NET Plugins, abarcando aspectos como conversión de PDF, manejo de formularios y generación de tabla de contenidos (TOC).
Preguntas Generales
1. ¿Qué es Documentize para .NET?
Documentize para .NET es una poderosa biblioteca para gestionar y procesar documentos PDF programáticamente. Incluye plugins para convertir PDFs a varios formatos, editar formularios PDF, agregar firmas digitales, generar TOCs y garantizar la conformidad con PDF/A para archivo a largo plazo.
2. ¿Cómo instalo los plugins de Documentize para .NET?
Puedes instalar los plugins de Documentize descargando los archivos de ensamblado desde el sitio web oficial o obteniendo paquetes directamente desde NuGet. Las instrucciones de instalación detalladas están disponibles en la documentación de cada plugin.
Plugins de Conversión de PDF
3. ¿Cómo puedo convertir un documento PDF a un archivo de Word (DOC/DOCX)?
Para convertir un documento PDF a formato Word utilizando el Convertidor de PDF a DOC:
- Instancia la clase
PdfDoc
. - Crea un objeto
PdfToDocOptions
para configurar las opciones de conversión. - Agrega las rutas de archivo de entrada PDF y de salida DOC/DOCX.
- Llama al método
Process
para ejecutar la conversión.
4. ¿Cómo convierto páginas PDF en imágenes JPEG?
Usando el Convertidor de PDF a JPEG:
- Crea una instancia de la clase
Jpeg
. - Establece opciones de conversión (por ejemplo, resolución, rango de páginas) a través de
JpegOptions
. - Agrega las rutas de archivo de entrada/salida.
- Llama al método
Jpeg.Process
para ejecutar la conversión.
5. ¿Cómo convierto un PDF a PNG?
Para convertir un PDF a formato PNG:
- Crea una instancia de la clase
Png
y un objeto PngOptions
. - Agrega el PDF de entrada y especifica la carpeta de salida.
- Establece opciones como la resolución (por ejemplo, 300 DPI).
- Llama al método
Process
para generar imágenes PNG.
6. ¿Cómo convierto un PDF a Excel (XLS/XLSX)?
Para convertir PDF a Excel:
- Instancia la clase
PdfXls
. - Utiliza
PdfToXlsOptions
para configurar las rutas de entrada/salida y las opciones de conversión. - Llama al método
Process
para iniciar la conversión.
7. ¿Cómo convierto un PDF a HTML?
Para convertir documentos PDF a HTML:
- Crea una instancia de la clase
PdfHtml
. - Configura las opciones de conversión con
PdfToHtmlOptions
o HtmlToPdfOptions
. - Agrega las rutas de entrada/salida y llama al método
Process
.
El Editor de Formularios PDF proporciona capacidades para:
- Agregar campos (
FormEditorAddOptions
). - Actualizar campos (
FormEditorSetOptions
). - Eliminar campos (
FormRemoveSelectedFieldsOptions
).
Después de configurar los campos del formulario, ejecuta el método Process
.
Para aplanar campos de formulario:
- Instancia la clase
FormFlattener
. - Utiliza
FormFlattenAllFieldsOptions
para aplanar todos los campos o FormFlattenSelectedFieldsOptions
para dirigirte a campos específicos. - Agrega archivos de entrada/salida y llama al método
Process
.
Para exportar datos de formularios, utiliza el Exportador de Formularios PDF. Crea un objeto FormExporterValuesToCsvOptions
, especifica las condiciones de los campos del formulario y ejecuta el método Process
para exportar los datos en formato CSV.
Gestión de PDF/A y TOC
Para convertir PDFs a PDF/A:
- Utiliza la clase
PdfAConverter
. - Configura la versión PDF/A (por ejemplo, PDF/A-3B) en
PdfAConvertOptions
. - Agrega las rutas de entrada/salida y llama al método
Process
.
12. ¿Cómo genero una Tabla de Contenidos (TOC) en un PDF?
Para crear un TOC:
- Crea una instancia de la clase
TocGenerator
. - Utiliza
TocOptions
para definir los parámetros del TOC. - Agrega archivos de entrada/salida y ejecuta el método
Process
.
Manejo de Firmas
13. ¿Cómo puedo firmar digitalmente un documento PDF?
Para agregar una firma digital:
- Instancia la clase
Signature
. - Utiliza
SignOptions
para configurar el archivo PFX, la contraseña y los detalles de la firma (por ejemplo, razón, información de contacto). - Agrega archivos de entrada/salida y ejecuta el método
Process
.
Características Adicionales
14. ¿Puedo dividir archivos PDF usando Documentize?
Sí, utilizando el Divisor de PDF:
- Instancia la clase
Splitter
. - Configura las opciones de división usando
SplitOptions
. - Agrega las rutas de entrada/salida y llama al método
Process
.
15. ¿Cómo fusiono múltiples archivos PDF en uno?
Para fusionar PDFs:
- Instancia la clase
Merger
. - Agrega PDFs de entrada y especifica un archivo de salida a través de
MergeOptions
. - Ejecuta el método
Process
para fusionar los archivos.
16. ¿Está Documentize limitado a trabajar solo con PDFs?
Aunque Documentize se centra principalmente en la manipulación de PDF, también admite conversiones hacia y desde formatos como DOC, XLS, HTML, JPEG y PNG.
Licencias y Compatibilidad
17. ¿Cuáles son los requisitos del sistema para usar los plugins de Documentize?
Documentize admite:
- Sistemas Operativos: Windows 7-11, Windows Server 2003-2022, macOS (10.12+), y Linux.
- Frameworks: .NET Framework 4.0 a 8.0.
- IDE: Compatible con varias versiones de Visual Studio.
18. ¿Cómo configuro las claves de licencia para Documentize?
Para activar un plugin, referencia Documentize en tu proyecto y configura las claves de licencia antes de llamar a cualquier método. Consulta la documentación del plugin específico para obtener instrucciones detalladas.
19. ¿Dónde puedo encontrar más ejemplos y documentación para los plugins de Documentize?
La documentación completa de la API y ejemplos se pueden encontrar en el sitio web de Documentize o a través de los paquetes de NuGet dentro de tu entorno de desarrollo.