DataSource definuje dátovu štruktúru záznamov pomocou polí - názvov s vlastnosťami. Pole pomocou typu a vlastností automatizuje validáciu hodnoty, spôsob zobrazenia v rôznych situáciach či spôsob zadávania hodnoty.

Názov poľa a typ

Názov poľa pozostáva z alfanumerických znakov a je unikátny v rámci polí DS a tých z ktorých je zdendený.

Názov ako identifikátor sa použiva aj vo fieldSetoch a taktiež pri rozoznávaní argumentov operácií.

Typ poľa udáva vlastnosti chovania (list, edit, view) na najnižšej úrovni, a tieto sú priamo prepisované samotným poľom.

fields: {
	celeMeno: {name:'celeMeno', type: 'text', editorType: 'TextAreaItem'} // overwrite editorType from type
}

Výsledné vlastnosti

ddd

Vlastnosti

Výsledný object poľa v rámci GUI je dynamicky vyrátavaný (prototypovo, aplikačne), napríklad: {type.fieldProperties} + {field} + {gui.properties} + {item.properties} + {object.properties} = {instance}

{ name: 'adresaPsc', type: 'psc', required: 1 }

Bežné vlastnosti

Identifikácia

title	`true` zapne povinnosť hodnoty v prípade editácie
shortTitle	`false` vypne možnosť hodnotu editovať - read only
prompt	`false` vypne možnosť hodnotu editovať - read only
ficon	`false` vypne možnosť hodnotu editovať - read only
hint
placeholderText

Hodnota poľa

required	`true` zapne povinnosť hodnoty v prípade editácie
canEdit	`false` vypne možnosť hodnotu editovať - read only
length	`128` obmedzí dĺžku znakov/číslic
shouldSaveValue	`false` vypne možnosť aplikovať hodnotu (napr. ukladať na servri)
canExport	`false` vypne zobraznie hodnoty v automatizovaných exportoch záznamov
primaryKey	`true` definujé hodnotu ako primárny kľúč, identifikujúci záznam (kľúčov môže byť viac)

Viditeľnosť

detail	`true` vypne zobrazovanie v zoznamoch (komponentoch s neúplnými záznamami)
canFilter	`false`vypne možnost použiť hodnotu ako filtrovacie kritérium (syntetické, na servri neimplementované polia)
canView	`false` vypne akékoľvek zobrazovanie na klientskej strane
hidden	`true` skryje pole počas zobrazovania, negáciou sa zobrazí
showIf	callback či zobraziť položku (argumenty sa líšia medzi form a list), `'false'` vypne zobrazenie (umožní zapnúť v gridoch, ak `detail`=`false`)

Detail, edit, search

editorType	prepísať (default z `type`) FormItem pre editáciu, použije sa aj ak existuje možnosť prepínania medzi edit/view.
readOnlyEditorType	prepísať FormItem pre needitovateľné zobrazenie (detail)
filterEditorType	prepísať FormItem vo filtri pre toto pole
validators	dodatočné validátory (nad tie z typu); array identifikátorov alebo definícií validátorov
validOperators	prepísať array možných filtrovacích typov kritérií

Nastavenie asociácie

optionDataSource	názov DS
displayField
foreignKey

Obmedzujúca množina

pickListCriteria

staticke criteria pre vyber hodnoty (napr. kombo, vyber zo zoznamu)

Backreferencie

Polia, ktoré nemajú vlastnú hodnotu, ale vedia su ju vyrátať definovaním väzby z opačnej/cudzej strany.

backref	`true` zapne rátanie hodnoty z opačnej strany, vyžaduje `optionDataSource`
refField	názov opačného pola (default je automaticke najdenie) vo filtri s primarnym klucom aktualneho zaznamu
refCriteria(vm)	funkcia vracajuca array advanced criterionov
refOperation	TODO moznost volanie custom finder operacie

Nastavenie filtrovania

setCriterion
getCriterion
canEditCriterion
filterEditorProperties