Установка Documentize через NuGet

Как установить через консоль менеджера пакетов NuGet

1. Откройте свой проект:

   • Запустите Visual Studio и откройте свое .NET приложение.

2. Доступ к консоли менеджера пакетов:

   • Перейдите в Справка > Менеджер пакетов NuGet > Консоль менеджера пакетов.

3. Установите пакет:

   • Чтобы установить последнюю полную версию, введите команду Install-Package Documentize.
   • Чтобы установить последнюю версию, включая исправления, используйте Install-Package Documentize -prerelease.
   • Нажмите Enter, чтобы выполнить команду.

Как обновить пакет через консоль менеджера пакетов NuGet

Если вы уже установили Documentize через NuGet и хотите обновить до последней версии:

1. Откройте свой проект:

   • Запустите Visual Studio и откройте свое .NET приложение.

2. Доступ к консоли менеджера пакетов:

   • Перейдите в Справка > Менеджер пакетов NuGet > Консоль менеджера пакетов.

3. Обновите пакет:

   • Чтобы обновить до последней полной версии, введите Update-Package Documentize.
   • Чтобы обновить до последней версии, включая исправления, используйте Update-Package Documentize -prerelease.
   • Нажмите Enter, чтобы выполнить команду.

Как установить через графический интерфейс менеджера пакетов NuGet

1. Откройте свой проект:

   • Запустите Visual Studio и откройте свое .NET приложение.

2. Перейдите к управлению пакетами NuGet:

   • В меню Проект выберите Управление пакетами NuGet.

3. Найдите Documentize:

   • Перейдите на вкладку Обзор и введите Documentize в строку поиска.

4. Установите пакет:

   • Нажмите Установить/Обновить рядом с последней версией Documentize.
   • Подтвердите, нажав Принять в появившемся окне.

Плюсы использования NuGet

• Автоматическое управление зависимостями:

  • NuGet автоматически управляет зависимостями, обеспечивая правильное включение и обновление всех необходимых библиотек. Это снижает риск отсутствия или несовместимости зависимостей.

• Упрощенные обновления:

  • Обновление пакетов с помощью NuGet довольно простое, как через консоль менеджера пакетов, так и через графический интерфейс. Это упрощает поддержку ваших библиотек в актуальном состоянии с последними возможностями и исправлениями.

• Интеграция с Visual Studio:

  • NuGet бесшовно интегрирован с Visual Studio, предоставляя удобный интерфейс для управления пакетами, не покидая среду разработки.

• Версионирование:

  • NuGet позволяет указывать и управлять различными версиями библиотек, что позволяет легко возвращаться к предыдущим версиям или тестировать новые релизы без нарушения процесса разработки.

Минусы использования NuGet

• Ограничено Visual Studio:

  • NuGet в первую очередь разработан для использования в Visual Studio. Хотя его можно использовать в других средах, интеграция наиболее robust в Visual Studio.

• Потенциальные конфликты версий:

  • В крупных проектах с множеством зависимостей управление версиями и разрешение конфликтов могут стать сложными. NuGet предоставляет инструменты для управления этим, но это требует внимательного подхода.

• Зависимость от сети:

  • Установка и обновление пакетов требуют подключения к интернету. Если вы работаете в среде с ограниченным или отсутствующим интернет-доступом, вам, возможно, придется использовать оффлайн-методы или заранее загрузить пакеты.

• Сложность для крупных проектов:

  • Для очень крупных проектов с расширенными деревьями зависимостей управление пакетами через NuGet может стать обременительным. В таких случаях могут потребоваться дополнительные инструменты или стратегии для эффективного управления зависимостями.

Установка Documentize с помощью MSI

Как установить с помощью MSI-установщика

1. Скачайте MSI-установщик:

   • Нажмите на v25.7 MSI, чтобы скачать MSI-установщик последней версии Documentize.

2. Запустите установщик:

   • Дважды щелкните на загруженный MSI-файл, чтобы открыть мастер установки.

3. Следуйте инструкциям мастера установки:

   • Следуйте указаниям на экране, предоставленным установщиком. Возможно, вам потребуется согласиться на лицензионное соглашение и выбрать параметры установки.

4. Завершите установку:

   • После завершения установки DLL-файлы Documentize будут установлены в глобальный кэш сборок (GAC) вашей системы или в другое указанное место.

5. Проверьте установку:

   • Убедитесь, что DLL-файлы установлены корректно, проверив их наличие в указанной директории установки или GAC.

