راهنمای کامل امضا الکترونیکی اسناد با پایتون: امضاهای دیجیتال با استفاده از تمبر، تصویر و فیلد فرم

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 = "13 مه 2025"               # تاریخ تایید
        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} ذخیره شد.")