fdev_tm

FD TableMaster

Co je TableMaster

TableMaster, dále TM, je subsystém sloužící k tvorbě a údržbě tabulkových editorů ( jinak též WTX objektů ). Zahrnuje tři základní funkce: editace, prohlížení a editor rozšiřujících X modulů.

TableMaster - editace

Po aktivaci volby TableMaster/ Editace se otevře formulář TableDesigner, dále TD. Jeho vzhled je patrný z úvodního obrázku, kde je zároveň otevřeno popup menu s nabídkou funkcí. Toto menu se otevírá, stejně jako ostatní popup menu, klepnutím pravého tlačítka myši na plochu tabulky. Dále popíšeme jednotlivé funkce:

Inicializovat z databázové tabulky: tato volba otevře dialog pro zadání jména databázové tabulky:

Po vyplnění jména a potvrzení tlačítkem Ok se automaticky vytvoří základní definice včetně sloupců a SQL příkazů. Tato vlastnost významně zrychluje návrh a implementaci tabulky. Vzhledem k tomu, že FastX SQL drivery neposkytují naprosto vyčerpávající informace o struktuře databáze, je potřeba definice DML příkazů UPDATE, DELETE upravit vzhledem k primárnímu klíči. TableDesigner implicitně nastavuje nesplnitelnou podmínku ... WHERE 1=2, aby předešel případným katastrofám spojeným s použitím nesprávně definované výběrové podmínky. Po načtení vzniklé definice může tabulka vypadat třeba takto:

Načíst existující WTX zdroj je volba, která zpřístupňuje editaci již existujících editačních tabulek. Její aktivace otevře dialogové okno s nabídkou existujících zdrojů. Po potvrzení se z vybraného zdroje načte definice tabulky podobně jako v předchozím případě.

Přejmenovat je volba vhodná pro vytváření nových tabulkových editorů na základě již existujících.

Uložit definici pod jménem je volba, která otevře dialog se jmény existujících zdrojů. Po zvolení jména a potvrzení je tento zdroj uložen. Pod stávajícím jménem definici uloží tlačítko Ok na nástrojové liště.

Přidat sloupec a Odebrat sloupec jsou volby podporující změnu struktury tabulky z hlediska sloupců.

Vlastnosti sloupce definuje následující dialog:

Záložka Sloupec tabulky definuje základní atributy sloupce: jméno, titulek, atd. Atribut Implicitní hodnota definuje hodnotu sloupce automaticky vloženou na novém řádku. Implicitní hodnota může obsahovat metasymboly. Atribut Editace povolena může nabývat hodnot Yes/ No/ New row. Atribut Seznam hodnot definuje rychlou nabídku možných hodnot sloupce. Hodnoty jsou odděleny znakem ~ (tilda).Tato nabídla se při editaci sloupce objeví v popup menu. V součinnosti se seznamem hodnot lze definovat seznam datových hodnot. Je-li neprázdný, musí obsahovat stejný počet položek oddělených tildou. Jednotlivé položky obou seznamů si potom navzájem odpovídají. Do databáze se ukládají položky ze seznamu datových hodnot a v tabulce se zobrazují položky z horního seznamu hodnot. Ordinální číslo je pořadí sloupce v SQL příkazech. Mají-li být například do daného sloupce čteny hodnoty v pořadí třetího výrazu SELECT příkazu, bude ordinální číslo rovno třem. Ordinální číslo však zároveň může identifikovat databázový sloupec v některém z INSERT/UPDATE/DELETE příkazů, ve kterých participuje. Označuje totiž číslo parametru příkazu, který má být nahrazen hodnotou tohoto sloupce.
Máme-li sadu příkazů ( viz Vlastnosti tabulky ):

SELECT ID,NAME,STREET,ROWID FROM CUSTOMERS
INSERT INTO CUSTOMERS (ID,NAME,STREET) VALUES (:1,:2,:3)
UPDATE CUSTOMERS SET NAME=:2,STREET=:3 WHERE ROWID=:4
DELETE FROM WHERE ROWID=:4

( a zároveň platí, že sloupec ROWID je unikátní v celé tabulce ), pak tabulkový sloupec s ordinálním číslem 1 bude pracovat s databázovým sloupcem ID. Měl by mít aktivovánu vazbu na INSERT, případně UPDATE, není-li primárním klíčem, což sloupce podobných jmen zpravidla bývají. Vazbu na UPDATE mohou mít všechny sloupce s výjimkou primárního klíče a databázových sloupců typu IDENTITY anebo ROWID. Vazbu na DELETE má zásadně buď primární klíč anebo sloupce typu IDENTITY anebo ROWID.

Záložka SQL validace a připojená nabídka vypadá takto:

Atribut WTX nabídka definuje jméno WTX zdroje, který lze při editaci tohoto sloupce otevřít z nástrojové lišty ( tlačítko Nabídka ). Pořadí sloupce v nabídce identifikuje sloupec, jehož hodnota se má při potvrzení výběru z nabídky použít. Lze tedy jednoduše implementovat editaci typu: vyplňuji hlavičku faktury, editační pole partner, stisknu klávesu F2 ( horká klávesa pro nabídku ), otevře se tabulka se seznamem partnerů, vyberu si některého a tlačítkem Ok ( Enter ) volbu potvrdím. Implicitní podmínka (SQL) se uplatní, je-li definována, na otevíranou nabídku. Lze tak například kontextově zúžit výběr. Foreign key tabulka, dále fkt, může obsahovat jméno SQL tabulky, ve které se má hledat ve sloupci - atribut Jméno sloupce - zadaná hodnota. Na výše uvedeném obrázku se shoduje fkt se jménem WTX nabídky. Je třeba zdůraznit, že se jedná o pouhou shodu jmen. Atributy Načíst též hodnoty sloupců... a Zapsat hodnoty do polí... mohou obsahovat jména dalších sloupců, jejichž hodnoty mají být z foreign key tabulky přečteny, a jména sloupců v editační tabulce, do nichž mají být tyto hodnoty zapsány. Typickým příkladem je opět validace zákazníka: po zadání kódu a odchodu na další sloupec se vyvolá na základě definice z předchozího obrázku SQL příkaz:

SELECT CUSTID,NAME,STREET FROM CUSTOMERS WHERE CUSTID='<hodnota>'

Pokud je příkaz úspěšný, zapíší se do tabulkových sloupců NAME, STREET hodnoty přečtené z databáze. V opačném případě je hlášena chyba a editace sloupce pokračuje.

Vlastnosti tabulky definuje následující dialog:

Přejít na Freelance Developer Home FDK Home