Плюсы использования MSI-установщика

• Простота использования:

  • MSI-установщик предоставляет простой и понятный процесс установки. Он обрабатывает все необходимые настройки и размещает DLL-файлы в централизованном месте, что упрощает использование Documentize в нескольких проектах.

• Установка на уровне системы:

  • Метод MSI устанавливает Documentize в глобальный кэш сборок (GAC) системы или другое центральное место. Это позволяет любому приложению в системе обращаться к DLL-файлам без необходимости указывать их отдельно в каждом проекте.

• Автоматические обновления:

  • Если Documentize предоставляет обновленный установщик, вы можете легко обновить свою установку, запустив новый MSI-файл, который обычно обрабатывает процесс обновления гладко.

• Согласованность:

  • Использование MSI-установщика гарантирует, что все необходимые файлы установлены корректно и согласованно в разных средах, уменьшая риск отсутствующих или неправильно размещенных DLL-файлов.

Минусы использования MSI-установщика

• Ограниченная гибкость:

  • MSI-установщик устанавливает Documentize в системное место, что может быть не подходящим для всех сред разработки. Ему может не хватать гибкости для учета конфигураций или версий, специфичных для проекта.

• Потенциальные накладные расходы:

  • Установка DLL-файлов в GAC может ввести накладные расходы и сложность, особенно в сценариях, когда одновременно могут потребоваться несколько версий Documentize.

• Ручное удаление:

  • Если вам нужно удалить Documentize, вы должны использовать средство удаления, предоставляемое MSI, которое может оставить остаточные файлы или конфигурации, если не будет правильно управляться.

• Конфликты версий:

  • Установки на уровне системы могут привести к конфликтам версий, если разные проекты требуют различных версий Documentize. Управление этими конфликтами может потребовать дополнительной настройки или очистки.

Установка Documentize через ZIP

Как установить через ZIP-архив

1. Скачать ZIP-архив:

   • Нажмите на v25.7 ZIP, чтобы скачать последнюю версию Documentize в архивном формате.

2. Извлечь содержимое:

   • После загрузки распакуйте содержимое ZIP-файла в каталог по вашему выбору. Вы можете выбрать, сохранить эти файлы в общем каталоге или внутри структуры вашего проекта.

3. Добавить ссылки на ваш проект:

   • Откройте ваш проект в вашей IDE (например, Visual Studio).
   • Перейдите в Проект > Добавить ссылку > Обзор и перейдите в каталог, где вы извлекли DLL-файлы.
   • Выберите соответствующие DLL-файлы и добавьте их в качестве ссылок на ваш проект.

4. Ручные обновления:

   • Если новая версия Documentize будет выпущена, вам нужно будет вручную скачать обновленный ZIP-архив и заменить старые DLL-файлы в вашем проекте на новые.

Плюсы использования ZIP-архива

• Полный контроль:

  • У вас есть полный контроль над тем, где и как DLL-файлы хранятся и ссылаются в вашем проекте. Это может быть полезно, если вы предпочитаете индивидуальную настройку или вам нужно управлять зависимостями вручную.

• Нет зависимости от менеджеров пакетов:

  • В отличие от NuGet, вы не зависите от менеджера пакетов для обработки установок. Это может быть выгодно в средах, где менеджеры пакетов недоступны или нежелательны.

• Портативность:

  • ZIP-архив можно легко передавать и перемещать между различными системами, что делает его идеальным для проектов, которые должны быть портативными или распространяемыми без зависимости от внешних инструментов.

Минусы использования ZIP-архива

• Ручное управление:

  • В отличие от NuGet, где обновления и управление зависимостями автоматизированы, с ZIP-архивом вам необходимо вручную управлять обновлениями и следить за тем, чтобы все необходимые DLL были правильно подключены.

• Риск конфликтов версий:

  • Если вы управляете несколькими проектами или работаете в команде, существует риск конфликтов версий, если разные проекты используют разные версии DLL. Это требует тщательного отслеживания версий между проектами.

• Нет автоматических обновлений:

  • Вы не получите автоматических обновлений или уведомлений, когда будет доступна новая версия. Это может привести к использованию устаревших библиотек, если вы не будете регулярно проверять наличие обновлений.

Невиндоусная среда

Работа с .NET Core DLL в невиндоусной среде

