Освоение управления документами: внедрение интеграции подписей штрихкодов .NET с GroupDocs.Signature

В современную цифровую эпоху обеспечение подлинности и целостности документов имеет решающее значение в различных отраслях. В этом руководстве показано, как интегрировать штрихкодовые подписи в ваш документооборот с помощью GroupDocs.Signature для .NET. Это руководство охватывает все основные аспекты, независимо от того, нужно ли вам подписывать, проверять, искать, обновлять или удалять подписи штрихкодов в документах.

Что вы узнаете

  • Настройка GroupDocs.Signature для .NET
  • Подписание документа штрих-кодовой подписью пошагово
  • Методы проверки, поиска, обновления и удаления подписей штрих-кодов
  • Изучение реальных приложений и возможностей интеграции
  • Оптимизация производительности и эффективное управление ресурсами

Готовы улучшить свою систему управления документами? Давайте приступим!

Предпосылки

Прежде чем начать, убедитесь, что у вас есть следующее:

  • .NET Core 3.1 или более поздняя версия, установленная на вашем компьютере.
  • Базовые знания программирования на языке C# и знакомство с настройкой среды .NET.

Необходимые библиотеки и зависимости

Чтобы начать использовать GroupDocs.Signature для .NET, установите библиотеку через менеджер пакетов:

.NET CLI

dotnet add package GroupDocs.Signature

Менеджер пакетов

Install-Package GroupDocs.Signature

Пользовательский интерфейс менеджера пакетов NuGet

Найдите «GroupDocs.Signature» и установите последнюю версию.

Приобретение лицензии

Приобретите бесплатную пробную версию, временную лицензию или купите полную лицензию у GroupDocs. Следуйте их инструкциям, чтобы получить временную лицензию, если вы хотите провести тестирование перед покупкой.

Настройка GroupDocs.Signature для .NET

После установки библиотеки инициализируйте и настройте приложение, используя действующую лицензию. Вот как это сделать:

  1. Установить GroupDocs.Signature: Используйте одну из команд менеджера пакетов, упомянутых выше.
  2. Приобрести лицензию: Следуйте этапы приобретения лицензии для выбранного вами варианта.
  3. Инициализировать GroupDocs.Signature:
    // Примените лицензию, если она у вас есть
License lic = new License();
lic.SetLicense("path/to/your/license/file.lic");

Руководство по внедрению

Изучите основные особенности внедрения интеграции подписи штрихкода .NET с GroupDocs.Signature.

Подписать документ с помощью штрих-кода

Обзор

Эта функция демонстрирует, как подписать документ с помощью штрих-кодовой подписи, встроив определенный текст, закодированный в штрих-коде, для дополнительной безопасности.

Шаги реализации

  1. Подготовьте свою среду: Убедитесь, что у вас настроены исходный и выходной каталоги.
  2. Настройте параметры подписи:
    string filePath = "YOUR_DOCUMENT_DIRECTORY/YourDocument.docx";
string outputFilePath = Path.Combine("YOUR_OUTPUT_DIRECTORY", "SignedDocument.docx");
string bcText = "John Smith";

using (Signature signature = new Signature(filePath))
{
    BarcodeSignOptions signOptions = new BarcodeSignOptions(bcText, BarcodeTypes.Code128)
    {
        VerticalAlignment = VerticalAlignment.Top,
        HorizontalAlignment = HorizontalAlignment.Center,
        Width = 100,
        Height = 40,
        Margin = new Padding(20),
        ForeColor = Color.Red,
        Font = new SignatureFont { Size = 12, FamilyName = "Comic Sans MS" }
    };

    SignResult signResult = signature.Sign(outputFilePath, signOptions);
}
  3. Понять параметры:
    • bcText: Текст, который вы хотите закодировать в штрих-коде.
    • BarcodeTypes.Code128: Указывает тип штрих-кода.
    • Варианты внешнего вида, такие как VerticalAlignment, HorizontalAlignment, Width, и Height определите, как ваша подпись будет выглядеть в документе.

