App Settings XML file – Element names, data types and possible values

The following table defines all the available app setting names, the data types of the app settings and the possible values:

Name (Label of setting in the app)

Data Type Values

AutomaticallySendReceiveData

(Windows: Send and receive data automatically)

(Android/iOS: Automatically)

enum

manual.sync

auto.sync

AutomaticReceiveIntervalSeconds

(Windows: Automatic receive interval in seconds)

(Android/iOS: Receive interval)

integer Any positive integer

AutomaticSendIntervalSeconds *

(Automatic send interval in seconds)

integer Any positive integer
AutomaticSendReceiveWhenActivityPausedOrCompleted

(Windows: Send and receive data when pausing or completing an activity)

(Android/iOS: When activity paused or completed)

boolean

True

False

AutomaticSendReceiveWhenOrderingBenchStock

(Windows: Send and receive data when ordering bench stock)

(Android/iOS: When ordering bench stock)

boolean

True

False

NumberOfDaysToKeepSynchronizationLog

(Windows: Number of days to keep synchronization log)

(Android/iOS: Period to keep synchronization log)

integer Any positive integer

SendGPSInformation

(Send GPS information)

boolean

True

False

RefreshLabelsAtStartUp

(Windows: Refresh application labels at startup)

(Android/iOS: Refresh at startup)

boolean

True

False

CodeAndDescriptionDisplayFormat

(Windows: Display format for code and description fields)

(Android/iOS: Code and description fields)

enum

description.default.to.code

description.and.code

code

code.and.description

CodeAndDescriptionSeparator

(Separator)

string Separator character(s), like for example -, --, [, or (

UseItemSpecificCodeAndDescriptionDisplayFormat

(Windows: Display format for item code and description

(Android/iOS: Item code and description)

boolean

True

False

ItemSpecificCodeAndDescriptionDisplayFormat

(Windows: Display format for item code and description)

(Android/iOS: Item code and description)

enum

description.default.to.code

description.and.code

code

code.and.description

ItemSpecificCodeAndDescriptionSeparator

(Seperator)

string Separator character(s), like for example -, --, [, or (

ScanBarcodeItemCode

(Enable item code scanning)

boolean

True

False

ScanBarcodeSerialNumber

(Enable serial number scanning)

boolean

True

False

ScanBarcodeSearch

(Enable search term scanning)

boolean

True

False

UseUserLanguage

(Use user language)

boolean

True

False

LanguageUsedByApplication

(Language used by application)

string This setting is only applicable when UseUserLanguage has the value false, and then it should contain one of the language codes as defined in Software Languages (ttaad1510m000).

MapProvider *

(Map Provider)

enum

open.street.map

windows.maps

AllowToAcceptDeclineVisits

(Allow to accept/decline a visit)

boolean

True

False

SplitVisitOnOverlap

(Split overlapping visits)

boolean

True

False

SplitVisitOnTime

(Split visits with intervals between activities)

boolean

True

False

NumberOfMinutesToSplitVisits**

(Minimum time in minutes between activities to split visit**/Split visit if time in minutes between activities exceeds***)

integer Any positive integer

VisitsToDisplay

(Visits to display)

enum

all.visits

for.specific.period

ShowVisitsBeforeDays

(Display from the past)

integer Any positive integer

ShowVisitsAfterDays

(Display of the future)

integer Any positive integer

InspectionCompletionCheck

(Check for uncompleted inspections during activity completion)

enum

never

warn

block

ChangeStatusActivitiesByOneAction

(Enable option to start, stop or complete multiple activities at once)

boolean

True

False

ConfirmCompletingActivities

(Ask for confirmation when completing activities)

boolean

True

False

DefaultAssignmentActualTimes

(Start and finish times of activities due to start, stop and complete actions, are based on)

enum

current

planned

StartStopTravel

(Travel registration with Start/Stop options)

boolean

True

False

ConfirmTravelStopData

(Show travel data when finishing travel)

boolean

True

False

ShowHoursBeforeWeeks

(Windows: Number of previous weeks for which to display hours)

(Android: Display from the past)

integer Any positive integer

ShowHoursAfterWeeks

(Windows: Number of following weeks for which to display hours)

(Android/iOS: Display of the future)

integer Any positive integer

AutomaticallyDownloadSerialHistory

(Windows: Automatically download serial history for active visits)

(Android/iOS: Automatically download for active visits)

boolean

True

False

SerialHistoryAutomaticDownloadPeriodValue

(Windows: Period to automatically download serial history data)

(Android/iOS: Period for automatic download)

integer Any positive integer

SerialHistoryAutomaticDownloadPeriodUnit

(Windows: Period to automatically download serial history data)

(Android/iOS: Period for automatic download)

enum

Year

Month

Day

SerialHistoryManualDownloadPeriodValue

(Windows: Period to manually download serial history data)

(Android/iOS: Period for manual download)

integer Any positive integer

SerialHistoryManualDownloadPeriodUnit

(Windows: Period to manually download serial history data)

(Android/iOS: Period for manual download)

enum

Year

Month

Day

SerialHistoryKeepHistoryPeriodValue

(Windows: Period to keep serial history data)

(Android/iOS: Period to keep history)

integer Any positive integer

SerialHistoryKeepHistoryPeriodUnit

(Windows: Period to keep serial history data)

(Android/iOS: Period to keep history)

enum

Year

Month

Day

ShowCompletedActivityListBeforeReport

(Show completed activities before generating visit report)

boolean

True

False

VisitReportBasedOn

(Windows: no label)

(Android: Based on completed activities of …)

enum

completed.activities.order

visit

RtfTemplatePdfConformanceLevel

(Pdf conformance level for rtf templates)

Enum

rich.text

none

pdf.a1.b

pdf.a2.b

pdf.a2.u

pdf.a3.b

pdf.a3.u

AutomaticallyDownloadDocuments

(Automatically download documents)

boolean

True

False

AutomaticDocumentsDownloadRange

(Download documents for)

enum

for.all.orders

for.orders.starting.within.days.from.now

AutomaticDocumentsDownloadDaysFromNow

(Days)

integer Any positive integer

* Only available for the Windows version. Has no influence on the Android/iOS version.

** Until solution 2131446.

*** From solution 2131446

Note: When the settings in Mobile Service do not contain the expected values or a certain setting can still be changed by the user while this was not expected, then the App Settings XML file may contain some incorrect names, types or values. Mobile Service logs incorrect names, data types and values in the log file. The log file can be uploaded to LN from the Settings – Support tab. To find errors in the App Settings XML file, search the log file for the tag AppSettingImport.
The following table lists technical settings that must be handled with care. Incorrectly setting the value of these settings in the App Settings XML file may lead to performance loss of the app or failure of data synchronization for all users of Mobile Service.
Name (Label of setting in the app) Data Type Values
BshellCommand

(Bshell Command(s))

String
LogLevel

(Log Level)

enum

error

info

debug

Note: Setting BshellCommand should mainly be used to disable the Bshell Command field in the app by setting the IsReadonly element in the xml file to true. It is strongly advised not to set any Bshell command value in this xml file.