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.