מדריך מלא לחתימת מסמכים אלקטרונית עם 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", "חתום כאן")

        # קונפיגורציה של אופציות משדה טופס על בסיס החתימה הטקסט
        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}.")