Instalación de Documentize a través de NuGet

Cómo instalar a través de la consola del gestor de paquetes NuGet

1. Abre tu proyecto:

   • Inicia Visual Studio y abre tu aplicación .NET.

2. Accede a la consola del gestor de paquetes:

   • Navega a Herramientas > Gestor de paquetes NuGet > Consola del gestor de paquetes.

3. Instala el paquete:

   • Para instalar la última versión completa, ingresa el comando Install-Package Documentize.
   • Para instalar la última versión incluyendo correcciones rápidas, usa Install-Package Documentize -prerelease.
   • Presiona Enter para ejecutar el comando.

Cómo actualizar el paquete a través de la consola del gestor de paquetes NuGet

Si ya has instalado Documentize a través de NuGet y deseas actualizar a la última versión:

1. Abre tu proyecto:

   • Inicia Visual Studio y abre tu aplicación .NET.

2. Accede a la consola del gestor de paquetes:

   • Navega a Herramientas > Gestor de paquetes NuGet > Consola del gestor de paquetes.

3. Actualiza el paquete:

   • Para actualizar a la última versión completa, ingresa Update-Package Documentize.
   • Para actualizar a la última versión incluyendo correcciones rápidas, usa Update-Package Documentize -prerelease.
   • Presiona Enter para ejecutar el comando.

Cómo instalar a través de la GUI del gestor de paquetes NuGet

1. Abre tu proyecto:

   • Inicia Visual Studio y abre tu aplicación .NET.

2. Navega a Administrar paquetes NuGet:

   • Desde el menú Proyecto, selecciona Administrar paquetes NuGet.

3. Busca Documentize:

   • Ve a la pestaña Explorar e ingresa Documentize en el cuadro de búsqueda.

4. Instala el paquete:

   • Haz clic en Instalar/Actualizar junto a la última versión de Documentize.
   • Confirma haciendo clic en Aceptar en la ventana emergente.

Pros de usar NuGet

• Gestión automática de dependencias:

  • NuGet gestiona automáticamente las dependencias, asegurando que todas las bibliotecas requeridas estén incluidas y actualizadas correctamente. Esto reduce el riesgo de tener dependencias faltantes o incompatibles.

• Actualizaciones simplificadas:

  • Actualizar paquetes es sencillo con NuGet, ya sea a través de la consola del gestor de paquetes o de la GUI. Esto facilita mantener tus bibliotecas actualizadas con las últimas características y correcciones de errores.

• Integrado con Visual Studio:

  • NuGet está perfectamente integrado con Visual Studio, proporcionando una interfaz amigable para gestionar paquetes sin salir del entorno de desarrollo.

• Versionado:

  • NuGet te permite especificar y gestionar diferentes versiones de bibliotecas, facilitando volver a versiones anteriores o probar nuevas versiones sin interrumpir tu desarrollo.

Contras de usar NuGet

• Limitado a Visual Studio:

  • NuGet está diseñado principalmente para usarse dentro de Visual Studio. Si bien se puede usar en otros entornos, la integración es más robusta en Visual Studio.

• Potencial de conflictos de versiones:

  • En proyectos más grandes con muchas dependencias, gestionar versiones y resolver conflictos puede volverse complejo. NuGet proporciona herramientas para gestionar esto, pero requiere atención cuidadosa.

• Dependencia de red:

  • Instalar y actualizar paquetes requiere una conexión a internet. Si estás trabajando en un entorno con acceso a internet restringido o nulo, es posible que necesites usar métodos fuera de línea o predescargar paquetes.

• Complejidad para proyectos grandes:

  • Para proyectos muy grandes con extensos árboles de dependencias, la carga de gestionar paquetes a través de NuGet puede volverse engorrosa. En tales casos, pueden ser necesarias herramientas o estrategias adicionales para gestionar efectivamente las dependencias.

Instalando Documentize a través de MSI

Cómo Instalar a través del Instalador MSI

1. Descargar el Instalador MSI:

   • Haz clic en el v25.7 MSI para descargar el instalador MSI de la última versión de Documentize.

2. Ejecutar el Instalador:

   • Haz doble clic en el archivo MSI descargado para iniciar el asistente de instalación.

3. Seguir el Asistente de Instalación:

   • Sigue las instrucciones en pantalla proporcionadas por el instalador. Es posible que necesites aceptar el acuerdo de licencia y seleccionar opciones de instalación.

