GroupDocs.Signature を使用した .NET での署名管理の習得

導入

今日のデジタル環境において、文書署名を効率的に管理することは、企業にとっても個人にとっても不可欠です。契約書の検証やコンプライアンス確保など、適切なツールは大きな違いを生み出します。このチュートリアルでは、署名管理ツールの使い方を解説します。 .NET 用 GroupDocs.Signature 文書内の署名をシームレスに管理および削除します。

学習内容:

  • Signature インスタンスを初期化する方法。
  • 署名を検出するためのさまざまな検索オプションを追加します。
  • ドキュメント内のさまざまな種類の署名を検索します。
  • 複数の署名を効率的に削除します。

始める準備はできましたか?まず前提条件を確認しましょう。

前提条件

始める前に、以下のものを用意してください。

  • 必要なライブラリ.NET 用 GroupDocs.Signature
  • 環境設定.NET Framework または .NET Core がインストールされた Visual Studio 2019 以降。
  • 知識の前提条件C# および .NET 開発に関する基本的な理解。

GroupDocs.Signature を .NET 用にセットアップする

始めるには、GroupDocs.Signatureライブラリをインストールする必要があります。手順は以下のとおりです。

インストール手順

.NET CLI の使用:

dotnet add package GroupDocs.Signature

パッケージ マネージャー コンソール:

Install-Package GroupDocs.Signature

NuGet パッケージ マネージャー UI: 「GroupDocs.Signature」を検索し、最新バージョンをインストールしてください。

ライセンス取得

まずは無料トライアルで機能をお試しください。長期間ご利用いただくには、一時ライセンスの取得またはご購入をご検討ください。 グループドキュメント.

実装ガイド

それぞれの機能を段階的に説明してみましょう。

機能1: 署名インスタンスの初期化

この機能は、GroupDocs.Signature for .NET を使用してドキュメント内の署名を管理するための環境を設定する方法を示します。

概要

初期化中 Signature インスタンスは、検索や削除などの署名操作のためにドキュメントを準備するため、非常に重要です。

コード実装

using System.IO;
using GroupDocs.Signature;

var filePath = Path.Combine("YOUR_DOCUMENT_DIRECTORY", "Sample_Signed_Multi_Document");
Directory.CreateDirectory(Path.GetDirectoryName(filePath)); // ディレクトリが存在することを確認してください。
File.Copy(filePath, outputFilePath, true);

// ドキュメントパスでSignatureインスタンスを初期化する
using (Signature signature = new Signature(outputFilePath))
{
    // 署名インスタンスは操作の準備が整いました。
}

説明

  • filePathソース ドキュメントへのパス。
  • Directory.CreateDirectory(...): ファイル操作を試みる前にディレクトリが存在することを確認します。
  • signature: 署名に関連するすべてのタスクを容易にする主要なオブジェクト。

機能2: 検索オプションの追加

署名を効率的に検出するには、ドキュメント内で探している署名の種類を指定する必要があります。

概要

検索オプションを追加すると、ドキュメント内のテキスト、バーコード、QR コード、画像ベースの署名など、特定の種類の署名をターゲットにすることができます。

コード実装

using System.Collections.Generic;
using GroupDocs.Signature.Options;

List<SearchOptions> listOptions = new List<SearchOptions>();
listOptions.Add(new TextSearchOptions()); // テキストベースの署名を検索します。
listOptions.Add(new BarcodeSearchOptions()); // バーコード署名を検索します。
listOptions.Add(new QrCodeSearchOptions()); // QR コード署名を検索します。
listOptions.Add(new ImageSearchOptions()); // 画像ベースの署名を検索します。

// listOptions には、ドキュメント内のさまざまな種類の署名を見つけるために必要なすべての検索オプションが含まれるようになりました。

説明

  • TextSearchOptionsドキュメント内のテキスト署名を対象とします。
  • BarcodeSearchOptions、 QrCodeSearchOptions、 そして ImageSearchOptionsバーコード、QR コード、画像ベースの署名の検出をそれぞれ有効にします。

機能3: 文書内の署名の検索

検索オプションを設定すると、ドキュメント内でこれらの署名を見つけることができるようになります。

概要

この機能は、指定された署名オプションを使用してドキュメントを検索し、それに応じて結果を処理する方法を強調表示します。

コード実装

using System.Collections.Generic;
using GroupDocs.Signature.Domain;

string filePath = Path.Combine("YOUR_DOCUMENT_DIRECTORY", "Sample_Signed_Multi_Document");
Directory.CreateDirectory(Path.GetDirectoryName(filePath)); // ディレクトリが存在することを確認してください。
File.Copy(filePath, outputFilePath, true);

using (Signature signature = new Signature(outputFilePath))
{
    List<SearchOptions> listOptions = new List<SearchOptions>();
    listOptions.Add(new TextSearchOptions());
    listOptions.Add(new BarcodeSearchOptions());
    listOptions.Add(new QrCodeSearchOptions());
    listOptions.Add(new ImageSearchOptions());

    // 指定されたオプションを使用して署名を検索します。
    SearchResult result = signature.Search(listOptions);

    if (result.Signatures.Count > 0)
    {
        // 文書内に見つかった署名。
    }
    else
    {
        // 文書内に署名が見つかりませんでした。
    }
}

説明

  • SearchResult検出されたすべての署名の詳細が含まれており、削除などの追加処理が可能になります。

機能4: 文書から署名を削除する

不要な署名を特定したら、次のステップはそれを効率的に削除することです。

概要

この機能は、GroupDocs.Signature for .NET を使用してドキュメントから複数の種類の署名を削除する方法を示します。

コード実装

using System.Collections.Generic;
using GroupDocs.Signature.Domain;

string filePath = Path.Combine("YOUR_DOCUMENT_DIRECTORY", "Sample_Signed_Multi_Document");
Directory.CreateDirectory(Path.GetDirectoryName(filePath)); // ディレクトリが存在することを確認してください。
File.Copy(filePath, outputFilePath, true);

using (Signature signature = new Signature(outputFilePath))
{
    List<SearchOptions> listOptions = new List<SearchOptions>();
    listOptions.Add(new TextSearchOptions());
    listOptions.Add(new BarcodeSearchOptions());
    listOptions.Add(new QrCodeSearchOptions());
    listOptions.Add(new ImageSearchOptions());

    // 署名を検索します。
    SearchResult result = signature.Search(listOptions);

    if (result.Signatures.Count > 0)
    {
        List<BaseSignature> signaturesToDelete = new List<BaseSignature>();

        // 削除するには署名を集めてください。
        foreach (BaseSignature temp in result.Signatures)
        {
            signaturesToDelete.Add(temp);
        }

        // 収集した署名をドキュメントから削除します。
        DeleteResult deleteResult = signature.Delete(signaturesToDelete);
    }
}

説明

  • signaturesToDelete削除対象として識別された署名のコレクション。
  • DeleteResult削除プロセスの成功または失敗に関するフィードバックを提供します。

実用的な応用

  1. 契約管理契約書内の古い署名の検証と削除を自動化します。
  2. コンプライアンス監査署名を監査およびクリーンアップして、すべてのドキュメントが規制要件に準拠していることを確認します。
  3. ドキュメントライフサイクル管理作成からアーカイブまでのライフサイクル全体にわたってドキュメント署名を管理します。

パフォーマンスに関する考慮事項

  • 署名を検索または削除するときに、ドキュメントの必要な部分のみを処理することでパフォーマンスを最適化します。
  • リソースの使用状況を監視し、署名操作中にアプリケーションの効率と応答性を維持することを確認します。