MicroStrategy ONE

Device Preferences: General Settings in iOS

The tables below provide a list of general settings that affect the mobile application. Some of these general device preferences can be set on both the client and server, while others can be set only on the client. Some client-side preferences can be configured through a UI.

The top level node in Preferences.xml is the <dp node, which has two child nodes—<cnf for the configuration and <cld for the cloud configuration. The top level node for general settings is the <gnl child node under <cnf. All of the child nodes of the <gnl node are listed in the table below, with detailed explanations in the three tables that follow.

Parent Element

  • Child Element 1

  • Child Element 2

 Parent Element Attributes Description Data Type Default Value

 

<dp

 

 

Device preference  (available only on the client)

 

 

 

<cnf

 

 

Represents the configuration

 

 

 

<cld

 

 

Represents the cloud configuration (available only on the client)

 

 

 

 

<gnl

 

 

This node contains the settings that appear on the "General" tab in the configuration interface

 

 

Preferences that can be set on both the client and the server

Parent Element

  • Child Element 1

  • Child Element 2

Parent Element Attributes

 Description

Data Type

Default Value

Parent Element

  • Child Element 1

  • Child Element 2

Parent Element Attributes

 Description

Data Type

Default Value

 

<ac>

 

 

 

Accent color

 

 

 

<atc>

 

 

Application theme

 

Integer enumeration

-1 = Not defined

 1 = Dark

 2 = Light

 

-1  Not defined

 

<aul>

 

 

Allow user to log out (display logout option)

 

Boolean

 

false

[Logout option is not displayed. User cannot log out.]

 

<bgd>

 

 

Enable background download

 

Boolean

 

 

<ccl>

 

 

Clear cache after user logs out

 

Boolean

 

false

[Cache is not cleared when user logs out.]

 

 

<dbwt>

 

 

Interval (in seconds) after which the device password must be reentered when the app has been in the background and is brought to the foreground

 

 

Integer

 

300

 

<dcn>

 

 

Minimum length of the device password

 

 

Integer

 

4

 

 

<dd>

 

 

 

Interval (in seconds) of wait time for the user to enter the password after entering an incorrect password

 

 

Integer

 

 

0

 

<dmatp>

 

 

 

Maximum allowed attempts to enter device password

 

 

Integer

 

10

 

<drcl>

 

 

 

Device password requires at least one capital letter

 

 

Boolean

 

false

[DPC does not require capital letter.]
 

 

<drld>

 

 

 

Device password must be entered after locking device

 

Boolean

 

false

[DPC is not required after locking device.]
 

 

<drn>

 

 

Device password requires at least one numeric

 

Boolean

 

false

[DPC  does not require number.]
 

 

<drsc>

 

 

 

Device password requires at least one special character

 

Boolean

 

false

[DPC does not require special characters.]
 

 

<dtm>

 

 

Use default security policy

 

 

Boolean

 

true

[Use default security policy. Do not require a device password or touch to open the application.]

 

 

<ea>

 

 

 

Enable annotations

 

 

 

<eaok>

 

 

Need to use external app to open Keynote files

 

Boolean

 

false

[Do not use external app to open Keynote]

 

 

<eps>

 

 

 

Enable sharing, including emailing, printing, and saving photos to new server

 

 

 

 

<gme>

 

 

Enable Google Maps

 

 

 

<gmk>

 

 

Google Maps key

 

 

 

<gmpk>

 

 

Google Maps premier key

 

 

 

<gmu>

 

 

Google Maps key URL

 

 

 

<hwa>

 

 

 

 

 

<mgc

 

 

Maximum supported number of columns in a grid

 

 

Integer

 

iPhone: 10

iPad: 50

 

Preferences that can be set on the client only and have a configuration UI

  • Child Element 1

  • Child Element 2

Parent Element Attributes

Description

Data Type

Default Value

<cc>

 

Specifies whether to clear caches automatically or when the application closes

Integer enumeration

1 = CacheClearModeAutomatic

2 = CacheClearModeOnClose

1  (CacheClearModeAutomatic)

[Caches are cleared automatically.]

 

<datml

 

 

Maximum amount of memory (in KB)that can be used for data (memory limit of data size)

 

 

Integer

 

iPhone:  10000

iPad2:  25000

iPad3:  25000

 

 

<de>

 

 

Enable diagnostics by default

 

 

Boolean

 

false  

[Diagnostics are disabled.]

 

 

<defml

 

 

Maximum amount of memory (in MB)that can be used for the definition (memory limit of definition size)

 

 

Integer

 

5

<dul

 

Disable unavailable links in offline mode

Boolean

true  

[Unavailable links are disabled in offline mode.]
 

<fc

 

Enable folder caching

[If folder caching is disabled, the app will connect tot he server every time folder browsing occurs]

Boolean

true  
[Folder caching is enabled.]

<ll

 

Logging level

[Logs are displayed according to the logging level]

Integer enumeration

  0 = All

  2 = Finest

  4 = Finer

  6 = Fine

  8 = Config

10 = Info

12 = Warning

14 = Severe

16 = Off

12  (Warning)

 

<mns

 

 

Monitor network status

 

 

Boolean

 

true

 

<nt

 

Interval (in seconds) after which the network request will be terminated

Integer

60

 

<renml

 

 

Maximum amount of memory (in MB)that can be used for rendering (memory limit of rendering)

 

 

Integer

 

iPhone:  60

iPad2:  60

iPa3d:  200

 

<usl

 

Allow users to access logging settings (show the logging section in the Advanced Settings page)

Boolean

true