4. Completar la Instalación:

   • Una vez que la instalación esté completa, las DLLs de Documentize se instalarán en el Caché de Ensambles Global del sistema (GAC) o en otra ubicación especificada.

5. Verificar la Instalación:

   • Verifica que las DLLs estén correctamente instaladas comprobando su presencia en el directorio de instalación designado o en el GAC.

Pros de Usar el Instalador MSI

• Facilidad de Uso:

  • El instalador MSI proporciona un proceso de instalación simple y guiado. Maneja todas las configuraciones necesarias y coloca las DLLs en una ubicación central, facilitando el uso de Documentize en varios proyectos.

• Instalación Global:

  • El método MSI instala Documentize en el Caché de Ensambles Global del sistema (GAC) o en otra ubicación central. Esto permite que cualquier aplicación del sistema acceda a las DLLs sin necesidad de referenciarlas individualmente en cada proyecto.

• Actualizaciones Automatizadas:

  • Si Documentize proporciona un instalador actualizado, puedes actualizar fácilmente tu instalación ejecutando el nuevo archivo MSI, que normalmente maneja el proceso de actualización sin problemas.

• Consistencia:

  • Usar el instalador MSI asegura que todos los archivos requeridos se instalen correctamente y de manera consistente a través de diferentes entornos, reduciendo el riesgo de DLLs faltantes o mal ubicadas.

Contras de Usar el Instalador MSI

• Flexibilidad Limitada:

  • El instalador MSI instala Documentize en una ubicación global, lo que puede no ser adecuado para todos los entornos de desarrollo. Puede carecer de la flexibilidad para acomodar configuraciones o versiones específicas de cada proyecto.

• Sobrecarga Potencial:

  • Instalar DLLs en el GAC puede introducir sobrecarga y complejidad, particularmente en escenarios donde se necesiten múltiples versiones de Documentize simultáneamente.

• Eliminación Manual:

  • Si necesitas desinstalar Documentize, debes utilizar el desinstalador proporcionado por el MSI, lo que puede dejar archivos o configuraciones residuales si no se maneja correctamente.

• Conflictos de Versión:

  • Las instalaciones globales pueden llevar a conflictos de versión si diferentes proyectos requieren diferentes versiones de Documentize. Manejar estos conflictos puede requerir configuración o limpieza adicional.

Instalando Documentize a través de ZIP

Cómo Instalar a través del Archivo ZIP

1. Descargar el Archivo ZIP:

   • Haz clic en v25.7 ZIP para descargar la última versión de Documentize en formato de archivo.

2. Extraer el Contenido:

   • Después de descargar, extrae el contenido del archivo ZIP en un directorio de tu elección. Puedes optar por mantener estos archivos en un directorio compartido o dentro de la estructura de tu proyecto.

3. Agregar Referencias a Tu Proyecto:

   • Abre tu proyecto en tu IDE (por ejemplo, Visual Studio).
   • Ve a Proyecto > Agregar Referencia > Examinar y navega al directorio donde extrajiste los DLLs.
   • Selecciona los archivos DLL pertinentes y agrégales como referencias a tu proyecto.

4. Actualizaciones Manuales:

   • Si se libera una nueva versión de Documentize, tendrás que descargar manualmente el archivo ZIP actualizado y reemplazar los antiguos archivos DLL en tu proyecto por los nuevos.

Pros de Usar el Archivo ZIP

• Control Completo:

  • Tienes control total sobre dónde y cómo se almacenan y referencian los DLLs en tu proyecto. Esto puede ser beneficioso si prefieres una configuración personalizada o necesitas gestionar las dependencias manualmente.

• Sin Dependencia de Gestores de Paquetes:

  • A diferencia de NuGet, no dependes de un gestor de paquetes para manejar las instalaciones. Esto puede ser ventajoso en entornos donde los gestores de paquetes no están disponibles o no son preferidos.

• Portabilidad:

  • El archivo ZIP puede ser fácilmente compartido y movido a través de diferentes sistemas, haciéndolo ideal para proyectos que necesitan ser portátiles o distribuidos sin depender de herramientas externas.

Contras de Usar el Archivo ZIP

