Settings Manager

EMDK For Xamarin - 2.5

Overview

The SettingsMgr controls access to specific items in the System Settings Menu.

All Android devices provide an in-device System Settings Menu that a device user can access to configure a variety of System Settings. Some of these System Settings may be sensitive in nature and could lead to undesired consequences if a device user changed them inappropriately.

Zebra Android devices provide a few ways to prevent a device user from making unwanted changes via the System Settings Menu. The AppMgr can be used to disable launching of the System Settings Menu application altogether. The AccessMgr can restrict the device user to a limited version of the System Settings Menu with a reduced set of capabilities (e.g. Display, Volume, About). In some cases it may be important to allow the device user to configure more System Settings while preventing configuration of especially sensitive ones.

The SettingsMgr provides individual control over access to select System Settings in the System Settings Menu.

Main Functionality

Turn On or Off the ability for the device user to do the following from the System Settings Menu:
- Perform an Enterprise Reset of the device
- Change the Wi-Fi configuration of the device
- Change whether applications from Unknown Sources (e.g. not from the Google Play Store) can be installed
- Turn Airplane Mode On or Off
- Access the "Apps" section, where installed and running applications can be affected

Ability to invoke Enterprise Reset in Settings UI

This parm allows you to specify whether or not the device user will be allowed invoke the "Enterprise data reset" function, usually found in the "Backup & reset" section of the System Settings Menu. Since this function could lead to data loss or could render a device less functional, it may be advisable to prevent device users from invoking it.

Note: Just because access to a Storage Card is not blocked, the Storage Card may or may not be accessible. For example, if the Storage Card is implemented by physically removable media and there is no media in the slot, then the Storage Card would not be accessible even though access to the Storage Card was enabled. Or, if the Storage Card was encrypted, and the Named Key was removed from the Key Storage Database (see the EncryptMgr), the Storage Card would not be accessible even though it was present and not blocked.

Parm Name: InvokeEnterpriseReset

Option	Name	Description	Requires
0	Do not change	This value (or the absence of this parm from the XML) will cause no changes to be made as to whether or not a device user will be allowed to invoke the "Enterprise data reset" function from the System Settings Menu.	OSX: 4.2+ MX: 4.2+
1	Enable	This value will cause the device user to be allowed to invoke the "Enterprise data reset" function from the System Settings Menu.	OSX: 4.2+ MX: 4.2+
2	Disable	This value will cause the device user to be prevented from invoking the "Enterprise data reset" function from the System Settings Menu.	OSX: 4.2+ MX: 4.2+

Option

Name

Description

Requires

Do not change

This value (or the absence of this parm from the XML) will cause no changes to be made as to whether or not a device user will be allowed to invoke the "Enterprise data reset" function from the System Settings Menu.

OSX: 4.2+

MX: 4.2+

Enable

This value will cause the device user to be allowed to invoke the "Enterprise data reset" function from the System Settings Menu.

OSX: 4.2+

MX: 4.2+

Disable

This value will cause the device user to be prevented from invoking the "Enterprise data reset" function from the System Settings Menu.

OSX: 4.2+

MX: 4.2+

Ability to Turn Wifi On/Off in Settings UI

This parm allows you to specify whether or not the device user will be allowed to change any Wi-Fi configuration from the "Wi-Fi" section of the System Settings Menu and the Quick Settings.

Note: While the title of this parm might make it seem that it only controls whether the device user is allowed to Turn Wi-Fi On or Off, it actually controls whether any changes to Wi-Fi configuration can be made. There is no way to control the ability to Turn Wi-Fi On and Off independently of other Wi-Fi configuration.

Parm Name: WifiSettingsUI

Option	Name	Description	Requires
0	Do not change	This value (or the absence of this parm from the XML) will cause no changes to be made as to whether or not a device user will be allowed to make changes to the Wi-Fi configuration from the System Settings Menu and the Quick Settings.	OSX: 4.3+ MX: 4.3+
1	Enable	This value will cause the device user to be allowed to make changes to the Wi-Fi configuration from the System Settings Menu and the Quick Settings.	OSX: 4.3+ MX: 4.3+
2	Disable	This value will cause the device user to be prevented from making changes to the Wi-Fi configuration from the System Settings Menu and the Quick Settings.	OSX: 4.3+ MX: 4.3+

