Creating a Mobile Service App Settings File

To create a Mobile Service App Settings file, open session Mobile Service App Settings (tsmdm5110m000) and create a record by entering an app setting code and description. A settings file needs to be added to the record. The session allows a default settings file that is already present in LN to be imported. After importing the default settings file, it can be downloaded from the session, edited and uploaded again. It is also possible to create a new settings file instead of using the default setting file.

The settings file is an xml file and it must have the following structure:
<AppSettings>
        <AppSetting>
                <Name></Name>
                <DataType></DataType>
                <Value></Value>
                <IsReadonly></IsReadonly>
        </AppSetting>
        <AppSetting>
                <Name></Name>
                <DataType></DataType>
                <Value></Value>
                <IsReadonly></IsReadonly>
        </AppSetting>
        <AppSetting>
               … etc
        </AppSetting>
</AppSettings>
Each AppSetting element describes a single setting in the app. It has the following sub elements:
Element Description
Name The name of the setting
DataType The data type of the setting (string / integer / double / boolean / enum)
Value The value of the setting
IsReadonly Whether the setting can be changed by the service employee (true / false)

The name element must match a name as defined in the last paragraph of this Appendix. Each setting has a specific data type. This can be a string denoting a text, an integer representing a whole value (1, 2, -7, 32), a double representing a fractional value (1.5, 2.3, -0.53, 1006.349), a boolean representing a true or false value, and lastly there are enum data types where the value can only be a value from a restricted set of values (for example, colors: red / blue / green, mode: automatic / manual / disabled). The data type of each setting as well as the allowed set of values for settings with an enum data type can be found in the last paragraph of this chapter.

Settings which are not set to read-only will only affect new installations of Mobile Service. These settings function only as an initial default. Settings which are set to read-only will not only affect new installations of Mobile Service but will also be enforced onto existing installations. Although the default setting file which can be imported in LN has a definition for each setting, not all settings have to be defined in the file. It is sufficient to add only those settings for which an initial default is desired, or which need to be made completely read-only.