Formos vaizdas - vartotojui matomi laukai

Aprašymo taisyklės:

1. Formos pavadinimas, kuris bus matomas vartotojui, talpinamas tarp žymų "caption".
2. Kiekviena formos eilutė atskira šaka "row", o eilutės vaikai "schema" - elementai, kurie bus atvaizduoti.

3. Tarp žymų "schema" išvardinamos savybės būdingos konkrečiam elementui.

   <app>
   <form>
       <caption>{{<!-- formos pavadinimas -->}}</caption>
       <row>
           <schema>...</schema>
           <schema>...</schema>
       </row>
       <row>...</row>
       <row>...</row>
   </form>
   ...
   </app>

Elementų tipai

Elementas	Aprašymas
text	laisvai vedamas tekstinis laukas. Galima apriboti leidžiamų vesti simbolių skaičių.
textarea	laisvai vedamas tekstinis laukas, turintis savybę rows, nurodančią, kiek eilučių bus vizualiai matoma vartotojui. Galima apriboti leidžiamų vesti simbolių skaičių.
number	skaitinis laukas. Galima nurodyti leidžiamų vesti simbolių po kablelio skaičių. Galima nurodyti didžiausią ir mažiausią leidžiamas reikšmes.
select	sąrašinis laukas.
checkbox	žymimasis kvadratinis laukelis. Vartotojui pažymėjus, laukelyje atsiranda varnelė. Lauko reikšmė yra true arba false.
radio	grupė elementų atvaizduojamų kaip maži apskritimai ir vartotojui leidžiama pasirinkti tik vieną reikšmę iš grupės.
date	įvedamas arba pasirenkamas iš kalendoriaus datos laukas.
daterange	įvedamas arba pasirenkamas iš kalendoriaus datų intervalo laukas.
label	vartotojui rodomas kaip informacinis laukas. Nekoreguojamas.
hidden	vartotojui nematomas laukas, kurio informacija bus naudojama formos apdorojimo metu.

Elementų savybės

Savybė	Aprašymas	Galimos reikšmės	Naudojama elementams
type (privalomas)	Elemento tipas	text, textarea, number, select, checkbox, radio, date, dateRange, label.	visiems
id	Elemento id. Bus atiduodamas rezultate.		visiems
caption	Elemento pavadinimas - bus matomas vartotojui.		visiems
value	Elemento numatytoji reikšmė.		visiems
valueWhen	Aprašomos sąlygos, kokią reikšmę laukas įgys priklausomai nuo tam tikrų formos pasikeitimų.	Kaip aprašyti?	visiems
disabled	Jeigu reikšmė true, laukas formoje nebus koreguojamas.	true, false	visiems
disabledWhen	Aprašoma sąlyga, kada laukas bus koreguojamas.	Kaip aprašyti?	visiems
width	1 - jei eilutėje elementas turi užimti visą ilgį.2 - jei eilutėje elementas turi užimti 50% ilgio.	1,2	visiems
data	Duomenys reikalingi elementui.		select, radio
rows	Elemento aukštis - rodomų eilučių skaičius.		textarea
decimal	Galimų simbolių skaičius po kablelio.		number
required	Nurodžius reikšmę true nebus leidžiama išsaugoti formos, jei laukas neužpildytas	true, false	visiems
requiredWhen	Aprašoma sąlyga, kada laukas bus privalomas.	Kaip aprašyti?	visiems
min	Mažiausia galima reikšmė, kai type = number. Mažiausias leistinas simbolių skaičius, kai type = text arba textarea. Anksčiausia leistina data, kai type = date arba daterange.		number, text, textarea, date, daterange
max	Didžiausia galima reikšmė, kai type = number. Didžiausias leistinas simbolių skaičius, kai type = text arba textarea. Vėliausia leistina data, kai type = date arba daterange.		number, text, textarea, date, daterange
visible	Jeigu reikšmė false, laukas formoje nebus matomas.	true, false	visiems
visibleWhen	Aprašoma sąlyga, kada laukas bus matomas formoje.	Kaip aprašyti?	visiems

Elementų savybė "data" gali būti aprašoma dviem būdais:

1. naudojant raktažodį “context” - kai elemento reikšmės imamos iš formos šablono šakos data. Sintaksė - po raktažodžio dedamas dvitaškis ir aprašoma nuoroda. Tarpai nenaudojami.

   <data>context:app.data.vietoves</data>

2. naudojant raktažodį “sp” - kai elemento reikšmės bus generuojamos dinamiškai naudojant procedūrą. Aprašant reikia nurodyti procedūros pavadinimą, kuri generuos reikalingą sąrašą. Sintaksė - po raktažodžio dedamas dvitaškis ir nurodomas procedūros pavadinimas. Tarpai nenaudojami.

   <data>sp:RGI_MGAMA_FORM_GET_SS_PAREIGOS</data>