Typ cxd:row-tool|cxd:preview-tool
Uzel popisující jeden dílčí nástroj vztahující se k jedné položce tabulky, zpravidla umisťovaný na konci řádku či pod náhledem (např. otevřít formuář či náhled).
Základní typ(y) uzlu(ů): itemToolElmType; gridToolType; (řazeno od přímých po obecné).
<cxd:row-tool|cxd:preview-tool
name="{string}"
type="new|edit|preview|folder|download|action|event"
action-name="{string}"
document-type="{string}"
select-view-type="true|false"
preview-method="{string}"
source-id="{number/xsd:integer}"
condition="true|false"
folder-id="{number/xsd:positiveInteger}"
event-value="{string}"
icon="{string}"
availability="menu|button|table-menu|table-button|button|table-menu|button|table-button|menu|table-menu|menu|table-button"
>
<cxd:param ... /> *
<cxd:confirm ... /> *
<cxd:success ... /> *
<cxd:edit-options ... /> !
<cxd:error ... /> *
<cxd:row-properties ... /> ?
</cxd:row-tool|cxd:preview-tool>
Prvek cxd:t28-itemToolElmType se nachází ve jmenném prostoru http://www.flexideo.com/comex/definition.
Atributy
name - Technický název nástroje jedinečný v rámci všech nástrojů řádku, náhledu na řádek i tabulky.; Speciální název, jež může sloužit jako systémová hodnota, název funkce či akce apod.; CamelCasingName - název umožňující malé i velké znaky anglické abecedy, číslice uprostřed a nakonci a podtržítka.(typ: string) TYP HODNOTY: string (string);
type - Základní typologie nástrojů umožňující sloužící např. pro identifikaci a zobrazení odpovídajícího ovladače.(typ: string)
TYP HODNOTY: string (string);
Možnosti obsahu:
» new ~ Tabulkový typ nástroje sloužící pro otevření formuláře pro přidání nové položky do tabulky. Pro otevření nutno ověřit volitelnou vlastnost form-type, není-li uvedena, je použit formulář dle typu tabulky.
» edit ~ Řádkový typ nástroje umožňující otevřít položku ve formuláři. Pro otevření nutno ověřit volitelnou vlastnost form-type, není-li uvedena, je použit formulář dle typu položky.
» preview ~ Zobrazení tiskového náhledu na položku či tabulku dle toho, zda je o řádkový či tabulkový nástroj.
» folder ~ Řádkový nástroj sloužící pro otevření složky vybraného řádku ve formě seznamu pod-tabulek a pod-složek s případným přesměrováním na otevření výchozí, je-li zvolena. Případně je otevírána přímo podtabulka uvedená ve vlasnosti folder-id u nástroje.
» download ~ Nástroj pro export celé tabulky do souboru v tabulkovém formátu (např. pro MS Excel) následně určený ke stažení.
» action ~ Spuštění SOAP akce, kde je jako vstup předán pdk-list jedné položky řádku nebo vybraných položek celé tabulky, pokud jde o tabulkový nástroj. Název spouštěné akce je určen pomocným atributem action-name
» event ~ Použití nástroje povede k vyvolání události "itemEvent" nebo "tableEvent" dle povahy nástroje. který ji vyvolal. Na událost je obecně možné vázat aktivity pomocí uzlu cxd:connextion u každé komponenty. Vyvolání události je možné doprovodit volitelnou řetězcovou hodnotou uvedenou v event-value.
action-name - Název SOAP akce dle registru akcí. Je uváděn pouze v případě nástroje typu action a je v tomto případě povinný.; Systémový název segmentu, nástroje nebo jeho části. Název většinou slouží jako jednoznačný identifikátor na větvi v určité hierarchii.; Může začínat pouze znakem malé anglické abecedy nebo podtržítka. Na jiné než první pozici se mohou též vyskytovat číslice.(typ: string) TYP HODNOTY: string (string);
document-type - Volitelný název dokumentového typu, většinou pohledového, jehož formulář či tisková šablona má být použita pro přidání, editaci či náhled položky tabulky.; Systémový název segmentu, nástroje nebo jeho části. Název většinou slouží jako jednoznačný identifikátor na větvi v určité hierarchii.; Může začínat pouze znakem malé anglické abecedy nebo podtržítka. Na jiné než první pozici se mohou též vyskytovat číslice.(typ: string) TYP HODNOTY: string (string);
select-view-type - Volba se vztahuje k tabulkovému nástroji pro přidání nové položky. V případě nastavení této volby na hodnotu true je třeba před otevřením formuláře nové položky vybrat z nabídky pohledových typů typu výchozího danéh tabulkou.; [SYNTAX: true | false; Neuvedení nebo hodnota false znamenají zpravidla totéž.](typ: boolean) TYP HODNOTY: boolean (xsd:string); (možnosti obsahu: true | false)
preview-method - Volitelné - obsahuje klíčové slovo "[select]" (vč. hranatých závorek) pro vyvolání výběru z nabídky nebo název metody zobrazení, ke kterému je v comex definici v rozsahu preview přiřazena XSL šablona (jméno souboru). Při nenastavení tohoto atributu s metodou se použije první dostupná metoda dle definice v rozsahu preview a její šablona.(typ: string) TYP HODNOTY: string (string);
source-id - Pomocný atribut obsahující XDS id výběrového uzlu, který má být při otevření prázdného formuláře předvyplněn dle dodaného klíč v url (inext). Vyskytuje se u tabulkového přidávajícího nástroje dokumentu.; Osmimístné celočíselné id jednoznačně identifikující daný uzel jako segment informačního systému mezi všemi ostatními segmenty (dokumenty, oblastmi a prvky).(typ: number) TYP HODNOTY: number (xsd:integer);
condition - Nastavení řádkového nástroje, kdy se dle této volby indikuje podmíněnost zobrazení nástroje na řádku. Vlastní zobrazení se pak řídí výskytem atributu tool-{$name} na datovém řadku položky.; [SYNTAX: true | false; Neuvedení nebo hodnota false znamenají zpravidla totéž.](typ: boolean) TYP HODNOTY: boolean (xsd:string); (možnosti obsahu: true | false)
folder-id - Pro nástroj typu folder vlastnost folder-id může (ale nemusí) specifikovat id složky (podtabulky), která má být nástrojem otevřena. Není-li uvedeno, je otevřena složka položky nebo případně rovnou některá podtabulka, je-li označena jako výchozí. Vlastnost folder-id má ale přednost.; Celočíselný identifikátor nástroje generovaný databází nebo identifikátor části daného nástroje. Nejde o primární klíč. Minimální hodnota je 1000, maximální je menší než min. xds-id (10000000).(typ: number) TYP HODNOTY: number (xsd:positiveInteger);
event-value - Volitelná řetězcová hodnota předávaná do události typu "itemEvent" nebo "tableEvent" vyvolané nástrojem typu event řádku či tabulky.(typ: string) TYP HODNOTY: string (string);
icon - Volitelný název souboru ikony, není-li uveden dostává nástroj standardní ikonu dle svého typu.; Název systémového souboru flexideo, vyžadující použití znaků angl. abecedy, číslic, podtržítek a pomlček pro název, pak obsahuje tečku a příponu složenou pouze ze znaků abecedy a příp. číslic.(typ: string) TYP HODNOTY: string (string);
availability - Volitelný atribut řídící dostupnost nástroje jako tlačítka či menu na řádku a nebo pod tabulkou pro hromadné operace.(typ: string)
TYP HODNOTY: string (string);
Možnosti obsahu:
» menu ~ Nástroj je dostupný pouze jako volba menu přímo na položce.
» button ~ Nástroj je dostupný pouze jako položka tlačítko přímo na položce.
» table-menu ~ Nástroj je dostupný pouze jako volba menu pod tabulkou (možné jen pro nástroje typu akce).
» table-button ~ Nástroj je dostupný pouze jako tlačítko pod tabulkou (možné jen pro nástroje typu akce).
» button|table-menu ~ Nástroj je dostupný jako tlačítko na položce a jako volba menu pod tabulkou (možné jen pro nástroje typu akce).
» button|table-button ~ Nástroj je dostupný jako tlačítko na položce a jako položka tlačítko pod tabulkou (možné jen pro nástroje typu akce).
» menu|table-menu ~ Nástroj je dostupný jako volba menu na položce a jako volba menu pod tabulkou (možné jen pro nástroje typu akce).
» menu|table-button ~ Nástroj je dostupný jako volba menu na položce a jako tlačítko pod tabulkou (možné jen pro nástroje typu akce).
Potomci
Uzel cxd:param
Naplnění parametru akce. Pokud je parametr zadán zde, při spuštění akce již uživatel není dotazován.
Uzel cxd:confirm
Definice potvrzovacího dialogu. Pokud je nastaven pro jednotlivé či hromadné použití, má se uživateli před spuštěním akce zobrazit potvrzovací dialog se zprávou uvedenou v cxd:lang/@message v duchu '...
Uzel cxd:success
Definice hlášky o úspěšném provedení. Pokud je nastaveno pro jednotlivé či hromadné použití, má se uživateli při úspěšném dokončení akce (tj. pokud se nevrátí soap/fault) zobrazit zpráva uvedená v cx...
Uzel cxd:edit-options
Definice zobrazení tlačítek a případných dalších nástrojů formuláře otevřeného pro přidání či editaci dokumentu z daného nástroje řádku, tabulky nebo náhledu.
Uzel cxd:error
Definice potvrzovacího dialogu. Pokud je nastaven pro jednotlivé či hromadné použití, má se uživateli před spuštěním akce zobrazit potvrzovací dialog se zprávou uvedenou v cxd:lang/@message v duchu '...
Uzel cxd:row-properties
Nepovinné rozšíření specifikace položkového nástroje. Umožňuje modifikovat výchozí (tj. standardní) umístění základních hodnot položky tabulky. Nastavení uvedená v tomto uzlu mají prioritu i před nas...