0 Témata v MarushkaDesignu
OBSAH 1 CÍL PŘÍKLADU...2 2 PRÁCE S PŘÍKLADEM...2 3 UKÁZKA DIALOGOVÉHO OKNA...3 4 STRUČNÝ POPIS PŘÍKLADU V MARUSHKADESIGNU...5-1 -
1 Cíl příkladu V tmt příkladu si ukážeme práci s tématy v MarushkaDesignu. Příklad byl vytvřen ve verzi 4.0.1.0, a prt nemusí být kmpatibilní se staršími verzemi. 2 Práce s příkladem V cestě nejnvější instalace MarushkaDesignu (standardně c:\prgram Files\Gevap\MarushkaDesign\4-0-1-0\service\themes\) vymažeme všechny subry, vyjma ThemesBlankTemplate.xml a Blank.xml. D tét slžky nahrajeme připravené subry themes.xml, Themes_CZ a Themes_CZ1 Pmcí editru témat si tevřeme subr themes.xml, avšak puze v případě, že máme nainstalvanu jinu verzi Marushky než 4-0-1-0. Jestli an, tak změňte cesty u parametru XMLPrjectPath k běma subrům pdle instalvané verze. D slžky c:\marushkaexamples\ rzbalíme bsah subru Themes_CZ.zip. Cílvu slžku je nutné respektvat kvůli prvázansti cest s prjektem. V případě umístění subrů d jiné cesty by nebyl mžné s příkladem pracvat. V prstředí MarushkaDesignu tevřeme prjekt Themes_CZ.xml. Označíme uzel frmálních vrstev železnice v datvém skladu SQLite (WKB), v kntextvém menu vybereme Data Načti vše: V mapvém kně zvlíme zbrazit Vše: Spustíme lkální webvý server: - 2 -
3 Ukázka dialgvéh kna Obr 1: Ukázka dialgvéh kna se spuštěným prjektem Themes_CZ a dtazem Přesměrvání Budapešť (menší kn) Obr 2: Ukázka dialgvéh kna se spuštěným prjektem Themes_CZ a dtazem Přesměrvání Győr (menší kn) - 3 -
Obr 3: Ukázka dialgvéh kna Editr témat - 4 -
4 Stručný ppis příkladu v MarushkaDesignu 4.1 Téma Je definván jedinečným identifikátrem ID, pd nímž jsu ulžena jedntlivá nastavení danéh tématu. Jedntlivá témata se pak zbrazují v následné webvé publikaci. Každé téma tak má vlastní nastavení zbrazvaných publikačních vrstev, má vlastní nastavení úvdníh zbrazvanéh území, nastavení HTML klienta, tisku a dalších. V rámci celé webvé publikace se vyskytuje vždy alespň jedn téma, jejich maximální pčet není nijak mezen. Jednmu tématu dpvídá právě jeden knfigurační xml subr danéh prjektu. Nad jedntlivým subrem prjektu stjí řídící knfigurační xml subr témat, který bsahuje především cesty k jedntlivým prjektům a jejich úvdnímu nastavení. Dplňující infrmace tématech si můžete přečíst v Manuálu. 4.2 Pstup vytváření a přiřazvání jedntlivých témat Nvá instalace MarushkaDesignu nebsahuje žádné téma ani řídící knfigurační xml subr témat, puze subr ThemesBlankTemplate.xml, cž je šablna prázdnéh řídícíh knfiguračníh xml subru témat a subr Blank.xml, cž je prázdná šablna tématu. Subr ThemesBlankTemplate.xml, respektive následně vytvřený řídící knfigurační subr témat themes.xml bsahují seznam témat a u každéh z nich především definici Label (název), ThemeId (čísla tématu), XmlPrjectPath (cesta k xml subru danéh prjektu), LayOut (důležitá nastavení ze sekce nastavení kmpnent lkálníh webvéh serveru Layut), ClientExtent (nastavení startvacíh mezujícíh bdélníku klienta v cílvých jedntkách a cílvém suřadnicvém systému) a LinksTTheme (seznam dstupných témat, na která je mžné přepnut za běhu lkálníh webvéh serveru při spuštěném daném tématu). Subr Blank.xml, respektive knfigurační xml subry jedntlivých témat bsahují především definici DataStres (zde je definván celý prjekt včetně všech jeh dílčích kmpnent, vyjma prjekce a cílvých jedntek), TargetUnits (cílvé jedntky) a TargetPrjectin (cílvá prjekce). Nvé téma je autmaticky vytvřen až p prvním spuštění lkálníh webvéh serveru. P každém dalším spuštění lkálníh webvéh serveru pak Marushka věřuje, jestli se shduje ID a label spuštěnéh tématu s ID a labelem některéh z témat definvaných v seznamu témat (řídícím knfiguračním xml subru témat). Pkud se ID a label shdují, tak je dané téma spuštěn. Pkud ne, tak je zalžen nvé téma se jménem převzatým z knfiguračníh xml subru danéh prjektu, tt téma je autmaticky přidán d seznamu témat a je mu přidělen další nebsazené ID v přadí. Témata jsu standardně číslvána d čísla 11, pmcí editru témat je však mžné jim nastavit i hdnty 1-10. Řídící knfigurační xml subr témat je třeba znvu ulžit p prvedení jakékliv mdifikace pmcí editru témat. A t tak, že před puštěním editru témat ulžíme knfiguraci pmcí ikny diskety d subru themes.xml, který je standardně umístěn v cestě instalace MarushkaDesignu: /MarushkaDesign/čísl verze ve frmátu x-x-x-x/service/themes/themes.xml. Tent subr je samzřejmě mžné umístit i d jakékliv jiné cesty, je ale ptřebné tut cestu sučasně upravit i v subru web.cnfig, jinak by nebyl mžné pracvat s prjekty. - 5 -
4.3 Editr témat Editr témat se standardně tevírá z Menu Nástrje Editr témat. Pmcí první ikny v levém hrním rhu editru témat je ptm tevírán knfigurační subr témat, který je standardně umístěn v cestě instalace MarushkaDesignu: [aktuální instalace Marushka Designu]/service/themes/themes.xml. Knfigurační subr může být samzřejmě umístěn i v jakémkliv jiném umístění, cestu k němu je mžné zjistit v subru Web.cnfig, umístěném ve slžce service v cestě instalace MarushkaDesignu, jedná se plžku PathTThemeSettings. Alternativně může být vytvřen také nvý knfigurační subr. Editr témat služí k přípravě webvé publikace prjektu/prjektů. V následujících dstavcích jsu uvedeny dplňující infrmace k těm, které se můžete editru témat dčíst v Manuálu. P kliku pravým tlačítkem na jedntlivé téma se zbrazí kntextvé menu. Jeh první nabízenu mžnstí je Nastavit pčáteční bdélník HTML klienta, p aktivaci tét mžnsti se bdélník vymezuje přímým zadáním v mapvém kně. Tat hdnta je pak zkpírvána d řádku ClientExtent a není ptřeba ji zadávat ručně. Funkce Kpíruj nastavení rzlžení a Kpíruj nastavení service inf služí ke zkpírvání celé kategrie LayOut, respektive celé kategrie ServiceInf a urychluje tak práci s tématy. Celá pravá část dialgvéh kna je vyhrazena pr knkrétní hdnty plžek nastavení danéh tématu. Jedntlivá nastavení jsu rzřazena d kategrií, z nichž každá plžka má v dlní části dialgvéh kna svu nápvědu blíže specifikující vlastnst dané funkce. A) Testvání V tét kategrii je bsažená puze plžka ShwInfIcnCver, pmcí které je umžněn zbrazvání klikatelné plchy u průhledných inf ikn vytvřených pmcí pseudslupce SET_INFO_ICON_COVER. Klikatelná plcha je při zapnutí tét funkce zbrazvána transparentní červenu barvu, tat funkcinalita je však pužitelná puze pr testvání prstrvé distribuce a vyvarvání se mžnéh překrytí jedntlivých klikatelných inf ikn (klizi jejich klikatelných plch). Míst ručníh nastavvání jedntlivých kmpnent pmcí editru témat je mžné vlat jedntlivé parametry přím na URL adrese. Tat mžnst je pdrbněji rzebírána v tutriálu Externí vlání i v kategrii Blg v článku Vlání HTML klienta metdu POST/GET na stránkách MarushkaDesignu, knkrétní URL na článek na Blgu: http://marushka.gestre.cz/cz/blgdetail/vlani-html-klienta-metdu-pst-get/9. B) Defaultní uživatelské nastavení klienta Jde kategrii uživatelských nastavení, které lze změnit i ve webvé prezentaci danéh tématu v Menu Nastavení. Jde tedy puze inicializační nastavení, které je uživatelsky dále mdifikvatelné. V tét kategrii nastavení lze zapínat/vypínat vlastnsti: animace mapy v publikaci, zbrazení suřadnic, zbrazení překrčení pčtu inf prvků, autmaticku lkalizaci, mapa nad panelem zálžek (v případě vypnutí tét funkce je vlastní mapvé kn publikace viditelné celé a není tak zkreslvána např. dynamická legenda), případně jiné funkce závisející na zbrazvaném výřezu dat, bnvení mapy při změně veliksti kna, ukládání uživatelskéh nastavení pslední pzice mapy apd. (využívá ckies). Ekvivalentem k tmut nastavení je kategrie Defaultní uživatelské nastavení klienta v editru témat, kde je mžné nastavit ttžné parametry. - 6 -
C) Nastavení HTML klienta Inicializační nastavení, která jsu mdifikvatelná puze správcem prjektu v tmt knfiguračním xml subru. Přehled vlastnstí: AutReDrawMap je autmatické překreslení mapy při změně zbrazvaných vrstev, BackgrundClr je barva pzadí mapy, ClientExtent je startvací mezující bdélník v cílvých jedntkách cílvé kartgrafické prjekce, ClientZmCefficient udává, klikrát se přiblíží/ddálí mapa při zmvání, Layut je velmi rzsáhlá kategrie, která je pměrně pdrbně ppsána v manuálu, mim jiné umžňuje zapnutí/vypnutí různých uživatelských vládacích prvků, pmcných kmpnent jak zbrazení přehledky, hlavičky, patičky, jazykvé mutace apd. U parametru LinksTTheme je mžné vybrat si ze seznamu dstupných témat ta témata, na která je mžné se za běhu lkálníh webvéh serveru při spuštěném knkrétním prjektu přepnut. Pmcí parametru URLTPrtal je mžné nastavit URL na hlavní prtál v menu. Parametr VicinityMinTScale umžňuje nastavit minimální měřítk dynamické přehledvé mapy. Pkud je hdnta menší než minimální hdnta TScale všech frmálních vrstev značených jak přehledkvé, ptm se pužije minimální hdnta všech těcht frmálních vrstev. D) Tisk V tét kategrii se nastavují jedntlivé plžky suvisející s tiskem. Více tét kategrii se můžete dzvědět v tutriálu Print na stránkách Marushky. E) Omezení služeb Tt nastavení bsahuje mezení pr tiskvé úlhy. Je mžné zde definvat MaxClientPrintSize, cž je největší frmát papíru, na který lze tisknut a MaxClientSize, definující maximální velikst mapvéh kna klienta v pixelech. Pzr! Pkud je nastaven příliš velké mapvé kn, tak je načítán větší mnžství prvků a tím se zabírá větší mnžství perační paměti. Prt je ptřeba rzumně zkmbinvat velikst mapvéh kna s pžadvaným pčtem zbrazvaných prvků, aby byl dsáhnut vyhvující rychlsti zbrazvání. F) Nastavení tématu kategrie dalších nastavení tématu DefaultWMSPngFrmat pmcí tht parametru se nastavuje defaultní typ PNG brázků pskytvaných WMS službu. Je mžné vybrat si ze tří mžnstí: - bit8 8 bitvá barva, pdpruje barevnu škálu 256 barev (255 + 1 průhledná), bsahuje 1 tabulku barev, nepdpruje plprůhledné barvy, vhdné především pr vektrvé kresby, nevhdné například pr ftgrafie, ztrátvá kmprese - bit24 24 bitvá barva, pdpruje barevnu škálu 16 milinů barev, (3 tabulky barev, pr každu z barev RGB samstatná tabulka), pdpruje plprůhledné barvy (brázek může být v různých místech různě průhledný), vhdné pr ftgrafie, rtft, pdpra bezztrátvé kmprese - bit8raw 8 bitvá barva, pdpruje barevnu škálu 256 barev (255 + 1 průhledná), pdpruje ale i plprůhledné barvy, kmbinace předchzích dvu, tent frmát má sice menší škálu barev než bit24, ale pdpruje také plprůhlednst ExternalWFS20CapabilitiesPath abslutní systémvá cesta k externímu WFS 2.0 capabilities subru - 7 -
ExternalWMS130CapabilitiesPath abslutní systémvá cesta k externímu WMS 1.3.0 capabilities subru ExternalWMSCapabilitiesPath abslutní systémvá cesta k externímu WMS capabilities subru Tyt výše zmíněné externě ulžené subry ExternalCapabilities, a hdnty v nich bsažené lze upravvat v libvlném XML editru a měnit tak hdnty jejich parametrů. ServiceInf zde je mžné měnit některé servisní infrmace, hlavně infrmativníh charakteru (především kntaktní a ppisné infrmace). Tyt infrmace je pak mžné získat jak výsledek dtazu GetCapabilities. Label název danéh tématu (není, respektive nemusí být jedinečný) ThemeId - ID danéh tématu (funguje jak jedinečný identifikátr tématu) XmlPrjectPath fyzická cesta k xml subru knkrétníh prjektu 4.4 Ppis prjektu Tent prjekt sahuje dva uzly frmálních vrstev, knkrétně uzly železnice a silnice. Uzel železnice bsahuje puze dvě frmální vrstvy, jednu pr vykreslvání vnitřní kresby (inline) a druhu pr vykreslvání vnější kresby (utline). Tyt dvě frmální vrstvy mají ve všech měřítcích ttžnu symblgii. Uzel silnice bsahuje tři kategrie frmálních vrstev, první kategrie se zbrazuje d měřítka 1: 10 000, druhá kategrie d měřítka 1: 10 001 d 1: 70 000 a třetí kategrie d měřítka 1: 70 001. Každá kategrie má lehce dlišnu symblgii kvůli dsažení lepší přehlednsti. Prstřednictvím tét vrstvy se zbrazují jedntlivé typy silnic v Maďarsku, knkrétně se jedná dálnice, rychlstní silnice, silnice I. třídy, silnice II. třídy a silnice III. třídy. K jedntlivým frmálním vrstvám byla také vytvřena legenda, která je zbrazvána k aktuálně zbrazvaným vrstvám v mapvé publikaci. V prjektu jsu dva dtazy typu přesměrvání. První dtaz je nazván Přesměrvání Budapešť, tent dtaz vyvlá dialgvé kn InPpUpBubble (ve vyskakvací bublině) s ttžným tématem (ThemeId=11). Pmcí přidání parametrů je zavlána pdkladvá vrstva: Ggle mapa ~ Letecký snímek, splečně s publikačními vrstvami silnice a železnice. Také je pslán jiný Extent (mezující bdélník), který zacílí mapvé kn na Budapešť a klí. Dále je prstřednictvím zaslání externích parametrů zakázána většina vládacích prvků, prtže by ve vlaném kně, vzhledem k jeh rzměrům zavazely. Definici dtazu, včetně psílaných parametrů si můžete prhlédnut ve vlastnstech dtazu v kategrii 2. Vlastnsti dtazu, plžka SqlStmtTemplate. Více externím vlání parametrů se můžete dzvědět v tutriálu Externí vlání parametrů na stránkách Marushky. Dtaz je spuštěn tlačítkem bíléh smajlíka dle v mapvém pli. T je mžné díky tmu, že má tent dtaz v kategrii 5. Aplikace nastavenu plžku IsApplicatin na hdntu 'True' a ve stejné kategrii má nastavený zmíněný ApplicatinButtn, cž je tlačítk, kterým se spuští daná aplikace. Druhý dtaz je nazván Přesměrvání Győr, tent dtaz vyvlá nvé kn, se stejným prjektem, který je však spuštěný jak nvé téma (ThemeId=12). U tht dtazu je ptřeba mít nastaven v kategrii RedirectSettings u parametru RedirectInternalParameters na hdntu False, jinak dtaz nevrátí správný extent. V tmt prjektu je nastavená jiná pdkladvá Ggle mapa ~ Hybridní, prjekt má nastaven jiný Extent, je zacílený na klí města Győr. Také jsu v editru témat vypnuty všechny kmpnenty z kategrie LayOut, vyjma LayOutWheel, který umžňuje zmvání klečkem. Okn dtazu je spuštěn pmcí ikny červenéh smajlíka, který je situvaný vedle ikny bíléh smajlíka. Spuštěný prjekt však na rzdíl d prjektu s ThemeId=11 nebsahuje psílané externí parametry. - 8 -