FFS API - funkce a popis metasymbolů

Copyright (c) 2000 Mirek Janata

Co jsou metasymboly

Jednou z vůdčích myšlenek Freelance architektury je snaha o co největší pružnost, přizpůsobivost a zároveň přehlednost jednotlivých komponent projektu a tím i celé aplikace. Metasymboly představují jeden z nástrojů k dosažení tohoto cíle. Jsou to obecné symboly použitelné na definovaných místech aplikačních zdrojů. FFS tyto symboly kontextově nahrazuje konkrétními hodnotami.

Metasymboly mohou být použity v následujících oblastech aplikačních zdrojů

• Blok Menus v popisovači aplikačních zdrojů ( viz Freelance Control Master )
• WTX šablony, tedy popisovače editačních tabulek
• WFX šablony, tedy popisovače editačních formulářů

Následující odstavce podrobněji popisují význam a možné využití jednotlivých metasymbolů.

Seznam metasymbolů - množina PUBLIC

::(application) jméno FastX aplikace

::(database) jméno připojené databáze

::(DATABASE) jméno připojené databáze převedené na velká písmena

::(user) jméno přihlášeného uživatele

::(date) aktuální datum

::(time) aktuální datum a čas

::(year) aktuální rok

::(form.<jméno položky>)hodnota jmenovaná položka v aktivním formuláři

::(form.<jméno edit. tabulky>.<jméno položky>)

hodnota jmenovaného sloupce v jmenované tabulce aktivního formuláře

@@PAR(<jméno parametru>)

hodnota jmenovaného aplikačního parametru

@@DBPAR(<jméno parametru>)

hodnota jmenovaného databázového parametru

Seznam metasymbolů - blok Menus v aplikačních zdrojích (<appname>.xre)

Položka variant

Celá množina PUBLIC

Seznam metasymbolů - cBrowse ( WTX soubor )

Položky <sloupec>|default, < sloupec >|related i < sloupec >|relation

Celá množina PUBLIC

< sloupec >|related, < sloupec >|relation a položka wroInfo:

::(value) hodnota právě validované položky

::(<jméno sloupce>) hodnota jmenovaného sloupce

::(this.<jméno položky>)hodnota jmenovaná položka ve formuláři, jenž je vlastníkem objektu

::(this.<jméno edit. tabulky>.<jméno položky>)

hodnota jmenovaného sloupce v jmenované tabulce formuláře, jenž je vlastníkem objektu

Položka select ( SQL příkaz pro čtení dat )

@@STR(<jméno sloupce>) je nahrazen odpovídajícím textem z bloku strings

@@(servertype) je nahrazen kódem typu databázového serveru

@@(<jméno parametru>) je nahrazen hodnotou parametru z příkazové řádky

Seznam metasymbolů - cForm, cWFXForm ( WFX soubor )

Položky <sloupec>|default, < sloupec >|related , < sloupec >|relation a saveCommand (příkaz zápis dat )

Celá množina PUBLIC

< sloupec >|related , < sloupec >|relation:

::(value) hodnota právě validované položky

::(<jméno ovl. prvku>) hodnota jmenovaného ovládacího prvku

::(this.<jméno položky>)hodnota jmenovaná položka ve formuláři, jenž je vlastníkem objektu

::(this.<jméno edit. tabulky>.<jméno položky>)

hodnota jmenovaného sloupce v jmenované tabulce formuláře, jenž je vlastníkem objektu