Plugin: Google Map Dashboard

From iDempiere en
Jump to navigation Jump to search


Googlemap-idempiere.png


Idea

  • We create this plugin to improve the visual value of iDempiere data lookup using google map. The goal is to create a Plugin available for community usage but in case of commercial implementation to have ability to use data commercial way. Plugin depends on Google API which is available in free tier and commercial package.


Description

  • Google Map Dashboard Plugin is a regular Dashboard Content, able to visualise data from iDempiere database.
  • Functionality - we have implement two use-case to demonstrate this feature. First is Business Partner visualisation, second is Assets based on selected Asset group.
  • Customisation - Your developers can customise data will be rendered on GoogleMap. It is up to your imagination.


Install Notes, Steps

  1. Create google account, Obtain your own API key - https://developers.google.com/maps/documentation/javascript/tutorial?hl=cs#api_key
  2. Database (Setup keys in system configurator)
    1. OPTION 1 - i. Apply link SQL INSERT to database (this will create dashboard content and system config for API Key) ii. Login as System Administrator, open System Configurator Window, look for GOOGLE_MAPS_API_KEY and fill value with your obtained API key. Optionally you can set different API keys for each Client
    2. OPTION 2 - i. As System admin create new Dashboard Content with zul file path "/zul/gmap.zul" ii. As System admin create new System Configurator record with name GOOGLE_MAPS_API_KEY and value fill with your obtained API key. Optionally you can set different API keys for each Client
  3. Deploy fragment project to Server (Install plugin trough felix console (download from bitbucket))
  4. Create Dashboard Preference with new Dashboard Content

Remark:

  • If you want to change marker icons, create new records in System configurator (Client level) with names GMAP_ASSET_MARKER or GMAP_BPARTNER_MARKER and fill value with image name (e.g. BPartner20.png)
  • With selected Business Partner are displayed Assets, if you want to disable this feature, create record in System Configurator with name GMAP_SHOW_BPARTNER_ASSET and value "false". This can be done too on Client level.

If you want to provide additional comments, please use the Discussion page

Known unresolved tasks

  • Handle Marker click events //resolved 24.04.2014
  • Reopen Marker text is not possible //resolved 24.04.2014