Oskari.org

Last modified by Ossi OpenSource on 2012/03/15 15:17

Oskari.org

Developer Web Site for Oskari Map Application Framework

oskarin-kartat.png

Oskari Map Application Framework

Oskari.org is a web site to support the development of Oskari Open Source JavaScript Map Application Framework.
The Map Application framework is implemented as a collection of reusable bundles.

Bundles are used as uniform containers to ship and share new functionality to the application setups. Additions to existing functionality are implemented as Plugins shipped within the bundles.

Oskari version 12 provides applications with loose coupling and inter-bundle messaging with Requests and Events, configuration, localization support. Loose coupling enables reusing bundles in different application setups.

See  demos below to see the same bundles used in different application setups.

Map functionality is implemented with OpenLayers. The user interface components are based on jQuery, YUILibrary, DOJO Toolkit, RightJS, see Open Source JavaScript libraries for a more complete list of libraries used and to be used.

Demos

Preview for the next version of Paikkatietoikkuna Map Window

Map Application based on Oskari DIV Manager goes 3D

oskari-div-manager-all-in-hd-small.png
 

Map Application based on Oskari DIV Manager

oskari-div-manager-all-in-hd-small.png

  • Oskari DIV Manager hosting bundles implemented with various libraries
    • Dojo, ExtJS, jQuery, jQueryUI, KendoUI, YUILibrary - a sample for each and the staff favourite - 'all in' with all the libaries on one page
  • New for version 12
    • Oskari DIV Manager is a kind of user interface controller for extension bundles
    • This partial implementation is a proof-of-concept of the more polished DIV manager that will be available with the stable version 11

Upgraded Quickstart Guide Demo

NG-QSG-small.pngquickstartguide-small.png

More Demos

oskarin-kartat.png

Published Map

  • based on Framework version 5.7

Versions and Versioning Scheme

 Target Version Lifecycle Source Code Status Date Support Summary 
  
oskari.org12Active, In DevelopmentAvailable
(12.1)		2012-04-11N/AProof-of-Concepts for Next Generation User Interface
paikkatietoikkuna.fi11Active, In Development2012-05
(preview)		2012-03-29Stable, LTSNext Generation User Interface backed by upgraded Liferay instance
oskari.org10Frozen, Superseded by 12Available
(10.1)		N/A
paikkatietoikkuna.fi9Active, In Internal Testing 2012-05Stable, LTSUpgrade for Paikkatietoikkuna Published Map
oskari.org8ObsoleteAvailable
(8.7)		N/A
paikkatietoikkuna.fi7Active, In MaintenanceAvailable
(7.4)		2012-03-12Stable, LTSCurrent Full Map for Paikkatietoikkuna
oskari.org6ObsoleteAvailableN/AOverhaul
paikkatietoikkuna.fi5Active, In MaintenanceAvailable
(5.7)		Stable, LTSCurrent Published Map for Paikkatietoikkuna
paikkatietoikkuna.fi4ObsoleteAvailableN/A
paikkatietoikkuna.fi3ObsoleteAvailableN/ARefactored release for Paikkatietoikkuna
paikkatietoikkuna.fi2ObsoleteN/AN/AFirst release for Paikkatietoikkuna
paikkatietoikkuna.fi1ObsoleteN/AN/ADeveloped for the Pilot version

Documentation

Quick Start Guide

Class Documentation

Framework Concepts

  • Application Architecture and Core Concepts
    • see Core Concepts 
    • Loose Coupling for Extension bundles with Request and Event processing
    • Inter bundle communication shall use Requests and Events to avoid hardcoding inter-bundle dependencies
    • Loose coupling with requests and events enables replacing some or all functionality - with hopefully some enhanced implementation
  • User Interface Concepts
    • Map View Plugin - protocol to add functionality directly to the map view
    • Oskari DIV Manager - provides basic user interface services and protocols to add flyouts and menutiles using
      • Flyout Plugin
      • Menu Tile Plugin
    • Map Layer Service Model Plugin - protocol to add support to new types of map layer
    • Search Result Plugin - protocol to add support to new types of search results
  • Bundle Documentation
  • Class and Protocol Documentation
  • Localization
  • Map Default Projection

Sequence Diagrams

  • Framework supports generating Sequence Diagrams when debug mode is enabled

Case studies

Project Information

Contributing Organizations

Development

  • Oskari Open Source Map Application framework is currently developed in Project PORTTI-2 for National Land Survey of Finland until 2012-12
  • Oskari samples and Proof-of-Concepts  are developed in Project PORTTI-2 by National Land Survey of Finland until 2012-12
  • The Development process described (tbd 2012-03)

Collaboration

