📝 راهنمای کامل امضا الکترونیکی اسناد با پایتون: ایجاد امضاهای دیجیتال برای PDF، اکسل و بیشتر

pip install groupdocs-signature-net

# وارد کردن کتابخانه اصلی GroupDocs.Signature
import groupdocs.signature as gs

# وارد کردن گزینه‌ها برای تنظیم تنظیمات امضا
import groupdocs.signature.options as gso

# وارد کردن تنظیمات ظاهر برای سفارشی کردن چگونگی نمایش امضاها
import groupdocs.signature.options.appearances as appearances

# این تابع نشان می‌دهد چگونه می‌توانید یک امضا دیجیتال را به یک اسناد PDF اضافه کنید
# امضا شامل یک گواهی دیجیتال و عناصر بصری است
def sign_pdf_document():
    # تعریف مسیرهای فایل
    sample_file_path = "sample.pdf"         # اسناد PDF منبع شما
    certificate_pfx = "MrSmithSignature.pfx"  # فایل گواهی دیجیتال
    image_handwrite = "signature_handwrite.jpg"  # تصویر امضا دستی اختیاری
    output_file_path = "signed.pdf"         # جایی که اسناد امضا شده را ذخیره کنید

    # باز کردن اسناد برای امضا
    with gs.Signature(sample_file_path) as signature:
        # تنظیم گزینه‌های امضا دیجیتال
        options = gso.DigitalSignOptions(certificate_pfx)

        # تنظیم ویژگی‌های ظاهر بصری
        options.image_file_path = image_handwrite  # افزودن تصویر امضا دستی
        options.left = 450                         # موقعیت X در صفحه
        options.top = 150                          # موقعیت Y در صفحه
        options.page_number = 1                    # کدام صفحه را امضا کنید
        options.password = "1234567890"            # رمز گواهی

        # افزودن متادیتا به امضا
        options.appearance = appearances.DigitalSignatureAppearance(
            "John Smith",                          # نام امضا کننده
            "Title",                               # عنوان امضا کننده
            "jonny@test.com"                       # ایمیل امضا کننده
        )
        options.reason = "Document Approval"       # دلیل امضا اسناد
        options.contact = "JohnSmith"              # اطلاعات تماس
        options.location = "Office1"               # جایی که امضا انجام شده است

        # اعمال امضا و ذخیره اسناد
        result = signature.sign(output_file_path, options)

        # نمایش پیام موفقیت با دو ورود جداگانه در روزنامه
        print(f"\nاسناد منبع امضا شده با موفقیت.")
        print(f"تعداد امضاهای اعمال شده: {len(result.succeeded)}")
        print(f"فایل در {output_file_path} ذخیره شده است.")

# این تابع نشان می‌دهد چگونه می‌توانید یک فایل اکسل را امضا کنید
# مناسب برای اسناد مالی، گزارش‌ها و سایر داده‌های حساس
def sign_excel_document():
    # تعریف مسیرهای فایل
    sample_file_path = "sample.xlsx"        # اسناد اکسل منبع شما
    certificate_pfx = "MrSmithSignature.pfx"  # فایل گواهی دیجیتال
    output_file_path = "signed.xlsx"        # جایی که اسناد امضا شده را ذخیره کنید

    # باز کردن اسناد اکسل برای امضا
    with gs.Signature(sample_file_path) as signature:
        # تنظیم گزینه‌های امضا دیجیتال با گواهی
        options = gso.DigitalSignOptions(certificate_pfx)

        # تنظیم موقعیت امضا در اسناد اکسل
        options.left = 450                  # موقعیت X در صفحه
        options.top = 150                   # موقعیت Y در صفحه
        options.page_number = 1             # کدام صفحه را امضا کنید (صفحه اول)
        options.password = "1234567890"     # رمز گواهی

        # افزودن اطلاعات امضا کننده به متادیتا امضا
        options.appearance = appearances.DigitalSignatureAppearance(
            "John Smith",                   # نام امضا کننده
            "Title",                        # عنوان امضا کننده
            "jonny@test.com"                # ایمیل امضا کننده
        )

        # اعمال امضا و ذخیره اسناد
        result = signature.sign(output_file_path, options)

        # نمایش پیام موفقیت با دو ورود جداگانه در روزنامه
        print(f"\nاسناد اکسل امضا شده با موفقیت.")
        print(f"تعداد امضاهای اعمال شده: {len(result.succeeded)}")
        print(f"فایل اکسل امضا شده در {output_file_path} ذخیره شده است.")

