📝 دليل شامل لتوقيع المستندات الإلكتروني باستخدام Python: إنشاء التوقيعات الرقمية للمستندات PDF، Excel و أكثر

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"\nSource document signed successfully.")
        print(f"Total signatures applied: {len(result.succeeded)}")
        print(f"File saved at {output_file_path}.")

# هذه الدالة تشرح كيفية توقيع ورقة عمل Excel رقميًا
# مثالي للمستندات المالية، التقارير، و البيانات الحساسة الأخرى
def sign_excel_document():
    # تعريف مسارات الملفات
    sample_file_path = "sample.xlsx"        # مستند Excel المصدر
    certificate_pfx = "MrSmithSignature.pfx"  # ملف شهادة رقمية
    output_file_path = "signed.xlsx"        # مكان حفظ المستند الموقّع

    # فتح مستند Excel للتوقيع
    with gs.Signature(sample_file_path) as signature:
        # تكوين خيارات التوقيع الرقمي مع الشهادة
        options = gso.DigitalSignOptions(certificate_pfx)

        # تعيين موقع التوقيع في مستند Excel
        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"\nExcel document signed successfully.")
        print(f"Total signatures applied: {len(result.succeeded)}")
        print(f"Signed Excel file saved at {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"\nDocument signed with barcode successfully!")
        print(f"Total signatures applied: {len(result.succeeded)}")
        print(f"File saved at {output_file_path}.")

# هذه الدالة تضيف توقيعًا QR-Code إلى المستندات
# مثالي للتحقق من الهاتف المحمول وربطه بالموارد عبر الإنترنت
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-Code مع البيانات التي سيتم تشفيرها
        # يمكن أن يكون هذا رابط التحقق، معرف المستند، أو بيانات أخرى
        options = gso.QrCodeSignOptions("GroupDocs.Signature")

        # تعيين نوع QR-Code - QR-Code القياسي هو الأكثر دعمًا
        options.encode_type = gsd.QrCodeTypes.QR

        # تكوين مظهر QR-Code وموقعها
        options.left = 50                   # موقع X على الصفحة
        options.top = 150                   # موقع Y على الصفحة
        options.width = 100                 # عرض QR-Code
        options.height = 100                # ارتفاع QR-Code
        options.rotation_angle = 45         # اختياري: دوران QR-Code

        # تطبيق التوقيع وحفظ المستند
        result = signature.sign(output_file_path, options)

        # عرض رسالة النجاح مع سجلين منفصلين
        print(f"\nDocument signed with QR code successfully!")
        print(f"Total signatures applied: {len(result.succeeded)}")
        print(f"File saved at {output_file_path}.")