SimpleType - typy fieldov

Každé pole je nejakého type, ktorý predurčuje základné ale aj pokročilé chovanie v komponentoch.

[ {name: 'zaciatok', type:'date'}, {name: 'zaciatokCas', type:'time'}, 'koniec:datetime' ]

Každá definícia typu hovorí o spôsobe zobrazenia hodnoty, možnosti editovania a hľadania podľa tohoto poľa.fields

Zoznam všetkých dostupných typov (FieldType0 je v premennej isc.builtinTypes alebo SimpleType.get('name')

// DataSource
{
	detailFields:[
		'meno,priezvisko,line1:line',
		'nadpis1:header,datumNarodenia,miestoNarodenia',
		{name:'nadpis2', title:'Kontakt', type:'section', itemIds: ['telefon','email','adresa']},
		'telefon,email:emailAddress,e1:empty,adresa'
	]
}

Vlastné typy

Vlastné typy môžu byť vytvarané per-project alebo on-the-fl.y

name	unikátny názov
inheritsFrom	z ktorého typu pochádzajú zdedené vlastnosti
editorType	FormItem na editáciu
readOnlyEditorType	FormItem na read-only
filterEditorType	FormItem na hľadanie (v Zozname alebo pokročilom hľadaní)
fieldProperties	vlastnosti aplikované na Field ako taký, alebo pre neexistujúce na inštanciu
editorProperties	vlastnosti aplikované na FormItem pre editovanie (aj search)
readOnlyEditorProperties	vlastnosti aplikované na readonly FormItem
listProperties	vlastnosti aplikované na pole ako stĺpca v zoznzame
validators	použité validátory, kompletný zoznam je podľa dedičnosti a vlastnych validátorov na poli.
valueMap
editFormatter
parseInput
validOperators

SimpleType.create({
  name: 'psc',
  inheritsFrom: 'integer',
  editorType: 'IntegerItem',
  readOnlyEditorType: 'StaticTextItem'
  fieldProperties: { length: 5 }
});

Primitívne typy

Textové typy

text	voľný text
longtext	voľný text, dlhší a viacriadkový
link	text je externou linkou
image	text je externou linkou na obrázok
enum	učuje možnú množinu hodnôt, pomocou `valueMap` alebo `fullValueMap`.
password	maskované zadávanie hesla
richtext	HTML5 richtext editor (CKEditor)

Numerické typy

integer	základné celé číslo
float	základné desatinné číslo
localeInt	formátovaný integer (M rímsky)
localeFloat	formátovaný float podľa locale
localeCurrency	currency v mene_
currency	float v mene
percent	0.0-100.0 %
integerPercent	0-100 %

Časové typy

date	dátum (bez času - 12:00)
time	len čas
datetime	dátum a čas (aka timestamp)
timerelative	dátum a čas (aka timestamp)
timepast	dátum a čas (aka timestamp)

Boolean typy

boolean	hodnoty `true` a `false` (alebo `null`)
any	bez kontroly typu, čiže len má alebo `null`, default sa rendruje ako `text`

Asociácie

Polia niektorého z asociačných typov obsahujú aj optionDataSource a automaticky používajú jeho primárny kľúč ako hodnotu.

Multiplicita 1

SC ponúka zadať type ako názov DataSource asociovaného objektu, prípadne multiple: true pre ich zoznam.

Pokročilou aleternatívou sú asociačné typy pre vlastnú editáciu a zobrazenie. Takéto pole má ďaľšie vlastnosti - optionDataSource alebo foreignKey ukazujúce na DS.

assoc1	klasický ComboBoxItem a readOnly ako anchor
assoc1group	sada polí z asociácie, napr. nadpis+popis (alebo pickFields), editovací + doplňujúce polia
assoc1detail	kompletný detail (vždy readOnly) asociovaného záznamu, s vlastnými operáciami
assoc1line	zobraziť ako Grid s jedným riadkom
aggr1	agregovaný sub-formulár
aggr1wide	na celú šírku
aggr1tab	do samostatnej záložky

Multiplicita N

assocn	základný zoznam záznamov
assocnwide	na celú šírku
assocntab	zoznam do samostatnej záložky
assocnmulti	miesto zoznamu použije
assocnchecks	pre malé množstvo vyberateľných záznamov, počas editácie zobrazujúce checkbox na výber
assocnback	TODO backreferencia ?
assocnaggr	asociované záznamy, chovajúce sa ako agregácia
aggrn
aggrnwide	na celú šírku
aggrntab	do samostatnej záložky

Dekoračné typy

Tieto typy polí sú vhodné len pre fieldSety, pretože dekorujú konkrétne detaily alebo formuláre, preto je často ideálne ich skrátene zapisovať priamo v názve poľa. Preklad polí zobrazujúcich text sa definuje ako preklad poľa v DS DataSource.locales.{field.name}.

Prázdne bunky sa dynamicky vynechávajú podľa nižšieho počtu stĺpcov detailu.

title	zobrazí statický nadpis cez celý riadok, pre následúce polia.
section	tento nadpis prepína viditeľnosť, pre názvy polí v array itemIds.
group	.
line	vykreslí oddelovaciu čiaru cez celý riadok.
empty	a `empty2` vynechájú 1 resp. 2 bunky v detaile
emptyRow	vynechá 1 riadok
blurb	statický text, ako nápoveda vo formulári, `blurb2` - cez dve bunky
blurbRow	na celý riadok