Zum Inhalt

Managed Configurations

Managed configurations allow the organization's IT admin to remotely specify settings for apps. This capability is particularly useful for organization-approved apps deployed to a work profile.

The way in which the configurations are defined depends on the MDM/EMM used. Usually there is an editor where available configurations can be set and transmitted to linked devices. For example, well known providers are Airwatch, iFrame, Mobile Iron, Google Play, Miradore, Mobile Device Manager Plus, Relution Enterprise Mobility Management Suite, ...

The configuration is splitted into multible bundles to simplify the readability and creation of these managed configurations. The following table contains the available bundles. Each bundle is descriped in its separate section.

Key Type Default Example Title Description Supported since app version
onboarding bundle empty_bundle details in onboarding section Onboarding This bundle contains all settings to customize and simplify the first app setup. 2.2.0
download bundle empty_bundle details in download section Download This bundle contains all settings to configure general downloads. 2.2.0

Onboarding

With this bundle you are able set up a hands-free initialization process of the localion navigator. This process is able to:

  • generate an user account for this installation from a volume license
  • define the required navigation maps
  • enforce an automatic download of this maps
Key Type Default Example Title Description
volumeLicenseUserName string "" "TestUser" Username of the volumelicense account Username of the account, that authorizes the creation of any user
volumeLicensePassword string "" "TestPassword" Password of the volumelicense account Encrypted password of the account, that authorizes the creation of any user
requiredMaps bundle array null [{requiredMap: {"requiredMapIdentifier": "DEU_TB_20304"}},{requiredMap: {"requiredMapIdentifier": "BEL_TB_20304"}}] Required maps Collection of all required maps to be installed.
forceAutomaticMapDownload boolean false true Automatic map download If the automatic map download is allowed, the map files are automatically downloaded immediately after the app starts, otherwise the user has to initiate the download manually via the download screen.
allowUserCancellation boolean true false Map download cancellation by the user If the cancellation is allowed by the user, the download can be canceled at any time, otherwise the user has to wait until the downloads are completed.

The requiredMaps-BundleArray consists of Bundles that can contain following parameters:

Key Type Default Example Title
requiredMapIdentifier string "" "DEU_TB_20304"
"DEU_TB_203"
The map identifier consisting of the country\'s ISO-3 code, map provider, map type and map version. You can leave out last two digits of the map version number.

Download

By default navigation maps will be provided by the localion navigator backend infrastructure.

You can define alternative Download URLs for navigation maps to provide them through your own infrastructure. This might be useful if you are planning to install multiple devices in a batch process and would like to avoid internet traffic.

A country-wide navigations map consist of to files: * Navigation Map with all street information - ends with .db * POI Database - ends with .lpd

Alternative download URLs for both files can be provided

Key Type Default Example Title Description
hostedMaps bundle array null [{hostedMap: {"hostedMapName": "DEU_TB_20304.db", "hostedMapUrl": "https://lbnavigator-maps/DEU_TB_20304.db"}}, {hostedMap: {"hostedMapName": "DEU_TB_20308.lpd", "hostedMapUrl": "https://lbnavigator-maps/DEU_TB_20308.lpd"}}] Hosted maps Collection of all hosted maps consisting of the map names and map urls
allowMobileDownloads boolean true false Usage of mobile networks If the use of mobile data is allowed, maps can be downloaded via it, otherwise a wifi connection is required.

The hostedMaps-BundleArray consists of Bundles that can contain following parameters:

Key Type Default Example Title
hostedMapName string "" "DEU_TB_20304.db" The name of the map file consisting of the country\'s ISO-3 code, map provider, map type, map version and file ending
hostedMapUrl string "" "https://lbnavigator-maps/DEU_TB_20304.db" The download url that points to the self hosted map file

Example

This file contains examples for all available key-value-apirs:

{
  "onboarding": {
    "volumeLicenseUserName": "TestUser",
    "volumeLicensePassword": "TestPassword",
    "requiredMaps": [
      {
        "requiredMapIdentifier": "DEU_TB_203"
      },
      {
        "requiredMapIdentifier": "BEL_TB_203"
      }
    ],
    "forceAutomaticMapDownload": true,
    "allowUserCancellation": true
  },
  "download": {
    "allowMobileDownloads": true,
    "hostedMaps": [
      {
        "hostedMapName": "DEU_TB_20304.db",
        "hostedMapUrl": "https://lbnavigator-maps/DEU_TB_20304.db"
      },
      {
        "hostedMapName": "DEU_TB_20308.lpd",
        "hostedMapUrl": "https://lbnavigator-maps/DEU_TB_20308.lpd"
      },
      {
        "hostedMapName": "BEL_TB_20304.db",
        "hostedMapUrl": "https://lbnavigator-maps/BEL_TB_20304.db"
      },
      {
        "hostedMapName": "BEL_TB_20308.lpd",
        "hostedMapUrl": "https://lbnavigator-maps/BEL_TB_20308.lpd"
      }
    ]
  }
}