DynSQLEditor.exe

Defaultně dodávaný exe soubor. Jedná se o nástroj určený pro editaci dynamických SQL dotazů.

Tento nástroj je určen především servisním konzultantům a správcům systému. Pomocí něho mohou v případě požadavků klientů definovat uživatelské SQL dotazy (např. v případě, že definují uživatelské reporty, ve kterých potřebují z databáze načíst taková data, která se pomocí dodávaných DynSQL nenačítají apod.). Běžný uživatel tento nástroj ke své práci nebude potřebovat. Jelikož se jedná o nástroj, který při neznalém použití může mít destruktivní následky, stejně jako je tomu u některých dalších nástrojů, je možno přístup do některých jeho funkcí chránit bezpečnostním heslem, viz dále.

Režimy práce s aplikací

Nástroj umožňuje práci z příkazové řádky i prostřednictvím grafického rozhraní. Ve kterém režimu se aplikace spustí závisí na použitých parametrech příkazové řádky. Možnosti:

DynSQLEditor.exe

Spuštění aplikace bez parametrů vyvolá interaktivní grafický režim.

DynSQLEditor.exe <název_souboru>

Spuštění aplikace s jediným parametrem, kterým je název existujícího souboru, vyvolá interaktivní grafický režim a otevření obsahu specifikovaného souboru (předpokládá se, že obsahuje DynSQL definice).

DynSQLEditor.exe /?

Spuštění aplikace s parametrem /? zobrazí informační dialogové okno se seznamem podporovaných parametrů, po jehož zavření se aplikace ukončí.

DynSQLEditor.exe <název_souboru> [/s<heslo>/x<soubor>|/y<soubor>|/r|/d|/n|/u<soubor>]

Spuštění aplikace s jinými parametry (seznam viz DynSQLEditor.exe /?) vyvolá řádkový režim.

DynSQLEditor.exe <název_souboru> [/s<heslo>/x<soubor>|/y<soubor>|/r|/d|/n|/u<soubor>]

Spuštění aplikace s jinými parametry (seznam viz DynSQLEditor.exe /?) vyvolá řádkový režim.

Pokud je pro danou instalaci zadáno bezpečnostní heslo a v řádkovém režimu je požadováno provedení operace, která bezpečnostní heslo vyžaduje, je zapotřebí v příkazové řádce heslo specifikovat (parametrem /S), jinak aplikace vypíše chybu a ukončí se.

DynSQLEditor.exe d:\repo.txt /r

DynSQLEditor - command line tool
FLORES [8.03.01 release cs-CZ]

Export dat repozitoře
----------------------
Parametr: /r
Soubor: d:\repo.txt

Okno Zabezpečení přístupu (TNxPasswordDialog) nelze modálně zobrazit
CHYBA: Exit Code 1

Dynamické SQL jsou v centrální repozitoři. Tato část repozitoře je součástí zálohy dat.

Následný popis slouží jen pro základní orientaci v nástroji, kterou možná budete potřebovat, pokud se rozhodnete definovat některé vlastní tiskové sestavy. Není vyčerpávajícím popisem nástroje, jelikož tento není určen uživatelům pro běžnou práci.

Definici DynSQL tvoří:

• Dynamický SQL příkaz - skládá se minimálně z:
  • Datových zdrojů - definice jednotlivých Datových zdrojů a jejich vazeb (např. typu hlavička - řádky)
  • Podmínek - definice struktury podmínek (pro omezování)
  • Klíčů - definice struktury podmínek (pro třídění)
  • vazby na objekt Controller - objekt implementující specifické chování editoru podmínek
• Místo v programu - umožňují spojit určité místo v kódu programu a DynSQL definici
• Reportovací skupina - sdružuje Místa v programu do skupin, jejichž nabídka se zobrazuje ve speciální agendě reportů
• DynSQL Šablona - šablony pro opakované použití definic podmínek

Na všech záložkách je možné si zobrazené záznamy filtrovat podle toho, zda jde o záznamy dodávané výrobcem či definované uživatelem. K tomu slouží omezovací panel v horní části záložky:

• Všechny
• Jen uživatelské
• Jen systémové

Tato filtrace je synchronizovaná pro všechny další záložky, takže stačí přepnout filtr pouze na jedné z nich.

Určení lokalizace:

Datové zdroje, datasety, podmínky, rozšířené fieldy a klíče pro řazení mají mj. vlastnost Lokalizace. Pokud je vyplněna (CZ, SK...), bude daný objekt k dispozici pouze v patřičné národní verzi.

Od výrobce uživatelé dostávají pouze DynSQL atd., které mají nastavenou lokalizaci jazyka příslušné národní verze, a dále ty, které mají prázdnou lokalizaci.

Pro uživatele nemá položka význam a nechá ji prázdnou. Položka má význam pro výrobce pro tvorbu více národních DynSQL atd. ve zdrojovém formátu txt.

Dynamické SQL

Okno má několik částí:

