Differences

This shows you the differences between two versions of the page.

--- user:skript:stator:modules:stator-customtables [2015/12/06 20:25] – vytvořeno kiregps
+++ user:skript:stator:modules:stator-customtables [2020/10/28 12:03] (current) – opravy překlepů mikrom
@@ Line 1: / Line 1: @@
-{{ :user:skript:stator:logo_ararat_2.png?nolink&250|}}
+[[user:skript:stator|{{ :user:skript:stator:logo_ararat_2.png?nolink&250|}}]]
 ====== Moduly CustomizedTable, SQLTable ======
@@ Line 24: / Line 24: @@
 Pro databázové operátory ''IN'', ''NOT IN'' a ''BETWEEN'' platí obdoba toho, co bylo napsáno výše. Operátory pracují s více hodnotami a je nutné, aby byly od sebe odděleny čárkou (příklad pro operátor ''IN'': 'FTF','STF').
-Operátor ''LIKE'' porovnává hodnotu s maskou, která může obsahovat zástupné znaky _ a %. Příkladem může být zápis hodnoty pro zobrazení všech FTF hodnot: '%FTF%'. Budou tedy akceptovány jen hodnoty, které kdekoli obsahují text FTF (např. coFTF).
+Operátor ''LIKE'' porovnává hodnotu s maskou, která může obsahovat zástupné znaky _ a %. Příkladem může být zápis hodnoty pro zobrazení všech FTF hodnot: '%FTF%'. Budou tedy akceptovány jen hodnoty, které kdekoli obsahují text FTF (např. coFTF). Nebo výraz '%TF%' akceptuje hodnoty coFTF,FTF,STF,TTF,FTFco.... a další všemožné patvary které obsahují 'TF' a něco před a něco za.
 ==== Počitatelný sloupec (Counting) ====
@@ Line 35: / Line 35: @@
 ==== Řazení ====
-Je možné sice definovat, že sloupec má numerický obsah a podle něj pak řadit, ale již není možné definovat, že sloupec obsahuje datum nebo čas a řadit podle data/času. Řazení podle data nálezu je v pořádku a pracuje pro databázové sloupce s datem. Nepracuje však s tagy. Pokud nějaký tag bude obsahovat datum, podle kterého má být seznam řazen, je třeba, aby datum mělo napřed rok, pak měsíc, pak den a použít abecední řazení. Jiná cesta zatím není.
+Je možné sice definovat, že sloupec má numerický obsah a podle něj pak řadit, ale již není možné definovat, že sloupec obsahuje datum nebo čas a řadit podle data/času. Řazení podle data nálezu je v pořádku a pracuje pro databázové sloupce s datem. Nepracuje však s tagy protože hodnota tagu je v databázi jako text a textové datum není úplně primitivní převést na číslo, zejména když není jasné, v jakém formátu je datum napsané. Pokud nějaký tag bude obsahovat datum, podle kterého má být seznam řazen, je třeba, aby datum mělo napřed rok, pak měsíc, pak den a použít abecední řazení. Jiná cesta zatím není.
 ===== SQLTable =====
@@ Line 43: / Line 43: @@
 ==== Jméno sloupce v SQL ====
-Jak bylo ukázáno na příkladu, jméno sloupce může obsahovat různé informace. Pokud je informací více, jejich příznaky jsou odděleny středníkem a na jejich pořadí nezáleží.
+Jméno sloupce může obsahovat různé doplňující či formátovací informace a v tom případě je uzavřeno v uvozovkách. V případě přítomností podobných informací je za jménem sloupce znak = a za ním následují příslušné informace. Pokud je jich více, jejich příznaky jsou odděleny středníkem a na jejich pořadí nezáleží.
-Kromě zarovnání výstupu (Left, Right, Center, Hide) je možné použít techniky, kterou používá modul ''CustomizedTable'' a určit sloupec, který bude použit pro výpočet celkového počtu jako základu pro sloupce pojmenované ''Percent'' nebo ''Histogram''. Příznak má zkratku ''Cnt'' a odpovídající část SQL příkazu může vypadat např.:
+=== Příznaky doplňujících informací ===
+^ Formátování ^| Left, Right, Center, Hide |
+^ Příznak počitatelného sloupce ^| Cnt (určuje sloupec, který bude použit pro výpočet celkového počtu jako základu pro sloupce pojmenované ''Percent'' nebo ''Histogram'') |
+^ Příznak numerické hodnoty ^| Num |
+^ Směr řazení ^| Asc, Desc |
+^ Operátory pro výběr řádků podle hodnoty ^| =, >, <, >=, <=, <>, IN((výsledek je v seznamu hodnot oddělených čárkou např.: 'A', 'B', 'C'.)), NOT IN((výsledek není v seznamu hodnot oddělených čárkou např.: 1, 2, 3.)), LIKE((Výsledek se podobá výrazu v uvozovkách např. '%test%' takže výsledek může být např **Atest, TEST, test, Test1**.... Symboly '%' určují volitelnou/různou část hledaného řetězce. Pokud tam není žádný symbol '%' v podstatě se LIKE degraduje na '=' s tím, že ignoruje velikost písmen. Ještě v LIKE může být použit symbol '_' jako zástupný symbol jednoho znaku např.: '_est' bude dávat slova **test, Test, Lest**... ale už tam nemůže být výsledek **iTest**. Symboly '%' a '_' se dají kombinovat.)), BETWEEN((výsledek je v rozmezí dvou zadaných hodnot např 1, 10 je 1 až 10)) |
+^ Příznak nepovinné existence tagu ^| NULL (pokud není tento příznak nastaven, do tabulky budou vybrány jen řádky, které mají nastavenou alespoň nějakou hodnotu tagu, s tímto příznakem budou použity i řádky bez přiřazeného tagu) |
+====  ====
+Příklad části SQL dotazu s nastavenými příznaky:
 <code>