• Gestión Manual:

  • A diferencia de NuGet, donde las actualizaciones y la gestión de dependencias son automáticas, con el archivo ZIP, debes gestionar manualmente las actualizaciones y asegurarte de que todos los DLLs requeridos estén correctamente referenciados.

• Riesgo de Conflictos de Versiones:

  • Si estás gestionando múltiples proyectos o trabajando en equipo, existe el riesgo de conflictos de versiones si diferentes proyectos utilizan diferentes versiones de los DLLs. Esto requiere un seguimiento cuidadoso de las versiones a través de los proyectos.

• Sin Actualizaciones Automáticas:

  • No recibirás actualizaciones automáticas ni notificaciones cuando haya una nueva versión disponible. Esto puede llevar al riesgo de usar bibliotecas desactualizadas a menos que verifiques regularmente si hay actualizaciones.

Entorno No Windows

Trabajando con DLLs de .NET Core en Entornos No Windows

Dado que Documentize para .NET proporciona soporte para .NET Standard 2.0 (.NET Core 2.0), se puede utilizar en aplicaciones Core que se ejecutan en sistemas operativos similares a Linux. Estamos trabajando constantemente en mejorar el soporte de .NET Core en nuestra API. Sin embargo, hay algunas operaciones que recomendamos que nuestros clientes realicen para obtener mejores resultados al utilizar las características de Documentize para .NET. Por favor, instale:

• paquete libgdiplus
• Paquete con fuentes compatibles con Microsoft: ttf-mscorefonts-installer (por ejemplo, sudo apt-get install ttf-mscorefonts-installer). Estas fuentes deben colocarse en el directorio /usr/share/fonts/truetype/msttcorefonts ya que Documentize para .NET escanea esta carpeta en sistemas operativos similares a Linux. En caso de que el sistema operativo tenga otra carpeta/directorio predeterminado para fuentes, debe usar la siguiente línea de código antes de realizar cualquier operación utilizando Documentize:

  Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<ruta del usuario a las fuentes ms>"));

v25.7

Mejora en la usabilidad del Extractor de Texto

• Class TextExtractor: es estático y no requiere el uso de un constructor.
• Class TextExtractor: comportamiento mejorado al ejecutarse en modo de evaluación. Sin excepción con documentos de más de 4 páginas.
• Class TextExtractor: se solucionaron problemas en el método Process.
• Class PdfExtractorOptions: eliminado.
• Class TextExtractorOptions: reestructurado.
• Enum TextFormattingMode: renombrado y mejorado.

Ejemplo de Uso:

// El ejemplo demuestra cómo extraer el contenido de texto de un documento PDF.
// Crear un objeto TextExtractorOptions para establecer instrucciones
var options = new TextExtractorOptions(TextFormattingMode.Pure);
// Agregar ruta del archivo de entrada
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Realizar el proceso
var results = TextExtractor.Process(options);
// Obtener el texto extraído del objeto ResultContainer
var textExtracted = results.ResultCollection[0].ToString();

Mejora en la usabilidad del Conversor Html

• Class HtmlConverter: es estático y no requiere el uso de un constructor.
• Class HtmlConverter: se solucionaron problemas en el método Process.
• Class HtmlConverter: eliminada la lógica de IDisposable.
• Class PdfConverterOptions: eliminado.

Ejemplos de Uso:

// El ejemplo demuestra cómo convertir un PDF a un documento HTML.
// Crear un objeto PdfToHtmlOptions para establecer el tipo de datos de salida como archivo con recursos integrados
var options = new PdfToHtmlOptions(PdfToHtmlOptions.SaveDataType.FileWithEmbeddedResources);
// Agregar ruta del archivo de entrada
options.AddInput(new FileDataSource("path_to_input.pdf"));
// Establecer ruta del archivo de salida
options.AddOutput(new FileDataSource("path_to_output.html"));
// Realizar el proceso
HtmlConverter.Process(options);

// El ejemplo demuestra cómo convertir un HTML a un documento PDF.
// Crear HtmlToPdfOptions
var options = new HtmlToPdfOptions();
// Agregar ruta del archivo de entrada
options.AddInput(new FileDataSource("path_to_input.html"));
// Establecer ruta del archivo de salida
options.AddOutput(new FileDataSource("path_to_output.pdf"));
// Realizar el proceso
HtmlConverter.Process(options);

Mejora en la usabilidad del Extractor de Imágenes

