Settings Manager

Note: To display only the features present on a particular device, select one or more filters from the SmartDocs bar below.

EMDK For Android - 6.7

Overview

The Settings Manager (SettingsMgr) controls access to specific device capabilities in the Android System Settings panel. This allows administrators to prevent device users from changing settings that are sensitive in nature or could lead to undesired results. See AccessMgr for other Settings panel feature restrictions. Use AppMgr to prevent access to the Settings panel altogether.

Main Functionality

Enable and Disable the ability to:
- Perform an Enterprise Reset on the device
- Change the Wi-Fi configuration
- Install apps from unknown sources (i.e. other than the Google Play store)
- Turn Airplane Mode On or Off
- Access the App Manager, where installed and running applications can be affected
- Control the use of notification messages to access app notification settings

Enterprise Reset Access

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+

Wi-Fi Access

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+

Install From Unknown Sources

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+

Airplane Mode Access

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+

App Manager Access

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+

App Notification Control

Controls whether the device user can change the notification setting for an application by long-pressing one of its notification messages. Supported only on devices running Android Nougat and higher.

See AccessMgr to restrict other methods of accessing app notification controls.

Parm Name: AppNotificationControlUsage

Option	Name	Description	Requires
0	Do not change	This value (or the absence of this parm from the XML) will cause no changes; any previously selected setting will be retained.	OSX: 7.4+ MX: 7.2+ Android API: 24+
1	Enable	Enables the device user to control app notification settings through a notification message.	OSX: 7.4+ MX: 7.2+ Android API: 24+
2	Disable	Prevents the device user from changing app notification settings through a notification message.	OSX: 7.4+ MX: 7.2+ Android API: 24+

Option

Name

Description

Requires

Do not change

This value (or the absence of this parm from the XML) will cause no changes; any previously selected setting will be retained.

OSX: 7.4+

MX: 7.2+

Android API: 24+

Enable

Enables the device user to control app notification settings through a notification message.

OSX: 7.4+

MX: 7.2+

Android API: 24+

Disable

Prevents the device user from changing app notification settings through a notification message.

OSX: 7.4+

MX: 7.2+

Android API: 24+

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>