@openui5/sap.m 1.106.0 → 1.107.0

package/src/sap/m/p13n/AbstractContainerItem.js

@@ -20,12 +20,12 @@ sap.ui.define(['sap/ui/core/Element'],
 		 * @extends sap.ui.core.Element
 		 *
 		 * @author SAP SE
-		 * @version 1.106.0
+		 * @version 1.107.0
 		 *
 		 * @constructor
 		 * @alias sap.m.p13n.AbstractContainerItem
 		 * @author SAP SE
-		 * @version 1.106.0
+		 * @version 1.107.0
 		 * @experimental Since 1.96.
 	 	 * @since 1.96
 		 * @ui5-restricted

package/src/sap/m/p13n/BasePanel.js

@@ -22,7 +22,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.106.0
+	 * @version 1.107.0
 	 *
 	 * @public
 	 * @abstract
@@ -420,6 +420,10 @@ sap.ui.define([
 
 	BasePanel.prototype._setTemplate = function(oTemplate) {
 		oTemplate.setType("Active");
+		var oCurrentTemplate = this.getAggregation("_template");
+		if (oCurrentTemplate) {
+			oCurrentTemplate.destroy();
+		}
 		this.setAggregation("_template", oTemplate);
 		if (oTemplate) {
 			if (this.getEnableReorder()){

package/src/sap/m/p13n/Container.js

@@ -37,7 +37,7 @@ sap.ui.define([
 	 * @extends sap.m.p13n.AbstractContainer
 	 *
 	 * @author SAP SE
-	 * @version 1.106.0
+	 * @version 1.107.0
 	 *
 	 * @private
 	 * @ui5-restricted

package/src/sap/m/p13n/Engine.js

@@ -32,7 +32,7 @@ sap.ui.define([
 
 	/**
 	 *
-	 * The <code>Engine</code> offers personalization capabilities by registering a control instance for modification such as:
+	 * The <code>Engine</code> entity offers personalization capabilities by registering a control instance for modification, such as:
 	 *
 	 * <ul>
 	 * <li><code>sap.m.p13n.Popup</code> initialization</li>
@@ -40,28 +40,28 @@ sap.ui.define([
 	 * <li>State appliance considering the persistence layer</li>
 	 * </ul>
 	 *
-	 * The Engine should be used whenever personalization should be enabled by considering a certain persistence layer.
+	 * The Engine must be used whenever personalization should be enabled by taking a certain persistence layer into account.
 	 * Available controller implementations for the registration process are:
 	 *
 	 * <ul>
-	 * <li>{@link sap.m.p13n.SelectionController SelectionController}: can be used to define a list of selectable entries</li>
-	 * <li>{@link sap.m.p13n.SortController SortController}: can be used to define a list of sortable properties</li>
-	 * <li>{@link sap.m.p13n.GroupController GroupController}: can be used to define a list of groupable properties</li>
+	 * <li>{@link sap.m.p13n.SelectionController SelectionController}: Used to define a list of selectable entries</li>
+	 * <li>{@link sap.m.p13n.SortController SortController}: Used to define a list of sortable properties</li>
+	 * <li>{@link sap.m.p13n.GroupController GroupController}: Used to define a list of groupable properties</li>
 	 * </ul>
 	 *
 	 * The following persistence layers can be chosen for personalization services:
 	 *
 	 * <ul>
-	 * <li>{@link sap.m.p13n.modification.FlexModificationHandler FlexModificationHandler}: Can be used in combination with <code>sap.ui.fl.variants.VariantManagement</code> to persist state in variant using <code>sap.ui.fl</code> capabilities.</li>
-	 * <li>{@link sap.m.p13n.modification.LocalStorageModificationHandler LocalStorageModificationHandler}: can be used to store personalization state in the local storage</li>
-	 * <li>{@link sap.m.p13n.modification.ModificationHandler ModificationHandler}: will be used by default - this handler will not persist state.</li>
+	 * <li>{@link sap.m.p13n.modification.FlexModificationHandler FlexModificationHandler}: Used in combination with <code>sap.ui.fl.variants.VariantManagement</code> to persist a state in variants using <code>sap.ui.fl</code> capabilities.</li>
+	 * <li>{@link sap.m.p13n.modification.LocalStorageModificationHandler LocalStorageModificationHandler}: Used to store a personalization state in the local storage</li>
+	 * <li>{@link sap.m.p13n.modification.ModificationHandler ModificationHandler}: Used by default - this handler will not persist a state.</li>
 	 * </ul>
 	 *
 	 * @namespace
 	 * @alias sap.m.p13n.Engine
 	 * @extends sap.m.p13n.AdaptationProvider
 	 * @author SAP SE
-	 * @version 1.106.0
+	 * @version 1.107.0
 	 * @public
 	 * @experimental Since 1.104. Please note that the API of this control is not yet finalized!
 	 * @since 1.104
@@ -90,16 +90,21 @@ sap.ui.define([
 
 	/**
 	 *
+	 * The central registration for personalization functionality.
+	 * The registration is a precondition for using <code>Engine</code> functionality for a control instance.
+	 * Once the control instance has been registered, it can be passed to the related <code>Engine</code>
+	 * methods that always expect a control instance as parameter. Only registered control instances can be used for personalization through the <code>Engine</code>.
 	 *
-	 * This method should only be called once per instance to register provided
-	 * classes of <code>sap.m.p13n.Controller</code> for the control instance.
+	 * @typedef {object} sap.m.p13n.EngineRegistrationConfig
+	 * @property {sap.m.p13n.ModificationHandler} modification The desired <code>{@link sap.m.p13n.modification.ModificationHandler ModificationHandler}</code> instance that is used for persistence.
+	 * @property {sap.m.p13n.MetadataHelper} helper The <code>{@link sap.m.p13n.modification.MetadataHelper MetadataHelper}</code> to provide metadata-specific information.
+	 * @property {object} controller A map of arbitrary keys that contain a controller instance as value. The key must be unique and needs to be provided for later access when using <code>Engine</code> functionality specific for one controller type.
 	 *
 	 * @public
 	 * @experimental Since 1.104. Please note that the API of this control is not yet finalized!
 	 *
 	 * @param {sap.ui.core.Control} oControl The control instance to be registered for adaptation
-	 * @param {Object} oConfig The config object providing key value pairs of keys and
-	 * <code>sap.m.p13n.*Controller</code> classes.
+	 * @param {sap.m.p13n.EngineRegistrationConfig} oConfig The Engine registration configuration
 	 *
 	 * @example
 	 *  {
@@ -162,9 +167,9 @@ sap.ui.define([
 
 
 	/**
-	 * Deregister a registered control. By deregistering a control the control will
-	 * be removed from the <code>Engine</code> registry and all instance specific sub
-	 * modules such as the registered controllers are going to be destroyed.
+	 * Unregisters a registered control. By unregistering a control the control is
+	 * removed from the <code>Engine</code> registry, and all instance-specific submodules,
+	 * such as the registered controllers, are destroyed.
 	 *
 	 * @public
 	 * @experimental Since 1.104. Please note that the API of this control is not yet finalized!
@@ -197,16 +202,16 @@ sap.ui.define([
 	 * @experimental Since 1.104. Please note that the API of this control is not yet finalized!
 	 *
 	 *
-	 * @param {sap.ui.core.Control} oControl The control instance to be personalized
-	 * @param {string|string[]} vPanelKeys The affected panels that should be added to the <code>sap.m.p13n.Popup</code>
+	 * @param {sap.ui.core.Control} oControl The control instance that is personalized
+	 * @param {string|string[]} vPanelKeys The affected panels that are added to the <code>sap.m.p13n.Popup</code>
 	 * @param {object} mSettings The settings object for the personalization
 	 * @param {string} [mSettings.title] The title for the <code>sap.m.p13n.Popup</code> control
-	 * @param {sap.ui.core.Control} [mSettings.source] The source control to be used by the <code>sap.m.p13n.Popup</code> control (only necessary in case the mode is set to <code>ResponsivePopover</code>)
-	 * @param {object} [mSettings.mode] The mode to be used by the <code>sap.m.p13n.Popup</code> control
+	 * @param {sap.ui.core.Control} [mSettings.source] The source control to be used by the <code>sap.m.p13n.Popup</code> control (only necessary if the mode is set to <code>ResponsivePopover</code>)
+	 * @param {object} [mSettings.mode] The mode is used by the <code>sap.m.p13n.Popup</code> control
 	 * @param {object} [mSettings.contentHeight] Height configuration for the related popup container
 	 * @param {object} [mSettings.contentWidth] Width configuration for the related popup container
 	 *
-	 * @returns {Promise} Promise resolving in the <code>sap.m.p13n.Popup</code> instance.
+	 * @returns {Promise} Promise resolving in the <code>sap.m.p13n.Popup</code> instance
 	 */
 	Engine.prototype.show = function(oControl, vPanelKeys, mSettings) {
 		return this.uimanager.show(oControl, vPanelKeys, mSettings);
@@ -214,7 +219,7 @@ sap.ui.define([
 
 	/**
 	 * Attaches an event handler to the <code>StateHandlerRegistry</code> class.
-	 * The event handler may be fired every time a user triggers a personalization change for a control instance during runtime.
+	 * The event handler is fired every time a user triggers a personalization change for a control instance during runtime.
 	 *
 	 * @public
 	 * @experimental Since 1.104. Please note that the API of this control is not yet finalized!
@@ -241,15 +246,15 @@ sap.ui.define([
 	};
 
 	/**
-	 * This method can be used to trigger a reset on the provided control instance.
+	 * This method can be used to trigger a reset to the provided control instance.
 	 *
 	 * @public
 	 * @experimental Since 1.104. Please note that the API of this control is not yet finalized!
 	 *
-	 * @param {sap.ui.core.Control} oControl The according control instance.
-	 * @param {string} aKeys The key for the affected config.
+	 * @param {sap.ui.core.Control} oControl The related control instance
+	 * @param {string} aKeys The key for the affected configuration
 	 *
-	 * @returns {Promise} A Promise resolving once the reset is completed.
+	 * @returns {Promise} A Promise resolving once the reset is completed
 	 */
 	Engine.prototype.reset = function(oControl, aKeys) {
 
@@ -280,8 +285,8 @@ sap.ui.define([
 
 
 	/**
-	 * Apply a State on a control by passing an object that contains the
-	 * registered controller key and an object matching the innter subcontroller housekeeping.
+	 * Applies a state to a control by passing an object that contains the
+	 * registered controller key and an object matching the inner subcontroller logic.
 	 *
 	 * @public
 	 * @experimental Since 1.104. Please note that the API of this control is not yet finalized!
@@ -292,7 +297,7 @@ sap.ui.define([
 	 *
 	 * @param {sap.ui.core.Control} oControl The registered control instance
 	 * @param {object} oState The state object
-	 * @param {boolean} bApplyAbsolute Defines whether the state should be an additional delta on the current control state
+	 * @param {boolean} bApplyAbsolute Defines whether the state should be an additional delta of the current control state
 	 *
 	 * @returns {Promise} A Promise resolving after the state has been applied
 	 */
@@ -352,16 +357,16 @@ sap.ui.define([
 
 	/**
 	 *
-	 *  Retrieves the externalized state for a given control instance,
+	 *  Retrieves the state for a given control instance
 	 *  after all necessary changes have been applied (e.g. modification handler appliance).
-	 *  After the returned Promise has been resolved, the returned State is in sync with the according
+	 *  After the returned <code>Promise</code> has been resolved, the returned state is in sync with the related
 	 *  state object of the control.
 	 *
 	 * @public
 	 * @experimental Since 1.104. Please note that the API of this control is not yet finalized!
 	 * @param {object} oControl The control instance implementing IxState to retrieve the externalized state
 	 *
-	 * @returns {Promise} a Promise resolving in the current control state.
+	 * @returns {Promise} A Promise resolving in the current control state
 	 */
 	Engine.prototype.retrieveState = function(oControl) {
 
@@ -419,19 +424,19 @@ sap.ui.define([
 	 *
 	 * @ui5-restricted
 	 *
-	 * @param {object} mDiffParameters A map defining the configuration to create the changes.
-	 * @param {sap.ui.core.Control} mDiffParameters.control The control instance tht should be adapted.
-	 * @param {string} mDiffParameters.key The key used to retrieve the corresponding Controller.
-	 * @param {object} mDiffParameters.state The state which should be applied on the provided control instance
-	 * @param {boolean} [mDiffParameters.applyAbsolute] Decides whether unmentioned entries should be affected,
-	 * @param {boolean} [mDiffParameters.stateBefore] In case the state should be diffed manually
-	 * for example if "A" is existing in the control state, but not mentioned in the new state provided in the
+	 * @param {object} mDiffParameters A map defining the configuration to create the changes
+	 * @param {sap.ui.core.Control} mDiffParameters.control The control instance that should be adapted
+	 * @param {string} mDiffParameters.key The key used to retrieve the related controller
+	 * @param {object} mDiffParameters.state The state that is applied to the provided control instance
+	 * @param {boolean} [mDiffParameters.applyAbsolute] Determines whether unmentioned entries are affected
+	 * @param {boolean} [mDiffParameters.stateBefore] If the state should be diffed manually;
+	 * for example, if "A" exists in the control state, but is not mentioned in the new state provided in the
 	 * mDiffParameters.state then the absolute appliance decides whether to remove "A" or to keep it.
-	 * @param {boolean} [mDiffParameters.suppressAppliance] Decides whether the change should be applied directly.
-	 * @param {boolean} [mDiffParameters.applySequentially] Decides whether the appliance should be queued or processed in parallel.
-	 * Controller
+	 * @param {boolean} [mDiffParameters.suppressAppliance] Determines whether the change is applied directly
+	 * @param {boolean} [mDiffParameters.applySequentially] Determines whether the appliance is queued or processed in parallel
+	 * controller
 	 *
-	 * @returns {Promise} A Promise resolving in the according delta changes.
+	 * @returns {Promise} A Promise resolving in the related delta changes
 	 */
 	Engine.prototype.createChanges = function(mDiffParameters) {
 
@@ -494,8 +499,8 @@ sap.ui.define([
 	 *
 	 * @ui5-restricted
 	 *
-	 * @param {sap.ui.core.Control} oControl The according control instance.
-	 * @returns {Promise} A Promise resolving after all pending modifications have been applied.
+	 * @param {sap.ui.core.Control} oControl The related control instance
+	 * @returns {Promise} A Promise resolving after all pending modifications have been applied
 	 */
 	Engine.prototype.waitForChanges = function(oControl) {
 		var oModificationSetting = this._determineModification(oControl);
@@ -508,9 +513,9 @@ sap.ui.define([
 	 * Determines whether the environment is suitable for the desired modification of the provided control instance.
 	 *
 	 * @ui5-restricted
-	 * @param {sap.ui.core.Control} oControl The according control instance.
+	 * @param {sap.ui.core.Control} oControl The related control instance
 	 *
-	 * @returns {Promise} A Promise resolving in a boolean whether the requirements for the persistence layer are met.
+	 * @returns {Promise} A Promise resolving in a Boolean that determines whether the requirements for the persistence layer are met
 	 */
 	Engine.prototype.isModificationSupported = function(oControl) {
 		var oModificationSetting = this._determineModification(oControl);
@@ -531,7 +536,7 @@ sap.ui.define([
 	 *
 	 * @param {sap.ui.core.Control} vControl The registered control instance
 	 * @param {object} mChanges A map of keys and arrays, every controller will provide an array of changes
-	 * @returns {Promise} The change appliance promise.
+	 * @returns {Promise} The change appliance <code>Promise</code>
 	 */
 	Engine.prototype._processChanges = function(vControl, mChanges) {
 		var aChanges = [];
@@ -553,16 +558,16 @@ sap.ui.define([
 	};
 
 	/**
-	 * This method can be used in the control's according designtime metadata
-	 * for keyuser personalization.
+	 * This method can be used in the designtime metadata of the control
+	 * for key user personalization.
 	 *
 	 * @ui5-restricted
 	 *
-	 * @param {sap.ui.core.Control} oControl The registered control instance.
-	 * @param {object} mPropertyBag The propertybag provided in the settings action.
-	 * @param {string} aKeys The keys to be used to display in the corresponding Controller
+	 * @param {sap.ui.core.Control} oControl The registered control instance
+	 * @param {object} mPropertyBag The property bag provided in the settings action
+	 * @param {string} aKeys The keys to be used to display in the corresponding controller
 	 *
-	 * @returns {Promise} A Promise resolving in the set of changes to be created during RTA.
+	 * @returns {Promise} A Promise resolving in the set of changes to be created during UI adaptation at runtime
 	 */
 	Engine.prototype.getRTASettingsActionHandler = function (oControl, mPropertyBag, aKeys) {
 
@@ -611,19 +616,19 @@ sap.ui.define([
 	};
 
 	/**
-	 * Enhances the xConfig object by using the <code>ModificationHandler</code>
+	 * Enhances the <code>xConfig</code> object by using the <code>ModificationHandler</code>.
 	 *
 	 * @ui5-restricted
 	 *
-	 * @param {sap.ui.core.Control} vControl The registered control instance.
+	 * @param {sap.ui.core.Control} vControl The registered control instance
 	 * @param {object} mEnhanceConfig An object providing the information about the xConfig enhancement
 	 * @param {object} mEnhanceConfig.key The affected property name
 	 * @param {object} mEnhanceConfig.controlMeta Object describing which config is affected
 	 * @param {object} mEnhanceConfig.controlMeta.aggregation The affected aggregation name (such as <code>columns</code> or <code>filterItems</code>)
-	 * @param {object} mEnhanceConfig.controlMeta.property The affected property name (such as <code>width</code> or <code>lable</code>)
+	 * @param {object} mEnhanceConfig.controlMeta.property The affected property name (such as <code>width</code> or <code>label</code>)
 	 * @param {object} mEnhanceConfig.value The value that should be written in the xConfig
-	 * @param {object} [mEnhanceConfig.propertyBag] Optional propertybag for the <code>ModificationHandler</code>
-	 * @returns {Promise} Promise resolving when the XConfig is successfully enhanced
+	 * @param {object} [mEnhanceConfig.propertyBag] Optional property bag for the <code>ModificationHandler</code>
+	 * @returns {Promise} Promise resolving when the xConfig is successfully enhanced
 	 */
 	Engine.prototype.enhanceXConfig = function(vControl, mEnhanceConfig) {
 
@@ -640,15 +645,15 @@ sap.ui.define([
 	};
 
 	/**
-	 * Returns a copy of the xConfig object
+	 * Returns a copy of the <code>xConfig</code> object.
 	 *
 	 * @ui5-restricted sap.m
-	 * @param {sap.ui.core.Element} vControl The according element which should be checked
-	 * @param {object} [mEnhanceConfig] An object providing a modification handler specific payload
-	 * @param {object} [mEnhanceConfig.propertyBag] Optional propertybag for different modification handler derivations
+	 * @param {sap.ui.core.Element} vControl The related element that should be checked
+	 * @param {object} [mEnhanceConfig] An object providing a modification-handler-specific payload
+	 * @param {object} [mEnhanceConfig.propertyBag] Optional property bag for different modification handler derivations
 	 *
 	 * @returns {Promise<object>|object}
-	 *     A promise that resolves with the xConfig, the xConfig directly if it is already available, or <code>null</code> if there is no xConfig
+	 * A <code>Promise</code> that resolves with the configuration. The xConfig itself if it is already available, or <code>null</code> if there is no xConfig
 	 */
 	Engine.prototype.readXConfig = function(vControl, mEnhanceConfig) {
 
@@ -742,15 +747,15 @@ sap.ui.define([
 	};
 
 	/**
-	 * This method can be used to initialize the Controller housekeeping.
+	 * This method can be used to initialize the controller housekeeping.
 	 *
 	 * @private
 	 *
 	 * @param {sap.ui.core.Control} vControl The registered control instance
-	 * @param {string|string[]} aKeys The key for the according Controller
+	 * @param {string|string[]} aKeys The key for the related controller
 	 * @param {Object[]} aCustomInfo A custom set of propertyinfos as base to create the UI
 	 *
-	 * @returns {Promise} A Promise resolving after the adaptation housekeeping has been initialized.
+	 * @returns {Promise} A Promise resolving after the adaptation housekeeping has been initialized
 	 */
 	Engine.prototype.initAdaptation = function(vControl, aKeys) {
 		this.verifyController(vControl, aKeys);
@@ -773,7 +778,7 @@ sap.ui.define([
 	};
 
 	/**
-	 * This method should only be used to register a new Controller.
+	 * This method should only be used to register a new controller.
 	 *
 	 * @private
 	 *
@@ -888,7 +893,7 @@ sap.ui.define([
 	 * @private
 	 * @param {string|sap.ui.core.Control} vControl The control id or instance
 	 *
-	 * @returns {object} The according registry entry
+	 * @returns {object} The related registry entry
 	 */
 	Engine.prototype._getRegistryEntry = function(vControl) {
 
@@ -904,7 +909,7 @@ sap.ui.define([
 	 * @ui5-restricted sap.m
 	 *
 	 * @param {string|sap.ui.core.Control} vControl The control id or instance
-	 * @returns {object} The according ModificationHandler.
+	 * @returns {object} The related ModificationHandler.
 	 */
 	Engine.prototype.getModificationHandler = function(vControl) {
 		var oModificationSetting = this._determineModification(vControl);
@@ -920,7 +925,7 @@ sap.ui.define([
 	 * @private
 	 * @param {string|sap.ui.core.Control} vControl The control id or instance
 	 * @param {object} oPreConfig A predefined configuration
-	 * @returns {object} The according registry entry
+	 * @returns {object} The related registry entry
 	 */
 	Engine.prototype._createRegistryEntry = function(vControl, oPreConfig) {
 
@@ -953,7 +958,7 @@ sap.ui.define([
 	 *
 	 * @private
 	 * @param {string|sap.ui.core.Control} vControl The control id or instance
-	 * @returns {object} The according modification registry entry
+	 * @returns {object} The related modification registry entry
 	 */
 	Engine.prototype._determineModification = function (vControl) {
 
@@ -1026,7 +1031,7 @@ sap.ui.define([
 	 * @param {string} sControlId The control id
 	 * @param {string} sAncestorControlId The control ancestor id
 	 *
-	 * @returns {boolean} Returns whether an according ancestor could be found.
+	 * @returns {boolean} Returns whether an related ancestor could be found.
 	 */
 	Engine.prototype.hasControlAncestorWithId = function(sControlId, sAncestorControlId) {
 		var oControl;
@@ -1067,13 +1072,13 @@ sap.ui.define([
 
 	/**
 	 * This method can be used to get the active p13n state of a registered Control.
-	 * E.g. the method will return the key of the Controller that is currently being
+	 * E.g. the method will return the key of the controller that is currently being
 	 * used to display a p13n UI.
 	 *
 	 * @private
 	 * @param {string|sap.ui.core.Control} vControl The control ID or instance
 	 *
-	 * @returns {boolean} The according flag is the Control has an open P13n container
+	 * @returns {boolean} The related flag is the Control has an open P13n container
 	 */
 	Engine.prototype.hasActiveP13n = function(vControl) {
 		return !!this._getRegistryEntry(vControl).activeP13n;
@@ -1081,13 +1086,13 @@ sap.ui.define([
 
 	/**
 	 * This method can be used to set the active p13n state of a registered Control.
-	 * E.g. the method will return the key of the Controller that is currently being
+	 * E.g. the method will return the key of the controller that is currently being
 	 * used to display a p13n UI.
 	 *
 	 * @private
 	 *
 	 * @param {sap.ui.core.Control} vControl The registered control instance.
-	 * @param {string} sKey The registered key to get the corresponding Controller.
+	 * @param {string} sKey The registered key to get the corresponding controller.
 	 */
 	Engine.prototype.setActiveP13n = function(vControl, sKey) {
 		this._getRegistryEntry(vControl).activeP13n = sKey;
@@ -1095,13 +1100,13 @@ sap.ui.define([
 
 	/**
 	 * Triggers a validation for a certain controller - The method will create a
-	 * MessageStrip and place it on the according oP13nUI. The BaseController needs
+	 * MessageStrip and place it on the related oP13nUI. The BaseController needs
 	 * to implement <code>BaseController#validateP13n</code>.
 	 *
 	 * @private
 	 *
 	 * @param {sap.ui.core.Control} vControl The registered control instance.
-	 * @param {string} sKey The registered key to get the corresponding Controller.
+	 * @param {string} sKey The registered key to get the corresponding controller.
 	 * @param {sap.ui.core.Control} oP13nUI The adaptation UI displayed in the container (e.g. BasePanel derivation).
 	 */
 	Engine.prototype.validateP13n = function(vControl, sKey, oP13nUI) {

package/src/sap/m/p13n/GroupController.js

@@ -13,16 +13,15 @@ sap.ui.define([
 	 *
 	 * @param {string} [sId] ID for the new control, generated automatically if no ID is given
 	 * @param {object} [mSettings] Initial settings for the new control
-     * @param {sap.ui.core.Control} mSettings.control The control instance to be personalized by this controller
+     * @param {sap.ui.core.Control} mSettings.control The control instance that is personalized by this controller
 	 *
 	 * @class
-	 * The <code>GroupController</code> serves as base class to create sort specific personalization implementations.
+	 * The <code>GroupController</code> entity serves as a base class to create group-specific personalization implementations.
 	 *
 	 * @extends sap.ui.base.Object
 	 *
 	 * @author SAP SE
-	 * @version 1.106.0
-	 *
+	 * @version 1.107.0
 	 * @public
 	 * @experimental
 	 * @since 1.104

package/src/sap/m/p13n/GroupPanel.js

@@ -21,7 +21,7 @@ sap.ui.define([
 	 * @extends sap.m.p13n.QueryPanel
 	 *
 	 * @author SAP SE
-	 * @version 1.106.0
+	 * @version 1.107.0
 	 *
 	 * @public
 	 * @experimental Since 1.104. Please note that the API of this control is not yet finalized!

package/src/sap/m/p13n/MetadataHelper.js

@@ -9,6 +9,14 @@ sap.ui.define([
 ], function (BaseObject) {
 	"use strict";
 
+    /**
+     * The <code>MetadataHelper</code> entity offers utility functionality for providing service metadata during the <code>Engine#register</code> process.
+     *
+	 * @author SAP SE
+	 * @public
+     * @experimental Since 1.104.
+	 * @alias sap.m.p13n.MetadataHelper
+     */
     var MetadataHelper = BaseObject.extend("sap.m.p13n.MetadataHelper", {
         constructor: function(aProperties) {
 			BaseObject.apply(this, arguments);

package/src/sap/m/p13n/Popup.js

@@ -34,7 +34,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.106.0
+	 * @version 1.107.0
 	 *
 	 * @public
 	 * @experimental Since 1.97.

package/src/sap/m/p13n/QueryPanel.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * @extends sap.m.p13n.BasePanel
 	 *
 	 * @author SAP SE
-	 * @version 1.106.0
+	 * @version 1.107.0
 	 *
 	 * @private
 	 * @ui5-restricted

package/src/sap/m/p13n/SelectionController.js

@@ -10,8 +10,9 @@ sap.ui.define([
     'sap/base/util/merge',
     'sap/base/util/deepEqual',
     'sap/m/p13n/SelectionPanel',
-    'sap/m/p13n/modules/xConfigAPI'
-], function (diff, BaseObject, merge, deepEqual, SelectionPanel, xConfigAPI) {
+    'sap/m/p13n/modules/xConfigAPI',
+    'sap/ui/core/Configuration'
+], function (diff, BaseObject, merge, deepEqual, SelectionPanel, xConfigAPI, Configuration) {
 	"use strict";
 
     /**
@@ -19,16 +20,16 @@ sap.ui.define([
 	 *
 	 * @param {string} [sId] ID for the new control, generated automatically if no ID is given
 	 * @param {object} [mSettings] Initial settings for the new control
-     * @param {sap.ui.core.Control} mSettings.control The control instance to be personalized by this controller
-     * @param {string} mSettings.targetAggregation The name of the personalized aggregation
+     * @param {sap.ui.core.Control} mSettings.control The control instance that is personalized by this controller
+     * @param {string} mSettings.targetAggregation The name of the aggregation that is now managed by this controller
 	 *
 	 * @class
-	 * The <code>SelectionController</code> serves as base class to create control specific personalization implementations.
+	 * The <code>SelectionController</code> entity serves as a base class to create control-specific personalization implementations.
 	 *
 	 * @extends sap.ui.base.Object
 	 *
 	 * @author SAP SE
-	 * @version 1.106.0
+	 * @version 1.107.0
 	 *
 	 * @public
 	 * @experimental Since 1.104. Please note that the API of this control is not yet finalized!
@@ -508,7 +509,7 @@ sap.ui.define([
         var sPositionAttribute = mP13nTypeSorting.position;
         var sSelectedAttribute = mP13nTypeSorting.visible;
 
-        var sLocale = sap.ui.getCore().getConfiguration().getLocale().toString();
+        var sLocale = Configuration.getLocale().toString();
 
         var oCollator = window.Intl.Collator(sLocale, {});
 

package/src/sap/m/p13n/SelectionPanel.js

@@ -48,7 +48,7 @@ sap.ui.define([
 	 * @extends sap.m.p13n.BasePanel
 	 *
 	 * @author SAP SE
-	 * @version 1.106.0
+	 * @version 1.107.0
 	 *
 	 * @public
 	 * @experimental Since 1.96.
@@ -130,7 +130,7 @@ sap.ui.define([
 	};
 
 	SelectionPanel.prototype._getListTemplate = function() {
-		return new ColumnListItem({
+		var oColumnListItem = new ColumnListItem({
 			selected: "{" + this.P13N_MODEL + ">" + this.PRESENCE_ATTRIBUTE + "}",
 			type: ListType.Active,
 			cells: [
@@ -161,24 +161,40 @@ sap.ui.define([
 									}
 								}
 							}
-						}),
-						// The active status is visiually represented as dot icon in the tabular view, for the screen reader it needs to be ensured
-						// that a similar information is available without the UI. This InvisibleText will provide a text in the screen reader as:
-						// "Active Field is active" & "Active Field is inactive"
-						new InvisibleText({
-							text: {
-								path: this.P13N_MODEL + ">active",
-								formatter: function(bactive) {
-									return bactive ? this._getResourceText("p13n.ACTIVESTATE_ACTIVE") : this._getResourceText("p13n.ACTIVESTATE_INACTIVE");
-								}.bind(this)
-							}
 						})
 					]
 				})
 			]
 		});
+
+		if (this.getActiveColumn()) {
+			// The active status is visiually represented as dot icon in the tabular view, for the screen reader it needs to be ensured
+			// that a similar information is available without the UI. This InvisibleText will provide a text in the screen reader as:
+			// "Active Field is active" & "Active Field is inactive" --> this should only be done in case the active column is being used
+			var oActiveTextOutput = new InvisibleText({
+				text: {
+					path: this.P13N_MODEL + ">active",
+					formatter: function(bactive) {
+						return bactive ? this._getResourceText("p13n.ACTIVESTATE_ACTIVE") : this._getResourceText("p13n.ACTIVESTATE_INACTIVE");
+					}.bind(this)
+				}
+			});
+
+			oColumnListItem.getCells()[1].addItem(oActiveTextOutput);
+		}
+
+		return oColumnListItem;
 	};
 
+	SelectionPanel.prototype.setActiveColumn = function(sActiveText) {
+		this.setProperty("activeColumn", sActiveText);
+		this._setTemplate(this._getListTemplate()); //recreate template since its depending on this property
+		this._displayColumns();//update header texts in Table columns
+		return this;
+	};
+
+
+
 	SelectionPanel.prototype.setShowHeader = function(bShowHeader) {
 		if (bShowHeader){
 			var sShowSelected = this._getResourceText("p13n.SHOW_SELECTED");