📝 คู่มือสุดท้ายสำหรับการลงชื่อเอกสารอิเล็กทรอนิกส์ด้วย 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 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 ด้วยข้อมูลที่จะเข้ารหัส
        # นี่อาจเป็น URL การยืนยัน, รหัสเอกสาร หรือข้อมูลอื่น ๆ
        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"\nเอกสารลงชื่อด้วย QR code สำเร็จแล้ว!")
        print(f"จำนวนลายเซ็นที่ใช้: {len(result.succeeded)}")
        print(f"ไฟล์บันทึกที่ {output_file_path}.")