Contributed Bundles

  • Core Bundles for Paikkatietoikkuna Map Window are developed for NLSFI 
  • Application Bundles for Paikkatietoikkuna Map Window developed for NLSFI
  • Sample and Proof of Concept Bundles for Oskari.org developed by NLSFI
  • Sample and Proof-of-Concept Bundles for Quick Start Guide developed by NLSFI
  • Coordinate Transformation bundle by fgi.fi

Copyright, Copyleft and Licensing

Project Resources

Oskari Development environment

  • Minimum requirement for developing Oskari JavaScript
    • A a recent,decent browser such as Safari, Chrome, Firefox and a JavaScript code editor - however Aptana is recommended as code editor, see below
    • Internet explorer is supported as runtime but is not recommended for any development other than compatibility and runtime testing.

Oskari Project setup to be used with Aptana

  • Aptana project snapshot with any required files is available since 2012-04-03
    • Please contact NLSFI for preview snapshots  - public snapshot is shifting to 2012-05 due to excess workload 
    • This is a TGZ file with the Oskari Aptana project directory - this file can be imported to Aptana with Import...> Import Existing Projects > Select Archive
    • Oskari Aptana project contains required browser side functionality. 
    • WebGL Earth bundle was successfully developed with this snapshot.
    • Backend support such as map services and ajax services is not included in this project setup.
  • see also: The upgraded Project directory structure for versions 11 and 12
  • see also: Upcoming Source Repository changes
  • Aptana is available for download from http://aptana.com/. Aptana has been a major productivity booster for Oskari development.

Oskari Source Code

  • Source Code Snapshots with external (Ext, OpenLayers etc) library dependencies as ZIP files

Oskari Source Repository

  • Currently Oskari has a public Subversion viewer for release snapshots. The repository is currently not used in development but only for distribution and viewing of sources. This will change. 
  • Git repository (read only or clone only) with a viewer will become available in 2012-08 and will replace current Subversion viewer 
  • See The Oskari Development Process for some information on the development process in relation to Oskari Git repository

Oskari Issue Tracking

  • Currently Oskari development has an internal JIRA to support issue tracking and the Agile development process for stable version
  • Public Issue tracker snapshots will become available in 2012-Q3 

Oskari Issue Reporting

  • Public Issue reporting will become available in 2012-Q3
  • You may use Paikkatietoikkuna feedback form to report any issues until Oskari issue reporting is live

Live Sites using the Map Framework

karttatiili.fi and kansalaisen.karttatiili.fi WMTS services

  • A map application to demonstrate National Land Surveys Open Data WMTS services will by the end of May 2012
    • The WMTS map tile service will be availabe at kansalaisen.karttatiili.fi for general public
    • The Service will also be used in both tiedostopalvelu.maanmittauslaitos.fi and www.paikkatietoikkuna.fi
  • The Service provides cached PNG map tiles as WMTS service to compatible clients
  • The WMTS tile configuration is compatible with paikkatietoikkuna.fi map configuration.
  • The application is based on Oskari version 12 proof-of-concepts
    • a known bug in this application setup prevents opening the pages in Internet Explorer 8 - this will be fixed 
  • Cached Datasets are being prepared - some parts of datasets will be cached on-demand
    • accept General Map Raster
    • accept Topographic Map Raster
    • cancel Background Map Series - Dataset for open data available for caching on 2012-05-14
    • cancel Basic Map Raster - Dataset for open data available for caching on 2012-05-14
    • cancel Ortophotos - Caching as PNG images in progress
  • Sample viewer applications for available datasets - opens by the end of May 2012-05
  • The service is part of NLSFI open data initiative, see NLSFI open data for more information
  • see OpenGIS Web Map Tile Service Implementation Standard for more information on WMTS
    • mmllogo.png

oskari.org

  • oskari-logo.png
    • Oskari demos are based on version 12 which includes bug fixes for 7.4 stable version

demo.paikkatietoikkuna.fi

  • Development version for next generation User Interface for paikkatietoikkuna.fi

tiedostopalvelu.maanmittauslaitos.fi

paikkatietoikkuna.fi

paikkatietoikkuna.fi - published maps

  • A development version 9 for published maps is available with support to embedding published maps on SSL secured sites
  • Maps generated with paikkatietoikkuna map publisher wizard
    • published maps are currently based on a maintained variation of Map Framework Version 5.
      • Published Map will be upgraded in first half of 2012
  • Top lists for usage
  • Published maps by NLSFI
    • mmllogo.png
    • NLSFI uses paikkatietoikkuna.fi published maps in contact information for district survey offices
      • example (unfortunately there's an extra character in the iframe URLs in the NLSFI site which prevents showing the map in Safari, Chrome currently)
Tags:
Created by Administrator on 2009/09/09 03:00
This wiki is licensed under a Creative Commons 2.0 license
XWiki Enterprise 3.2 - Documentation