Installation of map.apps SDI

Prerequisites

Install a compatible version of map.apps before installing map.apps SDI. Also make sure that your system matches the system requirements.

Install bundles

  1. Open map.apps Manager in your browser, go to Bundles and click the + button at the top.

  2. Upload the file ct-sdi-extension-<version>.jar containing the map.apps SDI bundles.
    This file is located in the root folder of the ZIP archive that you downloaded when you obtained map.apps SDI.

upload bundle

Install Save State Service

The Save State Service is required to save app states persistently to a database.

  1. Copy the file savestate.war from the obtained ZIP archive to the folder %TOMCAT%\webapps.

    If Tomcat is not already running, start it now. It will then automatically unpack the WAR file to a new folder webapps/savestate. This might take a few seconds.
    Alternatively, you can use the Tomcat Manager application running at http://localhost:8080/manager/html to deploy the WAR file.

  2. Open the map.apps application.properties. By default, this configuration file is located in the map.apps data.directory.location.

    1. Add the savestate.service.url.

      It is the full URL to the Save State Service followed by /resources/appstates.

      savestate.service.url=http://<yourserver>:<port>/savestate/resources/appstates
    2. Append the entry sdi_appstatemanagerintegration to the property manager.config.viewbundles:

      manager.config.viewbundles=appmanagement,reportmanagement,bundlemanagement,mapapps-github-manager,bundleupdatechecker,sdi_appstatemanagerintegration
  3. Restart Tomcat and reload map.apps Manager in your browser.

  4. Log in as an admin user.

    In map.apps Manager’s main toolbar, there should now be a new tool titled App States (Line 4).

    A tool named App States is the integration of map.apps App State Management for the outdated map.apps SDI 4.0.2 apps. These are based on map.apps line 3.
    app state

BKG Geocoding Service

For using the sdi_geocodingservice bundle in your app you’ll require a URL from the German Bundesamt für Kartographie und Geodäsie (BKG).

Please refer to Geocoding service documentation.

Create an app

Now you can create your own map.apps app with SDI features. Or try the bundled example apps to explore what is possible.

  1. Open map.apps Manager and click Apps.

  2. Click + Create and enter Title, App ID and a Description.

    create new app
  3. Click Next > Upload app.

    upload app
  4. Choose the provided example app sdi_full.

    upload app drag drop
  5. Choose Manual Configuration and change all URLs for your needs/environment or remove unneeded bundles.

    configuration menu
  6. Press Next and publish the app.

  7. In the last step click Done and your map.apps SDI app is ready for use.

  8. Click Launch to start the app and explore the map.apps SDI features in the highlighted areas.

    sdi functions

Uninstall

To uninstall map.apps SDI the following steps are necessary:

  1. Delete all map.apps apps using map.apps SDI bundles or remove the map.apps SDI bundles/functions from these apps.

  2. Delete all map.apps SDI bundles from the list of available bundles in the map.apps manager.
    You can filter the list with sdi_:

    • sdi_appstatemanagement

    • sdi_appstatemanagementshared

    • sdi_appstatemanagerintegration

    • sdi_appstatestore

    • sdi_copyrightviewer

    • sdi_geocodingservice

    • sdi_inspireviewlayer

    • sdi_loadservice

    • sdi_scalechanger

    • sdi_seasons-extension

    • sdi_share-link

    • sdi_srschanger

    • sdi_srs-layer-restrictor

    • sdi_themes_extension5

    • sdi_toc

  3. Remove the Save State Service — usually named savestate — from the available webapps in your tomcat.
    Either use tomcat functions or delete the folder and WAR files in the tomcat webapp folder.

  4. Remove all entries for map.apps SDI properties in your map.apps application.properties.
    E.g. savestate.service.url or the entry for sdi_appstatemanagerintegration in property manager.config.viewbundles.