19. peatükk · 19.3
Sisestuse kontrollimine vormis: postiindeks, IBAN, telefoninumber ja kuupäev
Vaata lühivideot
Teed registreerimisvormi ja saad selle tagasi ilma tähtedeta postiindeksiga, ühe numbri võrra liiga lühikese IBAN-iga ja sünnikuupäevaga kujul "12/3". Siis tuleb hakata helistama. Kui valid igale väljale õige Format (vorming), kontrollib Euro-Office sisestust juba täitmise ajal ja täitja saab kohe teate, kui midagi on valesti.
Näitena teeme töötubade registreerimisvormi lillepoele Bloemisterij Het Zonnetje. Vormi loomise põhitõed leiad artiklist PDF-vormi loomine.
Tähelepanu: välju, mida PDF-i lisad või muudad, ei salvesta Euro-Office iseenesest. Vajuta enne PDF-i sulgemist Ctrl + S või klõpsa üleval vasakul nupul Save (salvesta). Kui sulged salvestamata, kaovad uued väljad. Meie testis (november 2026) olid uus väli ja selle väärtus pärast salvestamist ja sulgemist mõne sekundi jooksul sinu WebOké Nextcloudi failis olemas. Ava vorm julgelt uuesti ja vaata, kas väljad ja seaded on alles.
Kus seda seadistada?
- Ava PDF ja vali üleval paremal Edit (muuda).
- Mine vahekaardile Forms (vormid) ja lisa lehele Text Box (tekstikast).
- Klõpsa väljal. Paremale ilmuvad Form settings (vormi seaded). Kui neid ei näe, klõpsa päris paremal vormi seadete ikoonil.
- Anna väljale kohas Name selge nimi, näiteks postcode.
- Vali kohas Format, milline sisestus peab välja nägema.

Format valikud
| Format | Mida see teeb | Sobib |
|---|---|---|
| None | Lubatud on kõik | Nimi, märkus |
| Number | Ainult arv | Kogus, summa |
| Percentage | Arv protsendina | Allahindlus |
| Date ja Time | Ainult kuupäev või kellaaeg valitud vormingus | Sünnikuupäev, algusaeg |
| Special | Kindlad mustrid nagu ZIP Code ja Phone Number | Tähelepanu: need on Ameerika mustrid, vaata allpool |
| Regular expression | Oma muster, mille ise määrad | Hollandi postiindeks, IBAN, mobiilinumber |
Ole Specialiga ettevaatlik
Valiku Special korral saad teisest rippmenüüst valida ZIP Code, ZIP Code + 4, Phone Number, Social Security Number ja Arbitrary Mask. Esimesed neli on Ameerika mustrid: ZIP Code ootab viit numbrit nagu 90210, Phone Number Ameerika telefoninumbrit ja Social Security Number on Ameerika sotsiaalkindlustusnumber (kolm, kaks ja neli numbrit). Hollandi andmete jaoks kasuta seetõttu regulaaravaldist.

Arbitrary Mask: trükkimise suunamine
Viies valik Special all, Arbitrary Mask (vaba mask), sobib ka Hollandi andmete jaoks. Kirjuta mask selle all olevasse kasti: 9 tähistab numbrit, A tähte ja muud märgid (näiteks tühik) jäävad nii, nagu on. Maskiga 9999 AA saab täitja numbri kohale trükkida ainult numbri ja tähe kohale ainult tähe. Kui keegi trükib 38a1 12, jääb alles 3811.
Mask kontrollib ainult trükkimise ajal. Poolikult täidetud postiindeksi nagu 3811 laseb see läbi ilma teateta. Kui tahad, et puudulik väärtus tagasi lükataks, kasuta regulaaravaldist.
Hollandi postiindeks regulaaravaldisega
Regulaaravaldis on lühike kirjeldus sellest, milline tekst peab välja nägema. Seda keelt pole vaja õppida: kopeeri mustrid allolevast tabelist.
- Klõpsa postiindeksi väljal.
- Vali kohas Format valik Regular expression.
- Kirjuta selle all olevasse kasti muster ^[1-9][0-9]{3} ?[A-Za-z]{2}$ ja vajuta Enter.
- Lisa kohta Tip (vihje) näide, näiteks "Näiteks 3811 AB". Vale sisestuse hoiatus ei ütle, kuidas õigesti teha, vihje ütleb.
- Märgi Required (kohustuslik), kui postiindeks on kohustuslik.

