📝 מדריך מלא לחתימת מסמכים אלקטרונית עם 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"\nהמסמך המקור נחתם בהצלחה.")
        print(f"סך החתימות שניתנו: {len(result.succeeded)}")
        print(f"קובץ שמור ב- {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"\nמסמך Excel נחתם בהצלחה.")
        print(f"סך החתימות שניתנו: {len(result.succeeded)}")
        print(f"קובץ Excel חתום שמור ב- {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}.")