Setup. Introduction. SSL VPN Instructions. Open workshop launchpad. See separate handout for detailed instructions.

Size: px

Start display at page:

Download "Setup. Introduction. SSL VPN Instructions. Open workshop launchpad. See separate handout for detailed instructions."

Kelley Bridges
5 years ago
Views:

1 Setup SSL VPN Instructins See separate handut fr detailed instructins. Cnnect t the clear-guest wifi netwrk. Use the daily passwrd prvided. Access a public site (like t verify cnnectivity. Cnnect t the Array SSL-VPN site at the prvided URL using IE/Firefx/Safari (Chrme is nt supprted). Sign in using the username/passwrd cmbinatin prvided by the HL instructrs. Once VPN is enabled use Remte Desktp t cnnect t the HL client machine using the machine IP and credentials prvided by the HL instructrs will. Once cnnected t the client machine in Remte Desktp, start up Firefx. Open wrkshp launchpad Using Firefx in the client machine, navigate t [ip address]:7777 using the server IP address prvided by the HL instructrs. Fr example, fr an address , pint the brwser t :7777. Yu shuld see the fllwing page. Intrductin The purpse f this lab is t prvide hands-n experience with a new feature f MapViewer that renders a theme as tiles generated at run-time (i.e., when queried). This feature is knwn as Dynamic Tile Layers (r DTL) and is useful fr displaying frequently updated cntent, such as smart meter data r mving asset lcatins, in peratinal applicatins.

2 A DTL is a theme (Vectr, Raster, WMS) which is rendered as tiles at run-time. DTLs are particularly effective when used in cncert with UTF Grids (explained belw) fr relatively static layers t prvide additinal cntext that can be turned n r ff in a map display. Strm dem with DTL This is a mdified versin f the strm dem which is part f the MVDEMO sample that displays all 50 years f strm lcatins (wind, hail, trnad), instead f year by year. The layers (wind, hail, trnad) are rendered as tiles at query time. The query includes nn-spatial clumns such as Year, Mnth, Day, Lss (prperty lss in millins), Crp Lss, Fatalities, and Injuries. This infrmatin is used t ppulate a grid f a specified cell size (e.g. 4x4 pixels) which cntains the clumn values fr ne f the pints (the default is the ne with a max value fr a clumn such as Lss) that fall within the grid. S if 4 wind strm lcatins fall within a grid cell then the inf-windw which is displayed when the user clicks n that grid cell is the strm with the max (prperty) lss value. While the dem shws fixed (histrical) strm lcatins the layers culd equally well have been lcatins f mbile assets, smart-meter readings, r lcatins f peple Tweeting abut the Patrits frm their Andrid device. Since the layers are just JDBC queries r predefined themes, they can als be filtered by nn-spatial attributes such as prperty lss > 1 (millin). Similarly they can be rendered using an advanced style.

While it is ptimized t wrk with Oracle Spatial & Graph, the data and backgrund maps can cme frm external surces such as GeJSON, WFS, WMS,and nline map services such as HERE, Bing, r

3 The next few sectins briefly intrduce MapViewer, Dynamic Tile Layers, UTF Grids, and the MVDEMO sample applicatin. Oracle MapViewer MapViewer is a tlkit cnsisting f server and client JEE and Javascript cmpnents fr incrprating interactive maps and spatial analysis in brwser-based applicatins. While it is ptimized t wrk with Oracle Spatial & Graph, the data and backgrund maps can cme frm external surces such as GeJSON, WFS, WMS,and nline map services such as HERE, Bing, r OpenStreetMap. The Javascript library (aka Oracle Maps V2) leverages HTML5 and prvides rich interactivity. The server cmpnent (deplyed in a JEE cntainer such as Weblgic Server r Glassfish) perfrms the database queries and serves up the data t be rendered in the HTML5 client.

4 Dynamic Tile Layers Dynamic tile layers (DTL) are layers (themes) that are defined prgrammatically (i.e. nly by using the OM.layer.DynamicTileLayer Oracle Maps V2 API bject). Unlike predefined layers (themes) the definitin is nt stred in the USER_SDO_THEMES r USER_SDO_CACHED_MAPS metadata views. A DTL is similar t a JDBC theme r layer in the sense that it is defined in client cde via the API. It differs frm a JDBC layer in that it must have an assciated tile layer cnfiguratin bject which specifies the Universe (SRID, zm levels, extent) and tile image size (e.g. 256x256 pixels). This is because a DTL is rendered as tiles at run-time. DTLs are rendered as tiles and require a Tile Layer cnfiguratin which specifies tile size, number f zm levels, and extent. When displayed n a backgrund map tile layer, a DTL can inherit the cnfiguratin f the backgrund map tile layer. When displayed alne a DTL requires a fully specified tile cnfiguratin bject as described belw. A DTL cde example A DTL needs a tile layer cnfiguratin, i.e. a Universe and tile image size. The fllwing tw lines create thse cnfiguratin bjects. The third line specifies the MapViewer URL. var myuniv = new OM.universe.LatLnUniverse(); var mycnfig = new OM.layer.TileLayerCnfig( { tileimagewidth: 256, tileimageheight: 256 }); var basemvurl = //a MapViewer instance URL Once we have the tile specificatin we can define a DTL using OM.layer.DynamicTileLayer. We ll use the SQL (JDBC) query based Trnad layer frm the Strm dem described abve as an example. First we define the <theme> xml fragment which includes SQL statement fr the query. var themesxml = "<themes>" + "<theme name=\"theme_trnad\">" + "<jdbc_query" + " datasurce=\"mvdemo\"" + " jdbc_srid=\"3857\"" + " x_clumn=\"lng_lc\"" + " y_clumn=\"lat_lc\"" + ">SELECT s.gem.sd_pint.x lng_lc,s.gem.sd_pint.y lat_lc,lss,year,mnth,day,state,fatalities,injuries,crplss frm trnad_3857 s " + "<hidden_inf>" + "<field clumn=\"year\" name=\"year\"/>" + "<field clumn=\"month\" name=\"mnth\"/>" + "<field clumn=\"day\" name=\"day\"/>" + "<field clumn=\"state\" name=\"state\"/>" + "<field clumn=\"loss\" name=\"lss\"/>" + "<field clumn=\"croploss\" name=\"crp_lss\"/>" + "<field clumn=\"fatalities\" name=\"fatalities\"/>" + "<field clumn=\"injuries\" name=\"injuries\"/>" + "</hidden_inf>" + "</jdbc_query>" + "<rendering>" +"<style name=\"v.tornado_64\" value_clumns=\"loss\" min_scale=\" \" max_scale=\"0.0\" scale_mde=\"ratio\"/>" +"<style name=\"v.tornado\" value_clumns=\"loss\" min_scale=\"8.0e10\" max_scale=\" \" scale_mde=\"ratio\"/>"

5 + "</rendering>" + "</theme>" + "</themes>"; The <hidden_inf> clumns define what is displayed in an inf-windw n click. The fllwing statement defines the trnad_damage DTL. Nte: the tileserverurl must be the MapViewer URL (base_url) + the OM servlet (i.e. mserver) since a DTL is a map image created at run-time and a cached tile image fetched via the map cache servlet (mcserver). var imagetltrnad = new OM.layer.DynamicTileLayer("trnad_damage", { tileserverurl : baseurl + "/mserver", tilelayercnfig : mycnfig, universe : myuniv, ptins : { "datasurce" : "MVDEMO", "transparent" : true, "enableutfgrid" : true, "UTFGrid_reslutin" : 4, enableutfgridinfwindw : false, //use a custm inf-windw handler "themes_xml" : themesxml } }); The abve is a cde snippet frm the strm dem applicatin. It illustrates the fllwing characteristics f a dynamic tile layer: 1) The map applicatin fetches map images frm a MapViewer server. Therefre, it can take the advantage f all available features that a MapViewer server prvides. 2) The map image tiles are set t be transparent (i.e., the value fr prperty "transparent" is true). This setting makes all f the nn-verlapping features visible when multiple dynamic tile layers are displayed ne n tp f the ther in ne map applicatin. Fr example, when yu verlay a 'trnad-damage' layer n tp f a 'hail-damage' layer, yu may see bth layers n the map when they are nt verlapping. This setting is especially useful when multiple layers cntaining linear r pint features. Nte that since the V2 API allws yu t turn n/ff a layer's visibility, s yu can always make a layer f interest standut and visible in yur applicatin. 3) This dynamic tile layer als enables MapViewer server's UTFGrid supprt (i.e., the value fr prperty " enableutfgrid" is true with a reslutin f 4 be specified as the value f prperty "UTFGrid_reslutin"). This setting instructs V2 API t request an additinal file as a cmpanin f each map image tile. That file cntains a JSON bject. One cmpnent f it is a tw-dimensinal grid that matches the tile image. Anther cmpnent f it is text attributes data fr each grid cell. When a muse event is triggered (e.g., a muse click) at an image pixel, its crrespnding grid cell can then be lcated and thus the text attributes f that grid cell can be retrieved. Then the map applicatin may custmize a MapViewer inf windw t display the text attributes. Ding s, mre infrmatin is passed frm the surce data t an end user. The text attributes in a JSON dcument are defined in a MapViewer theme's <hidden_inf> element. The theme can be either a predefined gemetry theme, r a dynamically frmatted JDBC theme. In the abve cde snippet, a JDBC theme was emplyed. A reslutin value (e.g., "UTFGrid_reslutin":4) indicates the windw width and height in the map image tile a grid cell represents. In this example, ne grid cell in the UTFGrid dcument represents 16 pixels (4x4=16). We had prefix UTF in 'UTFGrid' is because it uses UTF-8 encding.

7 When this UTF Grid is included with a map tile layer, a muse click will be assciated with a cell in the UTF Grid. If a feature is present at the muse click lcatin, the cell will cntain a character which in turn will be assciated with attribute(s). Thse attributes are then leveraged fr interactin such as inf windws. It is imprtant t recgnize the inherit trade ff assciated with a gridded representatin f layer attributes: perfrmance and scalability are imprved while detailed accuracy is reduced. MVDEMO Sample Applicatin The mvdem sample applicatin cnsists f a tutrial and sme feature dems, such as the strm dem. We will use the tutrial sectin fr the hands-n lab. The tutrials cnsist f cde snippets that demnstrate the use f varius Oracle Maps V2 bjects. The cde snippets (Javascript) can be edited and re-run t see the effect f any cde changes. The hands-n lab will fcus n Tutrial sectin named Dynamic Tile Layers and UTF Grid. The first entry C00: Dyn TL Lab is a placehlder fr cpying and pasting cde snippets frm ther examples r attempting t build yur wn example frm scratch.

8 Lab MapViewer Cnsle - Open MapViewer Cnsle frm launchpad - lg in using admin/welcme1 - Review Admin, Metadata, Cnfiguratin tabs

9 MVDEMO verview Open MVDMEO frm launchpad Click n Oracle Maps Html5 Tutrial link at bttm f page Explre dem categries and bserve Run buttn used t refresh map with cde changes

10 Click n dem A00 Display a map Scrll dwn in Javascript t basemap definitin. Nte map used in dem_map. Making a basic change: change dem_map t wrld_map and click Run abve map

Observe Dynamic Tile Layer defined using basemap

11 Dynamic Tile Layers Dynamic Tile Layer based n predefined basemap Open C01 - Dyn TL: MV basemap Observe Dynamic Tile Layer defined using basemap Change basemap frm dem_map t wrld_map and click Run

Highways theme (THEME_DEMO_HIGHWAYS) and click Run Add cunties

12 Dynamic Tile Layer based n predefined Themes Open C02 Dyn TL: MV Themes Observe Dynamic Tile Layer defined using themes Remve Highways theme (THEME_DEMO_HIGHWAYS) and click Run Add cunties (THEME_DEMO_COUNTIES) and click Run Observe updated Dynamic Tile Layer

13 Dynamic Tile Layer frm multiple MapViewer server instances Open CO3 Dyn TL: Multiple servers fr themes Nte ability t surce frm alternate MapViewer server instance Exercise nt part f lab as ur envirnment des nt allw external internet access

14 Dynamic Tile Layer frm JDBC Theme Open C05 Dyn TL: Filter a JDBC Theme Observe JDBC query definitin fr Dynamic Tile Layer

15 Dynamic Tile Layer frm JDBC Theme with filter Open C05 Dyn TL: Filter a JDBCTheme Observe SQL filter Update SQL filter changing 25 t 75 and click Run Observe change in Dynamic Tile layer

Grid-based inf windw Update tile layer surce frm cunty_utf_grid_tl

16 UTF Grid UTF Grid n predefined tile layer Open C06 UTF Grid n Tile Layer Observe UTF Grid enabled Click n map and bserve UTF Grid-based inf windw Update tile layer surce frm cunty_utf_grid_tl t utfgrid_tl and click Run Click n map and bserve UTF Grid-based inf windw

UTF Grid n Dynamic Tile Layer Open C02 Dyn TL: MV Themes Observe updated Dynamic Tile Layer des nt have inf windw behavir Insert enableutfgrid:true in ptins sectin f

Highways and Cities themes are nt cnfigured with Hidden Attributes.

17 UTF Grid n Dynamic Tile Layer Open C02 Dyn TL: MV Themes Observe updated Dynamic Tile Layer des nt have inf windw behavir Insert enableutfgrid:true in ptins sectin f Dynamic Tile Layer definitin Add a cmma at end f previus line Click Run, click in map and bserve UTF Grid-based inf windw Nte, attributes will nly include State as Highways and Cities themes are nt cnfigured with Hidden Attributes. Replace "THEME_DEMO_HIGHWAYS" "THEME_DEMO_CITIES" with THEME_DEMO_COUNTIES Click Run, click in map and bserve UTF Grid-based inf windw including state and cunty attributes Nte, Cunty theme is cnfigured with Hidden Attributes, hence included in UTF Grid-based inf windw.

Custmize attributes fr UTF Grid n Dynamic Tile Layer Open C04 Dyn TL: JDBC Theme Observe updated Dynamic Tile Layer des nt have inf windw behavir UTF Grid attributes are cntrlled using a theme s

18 Custmize attributes fr UTF Grid n Dynamic Tile Layer Open C04 Dyn TL: JDBC Theme Observe updated Dynamic Tile Layer des nt have inf windw behavir UTF Grid attributes are cntrlled using a theme s Hidden Inf. We will add Hidden Inf t the JDBC theme. Insert the fllwing Hidden Inf definitin inside the jdbc_query XML tags: '<hidden_inf><field clumn="cunty" name="cunty Name"/><field clumn="ttpp" name="ttal Ppulatin"/></hidden_inf> \n'+ Insert enableutfgrid:true in ptins sectin f Dynamic Tile Layer definitin Add a cmma at end f previus line Click Run and click in map t bserve UTF Grid-based inf windw

UTF grid inf windw Set enableutfgridinfwindw t false Uncmment event listener

19 UTF Grid n Dynamic Tile Layer with custm inf windw Open C07 Dyn TL with UTF Grid Set enableutfgridinfwindw t true Cmment ut event listener Observe default UTF grid inf windw Set enableutfgridinfwindw t false Uncmment event listener Observe custm UTF grid inf windw This cncludes ur Hands n Lab, thank yu fr attending!

TRAINING GUIDE. Overview of Lucity Spatial

TRAINING GUIDE. Overview of Lucity Spatial TRAINING GUIDE Overview f Lucity Spatial Overview f Lucity Spatial In this sessin, we ll cver the key cmpnents f Lucity Spatial. Table f Cntents Lucity Spatial... 2 Requirements... 2 Setup... 3 Assign