Поскольку Documentize для .NET поддерживает .NET Standard 2.0 ( .NET Core 2.0), его можно использовать в ядре приложений, работающих в операционных системах, подобных Linux. Мы постоянно работаем над улучшением поддержки .NET Core в нашем API. Тем не менее, есть некоторые операции, которые мы рекомендуем нашим клиентам выполнять, чтобы добиться лучших результатов при использовании функций Documentize для .NET. Пожалуйста, установите:

• пакет libgdiplus
• пакет с шрифтами, совместимыми с Microsoft: ttf-mscorefonts-installer (например, sudo apt-get install ttf-mscorefonts-installer). Эти шрифты должны быть размещены в директории /usr/share/fonts/truetype/msttcorefonts, так как Documentize для .NET сканирует эту папку в операционных системах, подобных Linux. В случае, если операционная система имеет другую папку/директорию по умолчанию для шрифтов, вы должны использовать следующую строку кода перед выполнением любой операции с использованием Documentize:

  Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<путь пользователя к шрифтам ms>"));

v25.7

Улучшенная удобству использования Text Extractor

• Class TextExtractor: статичен и не требует использования конструктора.
• Class TextExtractor: улучшено поведение при работе в режиме оценки. Нет исключения при работе с документами на 4+ страницах.
• Class TextExtractor: исправлены ошибки в методе Process.
• Class PdfExtractorOptions: удалён.
• Class TextExtractorOptions: переработан.
• Enum TextFormattingMode: переименован и улучшен.

Пример использования:

// Пример демонстрирует, как извлечь текстовое содержимое PDF документа.
// Создайте объект TextExtractorOptions для установки инструкций
var options = new TextExtractorOptions(TextFormattingMode.Pure);
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Выполните процесс
var results = TextExtractor.Process(options);
// Получите извлечённый текст из объекта ResultContainer
var textExtracted = results.ResultCollection[0].ToString();

Улучшенная удобству использования Html Converter

• Class HtmlConverter: статичен и не требует использования конструктора.
• Class HtmlConverter: исправлены ошибки в методе Process.
• Class HtmlConverter: удалена логика IDisposable.
• Class PdfConverterOptions: удалён.

Примеры использования:

// Пример демонстрирует, как конвертировать PDF в HTML документ.
// Создайте объект PdfToHtmlOptions, чтобы установить тип выходных данных как файл с встроенными ресурсами
var options = new PdfToHtmlOptions(PdfToHtmlOptions.SaveDataType.FileWithEmbeddedResources);
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_input.pdf"));
// Установите путь к выходному файлу
options.AddOutput(new FileDataSource("path_to_output.html"));
// Выполните процесс
HtmlConverter.Process(options);

// Пример демонстрирует, как конвертировать HTML в PDF документ.
// Создайте HtmlToPdfOptions
var options = new HtmlToPdfOptions();
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_input.html"));
// Установите путь к выходному файлу
options.AddOutput(new FileDataSource("path_to_output.pdf"));
// Выполните процесс
HtmlConverter.Process(options);

Улучшенная удобству использования Image Extractor

• Class ImageExtractor: статичен и не требует использования конструктора.

Пример использования:

// Пример демонстрирует, как извлечь изображения из PDF документа.
// Создайте ImageExtractorOptions для установки инструкций
var options = new ImageExtractorOptions();
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Установите путь к выходному каталогу
options.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// Выполните процесс
var results = ImageExtractor.Process(options);
// Получите путь к результату изображения
var imageExtracted = results.ResultCollection[0].ToFile();

Небольшие исправления

• Внутренние исправления.
• Исправлены примеры и подсказки Tiff Converter.
• Сокращено время оптимизации страниц.
• Исправлено: неправильный вывод изображения при конвертации PDF в PNG.
• Исправлено: китайские символы отображаются неправильно при конвертации PDF в PNG.
• Улучшено: производительность при конвертации PDF в HTML.

v25.6

Улучшенная удобство использования Tiff Converter

• Класс PdfToTiffOptions: Добавлен дополнительный параметр для конверсии - Сжатие.
• Класс PdfToTiffOptions: Добавлен дополнительный параметр для конверсии - Глубина цвета.
• Класс TiffConverter статичен и не требует использования конструктора.
• Улучшены основные примеры.

Примеры использования:

// Этот пример демонстрирует, как конвертировать документ PDF в формат TIFF.
// Создайте объект PdfToTiffOptions, чтобы установить инструкции
var options = new PdfToTiffOptions();
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Установите путь к выходному каталогу
options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
// Выполните процесс
TiffConverter.Process(options);

