SQL příkaz - SELECT

Příkaz Select definuje dotaz v jazyce T-SQL k získání dat pro zobrazení. Dotaz příkazu musí obsahovat klauzule WHERE kontrolující přístupové klíče uživatele. V případě, že klauzule nebude obsahovat kontrolu přístupových klíčů, uživatel bude mít přístup ke všem záznamům datové tabulky.

V příkazech se používají tyto stránkou definované parametry:
@userID ... identifikace přihlášeného uživatele
@groupID ... identifikace zvolené uživatelské skupiny
@roleName ... název zvolené uživatelské role
@FiltracniPodminky ... filtrační podmínky zadané uživatelem

Příklady příkazů:

Seznam s filtrem:
SELECT <seznam sloupců>
FROM <název schématu>.<název tabulky>
WHERE <název sloupce s klíčovou hodnotou> IN (SELECT hodnota FROM dbo.tfVratHodnotyKliceInt('<kód klíče = dbo.KliceKody.kod>', @userID, @groupID, @roleName))
AND @FiltracniPodminka
ORDER BY <seznam sloupců>

SQL příkaz - INSERT

Příkaz Insert definuje příkaz v jazyce T-SQL k vložení dat. Vkládaná data jsou předávána jako parametry se stejným názvem jako sloupec tabulky.

INSERT INTO <název schématu>.<název tabulky> (<sloupec1>) VALUES (@<sloupec1>)

Sloupce mřížky - VALIDACE

Pole Validace se používá pouze na pořizovacích stránkách. Určuje způsob validace vkládaných hodnot. Validuje se pomocí SQL dotazu, který vrací hodnotu errorMessage. ErrorMessage obsahuje chybovou hlášku, která se zobrazí při chybné validaci pole, nebo prázdný řetězec, pokud je validační podmínka splněna.
V příkazu lze použí parametr @parametr, který obsahuje zadanou hodnotu pole.
K dispozici jsou i parametry @roleName, @userID, @groupID předávané podle přihlášeného uživatele, nebo přebírané od zastupovaného uživatele a parametr @id podle ID požadavku.
@id = 0 při pořízení nového požadavku a při kopii požadavku.
@id = parametru idEditace při editaci požadavku

Příklad použití:
SELECT errorMessage =
CASE (SELECT COUNT(*) FROM <název schématu>.<název tabulky> WHERE <název sloupce> = @parametr)
WHEN 1 THEN ''
ELSE 'Nepřípustná hodnota.' END

Sloupce mřížky - DataFormatString

Pole DataFormatString se používá pro formátování zobrazovaných dat.

Příklady formátování:

{0:d} ... datum bez času
{0:N2} Kč ...  částka v Kč na 2 desetinná místa
{0:0.00} ... číselný údaj s přesností na 2 desetinná místa
{0:0.00;(0.00);""} ... číselný údaj s přesností na 2 desetinná místa. V případě, že je hodnota 0, zobrazí prázdný string ""
 

Formátování čísel

Vlastní formátování čísel

Formátování datumu

Vlastní formát datumu

Sloupce mřížky - RegExpression

Pole RegExpression se používá pro stanovení regulárního výrazu ověřujícího zadávanou hodnotu. Není-li regulární výraz splněn, je vypsána chybová zpráva uvedená ve vlastnosti sloupce RegExprMessage.

Příklady regulárních výrazů:

Datum 

Javascript

Javascript definuje kód prováděný na stránce pořízení požadavku. V kódu jsou definované javascriptové funkce, které lze spouštět z vybraných sloupců mřížky.

Cílem může být například zobrazení součtu některých polí. Sloupce, které mají funkci spouštět musí mít uvedeno jméno  funkce ve vlastnosti JavaScriptFunction.

Identifikace sloupce typu BoundField, CheckBoxField, ComboboxField, CalendarField pro použití ve výpočtu probíhá přes hodnotu vlastnosti „Datový sloupec“.

Příklad vloženého javascriptu:
<script language='javascript'>
    function PohledMenaFunkce() {
          var txt1 = document.getElementById('zaklad1');
          var txt2 = document.getElementById('dph1');
          var lbl = document.getElementById('pohledmena');
          
          var txt1Int;
          txt1Int = TryParseInt(txt1.value, 0);
 
          var txt2Int;
          txt2Int = TryParseInt(txt2.value, 0);
          
          var soucet = txt1Int + txt2Int;
          lbl.innerHTML = number_format(soucet, 2, ',', ' ');
    }