• Class ImageExtractor: es estático y no requiere el uso de un constructor.

Ejemplo de Uso:

// El ejemplo demuestra cómo extraer imágenes de un documento PDF.
// Crear ImageExtractorOptions para establecer instrucciones
var options = new ImageExtractorOptions();
// Agregar ruta del archivo de entrada
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Establecer ruta del directorio de salida
options.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// Realizar el proceso
var results = ImageExtractor.Process(options);
// Obtener la ruta de la imagen resultante
var imageExtracted = results.ResultCollection[0].ToFile();

Reparaciones Menores

• Reparaciones internas.
• Se corrigieron ejemplos y sugerencias del Conversor Tiff.
• Se minimizó la duración de la optimización de página.
• Corregido: imagen de salida incorrecta de conversión de PDF a PNG.
• Corregido: caracteres chinos no se mostraban correctamente durante la conversión de PDF a PNG.
• Mejorado: Rendimiento durante la conversión de PDF a HTML.

v25.6

Mejora de la usabilidad del Convertidor Tiff

• Class PdfToTiffOptions: Se añadió un parámetro adicional para la conversión - Compresión.
• Class PdfToTiffOptions: Se añadió un parámetro adicional para la conversión - ColorDepth.
• Class TiffConverter es estático y no requiere el uso de un constructor.
• Mejores ejemplos principales.

Ejemplos de Uso:

// El ejemplo demuestra cómo convertir un documento PDF en formato TIFF.
// Crear objeto PdfToTiffOptions para establecer instrucciones
var options = new PdfToTiffOptions();
// Agregar ruta del archivo de entrada
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Establecer ruta del directorio de salida
options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
// Realizar el proceso
TiffConverter.Process(options);

// El ejemplo demuestra cómo convertir un documento PDF en formato TIFF con parámetros adicionales.
// Crear objeto PdfToTiffOptions para establecer instrucciones
var options = new PdfToTiffOptions();
// Agregar ruta del archivo de entrada
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Establecer ruta del directorio de salida
options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
// Parámetros opcionales
options.PageList = new List<int> { 1, 3 };
options.MultiPage = true;
options.OutputResolution = 400;
options.Compression = TiffCompression.RLE;
options.ColorDepth = TiffColorDepth.Format24bpp;
// Realizar el proceso
TiffConverter.Process(options);

Correcciones Menores

• Correcciones internas.

v25.5

Nuevo Plugin Añadido: Exportador de Formularios

• Clase FormExporter: Representa el plugin Documentize.FormExporter que se utiliza para exportar valores de formularios de documentos PDF a archivos DSV o CSV.
• Clase FormExportToDsvOptions: Representa opciones para exportar valores de documentos PDF a archivos DSV o CSV mediante el plugin Documentize.FormExporter.

Ejemplo de Uso:

// El ejemplo demuestra cómo exportar valores de formularios a un archivo CSV.
// Crear un objeto FormExportToDsvOptions para establecer instrucciones
var options = new FormExportToDsvOptions(',', true);
// Agregar la ruta del archivo de entrada
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Establecer la ruta del archivo de salida
options.AddOutput(new FileDataSource("path_to_result_csv_file.csv"));
// Realizar el proceso
FormExporter.Process(options);

Mejora en la Usabilidad de Seguridad

• La clase es estática y no requiere el uso de un constructor.
• Mejora en los ejemplos principales.

Ejemplos de Uso:

// El ejemplo demuestra cómo cifrar un documento PDF.
// Crear un objeto EncryptionOptions para establecer instrucciones
var options = new EncryptionOptions("123456", "qwerty");
// Agregar la ruta del archivo de entrada
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Establecer la ruta del archivo de salida
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Realizar el proceso
Security.Process(options);

// El ejemplo demuestra cómo descifrar un documento PDF.
// Crear un objeto DecryptionOptions para establecer instrucciones
var options = new DecryptionOptions("123456");
// Agregar la ruta del archivo de entrada
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Establecer la ruta del archivo de salida
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Realizar el proceso
Security.Process(options);

Correcciones Menores

• Mejora en las sugerencias de clases y licencias.

v25.4

Mejora de la usabilidad del Optimizador

• La clase es estática y no requiere el uso de un constructor.
• Ejemplo principal mejorado.
• Se añadieron ejemplos adicionales.

