|
V každém elementu se definuje jeden parametr dotazu.
Obsahuje atribúty:
| • | name – povinné, jméno proměnné v SQL skriptu, například @Jmeno |
| • | type – povinné, typ proměnné v jazyku T-SQL. Může nabývat hodnoty: |
| o | bit – boolovská proměnná 0/1 |
| o | bigint – celočíselná proměnná 64-bit, rozsah –2^63 až +2^63–1 |
| o | int, integer – celočíselná proměnná 32-bit, rozsah –2^31 až +2^31–1 |
| o | smallint – celočíselná proměnná 16-bit, rozsah –32768 až +32767 |
| o | tinyint – celočíselná proměnná 8-bit, rozsah 0 až 255 |
| o | uniqueidentifier – unikátní identifikátor, GUID. |
| o | decimal, numeric, dec [ (p[ ,s] )] – desetinné číslo so zadefinovanou presnosťou.
p – celkový počet míst, 1 až 38*, default 18
s – počet desetinných míst, 0 až p, default 0 |
| o | money, smallmoney – implementované jako decimal s příslušným omezením hodnoty |
| o | float [ (n) ] – číslo s pohyblivou řádovou čárkou
n – počet bitů mantisy, 1 až 53. Pro n platí: |
| • | pokud 1<=n<=24, tak n je považované za 24 (4 bajty, přesnost 7 číslic,
hodnoty –3.4E+38 až 3.4E+38) |
| • | pokud 25<=n<=53, tak n je považované za 53 (8 bajtů, přesnost 15 číslic,
hodnoty –1.79E+308 až 1.79E+308) |
| o | real – stejné jako float(24) |
| o | double precision – stejné jako float(53) |
| o | datetime – datum a čas, 1.1.1753 – 31.12.9999, přesnost několik ms |
| o | smalldatetime – datum a čas, 1.1.1900 – 6.6.2079, přesnost 1 minuta |
| o | char, character [ ( n ) ] – text s pevnou délkou
n – počet znaků textu, 1 až 8000, default 1 |
| o | nchar, national char, national character [ ( n ) ] – Unicode text s pevnou délkou
n – počet znaků textu, 1 až 4000, default 1 |
| o | varchar, char varying, character varying – text s variabilní délkou
n – maximální počet znaků, 1 až 4000 a nebo max**, default 1
Poznámka: max = 2^31-1 bajtů (znaků v 8-bitové kódové stránce) |
| o | nvarchar, national char varying, national character varying – Unicode text s variabilní délkou
n – maximální počet znaků, 1 až 8000 a nebo max**, default 1
Poznámka: max = 2^31-1 bajtů (2^30-1 unicode znaků) |
| o | text – text s variabilní délkou až do 2^31-1 bajtů (8-bitových znaků)** |
| o | ntext, national text – Unicode text s variabilní délkou až do 2^31-1 bajtů (2^30-1 unicode znaků)**
* U typu decimal je maximální přesnost na formuláři omezená na 29 platných míst (dohromady před i za desetinnou čárkou).
** U typů varchar(max), nvarchar(max), text a ntext je maximální množství znaků v editačním políčku omezené na 32767. |
| • | text – nepovinné, text (label), který se zobrazí ve formuláři u příslušného editačního boxu. Pokud není zadané, použije se název proměnné z atributu name bez počátečního znaku @. |
| • | nullable – nepovinné, true/false, default false. Určuje, zda uživatel může ponechat tento parametr nezadaný. Pokud atribut nullable není přítomný, implikuje se hodnota false (t.j. zadání hodnoty je povinné). |
| • | default – nepovinné, implicitní hodnota pro proměnnou. Může se definovat i pomocí výrazů (viz níže). Pokud není zadané, proměnná nebude ve formuláři předvyplněná.
Při zobrazení formuláře s parametry musí být default hodnota převedená na deklarovaný typ. Proto jí třeba v textě zadávat regionálně invariantním způsobem. Teda například "3.5" (decimal hodnoty používají desetinnou čárku) a nebo "2014-01-31" pro dátum. Pozor – datum zadaný jako "1.3.2014" by byl převedený na 3. Leden 2014! |
| • | visible – nepovinné, true/false, default true. Určuje, zda se tento parametr má objevit ve formuláři. Při nastavení visible="false" je možné pomocí default hodnoty odevzdat implicitní needitovatelné parametry prostředí, jako např. {ID_ZZ}. |
| • | tooltip – nepovinné, textový tooltip, který se zobrazí pokud uživatel umístí kurzor myši nad popisek s textem. |
| • | input – pomocný kód, kterým se dá ovládat způsob zobrazení a zadání hodnoty. Například pokud je hodnota typu "bit" (t.j. boolean), může nabývat hodnoty "YesNo" (pro editaci hodnoty se použije kombo s hodnotami Yes/No) a nebo "checkbox" (pro editaci se použije checkbox).
Poznámka: Standardně se pro editaci boolean hodnoty použije kombo s hodnotami True/False. |
Příklad elementu param:
--<param name="@jmeno" type="nvarchar(50)" text="Jméno" default="Novák" nullable="true" tooltip="Jméno pacienta" />
|