ManagedAppConfiguration QML Type

Provides access to EMM policy settings. More...

• List of all members, including inherited members

Properties

• error : string
• policyDefaults : object
• policySettings : object
• supported : bool

Methods

• object defaultValue(string keyName)
• object defaultValue(string keyName, object valueIfKeyAbsent)
• object value(string keyName)
• object value(string keyName, bool returnDefault)
• object value(string keyName, bool returnDefault, object valueIfKeyAbsent)

Detailed Description

The ManagedAppConfiguration component provides an interface to allow Enterprise Mobility Management (EMM) software to overwrite certain provided default settings, allowing for streamlined app configuration across an enterprise. The component is a singleton, meaning that it does not need to be instantiated to be used.

For this component to function, your app needs a configurationSchema .xml file referenced in the app's appinfo.json. For more information see https://developer.android.com/work/managed-configurations.

Android also requires that a restriction file be referenced, the requirements of which can be found at https://developer.android.com/reference/android/content/RestrictionsManager.

The following code sample demonstrates a potential usage of ManagedAppConfiguration, using the policySettings property provided by the EMM software to overwrite a default portal URL and name provided in the configuration schema .xml.

Item {
        property bool isSupported:ManagedAppConfiguration.supported
        Connections {
                target: ManagedAppConfiguration

                onPolicySettingsChanged : {
                        console.log("supported: ", isSupported);
                        var appConfigDictionary = ManagedAppConfiguration.policySettings;
                        console.log("settings: ", JSON.stringify(appConfigDictionary));
                        for (var key in appConfigDictionary) {
                                console.log("Object item:", key, "=", appConfigDictionary[key]);
                                if (key === "portalUrl")
                                        portalUrl.text = appConfigDictionary["portalUrl"];
                                if (key === "portalName")
                                        portalName.text = appConfigDictionary["portalName"];
                        }
                        //json.text = JSON.stringify(appConfigDictionary);
                        settingsJson.text = JSON.stringify(ManagedAppConfiguration.policySettings, null, 2);

                }

                onPolicyDefaultsChanged : {
                        console.log("defaults changed: ", JSON.stringify(ManagedAppConfiguration.policyDefaults));
                }
        }
}

For more information on EMMs, including correct formatting of the required .xml files, see https://www.appconfig.org/ios for iOS and https://www.appconfig.org/android for Android.

Property Documentation

Method Documentation