Metin etiketleri - Temel bilgiler ve söz dizimi

Alanlarınızın doğru şekilde tanınması ve beklendiği gibi davranması için metin etiketlerinin gerektirdiği tam yapıyı anlayın.

Metin etiketleri, yapılandırılmış yer tutucuları doğrudan belgenize yazarak form alanları oluşturmanıza olanak tanır. Hızlı ve güçlüdürler, ancak yalnızca söz dizimi tam olduğunda çalışırlar.

Bu sayfa, bir metin etiketinin gerektirdiği yapıyı, her bölümün ne işe yaradığını ve etiketlerin doğru şekilde tanınması için uyulması gereken kuralları açıklar.

Gerekli etiket kapsayıcısı (süslü parantezler)

Her metin etiketi çift süslü parantez içine alınmalıdır:

{field-name_es_:signer-role:field-type:directive1:directive2}}

Süslü parantezler gereklidir ve iki amaca hizmet eder:

• Acrobat Sign'a metin etiketinin nerede başlayıp bittiğini bildirirler.
• Oluşturulan alanın başlangıç genişliğini ve yüksekliğini tanımlarlar.
  • İlk parantezin boyutu (fontu) alan yüksekliğini belirler. 
    • İlk parantezde daha büyük font boyutu daha uzun alanlar oluşturur.
    • Etiketin geri kalan kısmı farklı font boyutunda olabilir ancak en az 2pt veya daha büyük olmalıdır.
  • Parantezler arasındaki boşluk (parantezlerin kendileri dahil) alanın genel genişliğini belirler. 
    • Parantezler arasındaki boşluk genişledikçe alanlar da genişler
    • Boşluk karakterleri sayılır.

Süslü parantezler eksikse veya hatalı biçimlendirilmişse metin düz metin olarak işlenir, alan oluşturulmaz ve yüklendikten sonra formda etiketin metni görüntülenir.

Metin etiketlerine daha geniş bir genel bakış ve ne zaman kullanılacakları hakkında bilgi için Metin Etiketlerine genel bakış bölümüne bakın.

Metin etiketi için gerekli olan yapı

Süslü parantezlerin içinde her metin etiketi şu yapıya uymalıdır:

field-name_es_:signer-role:field-type:directive1:directive2

Bu yapı katıdır. Öğeleri yeniden sıralamak veya gerekli bölümleri atlamak sessiz hatalara veya istenmeyen davranışa neden olabilir.

Gerekli öğeler (sırayla)

Alan adı

Alan adı, Acrobat Sign'daki form alanını tanımlar.

• Belge içinde benzersiz olmalıdır.
• Boşluk içermemelidir.
• Raporlama ve veri çıkarma için kullanılır.

_es_ tanımlayıcısı

_es_ tanımlayıcısı, Acrobat Sign'a metnin bir metin etiketi temsil ettiğini bildirir.

• _es_ gereklidir.
• Bu olmadan etiket düz metin olarak işlenir.

İmzalayanın rolü

İmzalayan rolü, alanın hangi alıcıya ait olduğunu tanımlar.

• Her zaman bir imzalayan rolü ekleyin.
• İmzalayan rolü, alanın hangi alıcı için amaçlandığını belirtmek üzere bir sayı içermelidir. 

Desteklenen imzalayan rolleri

Metin etiketleri, sıralı imzalayan rolleri kullanarak alanları alıcılara atar.

Desteklenen imzalayan rolü biçimi:

:signerN

N, 1'den başlayarak numaralandırılan ve imzalama sırasındaki alıcının sırasına karşılık gelen bir sayıdır.

Örnekler:

• :signer1 — birinci alıcı
• :signer2 — ikinci alıcı
• :signer3 — üçüncü alıcı

Metin etiketleri tarafından uygulanan bir üst sınır yoktur. Alanın atanabilmesi için imzalayan rolü, sözleşmedeki geçerli bir alıcıya karşılık gelmelidir.

Metin etiketleri adlandırılmış veya anlamsal rolleri desteklemez. Yalnızca sıralı imzalayan rolleri tanınır.

Kuralın istisnası :prefill rolüdür:

• :prefill —  Sözleşmenin göndereni tarafından atanan ve sözleşme gönderildikten sonra, ilk imzalayan bilgilendirilmeden önce doldurulması gereken alanlar.
  • Bu konum gerçek imza döngüsünden önce gerçekleştiği için sayı kullanılmaz.

Alan türü

Alan türü, oluşturulan form alanının türünü belirler.

Yaygın örnekler şunlardır:

• :text
• :signature
• :date
• :checkbox

Yalnızca desteklenen alan türleri tanınır. Desteklenmeyen alan türleri yok sayılır.

Tam liste ve alana özgü davranışlar için bkz. Metin etiketleri desteklenen alan türleri.

Yönergeler (isteğe bağlı)

Yönergeler alanın davranışını değiştirir.

Örneğin:

• :required
• :tooltip()
• :readOnly
• :calc()
• :format()

Yönergeler alan türünden sonra görünmeli ve doğru söz dizimine uymalıdır.

Karmaşık yönerge etkileşimleri için bkz. Metin etiketleri için gelişmiş davranışlar.

Örnek: eksiksiz, geçerli metin etiketi

{full_name_es_:signer1:text:required:tooltip(Enter your full legal name)}}

Bu etiket:

• Alan sınırını ve boyutunu tanımlamak için süslü parantez kullanır
• Metin alanı oluşturur
• Bu alanı ilk imzalayana atar
• Zorunlu hale getirir
• İmzalayana bir araç ipucu gösterir

Ek basit ve bileşik örnekler için bkz. Metin etiketi örnekleri.

Erken anlaşılması gereken önemli kurallar

Metin etiketleri tasarım gereği katıdır. Aşağıdaki kuralları göz önünde bulundurun:

• Etiketler belge yüklendiğinde işlenir.
• Oluşturma sırasında doğrulama yoktur.
• Hatalar uyarı oluşturmaz.
• Hatalı biçimlendirilmiş etiketler düz metin olarak işlenir.

Bir şey çalışmıyorsa önce söz dizimi sorunu olduğunu varsayın ve Metin etiketleri sorun giderme bölümünü kontrol edin.