window.onload = function() { PohledMenaFunkceOnLoad(); };

    function PohledMenaFunkceOnLoad() {
          var txt1 = document.getElementById('zaklad1');
          var txt2 = document.getElementById('dph1');
          var lbl = document.getElementById('pohledmena');
          
          var txt1Int;
          var int1
          // Hodnota se načítá podle toho jestli je formulář v modu editace nebo prohlížení.
          if(txt1.innerHTML != ""){int1 = txt1.innerHTML} else {int1 = txt1.value}
          txt1Int = TryParseInt(int1, 0);
 
          var txt2Int;
          var int2
          if(txt2.innerHTML != ""){int2 = txt2.innerHTML} else {int2 = txt2.value}
          txt2Int = TryParseInt(int2, 0);
          
          var soucet = txt1Int + txt2Int;
          lbl.innerHTML = number_format(soucet, 2, ',', ' ');
    }

    function DatumVystFunkce() {
          var dprij = document.getElementById('dprij');
          var dvyst = document.getElementById('dvyst');
          var splatnost = document.getElementById('splatnost');
          var dspl = document.getElementById('dspl');

          if(dprij.value != ""){
                                dvyst.value = dprij.value
                                dspl.value = FormatujDatum(PrictiDnyKDatumu(PrevedNaDatum(dprij.value), splatnost));
          } 
    }

   function KontrolaDSPL() {
      var dspl = document.getElementById('dspl').value;
      var splatnost = document.getElementById('splatnost').innerHTML;
      var duzp = document.getElementById('dprij').value;
 
      var datumdspl = PrevedNaDatum(dspl);
      var datumduzp = PrevedNaDatum(duzp);
      var datumduzpSeSplatnosti = PrictiDnyKDatumu(datumduzp, splatnost);
 
      if (datumduzpSeSplatnosti.getTime() > datumdspl.getTime()) {
          alert("Datum splatnosti je menší než d. u. z. p + počet dní splatnosti");
      }

    }
</script>

Pro snadnější použití jsou připraveny některé funkce:
TryParseInt(vstup, vychoziHodnota) - Funkce se pokusí převést řetězec vstup na desetinné číslo. Pokud převod není možný, tak vrací číslo vychoziHodnota.

Pro formátování čísel je funkce number_format. Jako parametr se předává:

• formátovaný řetězet
• počet desetinných míst
• oddělovač desetinných čísel
• oddělovač tisíců

př. použití:

number_format(1234.56); 
Vrací:
'1,235'

number_format(1234.56, 2, ',', ' '); Vrací:
'1 234,56'

Pro práci s datumy jsou připraveny obecné funkce

• PrevedNaDatum(datumString) - přijímá řetězec jako parametr a převádí ho na datum.
• PrictiDnyKDatumu(datum, pocetDni) - přičte k datumu počet dní předané v parametru pocetDni. Parametr datum musí být ve formátu Date!
• FormatujDatum(datum) - Převede Date na čitelný řetězec datum ve formátu dd.mm.yyyy

Příklad pro kontrolu datumů je funkce KontrolaDSPL(), která využívá výše popsané pomocné funkce pro práci s datumy a při zjištění zadání menšího data splatnosti než je duzp + počet dní splatnosti vyhazuje hlášku.

V tomto případě bude ve vlastnosti JavaScriptFunction u sloupce vyplněna hodnota PohledMenaFunkce(). Toto způsobí, že při změně hodnoty v nastaveném poli se vyvolá javascriptová funkce PohledMenaFunkce().

Pro vyvolání výpočtu na detailu pořízeného požadavku je potřeba v jascriptu nastavit funkci, která výpočet při loadu stránky pustí:
window.onload = function() { PohledMenaFunkceOnLoad(); };
A je potřeba tuto funkci nadefinovat(viz. příklad). Změny jsou ve získávání hodnoty z prvků na formuláři. Při zobrazení detailu se hodnota získává pomocí txt1.innerHTML místo získávání hodnoty z txt1.value při pořizování.

Maska

Nastavení masky určuje formát a povolené znaky zadávané do vstupního pole.

příklady masky:

• pro čísla: 9,999,999.99
• pro datum: 99/99/9999
• pro čas: 99:99:99
• pro datum a čas: 99/99/9999 99:99:99

Znaky pro zadání masky:

9 - Pouze číselné znaky
L - Pouze písmena
$ - Poue písmena nebo mezery
C - Pouze uživatelské znaky (case sensitive)
A - Pouze písmena nebo uživatelské znaky
N - Pouze čísla nebo uživatelské znaky
? - Libovolné znaky

/ - Oddělovač datumu
<ESC>:</ESC> - Oddělovač času
. - Desetinný oddělovač
, - Oddělovač tisíců
\ - Escape character
{ - Počáteční oddělovač pro opakování masek
} - Konečný oddělovač pro opakování masek

Příklady 
9999999 - 7 číselných znaků 
99\/99 - 4 číselné znaky oddělené uprostřed znakem "/"

Typy Masky:

None - Bez validace
Number - Validace čísel
Date - Validace datumu
Time - Validace času
DateTime - Validace datumu a času

Další možnosti použití na stránce: www.asp.net/ajaxlibrary/act_MaskedEdit.ashx, nebo www.asp.net/ajax/ajaxcontroltoolkit/samples/maskededit/maskededit.aspx