Scripter.exe

Pomocí tohoto nástroje si můžete vyhrát záznamy z vybrané tabulky. Výsledkem může být script, stream soubor nebo textový soubor. Tento výsledný script resp. soubor pak můžete následně zpracovat, např. obdobným způsobem vložením do data jiného spojení apod.

Kromě funkce pro vyhrání dat z tabulek nabízející se přímo v menu, můžete vytvářet a provádět libovolné své vlastní scripty, např. pro naplnění tabulek nějakými výchozími daty apod.

Tento nástroj je určen především servisním konzultantům a správcům systému. Běžný uživatel tento nástroj ke své práci nebude potřebovat.

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 Working storage v menu Storage, 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.

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.

Formát skriptu:

• řádky uvozené znaky // jsou chápány jako komentář a ignorovány
• makropříkazy začínají znakem # následovaným klíčovým slovem. Pokud není uvedeno jinak, musí být jednotlivé prvky makra odděleny jedním nebo více znaky mezera nebo "tabulátor". Řetězcové konstanty se zapisují přímo, ale pokud mají obsahovat mezery, musí být uzavřeny mezi dvojité uvozovky (").
• makro musí být celé zapsáno na jediném řádku.
• jakýkoliv text, který není komentář nebo makro, je chápán jako SQL příkaz nebo dávka dat pro SQL. Jednotlivé SQL příkazy musí být ukončeny terminální sekvencí definovanou pomocí makropříkazu #SET TERM.
• SQL příkazy, které obsahují znaky ":" jsou chápány jako dávkové SQL. Za takovým příkazem je očekávána dávka dat ve formátu SDF. Začátek dávky je vyznačen řádkem se znakem "\" a konec je vyznačen řádkem se znakem "/". Parametry pro dosazení hodnot z dávky dat musí být identifikovány pořadovým číslem hodnoty na řádku dat. Pokud se má zapsat hodnota NULL, je třeba data uvést jako deset nul ("0000000000") a do jména parametru doplnit podtržítko a koncovku ID, např.: "1_ID".

#SET TERM \\
CREATE TABLE POKUS
(ID CHAR(10),
KOD INTEGER,
NAZEV VARCHAR(30),
POZNAMKA VARCHAR(100))\\
#SET TERM ;
#COMMIT
INSERT INTO POKUS (ID,KOD,NAZEV,POZNAMKA) VALUES (:1, :2, :3, :4);
\
"1111111111",111,"Řádek č.1","Poznámka 1"
"2222222222",0,"Řádek č.2","Poznámka 2"
"3333333333",333,"Řádek č.3",""
/
#EXPORT TABLE POKUS TO STREAM pokus