Pythonを使用して電子署名を作成する完全ガイド:スタンプ、画像、フォームフィールドのデジタル署名を簡単に

pip install groupdocs-signature-net

# GroupDocs.Signatureのコアライブラリをインポート
import groupdocs.signature as gs

# 署名設定を構成するためのオプションをインポート
import groupdocs.signature.options as gso

# 署名のカスタマイズのためのドメインクラスをインポート
import groupdocs.signature.domain as gsd

# この関数は、PDFにテキストフォームフィールド署名を追加する方法を示しています
# フォームフィールドは、ユーザーが署名情報を入力できるインタラクティブな領域を作成します
def add_form_field_signature():
    # ソースおよび出力文書のファイルパスを定義
    sample_pdf = "sample.pdf"               # ソースPDF文書
    output_file_path = "form_signed.pdf"    # 署名された文書を保存する場所

    # 署名用に文書を開く
    with gs.Signature(sample_pdf) as signature:
        # フィールド名とデフォルト値を持つテキストフォームフィールド署名を作成
        # フィールド名は識別子であり、値はデフォルトテキストです
        text_signature = gs.domain.TextFormFieldSignature("SignatureField", "Sign here")

        # テキスト署名に基づいてフォームフィールドオプションを構成
        options = gso.FormFieldSignOptions(text_signature)

        # フォームフィールドの位置とサイズを設定
        options.top = 150                   # ページ上のY位置
        options.left = 50                   # ページ上のX位置
        options.height = 50                 # フィールドの高さ
        options.width = 200                 # フィールドの幅

        # 文書に署名（フォームフィールドを追加）し、ファイルに保存
        result = signature.sign(output_file_path, options)

        # 成功メッセージを表示（個別のログエントリ）
        print(f"\nフォームフィールド署名が正常に追加されました。")
        print(f"合計フォームフィールドが追加されました: {len(result.succeeded)}")
        print(f"ファイルは {output_file_path} に保存されました。")

# この関数は、文書に画像ベースの署名を追加する方法を示しています
# 手書き署名、会社のロゴ、公式の印章を追加するのに最適です
def add_image_signature():
    # ファイルパスを定義
    sample_file_path = "sample.pdf"         # ソース文書
    image_signature = "signature.png"       # 署名画像ファイル
    output_file_path = "image_signed.pdf"   # 署名された文書を保存する場所

    # 署名用に文書を開く
    with gs.Signature(sample_file_path) as signature:
        # 署名画像のパスを使用して画像署名オプションを構成
        options = gso.ImageSignOptions(image_signature)

        # 画像署名の位置を設定
        options.left = 50                   # ページ上のX位置
        options.top = 50                    # ページ上のY位置

        # 文書内のすべてのページに適用
        options.all_pages = True

        # 画像で文書に署名し、ファイルに保存
        result = signature.sign(output_file_path, options)

        # 成功メッセージを表示（個別のログエントリ）
        print(f"\n画像署名が正常に適用されました。")
        print(f"合計署名が適用されました: {len(result.succeeded)}")
        print(f"署名された文書は {output_file_path} に保存されました。")

# この関数は、公式な見た目のスタンプ署名を追加する方法を示しています
# 公証書スタイルの印章、会社のスタンプ、承認印を作成するのに最適です
def add_stamp_signature():
    # 必要なライブラリをインポート
    import groupdocs.signature as gs
    import groupdocs.signature.domain as gsd
    import groupdocs.signature.options as gso

    # ファイルパスを定義
    sample_file_path = "sample.pdf"         # ソース文書
    output_file_path = "stamp_signed.pdf"   # 署名された文書を保存する場所

    # 署名用に文書を開く
    with gs.Signature(sample_file_path) as signature:
        # スタンプ署名オプションを定義
        options = gso.StampSignOptions()

        # スタンプの位置とサイズを設定
        options.left = 50                   # ページ上のX位置
        options.top = 150                   # ページ上のY位置
        options.width = 200                 # スタンプの幅
        options.height = 200                # スタンプの高さ

        # スタンプの外側の円形のテキスト行を作成
        # これは、スタンプの外側にテキストのリングを作成します
        outer_line = gsd.StampLine()
        outer_line.text = " * 公式文書 * "  # 星付きの装飾テキスト
        outer_line.text_repeat_type = gsd.StampTextRepeatType.FULL_TEXT_REPEAT  # テキストを円周に繰り返す
        outer_line.font = gsd.SignatureFont()         # フォントを構成
        outer_line.height = 22                        # テキスト行の高さ
        outer_line.text_bottom_intent = 6             # 下部のスペース
        options.outer_lines.append(outer_line)        # スタンプオプションに追加

        # スタンプの内側のテキスト行を作成（中央テキスト）
        # これは、スタンプの中心にコンテンツを作成します
        inner_line = gsd.StampLine()
        inner_line.text = "承認済み"                  # スタンプの中央テキスト
        inner_line.font = gsd.SignatureFont()         # フォントを構成
        inner_line.font.bold = True                   # テキストを太字にする
        inner_line.height = 40                        # テキスト行の高さ
        options.inner_lines.append(inner_line)        # スタンプオプションに追加

        # オプション: 追加の情報を含むさらに内側の行を追加
        date_line = gsd.StampLine()
        date_line.text = "2025年5月13日"               # 承認日
        date_line.height = 20                         # テキスト行の高さ
        options.inner_lines.append(date_line)         # スタンプオプションに追加

        # 署名を適用し、文書を保存
        result = signature.sign(output_file_path, options)

        # 成功メッセージを表示（個別のログエントリ）
        print(f"\nスタンプ署名が正常に適用されました。")
        print(f"合計署名が適用されました: {len(result.succeeded)}")
        print(f"ファイルは {output_file_path} に保存されました。")