دليل شامل لتوقيع المستندات الإلكتروني باستخدام 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 = "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}.")