Install map.apps SDI

Prerequisites

A compatible version of map.apps has to be installed before installing the map.apps SDI bundles. You will find the required map.apps version in the map.apps SDI release notes.

Install the map.apps SDI 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

Installing the Save State service

The Save State service is required to save app states persistently to a database. Follow these steps to install it.

  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 configuration file application.properties. By default, this file is located in [data.directory.location]/application.properties (see https://docs.conterra.de/en/mapapps/latest/installation/configuration.html#config-files for details).

  3. Add the following entry to this file. 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

  4. Additionally, append the entry sdi_appstatemanagerintegration to the property manager.config.viewbundles:

    manager.config.viewbundles=appmanagement,reportmanagement,bundlemanagement,mapapps-github-manager,bundleupdatechecker,sdi_appstatemanagerintegration

  5. Restart Tomcat and reload map.apps Manager in your browser. 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). Open the application.properties configuration file of the map.apps webapp (as described in the previous section). If not already present, add the following property with the URL to the geocoding service. Replace [yourKey] with your personal key.

+

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

Create an app

Now you can build 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:

    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. After that, press Next and publish the app.
    In the last step click Done and your map.apps SDI app is ready for use.
    Click Launch to start the app.
    Explore the map.apps SDI features in the highlighted areas.

    sdi functions