Alati ^ alguses ja $ lõpus
Euro-Office kontrollib, kas muster esineb sisestuses kuskil. Ilma lisamärkideta kiidab Belgia postiindeksi muster [1-9][0-9]{3} heaks ka 02000, sest selles sisaldub 2000. Pane seepärast algusesse ^ (katus) ja lõppu $ (dollarimärk): siis peab kogu sisestus mustrile vastama. Mustriga ^[1-9][0-9]{3}$ lükatakse 02000 tagasi ja 2000 kiidetakse heaks; ülaltoodud postiindeksi mustriga lükatakse tagasi 3811 ABC. (Pildil on muster veel ilma ^ ja $ märgita.)
Mustrid kopeerimiseks
| Väli | Muster | Õige | Viga |
|---|---|---|---|
| Hollandi postiindeks | ^[1-9][0-9]{3} ?[A-Za-z]{2}$ | 3811 AB, 3811AB | 12345, 3811 ABC |
| Belgia postiindeks | ^[1-9][0-9]{3}$ | 2000 | 02000 |
| Hollandi mobiilinumber | ^06[0-9]{8}$ | 0612345678 | 06-1234567 |
| Hollandi IBAN | ^NL[0-9]{2} ?[A-Z]{4} ?([0-9]{4} ?){2}[0-9]{2}$ | NL91 ABNA 0417 1643 00 | NL91ABNA041716430 |
Kuupäev Eesti vormingus
Kui valid kohas Format valiku Date, valid vormingu kindlast loendist ja täitmisel saab väli noolekese kalendri avamiseks. Loend algab Ameerika vormingutega nagu m/d/yy (kuu enne) ja selles pole vormingut dd.mm.yyyy, mis on Eestis tavaline numbriline järjekord. Sul on kaks head valikut:

- dd-mmm-yyyy: päev, kuu lühendina ja aasta. Selge, sest päeva ja kuud ei saa segi ajada.
- yyyy-mm-dd: rahvusvaheline vorming, näiteks 1990-12-31. Mugav, kui sorteerid vastuseid hiljem või tõstad need tabelisse.
Tahad kindlasti kuju 31.12.1990? Siis ära vali kohas Format valikut Date, vaid Regular expression mustriga ^(0[1-9]|[12][0-9]|3[01])\.(0[1-9]|1[0-2])\.(19|20)[0-9]{2}$. Väljal pole siis kalendrit, kuid see võtab vastu ainult kuupäeva kujul 31.12.1990; 12/31/1990 lükatakse tagasi. Lisa kohta Tip näiteks "pp.kk.aaaa".
Tähelepanu: kui jätad alles vaikevormingu m/d/yy, lükkab väli kuupäeva nagu 31.12.1990 tagasi teatega, et väärtus peab vastama vormingule "m/d/yy". Vali vorming seega alati teadlikult.
Kohustuslikud väljad ja maksimaalne pikkus
- Märgi Required väljadel, mis tuleb alati täita. Selline väli on täitmisel tumedamat värvi, nii näeb täitja, et see on kohustuslik.
- Valikuga Characters limit (märgipiirang) määrad suurima lubatud märkide arvu, näiteks 22 Hollandi IBAN-i jaoks ilma tühikuteta.
Testimine: nii näeb seda täitja
- Vali üleval paremal Commenting (kommenteerimine); selles režiimis täidad vormi täpselt nagu saaja.
- Trüki postiindeksi väljale vale väärtus, näiteks 12345, ja vajuta Tab.
- Euro-Office näitab akent Warning (hoiatus) tekstiga "Invalid value for field" ja välja nimega. Anna väljadele seega arusaadav Name, sest täitja näeb seda siin.
- Klõpsa OK, trüki 3811 AB ja vajuta Tab: nüüd läheb kõik ilma teateta läbi.
Vihje: hoiatus ilmub alles siis, kui liigud klahviga Tab teisele väljale. Kui lehel on ainult üks väli, ei juhtu klahvi Tab vajutamisel midagi ja teadet ei näe. Lisa testiks vormile seega vähemalt teine väli.

Lõksud
- Kuju ei tõenda ehtsust: IBAN-i muster kontrollib, kas see näeb välja nagu Hollandi IBAN, mitte seda, kas konto on olemas või kontrollnumber õige.
- Ära ole liiga range: Hollandi postiindeksi muster jätab välja Belgia ja Saksa täitjad. Kui sul on ka välismaa kliente, tee väli vabamaks või lisa eraldi väli Riik.
- Tühikud ja suurtähed: [A-Z] lubab ainult suurtähti. Kui tahad lubada ka väiketähti, kasuta [A-Za-z] nagu postiindeksi mustris.
- Testi alati ühe õige ja ühe vale väärtusega, enne kui vormi välja saadad.