Option

Name

Description

Requires

Do not change

This value (or the absence of this parm from the XML) will cause no changes to be made as to whether or not a device user will be allowed to make changes to the Wi-Fi configuration from the System Settings Menu and the Quick Settings.

OSX: 4.3+

MX: 4.3+

Enable

This value will cause the device user to be allowed to make changes to the Wi-Fi configuration from the System Settings Menu and the Quick Settings.

OSX: 4.3+

MX: 4.3+

Disable

This value will cause the device user to be prevented from making changes to the Wi-Fi configuration from the System Settings Menu and the Quick Settings.

OSX: 4.3+

MX: 4.3+

Ability to Turn UnknownSources On/Off in Settings UI

This parm allows you to specify whether or not the device user will be allowed to Turn On or Off the ability to install applications from "Unknown Sources" on or off from the "Security" section of the System Settings Menu.

Parm Name: UnknownSources

Option	Name	Description	Requires
0	Do not change	This value (or the absence of this parm from the XML) will cause no changes to be made as to whether or not a device user will be allowed to Turn "Unknown Sources" On or Off from the System Settings Menu.	OSX: 4.3+ MX: 4.3+
1	Enable	This value will cause the device user to be allowed to Turn "Unknown Sources" On or Off from the System Settings Menu.	OSX: 4.3+ MX: 4.3+
2	Disable	This value will cause the device user to be prevented from Turning "Unknown Sources" On or Off from the System Settings Menu.	OSX: 4.3+ MX: 4.3+

Option

Name

Description

Requires

Do not change

This value (or the absence of this parm from the XML) will cause no changes to be made as to whether or not a device user will be allowed to Turn "Unknown Sources" On or Off from the System Settings Menu.

OSX: 4.3+

MX: 4.3+

Enable

This value will cause the device user to be allowed to Turn "Unknown Sources" On or Off from the System Settings Menu.

OSX: 4.3+

MX: 4.3+

Disable

This value will cause the device user to be prevented from Turning "Unknown Sources" On or Off from the System Settings Menu.

OSX: 4.3+

MX: 4.3+

Ability to Turn Airplane Mode On/Off in Settings UI

This parm allows you to specify whether or not the device user will be allowed to Turn "Airplane Mode" On or Off from the "Wireless & Networks" section of the System Settings Menu, from the Quick Settings, and from the Power Key Menu.

Parm Name: AirplaneMode

Option	Name	Description	Requires
0	Do not change	This value (or the absence of this parm from the XML) will cause no changes to be made as to whether or not a device user will be allowed to Turn "Airplane Mode" On or Off from the System Settings Menu, Quick Settings, and Power Key Menu.	OSX: 4.3+ MX: 4.3+
1	Enable	This value will cause the device user to be allowed to Turn "Airplane Mode" On or Off from the System Settings Menu, Quick Settings, and Power Key Menu.	OSX: 4.3+ MX: 4.3+
2	Disable	This value will cause the device user to be prevented from Turning "Airplane Mode" On or Off from the System Settings Menu, Quick Settings, and Power Key Menu.	OSX: 4.3+ MX: 4.3+

Option

Name

Description

Requires

Do not change

This value (or the absence of this parm from the XML) will cause no changes to be made as to whether or not a device user will be allowed to Turn "Airplane Mode" On or Off from the System Settings Menu, Quick Settings, and Power Key Menu.

OSX: 4.3+

MX: 4.3+

Enable

This value will cause the device user to be allowed to Turn "Airplane Mode" On or Off from the System Settings Menu, Quick Settings, and Power Key Menu.

OSX: 4.3+

MX: 4.3+

Disable

This value will cause the device user to be prevented from Turning "Airplane Mode" On or Off from the System Settings Menu, Quick Settings, and Power Key Menu.

OSX: 4.3+

MX: 4.3+

Ability to Access Apps Section in Settings UI

