DynSQLEditor.exe

Výklad pojmu viz Reportingová skupina, ProgPoint, DynSQL, dataset - výklad.

Subzáložka Datasety má opět 2 základní části:

• Datové zdroje příkazu
• Datové položky zdroje dat

Datové zdroje příkazu

Ke každému DynSQL se v této části okna zobrazují (resp. definují) datové zdroje příkazu, tzv. datasety. Každý SQL příkaz má minimálně jeden dataset s názvem MAIN, může však mít i další datasety. Ke každému datasetu se v pravé části okna zobrazuje jeho Název, Popiska a konkrétní definice příslušného SQL dotazu:

SQL "Faktury vydané" má několik datasetů (hlavička, řádky, účetní deník, zálohy, šarže,...), zobrazená syntaxe SQLdotazu patří k aktuálnímu datasetu Rows

Pod definicí SQL dotazu pak informace o určení lokalizace a o nadřízeném datasetu. Např. pro řádky faktury (dataset ROWS) je nadřízeným datasetem MAIN, pro šarže/sériová čísla zadávaná v řádcích faktury (dataset BATCHES) je pak nadřízeným datasetem dataset ROWS :

Zadání nadřízeného datasetu. Příklad, kdy dataset ROWS z předchozího obrázku má nadřízený dataset MAIN

Poznámky k vlastnímu psaní dotazů:

Datové položky zdroje dat

V této části okna jsou pak k aktuálnímu zdroji dat - datasetu (z předchozí části okna) uvedeny datové položky zdroje dat. Tyto datové položky pak budou mj. k dispozici jako datové položky objektu např. při vkládání položek z databáze do tiskových sestav, v editoru výrazů v definici tiskových sestav apod.

Datovými položkami datasetu jsou:

• všechny položky definované přes aliasy přímo z tabulek připojených v SQL příkazu
• další rozšířené položky

Položky definované přes aliasy

Obsahuje seznam aliasů pro položky definované přes aliasy na odpovídající objekty pro tabulku, ze které se vybírá, a pro tabulky připojené v definici SQL pomocí příkazu "JOIN". Objasníme na příkladu:

SELECT {FIELDS} FROM IssuedInvoices A
LEFT JOIN Firms F ON F.ID=A.Firm_ID
....atd.

Příklad aliasu na objekt TNxStoreCard v datasetu MAIN v SQL příkazu Skladové šarže

Každý alias má mj. definován prefix a popis. Prefix slouží ke konstrukci jména položky z připojené tabulky a popisek pak ke konstrukci jejího názvu zobrazovaného např. v seznamu datových položek objektu. Objasníme na příkladu:

Pro každý alias lze též definovat JOIN klauzuli a v SQL příkazu pak jen použít element {JOIN}. Pro element {JOIN} platí: Relace mezi JOIN klauzulemi pracuje rekurzivně a to tak, aby JOIN fragment, jehož alias je použit v jiném JOIN fragmentu, byl umístěn před tímto JOIN fragmentem.

A ServiceAssemblyForms
DQ DocQueues - JOIN DocQueues DQ ON DQ.ID=SDC.DocQueue_ID
SDC ServiceDocuments - JOIN ServiceDocuments SDC ON SDC.ID=A.ServiceDocument_ID

SELECT ....
From ServiceAssemblyForms
JOIN ServiceDocuments SDC ON SDC.ID=A.ServiceDocument_ID
JOIN DocQueues DQ ON DQ.ID=SDC.DocQueue_ID

Rozšířené položky

Kromě položek čerpaných z objektových položek připojených tabulek přes aliasy lze nadefinovat libovolné další položky v části Rozšířené fieldy:

Seznam nadefinovaných rozšířených položek v datasetu MAIN v SQL příkazu Faktury vydané

K aktuální rozšířené položce se zobrazuje (resp. definuje) její SQL výraz, SQL název položky (alias), Popiska pro zobrazení, Velikost, Datový typ a Packed CLSID:

Příklad definice aktuální rozšířené položky z předchozího obrázku

Každá rozšířená položka má mj. definován alias a popisku pro zobrazení. Alias je pak jméno dané položky a popisek její název zobrazovaný např. v seznamu datových položek objektu. Objasníme na příkladu:

Dále je k dispozici položka pro určení lokalizace.

Zde se zobrazují (resp. definují) podmínky, podle kterých lze daný SQL dotaz podmínkovat, tj. data filtrovat (nadefinované podmínky jsou pak k dispozici jako prvky, podle nichž lze v dané agendě omezovat (typicky v záložkách Omezení)).

V pravé části je pak zobrazena definice dané podmínky. Aby nebylo nutné definice podmínek vypisovat opakovaně pro každou zvlášť, může mít podmínka odkaz na šablonu, kde je podmínka definována. Dále jsou definovány vlastnosti podmínky, např. zda lze vybírat jednu hodnotu, či více označených, zde je pro podmínku dostupné vyhledávání včetně nevyplněných apod. Dále je k dispozici položka pro určení lokalizace. V dolní části subzáložky Podmínky se pak tato zobrazuje jako Fragment SQL příkazu.

