Install map.apps SDI

Prerequisites

Install a compatible version of map.apps before installing the map.apps SDI bundles.

Install map.apps SDI

  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 resources/savestate/ct-savestate-<version>.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/ct-savestate-<version>. 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>/ct-savestate-<version>/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).

  1. Open the map.apps application.properties configuration file.

  2. Add the following property with the URL to the geocoding service and replace [yourKey] with your personal key.

    geocoding.service.url=https://sg.geodatenzentrum.de/gdz_ortssuche__[yourKey]

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