// Этот пример демонстрирует, как конвертировать документ PDF в формат TIFF с дополнительными параметрами.
// Создайте объект PdfToTiffOptions, чтобы установить инструкции
var options = new PdfToTiffOptions();
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Установите путь к выходному каталогу
options.AddOutput(new DirectoryDataSource("path_to_output_directory"));
// Необязательные параметры
options.PageList = new List<int> { 1, 3 };
options.MultiPage = true;
options.OutputResolution = 400;
options.Compression = TiffCompression.RLE;
options.ColorDepth = TiffColorDepth.Format24bpp;
// Выполните процесс
TiffConverter.Process(options);

Небольшие исправления

• Внутренние исправления.

v25.5

Добавлен новый плагин: Form Exporter

• Класс FormExporter: Представляет плагин Documentize.FormExporter, который используется для экспорта значений форм PDF документов в файл DSV или CSV.
• Класс FormExportToDsvOptions: Представляет параметры для экспорта значений PDF документов в файл DSV или CSV с помощью плагина Documentize.FormExporter.

Пример использования:

// Пример демонстрирует, как экспортировать значения формы в файл CSV.
// Создайте объект FormExportToDsvOptions, чтобы установить инструкции
var options = new FormExportToDsvOptions(',', true);
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Установите путь к выходному файлу
options.AddOutput(new FileDataSource("path_to_result_csv_file.csv"));
// Выполните процесс
FormExporter.Process(options);

Улучшена удобство использования Security

• Класс статический и не требует использования конструктора.
• Улучшены основные примеры.

Примеры использования:

// Пример демонстрирует, как зашифровать PDF документ.
// Создайте объект EncryptionOptions, чтобы установить инструкции
var options = new EncryptionOptions("123456", "qwerty");
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Установите путь к выходному файлу
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Выполните процесс
Security.Process(options);

// Пример демонстрирует, как расшифровать PDF документ.
// Создайте объект DecryptionOptions, чтобы установить инструкции
var options = new DecryptionOptions("123456");
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Установите путь к выходному файлу
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Выполните процесс
Security.Process(options);

Небольшие исправления

• Улучшены подсказки по классам и лицензиям.

v25.4

Улучшенная удобочитаемость Optimizer

• Класс статический и не требует использования конструктора.
• Улучшен основной пример.
• Добавлены дополнительные примеры.

Примеры использования:

// Пример демонстрирует, как оптимизировать PDF документ.
// Создайте объект OptimizeOptions для установки инструкций
var options = new OptimizeOptions();
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Установите путь к выходному файлу
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Выполните процесс
Optimizer.Process(options);

// Пример демонстрирует, как повернуть PDF документ.
// Создайте объект RotateOptions для установки инструкций
var options = new RotateOptions();
// Установите новое вращение
options.Rotation = Rotation.On90;
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Установите путь к выходному файлу
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Выполните процесс
Optimizer.Process(options);

// Пример демонстрирует, как изменить размер PDF документа.
// Создайте объект ResizeOptions для установки инструкций
var options = new ResizeOptions();
// Установите новый размер страницы
options.PageSize = PageSize.A3;
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Установите путь к выходному файлу
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Выполните процесс
Optimizer.Process(options);

// Пример демонстрирует, как сжать PDF документ.
// Создайте объект CompressOptions для установки инструкций
var options = new CompressOptions();
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Установите путь к выходному файлу
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Выполните процесс
Optimizer.Process(options);

Улучшенная удобочитаемость Plugin Splitter

• Класс статический и не требует использования конструктора.
• Улучшен основной пример.

Примеры использования:

// Пример демонстрирует, как разделить PDF документ.
// Создайте объект SplitOptions для установки инструкций
var options = new SplitOptions();
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Установите пути к выходным файлам
options.AddOutput(new FileDataSource("path_to_result_pdf_file_1.pdf"));
options.AddOutput(new FileDataSource("path_to_result_pdf_file_2.pdf"));
// Выполните процесс
Splitter.Process(options);

Улучшенная удобочитаемость Plugin Merger

• Класс статический и не требует использования конструктора.
• Улучшен основной пример.

Примеры использования:

// Пример демонстрирует, как объединить два PDF документа.
// Создайте объект MergeOptions для установки инструкций
var options = new MergeOptions();
// Добавьте пути к входным файлам
options.AddInput(new FileDataSource("path_to_your_pdf_file_1.pdf"));
options.AddInput(new FileDataSource("path_to_your_pdf_file_2.pdf"));
// Установите путь к выходному файлу
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Выполните процесс
Merger.Process(options);