Subzáložky obsahující SQL fragment jsou zvýrazněny hvězdičkou:

Příklad zvýraznění záložek hvězdičkou

Na subzáložce Speciální parametry se uvádí parametry pro použití dané podmínky. K některým parametrům:

• pro nastavení omezení za chráněné objekty - SecurityWithNull, SecurityMask, ObjectSecurityMask nebo SecurityMask, DynSQLSecurityMask nebo SecurityMask - Viz popis viz kap. Definovatelné položky - záložka Detail - datový typ Znaky - číselníková položka a její parametry.
• pro negování podmínek - ForceSupportNegation - typu Boolean. V případě, že bude parametr v podmínce uveden, bude negování podmínky povoleno/zakázáno bez ohledu na generická pravidla. Viz popis Inverze výběru.
• pro nastavení povinně zadávané podmínky - AlwaysUsed
• pro označení podmínky jen pro určitou lokalizaci - ForLocalization
• pro malá/velká písmena, divoké znaky - ConvertWildChars, IgnoreCase
• pro rozšířenou syntaxi hledání -
  • FulltextAllow=True - zobrazí zatržítko umožňující zadat u obyčejné text. podmínky, aby se zpracovala dále uvedeným způsobem
  • FulltextOn=True - výše zmíněné zatržítko rovnou zatrhne
  • FulltextEscapeChar=/ - escape znak, potlačuje ve fulltext syntaxi význam speciálních znaků (defaultně není žádný)
  • FulltextPhraseChar=" - cokoliv uzavřené v těchto znacích se ve fulltext syntaxi bere jako běžný nedělitelný text (defaultně jsou ")

Pokud je fulltext možnost aktivní, pak se podmínka zadaná uživatelem rozdělí na jednotlivé výrazy a každý výraz zvlášť je vložen do WHERE fragmentu této podmínky (na místo parametru {:VALUE}), a jednotlivé takto získané části jsou spojeny operátory které uživatel použil mezi výrazy (viz níže).

fragment: <<A.Subject>> like {:VALUE}
uživatelem zadaná podmínka: kočka OR pes
výsledek: (<<A.Subject>> like 'kočka' OR <<A.Subject>> like 'pes')

Pokud z nějakého důvodu není žádoucí opakovat celý WHERE fragment, opakující část se uzavře mezi značky /*FULLTEXT*/:

fragment: něco na začátku /*FULLTEXT*/<<A.Subject>> like {:VALUE} /*FULLTEXT*/ a něco na konci
uživatelem zadaná podmínka: kočka OR pes
výsledek: něco na začátku (<<A.Subject>> like 'kočka' OR <<A.Subject>> like 'pes') a něco na konci

Nadefinované klíče lze pak použít k nastavení třídění u jednotlivých agend, tj.:

• u dokladových agend pro třídění v záložkách Seznam (viz možnost zvolit si třídění na záložkách Omezení resp. Seznam (viz seznam klíčů ke třídění v seznamech dokladových agend)), nebo pro nastavení třídění v agendách typu "Reporty..." (viz např. Reporty nákupu, ...), kde je v kroku typu "Zadání omezení..." obdobný prvek pro nastavení Třídění jako na záložkách Omezení dokladových agend) případně pro nastavení vlastního třídění přímo v tiskové sestavě (viz klíče nabízené ke třídění v položce Vlastní třídění v definici tisk. sestavy)
• u číselníkových agend pro nastavení třídění v agendách typu "Reporty..." (viz např. Reporty ceníků, ...) případně pro nastavení vlastního třídění přímo v tiskové sestavě

  U číselníků se klíče definované zde nevyužívají pro třídění v záložkách Seznam, jelikož se s číselníky pracuje jiným způsobem. Více viz Načítání dat do paměti, SQL dotazy, třídění a Třídění v číselnících.

Každý klíč má kromě svého identifikátoru, Popisky, odkazu na Šablonu a položky pro určení lokalizace definován zdroj dat.

Je-li zatrženo "Skrytý", pak se daný klíč nenabízí v dané agendě mezi ostatními klíči k výběru třídění. Pokud DynSQL dané agendy neobsahuje žádné klíče pro třídění nebo jsou všechny skryté, pak se možnost volby třídění v dané agendě ani nenabízí. Viz např. DynSQL pro agendu Účetní deník - souvztažně versus absence třídění v záložce Omezení v Účetním deníku - souvztažně.

Je-li zatrženo "Vybírat pouze jeden klíč", pak bude možný výběr pouze jednoho z nadefinovaných klíčů a výběr klíčů pro třídění v daném místě programu se bude nabízet formou skrytého seznamu (viz Třídění s výběrem pouze jednoho klíče). Viz např. třídění v záložce Omezení v Účetních žádostech.

Příklad klíčů nadefinovaných v datasetu MAIN v SQL příkazu Ceníky-vybrané ceny. V závorce jsou uvedeny zdroje dat jednotlivých klíčů)