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
appBehaviour	bundle	empty_bundle	details in app behaviour section	App Behaviour	This bundle contains all settings to customize the app\'s behavior.	2.5.2

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.
disableManualDownloads	boolean	false	false	Disable manual downloads	If set to true, disables the users ability to manually download new maps from the download menu in the app.

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

App Behaviour

Key	Type	Default	Example	Title	Description
signOutButtonDisabled	boolean	false	true	Deactivate logout	If logout is deactivated, clicks on the logout button are ignored.
responsibilityHintsDisabled	boolean	false	true	Disable Responsibility Hints	If this setting is enabled, the driver's responsibility hint will not be displayed.
skipOptionalPermissions	boolean	false	true	Skip Optional Permissions	If this setting is enabled, the navigator will not prompt for not yet granted optional permissions upon startup.
specialRightsRoutingAllowed	boolean	false	true	Allow special rights routing	If this setting is enabled, the navigator does allow special rights routing.

Example

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

{
  "onboarding": {
    "volumeLicenseUserName": "TestUser",
    "volumeLicensePassword": "TestPassword",
    "requiredMaps": [
      {
        "requiredMapIdentifier": "DEU_TB_203"
      },
      {
        "requiredMapIdentifier": "BEL_TB_203"
      }
    ],
    "forceAutomaticMapDownload": true,
    "allowUserCancellation": true
  },
  "download": {
    "allowMobileDownloads": true,
    "disableManualDownloads": 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"
      }
    ]
  },
  "appBehaviour": {
    "signOutButtonDisabled": true,
    "responsibilityHintsDisabled": true,
    "skipOptionalPermissions": true,
    "specialRightsRoutingAllowed": true
  }
}