[Users can access logging settings.]

Preferences that can be set on the client only, but do not have a configuration UI

Parent Element

  • Child Element 1

  • Child Element 2

Parent Element Attributes

Description

Data Type

Default Value

 

<art>

 

 

Acceptable network response time (in seconds)

 

 

Integer

 

2

<cpurl

 

Cloud Personal Server URL

If the value is empty, the URL in the bundle is used.

String

" "

 

<crd>

 

 

Interval (in seconds) after which real-time data is cached

 

 

Integer

 

0

 

<cs>

 

 

Certificate server

 

 

String

 

" "

 

<cvi>

 

 

Interval (in seconds) after which device caches are validated

 

 

Integer

 

600

 

<dbpv

 

 

Disable the built-in PDF viewer

 

 

Boolean

 

false

[Built-in PDF viewer is not disabled.

 

 

<dt

 

 

Device token sent back from APNS (Apple Push Notification Service)

 

 

String

 

" "

 

<dw

 

 

Use data wipe feature when client certificate contains error

 

 

Boolean

 

false

[Data wipe feature cannot be used.]

 

<efs

 

 

Display full screen button

 

 

Boolean

 

true  

[Full screen is enabled. Full screen button is displayed.]

 

 

<eopdf

 

 

Allow users to open PDF documents in external applications

 

 

Boolean

 

true

[Users can open PDF documents in external applications.]

 

<es>

 

 

Enable sharing, including emailing, printing, and annotation for old server

 

 

Boolean

 

true

 

<gdid

 

 

 

Good Dynamics application ID

 

 

String

 

 

gdid

 

<gdver

 

 

 

Good Dynamics application version

 

 

String

 

 

gdver

 

<ipe

 

 

Ignore user privileges errors during Reconcile

 

 

Boolean

 

false  

[User privileges errors are not ignored during Reconcile.]

 

 

<lml

 

 

Learn More link

 

String

 

" "

 

<locid

 

 

Device locale identifier when used

 

 

String

 

" "

 

<ml>

 

 

Maximum amount of memory (in MB) that can be used for caching (memory limit)

Used with sl to determine the threshold of cache cleanup:

Threshold = ml * sl / 100

 

 

Integer

 

250

 

<mls

 

 

Maximum number of entries that can be made to the log file/stored on the device  (maximum log size)

 

 

Integer

 

250

 

<msc

 

 

Maximum number of status entries that are stored

 

 

Integer

 

50

<mids

 

Maximum incremental data slice size (in MB)

Integer

50

 

<msi

 

 

Number of days after which a status entry is deleted from the status store

 

 

Integer

 

7

 

<npc

 

 

Never persist credentials to local storage on a device

 

Boolean

 

false

[Credentials ]are persisted on device local storage. Credentials are saved in preferences.xml from one app session to the next.]

 

 

<pe

 

 

Interval (in minutes) after which the password expires

 

 

Integer

 

-1 (Never)

 

<plc

 

 

Automatically pre-load caches

 

Integer enumeration

1 = CachePreLoadModeAutomatic

2 = CachePreLoadModeOff

 

 

1  (CachePreLoadModeOff)

[Caches are not pre-loaded.]

 

<pn

 

 

Enable push notification between the mobile device and Intelligence Server

 

 

Integer enumeration

1 = PushNotificationOn

2 = PushNotificationOff

 

2  (PushNotificationOff)

[Push notification is not enabled.]

 

<ps

 

 

Maximum size of a PDF file (in kilo pixels) supported by the app

 

 

Integer

 

2048

 

<rar

 

 

Interval (in minutes) after which a user must be re-authenticated

[If the app is interrupted or suspended longer than the reauthorization timeout, the user must be reauthenticated to the project when the app is resumed.]

 

 

Integer

 

5

 

<sci

 

 

Interval (in seconds) after which the application checks for new subscriptions

 

 

Seconds

 

600

 

<scl

 

 

Show cached login on authentication prompt (including authentication prompt and confidential login)

 

 

Boolean

 

false  

[Cached login is not displayed.]

 

<sf>

 

 

Security framework to be used

 

 

Integer enumeration

0 = SecurityFrameworkUnknown

1 = SecurityFrameworkDefault

2 = SecurityFrameworkGoodDynamics

 

 

1 = SecurityFrameworkDefault

 

 

<sl

 

 

Soft limit % (in whole numbers) of the maximum amount of memory that can be used to clean up in the background when caching. Once this limit is reached, the app will start releasing memory.

Used with ml to determine the threshold of cache cleanup:

Threshold = ml * sl / 100

 

 

Integer

 

90

 

<slml

 

 

Show Learn More link

 

 

Boolean

 

true  

[Learn More link is displayed.]

 

 

<uas

 

 

Allow users to access settings

 

 

Boolean

 

true

[Users can access settings.]

 

 

<ucs

 

 

Use the certificate server

 

 

Boolean

 

false

[Certificate server is not  used.]

 

 

<uifs

 

 

Use the full screen on an iPhone 5

 

 

Boolean

 

false

[Full screen is not used on an iPhone 5.]

 

 

<uptc

 

 

Time period (in minutes) after which the configuration is automatically updated

 

 

Integer

 

-1 (Never)

 

<usc

 

 

Allow users to access cache settings (show the caching section in the Advanced Settings page)

 

 

Boolean

 

true

[Users can access cache settings.]

 

<usd

 

 

Allow users to access diagnostics mode settings (show the diagnostics section in the Advanced Settings page)

 

 

Boolean

 

true

[Users can access diagnostic settings.]