• Dynamické SQL
• Subzáložka Datasety
  • Datové zdroje příkazu
  • Datové položky zdroje dat
• Subzáložka Podmínky
• Subzáložka Klíče

Část Dynamické SQL

Seznam všech nadefinovaných DynSQL. Pod seznamem SQL příkazů se pro aktuální SQL příkaz zobrazuje ID příkazu, Název příkazu, Controller, určení lokalizace a informace o tom, zda jde o příkaz Systémový. Systémové SQL příkazy jsou dodávány výrobcem a nelze je editovat ani mazat a je omezeno i jejich prohlížení.

Seznam SQL příkazů lze třídit dle názvu nebo ID (nastavení třídění přes lokální nabídku menu).

Podrobný popis dodávaných dynamických SQL dotazů viz popis Struktur a definic F1Doc.chm.

Funkce, které jsou k dispozici:

Subzáložka Datasety

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ů:

• Pokud je v rámci SQL příkazu třeba provádět řazení za položku obsaženou v několika spojených selectech (UNION ALL), je třeba takovou položku definovat zvlášť, např. jako datovou položku zdroje dat (čímž se stane jednoznačnou součástí výčtu, který je v definici zastoupen klíčovým slovem {FIELDS}).

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.

Subzáložka Podmínky

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

Subzáložka Klíče

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íčů)

Místa v programu

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

Okno má dvě části:

• Seznam míst v programu
• Seznam dynamických SQL

Seznam míst v programu

Seznam míst v programu dodávaných výrobcem. Každé programové místo pak může mít přiřazeno jeden nebo více dynamických SQL. Pod seznamem programových míst se pro aktuální programové místo zobrazuje ID místa, Název místa, určení lokalizace a informace o tom, zda jde o progr. místo Systémové. Systémové jsou dodávány výrobcem a nelze je editovat ani mazat.

Seznam programových míst lze třídit dle názvu nebo ID (nastavení třídění přes lokální nabídku menu).

Podrobný popis dodávaných programových míst viz popis Struktur a definic F1Doc.chm.

Funkce, které jsou k dispozici:

Seznam dynamických SQL

Ke každému programovému místu se v této části okna zobrazují přiřazené dynamické SQL z části Dynamické SQL. Každé programové místo může mít i více dynamických SQL. Grafickými značkami S a U je odlišeno, zda vazba na SQL je systémová nebo uživatelská (přidána uživatelem). Programová místa se využívají pro definici tiskových sestav pro dané místo programu (definice sestavy má vazbu na dynamický zdroj dat (DynSQL), který je přiřazen k danému programovému místu). Tedy v definici vlastností každé tiskové sestavy se vybírá, ze zdrojů dat (DynSQL), které jsou k danému programovému místu přiřazeny a které pak budou zdrojem dat pro danou tisk. sestavu.

Příklad definice vazeb programového místa na dynamické SQL

Funkce, které jsou k dispozici:

Reportingové skupiny

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

Okno má dvě části:

• Seznam reportingových skupin
• Seznam míst v programu

Seznam reportingových skupin

Seznam reportingových skupin dodávaných výrobcem. Slouží pro sdružení programových míst (v programu pak agendy typu Reporty, např. fakturační reporty, skladové reporty apod.). Pod seznamem reportingových skupin se pro aktuální report. skupinu zobrazuje ID skupiny, Název skupiny, určení lokalizace a informace o tom, zda jde o reportingovou skupinu Systémovou. Systémové jsou dodávány výrobcem a nelze je editovat ani mazat.

Seznam reportingových skupin lze třídit dle názvu nebo ID (nastavení třídění přes lokální nabídku menu).

Podrobný popis dodávaných reportingových skupin viz popis Struktur a definic F1Doc.chm.

Funkce, které jsou k dispozici:

Seznam míst v programu

Ke každé reportingové skupině se v této části okna zobrazují přiřazená programová místa z části Programová místa. Každá reportingová skupina může mít i více přiřazených programových míst. Grafickými značkami S a U je odlišeno, zda vazba na programové místo je systémová nebo uživatelská (přidána uživatelem).

Příklad definice vazeb reportingové skupiny na programová místa

Funkce, které jsou k dispozici:

Šablony

Slouží pro definici podmínek. Definice podmínek se pak na šablony odkazují. Umožňují opakované použití definic podmínek.

Funkce

Vybrané funkce, které jsou v DynSQL dále k dispozici:

Toto řešení podporuje ukládání a načítání uživatelských vazeb mezi definicí DynSQL a ProgPointy a mezi ProgPointy a Reportingovými skupinami.

Volání DynSQLEditoru s parametry

Kroky 6) až 8) z předchozího příkladu je možno zautomatizovat zavoláním DynSQLEditoru s parametry. K dispozici je řádkový parametr /u nebo -u, za nímž musí následovat název souboru typu .xdl.

start /w DynSQLEditor.exe - -u C:\nexus\pokus.xdl