This parm allows you to specify whether or not the device user will be allowed to access the "Apps" section of the System Settings Menu.

Parm Name: AccessAppsSection

Option	Name	Description	Requires
0	Do not change	This value (or the absence of this parm from the XML) will cause no changes to be made as to whether or not a device user will be allowed to access the "Apps" section of the System Settings Menu.	OSX: 4.4+ MX: 4.4+
1	Enable	This value will cause the device user to be allowed to access the "Apps" section of the System Settings Menu.	OSX: 4.4+ MX: 4.4+
2	Disable	This value will cause the device user to be prevented from accessing the "Apps" section of the System Settings Menu.	OSX: 4.4+ MX: 4.4+

Option

Name

Description

Requires

Do not change

This value (or the absence of this parm from the XML) will cause no changes to be made as to whether or not a device user will be allowed to access the "Apps" section of the System Settings Menu.

OSX: 4.4+

MX: 4.4+

Enable

This value will cause the device user to be allowed to access the "Apps" section of the System Settings Menu.

OSX: 4.4+

MX: 4.4+

Disable

This value will cause the device user to be prevented from accessing the "Apps" section of the System Settings Menu.

OSX: 4.4+

MX: 4.4+

Examples

Query Everything

Input


<wap-provisioningdoc>
    <characteristic-query type="SettingsMgr" />
</wap-provisioningdoc>

Output


<wap-provisioningdoc>
    <characteristic type="SettingsMgr" version="4.3" >
        <parm name="InvokeEnterpriseReset" value="1"/>
        <parm name="WifiSettingsUI" value="1"/>
        <parm name="UnknownSources" value="1"/>
        <parm name="AirplaneMode" value="1"/>
        <parm name="AccessAppsSection" value="1"/>
    </characteristic>   
</wap-provisioningdoc>

Query if Invoking Enterprise Reset is Allowed

Input


<wap-provisioningdoc>
    <characteristic type="SettingsMgr" >
        <parm-query name="InvokeEnterpriseReset"/>
    </characteristic>
</wap-provisioningdoc>

Output


<wap-provisioningdoc>
    <characteristic type="SettingsMgr" version="4.3" >
        <parm name="InvokeEnterpriseReset" value="1"/>
    </characteristic>
</wap-provisioningdoc>

Query if Changing Wi-Fi Configuration is Allowed

Input


<wap-provisioningdoc>
    <characteristic type="SettingsMgr" >
        <parm-query name="WifiSettingsUI"/>
    </characteristic>
</wap-provisioningdoc>

Output


<wap-provisioningdoc>
    <characteristic type="SettingsMgr" version="4.3" >
        <parm name="WifiSettingsUI" value="1"/>
    </characteristic>
</wap-provisioningdoc>

Query if Changing Unknown Sources is Allowed

Input


<wap-provisioningdoc>
    <characteristic type="SettingsMgr" >
        <parm-query name="UnknownSources"/>
    </characteristic>
</wap-provisioningdoc>

Output


<wap-provisioningdoc>
    <characteristic type="SettingsMgr" version="4.3" >
        <parm name="UnknownSources" value="1"/>
    </characteristic>
</wap-provisioningdoc>

Query if Changing Airplane Mode is Allowed

Input


<wap-provisioningdoc>
    <characteristic type="SettingsMgr" >
        <parm-query name="AirplaneMode"/>
    </characteristic>
</wap-provisioningdoc>

Output


<wap-provisioningdoc>
    <characteristic type="SettingsMgr" version="4.3" >
        <parm name="AirplaneMode" value="1"/>
    </characteristic>
</wap-provisioningdoc>

Query if Accessing Apps Section is Allowed

Input


<wap-provisioningdoc>
    <characteristic type="SettingsMgr" >
        <parm-query name="AccessAppsSection"/>
    </characteristic>
</wap-provisioningdoc>

Output


<wap-provisioningdoc>
    <characteristic type="SettingsMgr" version="4.3" >
        <parm name="AccessAppsSection" value="1"/>
    </characteristic>
</wap-provisioningdoc>