# این تابع یک امضا قابل اسکن بارکد را به اسناد اضافه می‌کند
# مناسب برای اسناد انبار، گواهینامه‌ها یا اسناد ردیابی
def add_barcode_signature():
    # وارد کردن کتابخانه‌های مورد نیاز
    import groupdocs.signature as gs
    import groupdocs.signature.domain as gsd
    import groupdocs.signature.options as gso

    # تعریف مسیرهای فایل
    sample_file_path = "sample.xlsx"        # اسناد منبع شما
    output_file_path = "barcode_signed.xlsx"  # جایی که اسناد امضا شده را ذخیره کنید

    # باز کردن اسناد برای امضا
    with gs.Signature(sample_file_path) as signature:
        # ایجاد گزینه‌های امضا بارکد با متن برای کدگذاری
        options = gso.BarcodeSignOptions("GroupDocs.Signature")

        # تنظیم نوع بارکد - CODE128 به طور گسترده استفاده می‌شود و قابل اعتماد است
        options.encode_type = gsd.BarcodeTypes.CODE128

        # تنظیم ظاهر بارکد و موقعیت
        options.left = 50                   # موقعیت X در صفحه
        options.top = 150                   # موقعیت Y در صفحه
        options.width = 100                 # عرض بارکد
        options.height = 50                 # ارتفاع بارکد

        # اعمال امضا و ذخیره اسناد
        result = signature.sign(output_file_path, options)

        # نمایش پیام موفقیت با دو ورود جداگانه در روزنامه
        print(f"\nاسناد با بارکد امضا شده با موفقیت!")
        print(f"تعداد امضاهای اعمال شده: {len(result.succeeded)}")
        print(f"فایل در {output_file_path} ذخیره شده است.")

# این تابع یک امضا کد QR را به اسناد اضافه می‌کند
# مناسب برای تایید موبایل و لینک کردن به منابع آنلاین
def add_qrcode_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 = "qrcode_signed.pdf"  # جایی که اسناد امضا شده را ذخیره کنید

    # باز کردن اسناد برای امضا
    with gs.Signature(sample_file_path) as signature:
        # ایجاد گزینه‌های کد QR با داده‌های کدگذاری
        # این می‌تواند URL تایید، شناسه اسناد یا سایر داده‌ها باشد
        options = gso.QrCodeSignOptions("GroupDocs.Signature")

        # تنظیم نوع کد QR - کد QR استاندارد به طور گسترده پشتیبانی می‌شود
        options.encode_type = gsd.QrCodeTypes.QR

        # تنظیم ظاهر کد QR و موقعیت
        options.left = 50                   # موقعیت X در صفحه
        options.top = 150                   # موقعیت Y در صفحه
        options.width = 100                 # عرض کد QR
        options.height = 100                # ارتفاع کد QR
        options.rotation_angle = 45         # اختیاری: کد QR را چرخانده

        # اعمال امضا و ذخیره اسناد
        result = signature.sign(output_file_path, options)

        # نمایش پیام موفقیت با دو ورود جداگانه در روزنامه
        print(f"\nاسناد با کد QR امضا شده با موفقیت!")
        print(f"تعداد امضاهای اعمال شده: {len(result.succeeded)}")
        print(f"فایل در {output_file_path} ذخیره شده است.")