@@ Line 52: / Line 61: @@
 ===== Sloupce modulů CustomizedTable a SQLTable =====
-Vytváření seznamu je ve Statoru částeně společné pro oba moduly. Sloupce, které najdeme v nastavení CustomizedTable, je možné využít i v modulu SQLTable. Stačí dát poli v SQL dotazu alias se jménem uvedeným níže a výstup bude naformátován podle příkladu. Snadno tak vytvoříme uživateský seznam, která vypadá přesně ve stylu ostatních modulů Statoru.
+Vytváření seznamu je ve Statoru částečně společné pro oba moduly. Sloupce, které najdeme v nastavení CustomizedTable, je možné využít i v modulu SQLTable. Stačí dát poli v SQL dotazu alias se jménem uvedeným níže a výstup bude naformátován podle příkladu. Snadno tak vytvoříme uživatelský seznam, která vypadá přesně ve stylu ostatních modulů Statoru.
 ^Jméno^Implicitní zarovnání^Význam^Příklad naformátování obsahu sloupce ve výstupní tabulce^
-|ID|left|identifikační kód keše (zobrazeno jako kód s odkazem na listing keše)|[[user:skript:stator_modules|GC14WV8]]|
+|ID|left|identifikační kód keše (zobrazeno jako kód s odkazem na listing keše)|[[user:skript:stator:modules:stator-customtables|GC14WV8]]|
 |Type|left|typ keše (textově) |Traditional Cache|
 |Type icon|center|ikona typu keše|{{http://www.geocaching.com/images/wpttypes/sm/2.gif}}|
@@ Line 75: / Line 84: @@
 |Author|left|autor keše (údaj uvedený v listingu)|Pitris, adopted by D@ewo|
 |DateCreate|center|datum založení keše|4.8.2007|
-|Coordinates|left|souřadnice keše\\ <wrap important></wrap>v SELECTu je potřeba vybrat obě části souřadnic a jako oddělovač dát středník:\\ ''SELECT (x||";"||y) "Coordinates"
+|Coordinates|left|souřadnice keše\\ <wrap important></wrap>v SELECTu je potřeba vybrat obě části souřadnic, spojit je do jediné textové hodnoty a jako oddělovač dát středník:\\ ''SELECT (x||";"||y) "Coordinates"
 FROM geocache...''|N50°5.207' E014°25.065'|
 |Country|left|země, ve které keš leží|Czech Republic|
@@ Line 81: / Line 90: @@
 |Country flag, text|left|země - vlajka a název|{{http://www.geocaching.com/images/icons/flags/png/cz.png}} Czech Republic|
 |State|left|první úroveň správního členění (stát USA, kraj ČR, vojvodství Polska, ...)|Hlavní město Praha|
-|Cache info|left|informace o keši (ikona typu, kód, název a vlajka země)|{{http://www.geocaching.com/images/wpttypes/sm/2.gif}} [[user:skript:stator_modules|GC14WV8]] - Terezka {{http://www.geocaching.com/images/icons/flags/png/cz.png}}|
+|Cache info|left|informace o keši (ikona typu, kód, název a vlajka země)|{{http://www.geocaching.com/images/wpttypes/sm/2.gif}} [[user:skript:stator:modules:stator-customtables|GC14WV8]] - Terezka {{http://www.geocaching.com/images/icons/flags/png/cz.png}}|
 |Distance|right|vzdálenost ke keši od domácích souřadnic (v jednotkách uvedených v konfiguraci Statoru)|69,94|
-|Direction|right|azimut ke keši od domácích souřadnic|157 °|
+|Direction|right|azimut ke keši od domácích souřadnic|157°|
 |Direction icon|center|ikona směru ke keši od domácích souřadnic|{{http://www.geocaching.com/images/icons/compass/S.gif}}|
 |Found date|center|datum nálezu|14.12.2013|
@@ Line 103: / Line 112: @@
 <wrap tip> </wrap>Nadpisy sloupců lze definovat v souboru ''ColumnNames[_XX].ini''.
 ===== Dokumentace modulů Statoru =====
 {{topic>stator_modul}}