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 v24.12 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 v24.12 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>"));

v24.12

Se añadió un nuevo Plugin: Convertidor de PDF a PNG

• Clase PngConverter: Representa el plugin Documentize.PngConverter. Se utiliza para convertir documentos PDF a formato PNG.
• Clase PdfToPngOptions: Representa las opciones del convertidor 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);

Se añadió un nuevo Plugin: Convertidor de PDF a TIFF

• Clase TiffConverter: Representa el plugin Documentize.TiffConverter. Se utiliza para convertir documentos PDF a formato TIFF.
• Clase PdfToTiffOptions: Representa las opciones del convertidor 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);

Se añadió un nuevo Plugin: Generador de Tablas de PDF

• Clase TableGenerator: Representa el plugin Documentize.TableGenerator. Se utiliza para agregar una tabla a un documento PDF.
• Clase TableBuilder: Clase que representa el generador de tablas en una página pdf.
• Clase TableRowBuilder: Clase que representa el generador de filas de tabla.
• Clase TableCellBuilder: Clase que representa el generador de celdas de 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 a 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

Nuevo Plugin Agregado: Convertidor de PDF a JPEG

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

Ejemplo de Uso:

var plugin = new JpegConverter();
var opt = new PdfToJpegOptions();
opt.AddInput(new FileDataSource("ruta_a_su_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.

Clase DirectoryDataSource Agregada

• Propósito: La clase DirectoryDataSource permite a los usuarios gestionar datos de directorio para operaciones de carga y guardado dentro de 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_su_directorio");

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

Clase PdfToJpegOptions Agregada

• 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 la imagen.
• Constructor:
  • PdfToJpegOptions(): Inicializa una nueva instancia de opciones para el convertidor JPEG.

Propiedades:

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

v24.10

Nuevo Plugin Agregado: Conversor PDF/A

• Se ha introducido una nueva función de conversión a PDF/A, permitiendo 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 corrigieron 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 e ImageExtractor para tiempos de procesamiento más rápidos.
• Se actualizó la clase RotateOptions para admitir ángulos de rotación adicionales.

v24.9

Lanzado