Проверка документа на наличие штрих-кода подписи

Обзор

Проверьте, содержит ли документ конкретную штрихкодовую подпись для подтверждения его подлинности.

Шаги реализации

  1. Настройте параметры проверки:
    string outputFilePath = "YOUR_OUTPUT_DIRECTORY/SignedDocument.docx";
string bcText = "John Smith";

using (Signature signature = new Signature(outputFilePath))
{
    BarcodeVerifyOptions verifyOptions = new BarcodeVerifyOptions()
    {
        AllPages = false,
        PageNumber = 1,
        EncodeType = BarcodeTypes.Code128,
        Text = bcText
    };

    VerificationResult verifyResult = signature.Verify(verifyOptions);
}
  2. Объяснение:
    • AllPages: Проверьте, присутствует ли штрих-код на всех страницах или только на определенной.
    • PageNumber: Укажите, какую страницу следует проверить для проверки.

Поиск документа по штрих-коду подписи

Обзор

Выполните поиск по документу, чтобы найти любые существующие подписи штрих-кодов, полезные для аудита и проверки целостности.

Шаги реализации

  1. Настройте параметры поиска:
    string outputFilePath = "YOUR_OUTPUT_DIRECTORY/SignedDocument.docx";

using (Signature signature = new Signature(outputFilePath))
{
    BarcodeSearchOptions searchOptions = new BarcodeSearchOptions()
    {
        AllPages = true
    };

    List<BarcodeSignature> signatures = signature.Search<BarcodeSignature>(searchOptions);
}
  2. Ключевые моменты:
    • AllPages: Установите значение true, если вы хотите, чтобы поиск охватывал все страницы.

Обновление подписи штрихкода документа

Обзор

Измените существующие подписи штрих-кодов в документе, при необходимости отрегулировав их положение или размер.

Шаги реализации

  1. Найти и изменить подписи:
    string outputFilePath = "YOUR_OUTPUT_DIRECTORY/SignedDocument.docx";
List<BarcodeSignature> signatures = new List<BarcodeSignature>(); // Предположим, что заполнено подписями штрихкодов

foreach (BarcodeSignature bcSignature in signatures)
{
    bcSignature.Left += 100;
    bcSignature.Top += 100;
    bcSignature.Width = 200;
    bcSignature.Height = 50;
}

List<BaseSignature> signaturesToUpdate = signatures.ConvertAll(p => (BaseSignature)p);

using (Signature signature = new Signature(outputFilePath))
{
    UpdateResult updateResult = signature.Update(signaturesToUpdate);
}
  2. Объяснение:
    • Регулировать Left, Top, Width, и Height для изменения положения или размера подписей.

Удалить штрих-код подписи документа по идентификатору

Обзор

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

Шаги реализации

  1. Настройте параметры удаления:
    string outputFilePath = "YOUR_OUTPUT_DIRECTORY/SignedDocument.docx";
List<string> signatureIds = new List<string>(); // Предположим, что этот список содержит идентификаторы подписей, которые нужно удалить.

List<BaseSignature> signaturesToUpdate = new List<BaseSignature>();
foreach (var item in signatureIds)
{
    BarcodeSignature temp = new BarcodeSignature(item);
    signaturesToUpdate.Add(temp);
}

using (Signature signature = new Signature(outputFilePath))
{
    DeleteResult deleteResult = signature.Delete(signaturesToUpdate);
}
  2. Ключевые моменты:
    • signatureIdsСписок идентификаторов подписей штрих-кодов, которые необходимо удалить.

Практические применения

  1. Проверка юридических документов: Гарантируйте подлинность, подписывая контракты с помощью уникального штрих-кода.
  2. Образовательные учреждения: Проверьте студенческие документы, такие как удостоверения личности или стенограммы.
  3. Деловые контракты: Безопасное подписание и проверка деловых соглашений.
  4. Медицинские записи: Поддержание целостности записей о пациентах.
  5. Управление цепочками поставок: Отслеживайте и проверяйте подлинность отправлений с помощью штрих-кодов.

Соображения производительности

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