Uso de Ejemplos:

// El ejemplo demuestra cómo optimizar un documento PDF.
// Crear un objeto OptimizeOptions para establecer instrucciones
var options = new OptimizeOptions();
// Añadir la ruta del archivo de entrada
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Establecer la ruta del archivo de salida
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Realizar el proceso
Optimizer.Process(options);

// El ejemplo demuestra cómo rotar un documento PDF.
// Crear un objeto RotateOptions para establecer instrucciones
var options = new RotateOptions();
// Establecer nueva Rotación
options.Rotation = Rotation.On90;
// Añadir la ruta del archivo de entrada
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Establecer la ruta del archivo de salida
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Realizar el proceso
Optimizer.Process(options);

// El ejemplo demuestra cómo redimensionar un documento PDF.
// Crear un objeto ResizeOptions para establecer instrucciones
var options = new ResizeOptions();
// Establecer nuevo Tamaño de Página
options.PageSize = PageSize.A3;
// Añadir la ruta del archivo de entrada
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Establecer la ruta del archivo de salida
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Realizar el proceso
Optimizer.Process(options);

// El ejemplo demuestra cómo comprimir un documento PDF.
// Crear un objeto CompressOptions para establecer instrucciones
var options = new CompressOptions();
// Añadir la ruta del archivo de entrada
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Establecer la ruta del archivo de salida
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Realizar el proceso
Optimizer.Process(options);

Mejora de la usabilidad del Plugin Divisor

• La clase es estática y no requiere el uso de un constructor.
• Ejemplo principal mejorado.

Uso de Ejemplos:

// El ejemplo demuestra cómo dividir un documento PDF.
// Crear un objeto SplitOptions para establecer instrucciones
var options = new SplitOptions();
// Añadir la ruta del archivo de entrada
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Establecer las rutas de los archivos de salida
options.AddOutput(new FileDataSource("path_to_result_pdf_file_1.pdf"));
options.AddOutput(new FileDataSource("path_to_result_pdf_file_2.pdf"));
// Realizar el proceso
Splitter.Process(options);

Mejora de la usabilidad del Plugin Combinador

• La clase es estática y no requiere el uso de un constructor.
• Ejemplo principal mejorado.

Uso de Ejemplos:

// El ejemplo demuestra cómo combinar dos documentos PDF.
// Crear un objeto MergeOptions para establecer instrucciones
var options = new MergeOptions();
// Añadir las rutas de los archivos de entrada
options.AddInput(new FileDataSource("path_to_your_pdf_file_1.pdf"));
options.AddInput(new FileDataSource("path_to_your_pdf_file_2.pdf"));
// Establecer la ruta del archivo de salida
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Realizar el proceso
Merger.Process(options);

Soluciones Menores

• Mejora de pistas de clase.

v25.3

Nuevo Plugin Agregado: Form Flattener

• Clase FormFlattener: Representa el plugin Documentize.FormFlattener que se utiliza para aplanar campos en documentos PDF.
• Clase FormFlattenerOptions: Representa las opciones para Aplanar Campos en documentos por el plugin Documentize.FormFlattener.

Ejemplo de Uso:

//El ejemplo demuestra cómo aplanar campos en un archivo PDF.
// Crear objeto FormFlattenerOptions para establecer instrucciones
var options = new FormFlattenerOptions();
// Agregar ruta del archivo de entrada
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Establecer ruta del archivo de salida
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Parámetro opcional para omitir el campo con nombre "Surname".
options.SkipFields.Add("Surname");
// Realizar el proceso
FormFlattener.Process(options);

//El ejemplo demuestra cómo obtener nombres de campos de un archivo PDF.
var fieldNames = FormFlattener.GetFieldNames("path_to_your_pdf_file.pdf");

Correcciones Menores

• Mejora en las sugerencias de clase y ejemplos.

v25.2

Nuevo Plugin Agregado: Generador de TOC

• Class TocGenerator: Representa el plugin Documentize.TocGenerator. Se utiliza para agregar una Tabla de Contenidos a documentos PDF.
• Class TocOptions: Representa las opciones para agregar una Tabla de Contenidos al documento mediante el plugin Documentize.TocGenerator.
• Class TocHeading: Representa las opciones para los Encabezados o Títulos de la Tabla de Contenidos del documento mediante el plugin Documentize.TocGenerator.

