Python ile E-Doküman İmzalamak için Tam Rehber: Damga, Görsel ve Form Alanı Dijital İmzalar Kolayca

pip install groupdocs-signature-net

# GroupDocs.Signature ana kütüphanesini içe aktarın
import groupdocs.signature as gs

# İmza ayarlarını yapılandırmak için seçenekleri içe aktarın
import groupdocs.signature.options as gso

# İmza özelleştirmek için alan sınıflarını içe aktarın
import groupdocs.signature.domain as gsd

# Bu işlev, PDF'e metin form alanı imzası eklemenizi gösterir
# Form alanları, kullanıcıların imza bilgilerini girmesini sağlayan etkileşimli alanlar oluşturur
def add_form_field_signature():
    # Kaynak ve çıktı belgeleri için dosya yollarını tanımlayın
    sample_pdf = "sample.pdf"               # Kaynak PDF belgeleriniz
    output_file_path = "form_signed.pdf"    # İmzalanmış belgeyi kaydetme yeri

    # İmzalamak için belgeyi açın
    with gs.Signature(sample_pdf) as signature:
        # Metin form alanı imzası oluşturun ve alan adı ile varsayılan değeri tanımlayın
        # Alan adı tanımlayıcıdır, değer ise varsayılan metindir
        text_signature = gs.domain.TextFormFieldSignature("SignatureField", "Buraya imza atın")

        # Metin imzasına dayalı form alanı seçeneklerini yapılandırın
        options = gso.FormFieldSignOptions(text_signature)

        # Form alanı konumunu ve boyutunu ayarlayın
        options.top = 150                   # Sayfa üzerindeki Y-pozisyonu
        options.left = 50                   # Sayfa üzerindeki X-pozisyonu
        options.height = 50                 # Alanın yüksekliği
        options.width = 200                 # Alanın genişliği

        # Belgeyi imzala (form alanı ekle) ve dosyaya kaydet
        result = signature.sign(output_file_path, options)

        # Ayrı günlük girişleriyle başarı mesajını göster
        print(f"\nForm alanı imzası başarıyla eklendi.")
        print(f"Toplam form alanları eklendi: {len(result.succeeded)}")
        print(f"Dosya {output_file_path} adresinde kaydedildi.")

# Bu işlev, belgelere görsel tabanlı imza eklemenizi gösterir
# El yazısı imzalar, şirket logoları veya resmi damgalar eklemek için mükemmel
def add_image_signature():
    # Dosya yollarını tanımlayın
    sample_file_path = "sample.pdf"         # Kaynak belge
    image_signature = "signature.png"       # İmza görüntü dosyanız
    output_file_path = "image_signed.pdf"   # İmzalanmış belgeyi kaydetme yeri

    # İmzalamak için belgeyi açın
    with gs.Signature(sample_file_path) as signature:
        # Görüntü imza seçeneklerini görüntü imza dosya yolu ile yapılandırın
        options = gso.ImageSignOptions(image_signature)

        # Görüntü imzası konumunu ayarlayın
        options.left = 50                   # Sayfa üzerindeki X-pozisyonu
        options.top = 50                    # Sayfa üzerindeki Y-pozisyonu

        # Belgenin tüm sayfalarına uygula
        options.all_pages = True

        # Görüntü ile belgeyi imzala ve dosyaya kaydet
        result = signature.sign(output_file_path, options)

        # Ayrı günlük girişleriyle başarı mesajını göster
        print(f"\nGörüntü imzası başarıyla uygulandı.")
        print(f"Toplam imzalar uygulandı: {len(result.succeeded)}")
        print(f"İmzalanmış belge {output_file_path} adresinde kaydedildi.")

# Bu işlev, resmi görünümde damga imzası eklemenizi gösterir
# Noter tarzı damgalar, şirket damgaları veya onay işaretleri oluşturmak için ideal
def add_stamp_signature():
    # Gerekli kütüphaneleri içe aktarın
    import groupdocs.signature as gs
    import groupdocs.signature.domain as gsd
    import groupdocs.signature.options as gso

    # Dosya yollarını tanımlayın
    sample_file_path = "sample.pdf"         # Kaynak belge
    output_file_path = "stamp_signed.pdf"   # İmzalanmış belgeyi kaydetme yeri

    # İmzalamak için belgeyi açın
    with gs.Signature(sample_file_path) as signature:
        # Damga imza seçeneklerini tanımlayın
        options = gso.StampSignOptions()

        # Damganın konumunu ve boyutunu ayarlayın
        options.left = 50                   # Sayfa üzerindeki X-pozisyonu
        options.top = 150                   # Sayfa üzerindeki Y-pozisyonu
        options.width = 200                 # Damganın genişliği
        options.height = 200                # Damganın yüksekliği

        # Damganın dış çember metin çizgisini oluşturun
        # Bu, damganın dışındaki metin çemberini oluşturur
        outer_line = gsd.StampLine()
        outer_line.text = " * Resmi Belge * "  # Süsleme için yıldızlı metin
        outer_line.text_repeat_type = gsd.StampTextRepeatType.FULL_TEXT_REPEAT  # Metni çember etrafında tekrarla
        outer_line.font = gsd.SignatureFont()         # Yazı tipi yapılandırması
        outer_line.height = 22                        # Metin çizgisi yüksekliği
        outer_line.text_bottom_intent = 6             # Alt boşluk
        options.outer_lines.append(outer_line)        # Damga seçeneklerine ekle

        # Damganın iç çizgi metnini oluşturun (merkez metni)
        # Bu, damganın ortasında içeriği oluşturur
        inner_line = gsd.StampLine()
        inner_line.text = "ONAYLANDI"                  # Damganın merkez metni
        inner_line.font = gsd.SignatureFont()         # Yazı tipi yapılandırması
        inner_line.font.bold = True                   # Metni kalın yap
        inner_line.height = 40                        # Metin çizgisi yüksekliği
        options.inner_lines.append(inner_line)        # Damga seçeneklerine ekle

        # İsteğe bağlı: Ekstra bilgi ile daha fazla iç çizgi ekleyin
        date_line = gsd.StampLine()
        date_line.text = "13 Mayıs 2025"               # Onay tarihi
        date_line.height = 20                         # Metin çizgisi yüksekliği
        options.inner_lines.append(date_line)         # Damga seçeneklerine ekle

        # İmzayı uygula ve belgeyi kaydet
        result = signature.sign(output_file_path, options)

        # Ayrı günlük girişleriyle başarı mesajını göster
        print(f"\nDamga imzası başarıyla uygulandı.")
        print(f"Toplam imzalar uygulandı: {len(result.succeeded)}")
        print(f"Dosya {output_file_path} adresinde kaydedildi.")