Мелкие исправления

• Улучшены подсказки классов.

v25.3

Добавлен новый плагин: Form Flattener

• Class FormFlattener: Представляет плагин Documentize.FormFlattener, который используется для преобразования полей в PDF-документах.
• Class FormFlattenerOptions: Представляет параметры для преобразования полей в документе с помощью плагина Documentize.FormFlattener.

Пример использования:

//Данный пример демонстрирует, как преобразовать поля в PDF-файле.
// Создайте объект FormFlattenerOptions для установки инструкций
var options = new FormFlattenerOptions();
// Добавьте путь к входному файлу
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Установите путь к выходному файлу
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
//Необязательный параметр для пропуска поля с именем "Surname".
options.SkipFields.Add("Surname");
// Выполнить процесс
FormFlattener.Process(options);

//Данный пример демонстрирует, как получить имена полей из PDF-файла.
var fieldNames = FormFlattener.GetFieldNames("path_to_your_pdf_file.pdf");

Небольшие исправления

• Улучшены подсказки классов и примеры.

v25.2

Добавлен новый плагин: Генератор содержания

• Class TocGenerator: Представляет плагин Documentize.TocGenerator. Используется для добавления оглавления в PDF документы.
• Class TocOptions: Представляет параметры для добавления оглавления в документ с помощью плагина Documentize.TocGenerator.
• Class TocHeading: Представляет параметры для заголовков или названий оглавления документа с помощью плагина Documentize.TocGenerator.

Пример использования:

// Пример демонстрирует, как добавить оглавление в PDF файл.
var options = new TocOptions();
// Установить заголовок
options.Title = "Мое оглавление";
// Генерировать ссылки в закладках
options.GenerateBookmarks = true;
// Дизайн заголовков
options.Headings.Add(new TocHeading("Введение", 2, false, 1));
options.Headings.Add(new TocHeading("Глава I", 3, true, 1));
options.Headings.Add(new TocHeading("Глава II", 4, true, 1));
options.Headings.Add(new TocHeading("Пример A", 4, true, 2));
options.Headings.Add(new TocHeading("Пример B", 4, true, 2));
options.Headings.Add(new TocHeading("Пример C", 4, true, 2));
options.Headings.Add(new TocHeading("Пример D", 4, true, 2));
options.Headings.Add(new TocHeading("Глава III", 5, true, 1));
// Добавить путь к входному файлу
options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// Установить путь к выходному файлу
options.AddOutput(new FileDataSource("path_to_result_pdf_file.pdf"));
// Выполнить процесс
TocGenerator.Process(options);

Небольшие исправления

• Улучшены подсказки и примеры классов.
• Обновлены водяные знаки.
• Улучшена конверсия PDF в XSLX.
• Улучшена конверсия PDF в PDF/A-1a.

v25.1

Улучшенный плагин: ImageExtractor

• Добавлено коллекция выходных данных в ImageExtractorOptions.
• Добавлена поддержка нескольких входов в ImageExtractorOptions.
• Исправлены закрытые выходные потоки.

Пример использования:

// создать объект ImageExtractor для извлечения изображений
var plugin = new ImageExtractor();
// создать ImageExtractorOptions
var opt = new ImageExtractorOptions();
// добавить путь к входному файлу
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// установить выходной каталог
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// выполнить процесс извлечения
var resultContainer = plugin.Process(opt);
// получить изображение из объекта ResultContainer
var imageExtracted = resultContainer.ResultCollection[0].ToFile();

Небольшие исправления

• Улучшены подсказки и примеры классов.
• Валидация подписи PDF.
• Улучшена поддержка китайских символов.

v24.12

Добавлен новый плагин: Конвертер PDF в PNG

• Класс PngConverter: Представляет плагин Documentize.PngConverter. Используется для конвертации PDF-документов в формат PNG.
• Класс PdfToPngOptions: Представляет параметры конвертации PDF в PNG для плагина Documentize.PngConverter.

Пример использования:

// создать PngConverter
var plugin = new PngConverter();
// создать объект PdfToPngOptions для установки инструкций
var opt = new PdfToPngOptions();
// добавить путь к входному файлу
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// установить путь к выходному файлу
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// выполнить процесс
plugin.Process(opt);

Добавлен новый плагин: Конвертер PDF в TIFF