Ejemplo de Uso:

// El ejemplo demuestra cómo agregar una Tabla de Contenidos a un archivo PDF.
var options = new TocOptions();
// Establecer el Título
options.Title = "Mi Tabla de Contenidos";
// Generar vínculos en marcadores
options.GenerateBookmarks = true;
// Diseñar Encabezados
options.Headings.Add(new TocHeading("Introducción", 2, false, 1));
options.Headings.Add(new TocHeading("Capítulo I", 3, true, 1));
options.Headings.Add(new TocHeading("Capítulo II", 4, true, 1));
options.Headings.Add(new TocHeading("Ejemplo A", 4, true, 2));
options.Headings.Add(new TocHeading("Ejemplo B", 4, true, 2));
options.Headings.Add(new TocHeading("Ejemplo C", 4, true, 2));
options.Headings.Add(new TocHeading("Ejemplo D", 4, true, 2));
options.Headings.Add(new TocHeading("Capítulo III", 5, true, 1));
// Agregar ruta del archivo de entrada
options.AddInput(new FileDataSource("ruta_a_tu_archivo_pdf.pdf"));
// Establecer ruta del archivo de salida
options.AddOutput(new FileDataSource("ruta_a_archivo_pdf_resultante.pdf"));
// Ejecutar el proceso
TocGenerator.Process(options);

Correcciones Menores

• Mejora de sugerencias y ejemplos de clases.
• Actualización de marcas de agua.
• Mejora de la conversión de PDF a XSLX.
• Mejora de la conversión de PDF a PDF/A-1a.

v25.1

Plugin Mejorado: ImageExtractor

• Se añadió la Colección de Salida a ImageExtractorOptions.
• Se agregó soporte para múltiples Entradas en ImageExtractorOptions.
• Se corrigieron flujos de salida cerrados.

Ejemplo de Uso:

// crear objeto ImageExtractor para extraer imágenes
var plugin = new ImageExtractor();
// crear ImageExtractorOptions
var opt = new ImageExtractorOptions();
// añadir ruta del archivo de entrada
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// establecer directorio de salida
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// realizar el proceso de extracción
var resultContainer = plugin.Process(opt);
// obtener la imagen del objeto ResultContainer
var imageExtracted = resultContainer.ResultCollection[0].ToFile();

Correcciones Menores

• Mejora de pistas y ejemplos de clase.
• Validación de firmas PDF.
• Mejora del soporte para caracteres chinos.

v24.12

Nuevo plugin añadido: Convertidor de PDF a PNG

• Clase PngConverter: Representa el plugin Documentize.PngConverter. Se utiliza para convertir documentos PDF en formato PNG.
• Clase PdfToPngOptions: Representa las opciones de conversión de PDF a PNG para el plugin Documentize.PngConverter.

Ejemplo de uso:

// crear PngConverter
var plugin = new PngConverter();
// crear objeto PdfToPngOptions para establecer instrucciones
var opt = new PdfToPngOptions();
// añadir ruta del archivo de entrada
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// establecer ruta del archivo de salida
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// realizar el proceso
plugin.Process(opt);

Nuevo plugin añadido: Convertidor de PDF a TIFF

• Clase TiffConverter: Representa el plugin Documentize.TiffConverter. Se utiliza para convertir documentos PDF en formato TIFF.
• Clase PdfToTiffOptions: Representa las opciones de conversión de PDF a TIFF para el plugin Documentize.TiffConverter.

Ejemplo de uso:

// crear TiffConverter
var plugin = new TiffConverter();
// crear objeto PdfToTiffOptions para establecer instrucciones
var opt = new PdfToTiffOptions();
// añadir ruta del archivo de entrada
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// establecer ruta del archivo de salida
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// realizar el proceso
plugin.Process(opt);

Nuevo plugin añadido: Generador de Tablas para PDF

• Clase TableGenerator: Representa el plugin Documentize.TableGenerator. Se utiliza para añadir una tabla a un documento PDF.
• Clase TableBuilder: Clase que representa un constructor para la tabla en la página pdf.
• Clase TableRowBuilder: Clase que representa un constructor para la fila de la tabla.
• Clase TableCellBuilder: Clase que representa un constructor para la celda de la tabla.

Ejemplo de uso:

