0 Externí vlání webvé publikace Marushka s parametry
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 MARUSHKADESIGN...4 5 PODPOROVANÉ PARAMETRY VOLÁNÍ VE VERZI 4.0.1.0...8 6 PŘÍKLAD VOLÁNÍ KLIENTA S LOKALIZACÍ... 10 7 VOLÁNÍ MARUSHKY POMOCÍ JAVASCRIPTOVÉHO ROZHRANÍ... 11-1 -
1 Cíl příkladu V tmt příkladu si ukážeme vlání mapvéh klienta z externí webvé stránky, ppřípadě z externí aplikace. Příklad byl vytvřen ve verzi 4.0.1.0 a nemusí tedy být kmpatibilní se staršími verzemi. 2 Práce s příkladem D slžky C:\MarushkaExamples\ rzbalíme bsah subru ExternalCall_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. D slžky (standardně "C:\Prgram Files\Gevap\MarushkaDesign\4-0-1-0\service\html\") aktuální verze Marushky nahrajeme subry Ft1.dat, Ft2.dat, Head1.dat, Head2.dat a lg.png. V prstředí MarushkaDesignu tevřeme prjekt ExternalCall_CZ.xml. Označíme frmální vrstvy Kraje a Okresy, 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! (vygeneruje se subr v tématech): Cestu k subru hlavičky a patičky definujeme v Editru témat (plžky LayOutHMTLHead a LayOutHTMLFt). Otevřeme ve webvém prhlížeči (např. Internet Explrer) subr ExternalCall_CZ.htm. - 2 -
3 Ukázka Dialgvéh kna Obr. 1 Ukázka výsledku dtazu se zvýrazněnu adresu lkálníh serveru (ranžvým bdélníkem) Obr. 2 Ukázka editru témat, sekce nastavení HTML klienta - 3 -
4 Stručný ppis příkladu v MarushkaDesign Testvací příklad bsahuje databázi v SQLite, ve které jsu dvě publikační vrstvy. V datvém zdrji SQLite (WKB) jsu tři frmální vrstvy, z nichž se jedna dkazuje na fyzicku vrstvu (databázvu tabulku) OKRESY, druhá a třetí na fyzicku vrstvu KRAJE. Nsitelem dat jsu tedy fyzické vrstvy (databázvé tabulky) OKRESY a KRAJE. Subr ExternalCall_CZ.htm Při defaultním nastavení tht dkumentu (nejsu v něm prvedeny žádné změny parametrů) je deslaná URL bez parametrů. Při změně parametrů jsu změněné parametry a jejich hdnty přidávány na knec URL a jsu ddělvány znakem &, aby měl uživatel přehled tm, které parametry byly změněny. Za každé mdifikvané ple v tét html stránce je p spuštění MarushkaDesign přidán jeden parametr s knkrétní hdntu. Parametry ve vlání můžeme ptlačit pužití kmpnent, které jsu pvleny v knfiguraci klienta. Tj. v definici tématu sekce LayOut (Definice rzlžení HTML klienta), pkud je např. parametr LayOutVicinity (zbrazit přehledvu mapu) nastaven na false, není mžné přehledvu mapu zapnut zvenčí, ale pkud je pvlen, můžeme jej hdntu false zvenčí zakázat. Jména parametrů pužitelných pr vlání jsu většinu shdná se jmény prměnných v nastavení LayOut, puze bsahují míst předpny LayOut předpnu Mar. Například parametr pr zakázání přehledvé mapy je MarVicinity, v editru témat se jmenuje LayOutVicinity. Více viz kapitla 5 tht dkumentu. 4.1 Nastavení serveru V první části stránky musíme v prvním řádku nejdříve vyplnit Adresu lkálníh serveru (zkpírujeme z hrníh řádku v lkálním web serveru v MarushkaDesign viz Obr. 1). Ve druhém řádku musíme vyplnit aktuální ID tématu, které rvněž zjistíme z tevřenéh lkálníh webvéh serveru. Dalším již nepvinným parametrem je Uživatelské jmén a Hesl. Těcht parametrů využijeme puze v případě, jestliže pužíváme autrizvaný přístup k webvému serveru. Pzr, hesl není žádným způsbem kryptván! 4.2 Nastavení území Ve druhé části zvlíme mžnst, v jakém výchzím prstrvém území se bude server Marushka spuštět. Máme na výběr ze čtyř mžnstí: A) Bez definice území B) Výchzí území definvané středvým bdem a měřítkem, kde zadáme středvý bd v cílvých suřadnicích a měřítk, ve kterém bude pžadvaná mapa vykreslvána. C) Zbrazení výchzíh mapvéh kna je definice bdélníkem pmcí suřadnic v cílvých jedntkách v přadí xmin ymin xmax ymax. Jedntlivé parametry jsu d sebe dděleny puze mezeru. Při prvním vykreslení mapy je vyhdncen lkalizační dtaz a psune startvací mezující bdélník d výsledku lkalizace. Pkud výsledek bsahuje prvky pr zvýraznění, tak je zvýrazní. - 4 -
D) Spuštění lkalizačníh dtazu s parametrem. Mapvé kn serveru Marushka pak bude zbrazen ve výřezu, který je výsledkem tht dtazu definván. V dkumentu je předvyplněný lkalizační dtaz, kde je funkčním územím kres Břeclav. Ten je uveden v pli druhéh parametru, ple prvníh parametru služí pr definici kraje. Míst prvníh i druhéh parametru je mžné zadat jakukliv realitě dpvídající dvjici kraj kres v České republice. Je nutné zadat pravdu dpvídající dvjici číselník druhéh parametru je ttiž závislý na výsledku číselníku prvníh parametru. Při zadání nedpvídajícíh parametru by dtaz nevrátil žádný výsledek. 4.3 Seznam vrstev p inicializaci Ve třetí části můžeme zadat Seznam zapnutých publikačních a Seznam infrmačních vrstev, které se budu zbrazvat p inicializaci mapvéh kna. Na výběr je v bu případech z pěti mžnstí. Pzr, infrmační vrstvu lze zapnut puze tehdy, pkud je již zapnutá jí dpvídající publikační vrstva! Tedy lze zapnut např. infrmační vrstvu 1 splečně s publikační vrstvu 1, ale není mžné zapnut infrmační vrstvu 2 splečně s publikační vrstvu 1 - zbrazila by se puze publikační vrstva 1 bez infrmační vrstvy 2. Defaultní nastavení znamená, že jsu načteny vrstvy přesně tak, jak byly definvány v prjektu. V tmt případě jsu defaultně zapnuty bě publikační vrstvy, bě inf vrstvy jsu vypnuty. 4.4 Parametry prstředí Ve čtvrté části v kategrii Zbrazení/nezbrazení jedntlivých vládacích prvků můžeme nastavit jedntlivé parametry prstředí. Jde především nastavení vzhledu kna a zbrazení jedntlivých kmpnent, převážně se nastavuje puze t, jestli se má daný aktivní prvek zbrazit či nikliv. Výjimku tvří puze Index aktivní zálžky, kde definujeme index zálžky, která má být p spuštění webvé publikace aktivní. U tht indexu lze zadat hdnty 0 5, přičemž 0 představuje defaultní hdntu. - 5 -
V kategrii Další mžnsti nastavení je mžné nastavit Jmén subru HTML hlavičky a HTML patičky, zde je přednastavená vlba Defaultní nastavení. Dále je zde mžné nastavit Titulek kna webvéh prhlížeče, Zapnutí/vypnutí zmu pmcí klečka myši, či nastavit Název kna pr navigaci. 4.5 Speciální aplikace V pslední části můžeme zavlat klienta ve speciálním mdu GetFence, který služí k zadání plygnu (hrady). P zavlání se klient přepne d módu Výběr plygnem a pkud uživatel úspěšně dknčí (zadá) hradu/plygn, tak klient vrátí suřadnice na specifikvanu URL (ta se zadává d ple na druhém řádku tét sekce). Na dalším řádku je mžné zadat Maximální plchu hrady v cílvých jedntkách datvéh skladu (zde jsu t m²). Parametry v tét části se dešlu puze pkud je u parametru Aplikace (GetFenceMde) nastavená vlba spustit aplikaci, jinak z tét skupiny parametrů není deslán nic. - 6 -
4.6 Spuštění MarushkaDesign Naknec je ještě ptřeba spustit Marushku, čímž se zavlá kn Marushky s uživatelem vyplněnými parametry. T se prvede pmcí tht tlačítka: - 7 -
5 Pdprvané parametry vlání ve verzi 4.0.1.0 Autrizace Parametr vlání Ppis Hdnty UserName Uživatelské jmén uživatele string Passwrd hesl string Layut a Definice rzlžení klienta Parametr vlání Prměnná tématu Ppis Hdnty MarApplicatin LayOutApplicatin Zbrazit tlačítk Aplikace true/false MarCrssBar LayOutCrssBar Zbrazit navigační kříž true/false MarGemetryQuery LayOutGemetryQuery Zbrazit tlačítk gemetrické dtazy true/false MarGPS LayOutGPS Zbrazit tlačítk GPS true/false MarHTMLFt LayOutHTMLFt Jmén subru HTML patky. Subry umístěné v adresáři HTML, např. patka.dat, pr nezbrazení prázdný řetězec. Subry umístěné MarHTMLHead LayOutHTMLHead v adresáři HTML, Jmén subru HTML Např. hlavicka.dat, hlavičky pr nezbrazení prázdný řetězec. MarMeasurement LayOutMeasurement Zbrazit tlačítk Měření true/false MarMenu LayOutMenu Zbrazit menu true/false MarPanelDraw LayOutPanelDraw Zbrazit zálžku kreslení true/false MarPanelExpand LayOutPanelExpand Maximalizvat panel zálžek true/false MarPanelFind LayOutPanelFind Zbrazit zálžku hledat true/false MarPanelIndex LayOutPanelIndex Index aktuální zálžky [0,1,2,3,4] MarPanelInf LayOutPanelInf Zbrazit zálžku infrmace true/false MarPanelLayers LayOutPanelLayers Zbrazit zálžku vrstvy true/false MarPanelLegend LayOutPanelLegend Zbrazit zálžku legenda true/false MarPanelPrint LayOutPanelPrint Zbrazit zálžku tisk true/false MarPlygn LayOutPlygn Zbrazit tlačítk výběr plygnem true/false MarPreselect LayOutPreselect Zbrazit Inf nastrj (funkce klikni d mapy -> vyber ze seznamu prvek-> zbraz true/false infrmace) MarPreselectOn - Aktivvání funkce inf true/false MarScalebar LayOutScalebar Zbrazit psuvník měřítka true/false MarTheme LayOutTheme Zbrazit nabídku témat true/false MarTls LayOutTls Zbrazit nabídku nástrjů true/false MarVicinity LayOutVicinity Zbrazit přehledvu mapu true/false MarWheel LayOutWheel Zm pmcí klečka myši true/false MarKN LayOutKN Zbraz tlačítk nahlížení d KN true/false MarPpularQuery LayOutPpularQuery Zbrazit/skrýt ppulární dtaz true/false - 8 -
Dtazy, lkalizace Parametr vlání Ppis Hdnty MarQueryID Unikátní ID dtazu plžka GId ve vlastnstech dtazu. GID MarQParamCunt Pčet parametrů lkalizačníh dtazu. [0.. n] MarQParamX Hdnta parametru dtazu s indexem X. Indexuje se d 0. Hdntu zapisujeme URLEncded string MarMiddlePint Středvý bd území, hdnty jsu ddělvány mezeru [x y] MarScale Měřítk zbrazení string Speciální módy klienta Parametr vlání Ppis Hdnty actin Typ akce getfence returnfenceurl URL stránky pr zpracvání string MarFenceLimit Maximální plcha hrady string Vrstvy, inf vrstvy a extent, téma Parametr vlání Ppis Hdnty ThemeID ID tématu. [0.. n] MarExtent MarUid MarUidi Parametr definuje startvací mezující bdélník HTML klienta. Hdnty jsu dděleny mezerami (respektive %20 prtže by měly být URLEncded). Aktuální hdnty jsu v suřadnicvém systému S-JTSK a mm. Seznam vrstev, které mají být p zavlání zapnuté. Vrstvy se identifikují glbálním ID publikační vrstvy. Jedntlivé hdnty jsu dděleny mezerami. Seznam inf vrstev, které mají být p zavlání zapnuté. Vrstvy se identifikují glbálním ID publikační vrstvy. Jedntlivé hdnty jsu dděleny mezerami. [xmin ymin xmax ymax] [GID1 GID2 GID3 ] [GID1 GID2 GID3 ] - 9 -
6 Příklad vlání klienta s lkalizací V tématu s id=13 máme nadefinvaný lkalizační dtaz Lkalizace skupiny. Tent dtaz bsahuje dva parametry (hdnta vlastnsti QueryParams=Kraj;Okres). Tent dtaz má vlastnst GId= 98F36261. Klienta následně vláme s následujícími parametry: ThemeID=13 MarQueryID=98F36261 MarQParamCunt=2 MarQParam0=Jihmravský MarQParam1=Břeclav Parametry bsahuji české znaky, prt je zakódujeme pmcí kódvání URLEncded UTF-8. ThemeID=13 MarQueryID=98F36261 MarQParamCunt=2 MarQParam0=Jihmravsk%c3%bd%0d%0a MarQParam1=B%c5%99eclav Výsledný dtaz na server metdu GET vypadá následvně: http://adresaserveru/marushka/default.aspx?themeid=13&marqueryid=98f36261&marqparamcunt=2 &MarQParam0= Jihmravsk%c3%bd%0d%0a&MarQParam1= B%c5%99eclav Pkud budeme pužívat HTML frmulář a vlání metdu POST kódvání se prvede autmaticky. - 10 -
7 Vlání Marushky pmcí JavaScriptvéh rzhraní Marushku jde také vlat p jejím načtení v rámu (Iframe) přes JavaScriptvé rzhraní (bez nutnsti pkaždé reladvat celu stránku). Seznam funkcí, které je mžné vlat tut metdu je v každé instanci MarushkaDesign dstupný v cestě (aktuální instalace MD)/bin/service/js/interface.js. V přilženém archivu je subr InterfaceCall_CZ.html, kde je vlána funkce MarushkaLcalize(), cž je funkce, která spustí předefinvanu lkalizaci p kmpletním načtení Marushky uvnitř Iframe. Tat funkce je zavlána p kliku na tlačítk, cž spustí tut funkci, která lkalizuje dané území. Kmpletní HTML s vlanu funkcí si můžete prhlédnut, pkud si například v pznámkvém blku tevřete subr InterfaceCall.html. - 11 -