• Класс TiffConverter: Представляет плагин Documentize.TiffConverter. Используется для конвертации PDF-документов в формат TIFF.
• Класс PdfToTiffOptions: Представляет параметры конвертации PDF в TIFF для плагина Documentize.TiffConverter.

Пример использования:

// создать TiffConverter
var plugin = new TiffConverter();
// создать объект PdfToTiffOptions для установки инструкций
var opt = new PdfToTiffOptions();
// добавить путь к входному файлу
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// установить путь к выходному файлу
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// выполнить процесс
plugin.Process(opt);

Добавлен новый плагин: Генератор таблиц PDF

• Класс TableGenerator: Представляет плагин Documentize.TableGenerator. Используется для добавления таблицы в PDF-документ.
• Класс TableBuilder: Класс представляет построитель таблицы на странице PDF.
• Класс TableRowBuilder: Класс представляет построитель строки таблицы.
• Класс TableCellBuilder: Класс представляет построитель ячейки таблицы.

Пример использования:

// создать TableGenerator
var plugin = new TableGenerator();
// создать объект TableOptions для установки инструкций
TableOptions opt = new TableOptions().InsertPageBefore(1)
   .AddTable()
        .AddRow()
            .AddCell().AddParagraph("Имя")
            .AddCell().AddParagraph("Возраст")
        .AddRow()
            .AddCell().AddParagraph("Боб")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("Сэм")
            .AddCell().AddParagraph("20")
        .AddRow()
            .AddCell().AddParagraph("Сэнди")
            .AddCell().AddParagraph("26")
        .AddRow()
            .AddCell().AddParagraph("Том")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("Джим")
            .AddCell().AddParagraph("27");
// добавить путь к входному файлу
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// установить путь к выходному файлу
opt.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));
// выполнить процесс
plugin.Process(opt);

Переименован класс PdfDoc в DocConverter

• Класс DocConverter: Представляет плагин Documentize.DocConverter. Используется для конвертации PDF-документов в формат DOC/DOCX.

Пример использования:

// создать DocConverter
var plugin = new DocConverter();
// создать объект PdfToDocOptions для установки инструкций
var opt = new PdfToDocOptions();
// добавить путь к входному файлу
opt.AddInput(new FileDataSource(inputPath));
// установить путь к выходному файлу
opt.AddOutput(new FileDataSource(outputPath));
// выполнить процесс
plugin.Process(opt);

v24.11

Добавлен новый плагин: Конвертер PDF в JPEG

• Назначение: Класс JpegConverter предназначен для преобразования документов PDF в формат JPEG, что упрощает пользователям обработку и обмен изображениями, полученными из PDF.
• Конструктор:
  • JpegConverter(): Инициализирует новый экземпляр конвертера JPEG.

Пример использования:

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

• Метод:
  • Process(PdfToJpegOptions options): Запускает процесс конвертации в JPEG с использованием указанных параметров.

Добавлен класс DirectoryDataSource

• Назначение: Класс DirectoryDataSource позволяет пользователям управлять данными директории для операций загрузки и сохранения в плагинах.
• Конструктор:
  • DirectoryDataSource(string path): Инициализирует новый объект данных директории с указанным путем.

Пример использования:

var directorySource = new DirectoryDataSource("path_to_your_directory");

• Свойства:
  • DataType: Получает тип источника данных.
  • Path: Получает путь текущей директории данных.

Добавлен класс PdfToJpegOptions

• Назначение: Этот класс содержит параметры для настройки процесса конвертации в JPEG, позволяя пользователям указывать разрешение, списки страниц и качество изображения.
• Конструктор:
  • PdfToJpegOptions(): Инициализирует новый экземпляр параметров для конвертера JPEG.

Свойства:

• OutputResolution: Указывает разрешение получаемых изображений JPEG.
• PageList: Список страниц для конвертации из PDF.
• Quality: Устанавливает качество выходного JPEG.

v24.10

Добавлен новый плагин: PDF/A Конвертер

• Введена новая функция конвертации PDF/A, позволяющая пользователям легко конвертировать стандартные PDF файлы в документы, соответствующие стандарту PDF/A.

Пример использования:

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);

Исправления ошибок

• Исправлены проблемы, связанные с классом FileResult, которые приводили к неправильным выходным путям.
• Устранены мелкие ошибки, влияющие на HtmlConverter при работе с большими файлами.

Улучшения

• Повышена производительность PdfExtractor и ImageExtractor для более быстрых времён обработки.
• Обновлен класс RotateOptions для поддержки дополнительных углов поворота.

v24.9

Выпущено