// crear TableGenerator
var plugin = new TableGenerator();
// crear objeto TableOptions para establecer instrucciones
TableOptions opt = new TableOptions().InsertPageBefore(1)
   .AddTable()
        .AddRow()
            .AddCell().AddParagraph("Nombre")
            .AddCell().AddParagraph("Edad")
        .AddRow()
            .AddCell().AddParagraph("Bob")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("Sam")
            .AddCell().AddParagraph("20")
        .AddRow()
            .AddCell().AddParagraph("Sandy")
            .AddCell().AddParagraph("26")
        .AddRow()
            .AddCell().AddParagraph("Tom")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("Jim")
            .AddCell().AddParagraph("27");
// añadir ruta del archivo de entrada
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// establecer ruta del archivo de salida
opt.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));
// realizar el proceso
plugin.Process(opt);

Renombrada la clase PdfDoc a DocConverter

• Clase DocConverter: Representa el plugin Documentize.DocConverter. Se utiliza para convertir documentos PDF en formato DOC/DOCX.

Ejemplo de uso:

// crear DocConverter
var plugin = new DocConverter();
// crear objeto PdfToDocOptions para establecer instrucciones
var opt = new PdfToDocOptions();
// añadir ruta del archivo de entrada
opt.AddInput(new FileDataSource(inputPath));
// establecer ruta del archivo de salida
opt.AddOutput(new FileDataSource(outputPath));
// realizar el proceso
plugin.Process(opt);

v24.11

Se agregó un nuevo Plugin: Conversor de PDF a JPEG

• Propósito: La clase JpegConverter está diseñada para convertir documentos PDF en formato JPEG, facilitando a los usuarios el manejo y compartición de imágenes derivadas de PDFs.
• Constructor:
  • JpegConverter(): Inicializa una nueva instancia del conversor JPEG.

Ejemplo de Uso:

var plugin = new JpegConverter();
var opt = new PdfToJpegOptions();
opt.AddInput(new FileDataSource("ruta_a_tu_archivo_pdf.pdf"));
opt.AddOutput(new DirectoryDataSource("ruta_al_directorio_de_resultados"));
plugin.Process(opt);

• Método:
  • Process(PdfToJpegOptions options): Inicia el proceso de conversión a JPEG utilizando las opciones especificadas.

Se agregó la Clase DirectoryDataSource

• Propósito: La clase DirectoryDataSource permite a los usuarios gestionar datos de directorios para operaciones de carga y guardado dentro de los plugins.
• Constructor:
  • DirectoryDataSource(string path): Inicializa un nuevo objeto de datos de directorio con la ruta especificada.

Ejemplo de Uso:

var directorySource = new DirectoryDataSource("ruta_a_tu_directorio");

• Propiedades:
  • DataType: Recupera el tipo de fuente de datos.
  • Path: Obtiene la ruta del directorio de datos actual.

Se agregó la Clase PdfToJpegOptions

• Propósito: Esta clase contiene opciones para configurar el proceso de conversión a JPEG, permitiendo a los usuarios especificar resolución, listas de páginas y calidad de imagen.
• Constructor:
  • PdfToJpegOptions(): Inicializa una nueva instancia de opciones para el conversor JPEG.

Propiedades:

• OutputResolution: Especifica la resolución de las imágenes JPEG resultantes.
• PageList: Una lista de páginas para convertir desde el PDF.
• Quality: Establece la calidad de la salida JPEG.

v24.10

Nuevo Plugin Añadido: Convertidor PDF/A

• Se ha introducido una nueva función de conversión a PDF/A, que permite a los usuarios convertir fácilmente archivos PDF estándar en documentos compatibles con PDF/A.

Ejemplo de Uso:

var options = new PdfAConvertOptions
{
    PdfAVersion = PdfAStandardVersion.PDF_A_3B
};

options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
options.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));

var plugin = new PdfAConverter();
plugin.Process(options);

Corrección de Errores

• Se han solucionado problemas relacionados con la clase FileResult que resultaban en rutas de salida incorrectas.
• Se resolvieron errores menores que afectaban al HtmlConverter al manejar archivos grandes.

Mejoras

• Se mejoró el rendimiento de PdfExtractor y ImageExtractor para tiempos de procesamiento más rápidos.
• Se actualizó la clase RotateOptions para soportar ángulos de rotación adicionales.

v24.9

Liberado