UserCustomizationChecker.exe
Defaultně dodávaný exe soubor. Jedná se o nástroj určený pro vyhledání a kontrolu uživatelských výrazů a SQL dotazů zadaných v ABRA Gen.
Nástroj slouží na vyhledání a kontrolu uživatelských výrazů a SQL dotazů zadaných v ABRA Gen.
Je možné zvolit, jakou část ABRA Gen má nástroj prohledávat (např. Panely definovatelných údajů, Definovatelné sloupce v seznamech, Definovatelné formuláře, Skripty apod).
Nastavení, kde všude se budou uživatelské výrazy a SQL dotazy vyhledávat.
A dále, zda se mají vyhledávat a kontrolovat všechny uživatelské výrazy a SQL nebo pouze ty, jejichž obsah vyhovuje daným regulárním výrazům. Toto je ovlivněno zatržítkem Omezit vyhledávaní dle regulárních výrazů, pokud je zatrženo je možné je v dalším kroku zadávat. Ve výchozím nastavení se předvyplní výrazy se zaměřením na problematická místa z pohledu přechodu na verzi ABRA Gen s podporou Unicode, kdy mohou některé SQL a výrazy, které fungovaly na předchozích verzích, přestat zcela fungovat a bude je pravděpodobně potřeba upravit.
V tomto případě se jedná pouze o SQL či výrazy, které obsahují:
Firebird
- COLLATE
Oracle
- COALESCE
- CASE WHEN
- UNION
- StringFieldValue
MSSQL
-
COALESCE
-
UNION
-
StringFieldValue
-
Jestliže se v nich nachází "+" nebo "||"
Zadávání výrazů a jejich vyhodnocení probíhá takto:
Jsou prohledávány pouze části ABRA Gen zatržené v kroku Nastavení vyhledávání. A to dle zadaných výrazů na záložce Nastavení výrazů, která obsahuje tyto záložky:
Vše – tyto regulární výrazy se týkají všech prvků ABRA Gen v částech zatržených v předchozím kroku
QR výrazy – týká se pouze míst, kde se zadávají Výrazy – typicky místa, kde pro zadání SQL dotazu je potřeba použít funkci NxSQLSelect
Skripty – týká se pouze výrazů a SQL dotazů ve skriptech
SQL dotazy – týká se pouze míst, kde se zadává přímo SQL – typicky místa, kde pro zadání SQL dotazu není potřeba použít funkci NxSQLSelect
Mezi záložkami platí vztah AND a mezi řádky na jednotlivých záložkách OR.
V posledním kroku nástroje je zobrazen podrobný výsledek v podobě xml, případně je možné přepnout na zjednodušené zobrazení ve formátu csv.
Výsledky analyzovaných výrazů či SQL mohou nabývat několika stavů:
Nespuštěný (v xml >NotExecute<) - Výraz nebo SQL dotaz nebyl spuštěn. Standardně se týká všech skriptů, které se nástroj ani nepokouší spustit.
Bez chyby (v xml >Execute<) – Výraz nebo SQL dotaz byl spuštěn a prošel bez chyby.
S chybou (v xml >Error<) – Výraz nebo SQL dotaz byl spuštěn a vyskytla se u něj chyba.
Neznámý stav (v xml >Unknown<) – Okrajová situace, kdy se nepodaří zjistit stav kontroly.
Doporučujeme ve výsledcích vyhledat výrazy a SQL, jejichž kontrola neskončila stavem Bez chyby a tyto výrazy a SQL poté v ABRA Gen vyzkoušet a případně opravit.
Ve výsledcích je možné pomocí ctrl+F vyhledávat, nebo si výsledky uložit do souboru či schránky a přenést je do vhodnějšího editoru. V praxi lze na databázi Oracle hledat klíčové slovo chyby „ORA-„ a na MSSQL „collation conflict“.
Skripty, Tiskové sestavy, Definovatelné a B2B Exporty a část Definovatelných formulářů (Doplněk Tlačítka s akcemi) – nástroj nevyhodnocuje pouze vypisuje a případně omezuje jejich výpis dle zadaných regulárních výrazů.
V případě většího množství skriptů je doporučené spouštět jejich kontrolu kvůli větší přehlednosti výsledků samostatně. Skripty bez zdrojového kódu nebo Zakódované skripty nástroj nevyhodnocuje a přeskakuje je. Zakódované skripty doporučujeme před kontrolou Odkódovat.
Nástroj je též možné použít ke kontrole při přechodu mezi produkty ABRA Gen G3/G4/M4.
Od verze 22.1.6 je nástroj již součástí instalace ABRA Gen a lze jej najít v adresáři, kde je ABRA Gen instalován. Pro nižší verze je nástroj ke stažení samostatně níže.
Jelikož se jedná o jeden z nástrojů, které při neznalém použití mohou mít destruktivní následky nebo u nichž není žádoucí, aby s nimi pracoval běžný uživatel, je možno provedení některých jeho funkcí chránit bezpečnostním heslem.
Kontroluje se funkce OpenConnection v menu File, pro výběr spojení s databází.
Po vyvolání akce chráněné heslem program nejdříve zkontroluje, zda pro danou instalaci již bylo bezpečnostní heslo zadáno. Heslo je pro všechny chráněné nástroje společné. Pokud heslo dosud v dané instalaci nebylo zadáno v rámci spuštění některého z chráněných nástrojů či jeho chráněné funkce, program na tuto skutečnost upozorní a nabídne možnost jej zadat.
Zadání hesla není povinné, ale v každém případě jej doporučujeme využívat. Můžete tak předejít nežádoucím manipulacím např. ze strany neznalé osoby, které mohou pro váš systém mít i značně destruktivní následky.
Pokud bezpečnostní heslo pro spouštění nástrojů bylo v rámci spuštění některého z chráněných nástrojů v dané instalaci již zadáno, zobrazí se přihlašovací dialog do nástrojů, v němž se uživatel musí přihlásit zadáním bezpečnostního hesla. Po stisku OK se ověřuje jeho správnost. Nebylo-li heslo zadáno správně, program umožní uživateli opětovné zadání jména a hesla (např. pro případ překlepu). Pokud ani opakovaně není heslo zadáno správně, program danou akci neprovede (totéž po vyvolání Storna z přihlašovacího dialogu). Bylo-li přihlášení úspěšné, program pokračuje dál v příslušné akci.