Tekstimerkinnät - perusteet ja syntaksi

Ymmärrä tekstimerkintöjen vaatima tarkka rakenne, jotta kentät tunnistetaan oikein ja toimivat odotetusti.

Tekstimerkinnöillä voit luoda lomakekenttiä kirjoittamalla rakenteellisia paikkamerkkejä suoraan asiakirjaasi. Ne ovat nopeita ja tehokkaita, mutta toimivat vain, kun syntaksi on tarkka.

Tämä sivu selittää tekstimerkinnän vaatiman rakenteen, mitä kukin osa tekee ja säännöt, joita on noudatettava, jotta merkinnät tunnistetaan oikein.

Vaadittu merkinnän sulkeminen (aaltosulkeet)

Jokainen tekstimerkintä on suljettava kaksoisaaltosulkeisiin:

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

Aaltosulkeet ovat pakollisia ja niillä on kaksi tarkoitusta:

• Ne kertovat Acrobat Signille, mistä tekstimerkintä alkaa ja mihin se päättyy.
• Ne määrittävät luodun kentän alkuperäisen leveyden ja korkeuden.
  • Ensimmäisen sulkeen koko (kirjasin) määrittää kentän korkeuden. 
    • Suurempi kirjasinkoko ensimmäisessä sulkeessa luo korkeampia kenttiä.
    • Merkinnän loppuosa voi olla eri kirjasinkokoa, mutta sen on oltava vähintään 2 pistettä.
  • Sulkeiden välinen tila (sulkeet mukaan lukien) määrittää kentän kokonaisleveyden. 
    • Laajempi välistys sulkeiden välillä luo leveämpiä kenttiä
    • Välilyönnit lasketaan.

Jos aaltosulkeet puuttuvat tai ovat väärin muotoiltuja, tekstiä käsitellään tavallisena tekstinä, kenttää ei luoda ja näet tunnisteen tekstin tulostettuna lomakkeessasi sen lataamisen jälkeen.

Laajempaa tietoa tekstitunnisteista ja niiden käyttötilanteista saat kohdasta Tekstitunnisteiden yleiskatsaus.

Tekstitunnisteen pakollinen rakenne

Aaltosulkeiden sisällä jokaisen tekstitunnisteen on noudatettava tätä rakennetta:

kentän-nimi_es_:allekirjoittajan-rooli:kentän-tyyppi:direktiivi1:direktiivi2

Tämä rakenne on tiukka. Elementtien järjestyksen muuttaminen tai pakollisten osien poisjättäminen voi johtaa hiljaiseen epäonnistumiseen tai ei-toivottuun toimintaan.

Pakolliset elementit (järjestyksessä)

Kentän nimi

Kentän nimi yksilöi Adobe Acrobat Signin lomakekentän.

• On oltava yksilöllinen asiakirjassa.
• Ei saa sisältää välilyöntejä.
• Käytetään raportointiin ja tietojen poimintaan.

_es_ tunniste

_es_ tunniste kertoo Acrobat Signille, että teksti edustaa tekstitunnistetta.

• _es_ on pakollinen.
• Ilman sitä tunnistetta käsitellään tavallisena tekstinä.

Allekirjoittajan rooli

Allekirjoittajan rooli määrittää, mille vastaanottajalle kenttä kuuluu.

• Sisällytä aina allekirjoittajan rooli.
• Allekirjoittajan roolissa on oltava numero, joka osoittaa, mille vastaanottajalle kenttä on tarkoitettu. 

Tuetut allekirjoittajan roolit

Tekstitunnisteet määrittävät kentät vastaanottajille käyttämällä sijaintiperusteisia allekirjoittajan rooleja.

Tuettu allekirjoittajan roolin muoto on:

:signerN

Missä N on numero, joka alkaa 1:stä ja vastaa vastaanottajan sijaintia allekirjoitusjärjestyksessä.

Esimerkkejä:

• :signer1 — ensimmäinen vastaanottaja
• :signer2 — toinen vastaanottaja
• :signer3 — kolmas vastaanottaja

Tekstitunnisteet eivät aseta ylärajaa. Allekirjoittajan roolin on vastattava todellista vastaanottajaa sopimuksessa, jotta kenttä voidaan määrittää.

Tekstitunnisteet eivät tue nimettyjä tai semanttisia rooleja. Vain sijaintiin perustuvat allekirjoittajaroolit tunnistetaan.

Poikkeus sääntöön on :prefill-rooli:

• :prefill — Kentät, jotka määritetään sopimuksen lähettäjälle ja jotka on täytettävä sopimuksen lähettämisen jälkeen, mutta ennen ensimmäisen allekirjoittajan ilmoittamista.
  • Numeroa ei käytetä, koska tämä sijainti tapahtuu ennen varsinaista allekirjoituskiertoa.

Kentän tyyppi

Kenttätyyppi määrittää luotavan lomakekentän tyypin.

Yleisiä esimerkkejä:

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

Vain tuetut kenttätyypit tunnistetaan. Tukemattomat kenttätyypit ohitetaan.

Täydellinen luettelo ja kenttäkohtainen toiminta löytyy kohdasta Tekstitunnisteiden tuetut kenttätyypit.

Direktiivit (valinnainen)

Direktiivit muokkaavat kentän toimintaa.

Esimerkkejä:

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

Direktiivien on oltava kentän tyypin jälkeen ja niiden on noudatettava oikeaa syntaksia.

Monimutkaisten direktiivien vuorovaikutuksista katso Tekstimerkintöjen lisätoiminnot.

Esimerkki: täydellinen, kelvollinen tekstimerkintä

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

Tämä merkintä:

• Käyttää aaltosulkeita kentän rajojen ja koon määrittämiseen
• Luo tekstikentän
• Määrittää kentän ensimmäiselle allekirjoittajalle
• Tekee siitä pakollisen
• Näyttää työkaluvihjeen allekirjoittajalle

Lisää yksinkertaisia ja yhdistettyjä esimerkkejä löydät kohdasta Tekstitunnisteiden esimerkit.

Tärkeät säännöt, jotka on hyvä ymmärtää heti

Tekstitunnisteet on suunniteltu tarkoituksella joustamattomiksi. Pidä nämä säännöt mielessä:

• Tunnisteet käsitellään, kun asiakirja ladataan.
• Kirjoitusaikana ei ole validointia.
• Virheet eivät luo varoituksia.
• Väärin muodostetut tunnisteet käsitellään tavallisena tekstinä.

Jos jokin ei toimi, oleta ensin syntaksivirhe ja tarkista Tekstitunnisteiden vianmääritys.