@openui5/sap.ui.core 1.97.1 → 1.100.0

package/src/sap/ui/debug/PropertyList.js

@@ -35,7 +35,7 @@ sap.ui.define('sap/ui/debug/PropertyList', [
 	 *
 	 * @extends sap.ui.base.EventProvider
 	 * @author Martin Schaus
-	 * @version 1.97.1
+	 * @version 1.100.0
 	 *
 	 * @param {sap.ui.core.Core}
 	 *            oCore Core instance of the app; version might differ!

package/src/sap/ui/dom/includeStylesheet.js

@@ -81,9 +81,14 @@ sap.ui.define(["sap/base/assert"],
 	}
 
 	/**
-	 * Includes the specified stylesheet via a <link>-tag in the head of the current document. If there is call to
-	 * <code>includeStylesheet</code> providing the sId of an already included stylesheet, the existing element will be
-	 * replaced.
+	 * Includes the specified stylesheet via a &lt;link&gt;-tag in the head of the current document.
+	 *
+	 * If <code>includeStylesheet</code> is called with an <code>sId</code> of an already included stylesheet and:
+	 * <ul>
+	 * <li>either <code>fnLoadCallback</code> or <code>fnErrorCallback</code> is given: the old stylesheet is deleted and a new one is inserted</li>
+	 * <li><code>vUrl</code> is different from the existing one's: the old stylesheet is deleted and a new one is inserted</li>
+	 * <li>otherwise: no action</li>
+	 * </ul>
 	 *
 	 * @param {string|object} vUrl the URL of the stylesheet to load or a configuration object
 	 * @param {string} vUrl.url the URL of the stylesheet to load

package/src/sap/ui/events/jquery/EventExtension.js

@@ -46,7 +46,7 @@ sap.ui.define(["sap/ui/thirdparty/jquery", "sap/ui/events/PseudoEvents"
 		/**
 		 * Returns an array of names (as strings) identifying {@link module:sap/ui/events/PseudoEvents} that are fulfilled by this very Event instance.
 		 *
-		 * @returns {String[]} Array of names identifying {@link module:sap/ui/events/PseudoEvents} that are fulfilled by this very Event instance.
+		 * @returns {string[]} Array of names identifying {@link module:sap/ui/events/PseudoEvents} that are fulfilled by this very Event instance.
 		 * @public
 		 */
 		jQuery.Event.prototype.getPseudoTypes = function() {

package/src/sap/ui/events/jquery/EventSimulation.js

@@ -229,13 +229,12 @@ sap.ui.define([
 	};
 
 	// Simulate mouse events on browsers firing touch events
-	oEventSimulation._initMouseEventSimulation = function(bBlackberryDevice) {
+	oEventSimulation._initMouseEventSimulation = function() {
 
 		var bFingerIsMoved = false,
 			iMoveThreshold = jQuery.vmouse.moveDistanceThreshold,
 			iStartX, iStartY,
-			iOffsetX, iOffsetY,
-			iLastTouchMoveTime;
+			iOffsetX, iOffsetY;
 
 		var fnCreateNewEvent = function(oEvent, oConfig, oMappedEvent) {
 			var oNewEvent = jQuery.event.fix(oEvent.originalEvent || oEvent);
@@ -280,14 +279,6 @@ sap.ui.define([
 					Math.abs(oTouch.pageY - iStartY) > iMoveThreshold);
 			}
 
-			if (bBlackberryDevice) {
-				//Blackberry sends many touchmoves -> create a simulated mousemove every 50ms
-				if (iLastTouchMoveTime && oEvent.timeStamp - iLastTouchMoveTime < 50) {
-					return;
-				}
-				iLastTouchMoveTime = oEvent.timeStamp;
-			}
-
 			var oNewEvent = fnCreateNewEvent(oEvent, oConfig, oEvent.touches[0]);
 
 			setTimeout(function() {
@@ -321,7 +312,6 @@ sap.ui.define([
 
 				var oTouch = oEvent.originalEvent.touches[0];
 				bFingerIsMoved = false;
-				iLastTouchMoveTime = 0;
 				iStartX = oTouch.pageX;
 				iStartY = oTouch.pageY;
 				iOffsetX = Math.round(oTouch.pageX - jQuery(oEvent.target).offset().left);
@@ -438,7 +428,7 @@ sap.ui.define([
 		if (Device.support.touch) {
 			// Deregister the previous touch to mouse event simulation (see line 25 in this file)
 			oEventSimulation.disableTouchToMouseHandling();
-			oEventSimulation._initMouseEventSimulation(Device.os.blackberry);
+			oEventSimulation._initMouseEventSimulation();
 		}
 		ControlEvents.events = oEventSimulation._init(ControlEvents.events);
 	}());

package/src/sap/ui/model/Binding.js

@@ -547,7 +547,8 @@ sap.ui.define([
 	 * of the binding is fired. The default implementation just fires the change event when the
 	 * method is called. Subclasses should implement this, if possible.
 	 *
-	 * @param {boolean} bForceUpdate Whether the event should be fired when the binding is suspended
+	 * @param {boolean} [bForceUpdate] Whether the event should be fired when the binding is
+	 *   suspended
 	 *
 	 * @private
 	 */
@@ -564,7 +565,7 @@ sap.ui.define([
 	 * To update a control, even if no data has been changed, e.g. to reset a control after failed
 	 * validation, please use the parameter <code>bForceUpdate</code>.
 	 *
-	 * @param {boolean} bForceUpdate Update the bound control even if no data has been changed
+	 * @param {boolean} [bForceUpdate] Update the bound control even if no data has been changed
 	 *
 	 * @public
 	 */
@@ -591,7 +592,7 @@ sap.ui.define([
 	/**
 	 * _refresh for compatibility
 	 *
-	 * @param {boolean} bForceUpdate Whether an update should be forced
+	 * @param {boolean} [bForceUpdate] Whether an update should be forced
 	 * @private
 	 */
 	Binding.prototype._refresh = function(bForceUpdate) {

package/src/sap/ui/model/ClientModel.js

@@ -29,7 +29,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.Model
 	 *
 	 * @author SAP SE
-	 * @version 1.97.1
+	 * @version 1.100.0
 	 *
 	 * @param {string} [oData] URL where to load the data from
 	 * @public

package/src/sap/ui/model/ClientTreeBinding.js

@@ -413,7 +413,7 @@ sap.ui.define([
 	 * Check whether this Binding would provide new values and in case it changed,
 	 * inform interested parties about this.
 	 *
-	 * @param {boolean} bForceupdate Not used in this method
+	 * @param {boolean} [bForceupdate] Not used in this method
 	 *
 	 */
 	ClientTreeBinding.prototype.checkUpdate = function(bForceupdate){

package/src/sap/ui/model/CompositeBinding.js

@@ -148,6 +148,9 @@ sap.ui.define([
 
 			this.bRawValues = this.oType.getUseRawValues();
 			this.bInternalValues = this.oType.getUseInternalValues();
+			this.oType.processPartTypes(this.aBindings.map(function (oBinding) {
+				return oBinding.getType();
+			}));
 
 			if (this.bRawValues && this.bInternalValues) {
 				throw new Error(this.oType + " has both 'bUseRawValues' & 'bUseInternalValues' set to true. Only one of them is allowed to be true");
@@ -825,7 +828,7 @@ sap.ui.define([
 	 * Check whether this Binding would provide new values and in case it changed,
 	 * inform interested parties about this.
 	 *
-	 * @param {boolean} bForceUpdate Whether an update should be forced
+	 * @param {boolean} [bForceUpdate] Whether an update should be forced
 	 *
 	 */
 	CompositeBinding.prototype.checkUpdate = function(bForceUpdate){

package/src/sap/ui/model/CompositeDataState.js

@@ -14,7 +14,7 @@ sap.ui.define(['./DataState', "sap/base/util/deepEqual", "sap/base/util/each"],
 	 * @extends sap.ui.model.DataState
 	 *
 	 * @author SAP SE
-	 * @version 1.97.1
+	 * @version 1.100.0
 	 *
 	 * @public
 	 * @alias sap.ui.model.CompositeDataState
@@ -105,9 +105,10 @@ sap.ui.define(['./DataState', "sap/base/util/deepEqual", "sap/base/util/each"],
 	};
 
 	/**
-	 * Returns the array of state messages of the model or undefined.
+	 * Returns the array of current state messages of the model.
 	 *
 	 * @returns {sap.ui.core.Message[]} The array of messages of the model
+	 *
 	 * @public
 	 */
 	CompositeDataState.prototype.getModelMessages = function() {
@@ -115,9 +116,10 @@ sap.ui.define(['./DataState', "sap/base/util/deepEqual", "sap/base/util/each"],
 	};
 
 	/**
-	 * Returns the array of state messages of the control.
+	 * Returns the array of current state messages of the control.
 	 *
 	 * @return {sap.ui.core.Message[]} The array of control messages
+	 *
 	 * @public
 	 */
 	CompositeDataState.prototype.getControlMessages = function() {
@@ -125,9 +127,29 @@ sap.ui.define(['./DataState', "sap/base/util/deepEqual", "sap/base/util/each"],
 	};
 
 	/**
-	 * Returns the array of all state messages combining the model and control messages.
+	 * Returns an array of all model and control messages of all parts of the composite binding,
+	 * regardless of whether they are old or new.
 	 *
 	 * @returns {sap.ui.core.Message[]} The array of all messages
+	 *
+	 * @public
+	 * @since 1.98.0
+	 */
+	 CompositeDataState.prototype.getAllMessages = function () {
+		var oResultSet = new Set();
+
+		this.aDataStates.forEach(function(oDataState) {
+			oDataState.getAllMessages().forEach(oResultSet.add.bind(oResultSet));
+		});
+
+		return Array.from(oResultSet);
+	};
+
+	/**
+	 * Returns the array of all current state messages combining the model and control messages.
+	 *
+	 * @returns {sap.ui.core.Message[]} The array of all messages
+	 *
 	 * @public
 	 */
 	CompositeDataState.prototype.getMessages = function() {

package/src/sap/ui/model/CompositeType.js

@@ -39,7 +39,7 @@ sap.ui.define(['./SimpleType'],
 	 *   <code>true</code>.
 	 * @extends sap.ui.model.SimpleType
 	 * @public
-	 * @version 1.97.1
+	 * @version 1.100.0
 	 */
 	var CompositeType = SimpleType.extend("sap.ui.model.CompositeType", /** @lends sap.ui.model.CompositeType.prototype */ {
 
@@ -175,5 +175,17 @@ sap.ui.define(['./SimpleType'],
 		return this.bParseWithValues;
 	};
 
+	/**
+	 * Processes the types of the parts of this composite type. A concrete composite type may
+	 * override this method if it needs to derive information from the types of the parts.
+	 *
+	 * @param {sap.ui.model.SimpleType[]} aPartTypes Types of the composite binding's parts
+	 *
+	 * @protected
+	 * @since 1.100.0
+	 */
+	CompositeType.prototype.processPartTypes = function (aPartTypes) {
+	};
+
 	return CompositeType;
 });

package/src/sap/ui/model/ContextBinding.js

@@ -46,7 +46,7 @@ sap.ui.define(['./Binding'],
 	 * Check whether this Binding would provide new values and in case it changed, inform interested
 	 * parties about this.
 	 *
-	 * @param {boolean} bForceupdate Ignored in this method
+	 * @param {boolean} [bForceupdate] Ignored in this method
 	 */
 	ContextBinding.prototype.checkUpdate = function(bForceupdate) {
 		// nothing to do here, data changes can not change the context

package/src/sap/ui/model/DataState.js

@@ -65,7 +65,7 @@ sap.ui.define([
 	 * @extends sap.ui.base.Object
 	 *
 	 * @author SAP SE
-	 * @version 1.97.1
+	 * @version 1.100.0
 	 *
 	 * @public
 	 * @alias sap.ui.model.DataState
@@ -123,10 +123,29 @@ sap.ui.define([
 	};
 
 	/**
-	 * Returns the array of this data state's messages combining the model and control messages.
-	 * The array is sorted descendingly by message severity.
+	 * Returns an array of all model and control messages, regardless of whether they are old or
+	 * new.
+	 *
+	 * @returns {sap.ui.core.Message[]} The array of all messages
+	 *
+	 * @public
+	 * @since 1.98.0
+	 */
+	 DataState.prototype.getAllMessages = function () {
+		var oResultSet = new Set();
+
+		this.getMessages().forEach(oResultSet.add.bind(oResultSet));
+		this._getOldMessages().forEach(oResultSet.add.bind(oResultSet));
+
+		return Array.from(oResultSet);
+	};
+
+	/**
+	 * Returns the array of this data state's current messages combining the model and control
+	 * messages. The array is sorted descendingly by message severity.
 	 *
 	 * @returns {sap.ui.core.Message[]} The sorted array of all messages
+	 *
 	 * @public
 	 */
 	DataState.prototype.getMessages = function () {
@@ -179,9 +198,10 @@ sap.ui.define([
 	};
 
 	/**
-	 * Returns the array of state messages of the model or undefined.
+	 * Returns the array of this data state's current model messages.
 	 *
 	 * @returns {sap.ui.core.Message[]} The array of messages of the model
+	 *
 	 * @public
 	 */
 	DataState.prototype.getModelMessages = function() {
@@ -201,9 +221,10 @@ sap.ui.define([
 	};
 
 	/**
-	 * Returns the array of state messages of the control.
+	 * Returns the array of this data state's current control messages.
+	 *
+	 * @returns {sap.ui.core.Message[]} The array of control messages
 	 *
-	 * @return {sap.ui.core.Message[]} The array of control messages
 	 * @public
 	 */
 	DataState.prototype.getControlMessages = function() {

package/src/sap/ui/model/ListBinding.js

@@ -74,8 +74,8 @@ sap.ui.define(['./Binding', './Filter', './FilterType', './Sorter', 'sap/base/ut
 	 * Returns all current contexts of this list binding in no special order. Just like
 	 * {@link #getCurrentContexts}, this method does not request any data from a back end and does
 	 * not change the binding's state. In contrast to {@link #getCurrentContexts}, it does not only
-	 * return the contexts as last requested by a control, but all that are currently available in
-	 * the binding.
+	 * return those contexts that were last requested by a control, but all contexts that are
+	 * currently available in the binding.
 	 *
 	 * @returns {sap.ui.model.Context[]}
 	 *   All current contexts of this list binding, in no special order

package/src/sap/ui/model/MetaModel.js

@@ -16,7 +16,7 @@ sap.ui.define(['./Model'],
 	 * @extends sap.ui.model.Model
 	 *
 	 * @author SAP SE
-	 * @version 1.97.1
+	 * @version 1.100.0
 	 *
 	 * @public
 	 * @alias sap.ui.model.MetaModel
@@ -39,8 +39,7 @@ sap.ui.define(['./Model'],
 	 * @param {boolean} [bReload]
 	 *   force reload even if data is already available. For server side models this should
 	 *   refetch the data from the server
-	 * @return {sap.ui.model.Context} the binding context, if it could be created synchronously
-
+	 * @return {sap.ui.model.Context|undefined} the binding context, if it could be created synchronously
 	 * @see sap.ui.model.Model.prototype.createBindingContext
 	 *
 	 */

package/src/sap/ui/model/Model.js

@@ -49,7 +49,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.message.MessageProcessor
 	 *
 	 * @author SAP SE
-	 * @version 1.97.1
+	 * @version 1.100.0
 	 *
 	 * @public
 	 * @alias sap.ui.model.Model
@@ -686,7 +686,7 @@ sap.ui.define([
 	 *   Force reload even if data is already available; for server-side models this should refetch
 	 *   the data from the server
 	 *
-	 * @return {sap.ui.model.Context}
+	 * @return {sap.ui.model.Context|undefined}
 	 *   The binding context, if it could be created synchronously
 	 * @public
 	 */

package/src/sap/ui/model/SelectionModel.js

@@ -20,7 +20,7 @@ sap.ui.define(['sap/ui/base/EventProvider', "sap/base/assert"],
 	 * @extends sap.ui.base.EventProvider
 	 *
 	 * @author SAP SE
-	 * @version 1.97.1
+	 * @version 1.100.0
 	 *
 	 * @param {int} iSelectionMode <code>sap.ui.model.SelectionModel.SINGLE_SELECTION</code> or <code>sap.ui.model.SelectionModel.MULTI_SELECTION</code>
 	 *

package/src/sap/ui/model/SimpleType.js

@@ -46,7 +46,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.model.Type
 	 * @public
-	 * @version 1.97.1
+	 * @version 1.100.0
 	 */
 	var SimpleType = Type.extend("sap.ui.model.SimpleType", /** @lends sap.ui.model.SimpleType.prototype */ {
 

package/src/sap/ui/model/TreeAutoExpandMode.js

@@ -12,7 +12,7 @@ sap.ui.define([],
 	/**
 	 * Different modes for setting the auto expand mode on tree or analytical bindings.
 	 *
-	 * @version 1.97.1
+	 * @version 1.100.0
 	 * @enum {string}
 	 * @alias sap.ui.model.TreeAutoExpandMode
 	 * @protected

package/src/sap/ui/model/Type.js

@@ -19,7 +19,7 @@ sap.ui.define(['sap/ui/base/Object'],
 	 *
 	 * @extends sap.ui.base.Object
 	 * @public
-	 * @version 1.97.1
+	 * @version 1.100.0
 	 */
 	var Type = BaseObject.extend("sap.ui.model.Type", /** @lends sap.ui.model.Type.prototype */ {
 

package/src/sap/ui/model/_Helper.js

@@ -0,0 +1,22 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+sap.ui.define([
+	"sap/base/util/extend"
+], function (extend) {
+	"use strict";
+
+	/**
+	 * @alias sap.ui.model._Helper
+	 * @private
+	 */
+	var _Helper = {
+		// Trampoline property to allow for mocking in unit tests.
+		// @see sap.base.util.extend
+		extend : extend
+	};
+
+	return _Helper;
+}, /* bExport= */false);

package/src/sap/ui/model/analytics/AnalyticalBinding.js

@@ -52,7 +52,9 @@ sap.ui.define([
 	 * <li>if an associated property (e.g. text property) of an additional measure is contained in
 	 * the select binding parameter
 	 * <li>if a dimension or a measure of the current analytical info is not contained in the select
-	 * binding parameter
+	 * binding parameter, unless the dimension or measure has been added automatically by the
+	 * binding, because a property associated to the dimension or measure has been added as a
+	 * "visible" or "inResult" column
 	 * </ul>
 	 *
 	 * @param {sap.ui.model.analytics.AnalyticalBinding} oBinding
@@ -61,16 +63,10 @@ sap.ui.define([
 	 *   array if there are no additional select properties needed
 	 */
 	function getAdditionalSelects(oBinding) {
-		var oAnalyticalQueryRequest
+		var oColumn, aComputedSelect, sComputedSelect, oDimension, i, j, oMeasure, n, sPropertyName,
+			oAnalyticalQueryRequest
 				= new odata4analytics.QueryResultRequest(oBinding.oAnalyticalQueryResult),
-			aComputedSelect,
-			sComputedSelect,
-			oDimension,
-			i,
-			j,
-			oMeasure,
-			n,
-			sPropertyName,
+
 			aSelect = oBinding.mParameters.select.split(","),
 			bError = trimAndCheckForDuplicates(aSelect, oBinding.sPath);
 
@@ -106,6 +102,10 @@ sap.ui.define([
 				sPropertyName = aComputedSelect[i];
 				j = aSelect.indexOf(sPropertyName);
 				if (j < 0) {
+					oColumn = oBinding.mAnalyticalInfoByProperty[sPropertyName];
+					if (!oColumn || (!oColumn.visible && !oColumn.inResult)) {
+						continue; // ignore automatically added columns
+					}
 					oLogger.warning("Ignored the 'select' binding parameter, because"
 							+ " it does not contain the property '" + sPropertyName + "'",
 						oBinding.sPath);
@@ -248,10 +248,10 @@ sap.ui.define([
 	 *   A comma-separated list of property names that need to be selected.<br/>
 	 *   If the <code>select</code> parameter is given, it has to contain all properties that are
 	 *   contained in the analytical information (see
-	 *   {@link sap.ui.model.analytics.AnalyticalBinding#updateAnalyticalInfo}) and their associated
-	 *   dimensions and measures. It must not contain additional dimensions or measures or
-	 *   associated properties for additional dimensions or measures. But it may contain additional
-	 *   properties like a text property of a dimension that is also selected.<br/>
+	 *   {@link sap.ui.model.analytics.AnalyticalBinding#updateAnalyticalInfo}). It must not contain
+	 *   additional dimensions or measures or associated properties for additional dimensions or
+	 *   measures. But it may contain additional properties like a text property of a dimension that
+	 *   is also selected.<br/>
 	 *   All properties of the <code>select</code> parameter are also considered in
 	 *   {@link sap.ui.model.analytics.AnalyticalBinding#getDownloadUrl}.<br/>
 	 *   The <code>select</code> parameter must not contain any duplicate entry.<br/>
@@ -587,18 +587,31 @@ sap.ui.define([
 	 *
 	 * @function
 	 * @name sap.ui.model.analytics.AnalyticalBinding.prototype.getNodeContexts
-	 * @param {object}
-	 *            mParameters specifying the aggregation level for which contexts shall be fetched. Supported parameters are:
-	 * <ul>
-	 * <li>oContext: parent context identifying the requested group of child contexts</li>
-	 * <li>level: level number for oContext, because it might occur at multiple levels; context with group ID <code>"/"</code> has level 0</li>
-	 * <li>numberOfExpandedLevels: number of child levels that shall be fetched automatically</li>
-	 * <li>startIndex: index of first child entry to return from the parent context (zero-based)</li>
-	 * <li>length: number of entries to return; counting begins at the given start index</li>
-	 * <li>threshold: number of additional entries that shall be locally available in the binding for subsequent
-	 * accesses to child entries of the given parent context. </li>
-	 * </ul>
-	 * @return {array}
+	 * @param {sap.ui.model.Context} oContext
+	 *            Parent context identifying the requested group of child contexts
+	 * @param {object|int} mParameters
+	 *            Parameters, specifying the aggregation level for which contexts shall be fetched
+	 *            or (legacy signature variant) index of first child entry to return from the parent context (zero-based)
+	 * @param {int} mParameters.level
+	 *            Level number for oContext, because it might occur at multiple levels; context with group ID <code>"/"</code> has level 0
+	 * @param {int} [mParameters.numberOfExpandedLevels=0]
+	 *            Number of child levels that shall be fetched automatically
+	 * @param {int} [mParameters.startIndex=0]
+	 *            Index of first child entry to return from the parent context (zero-based)
+	 * @param {int} [mParameters.length=<model size limit>]
+	 *            Number of entries to return; counting begins at the given start index
+	 * @param {int} [mParameters.threshold=0]
+	 *            Number of additional entries that shall be locally available in the binding for subsequent
+	 *            accesses to child entries of the given parent context
+	 * @param {int} [iLength=<model size limit>]
+	 *            Same meaning as <code>mParameters.length</code>, legacy signature variant only
+	 * @param {int} [iThreshold=0]
+	 *            Same meaning as <code>mParameters.threshold</code>, legacy signature variant only
+	 * @param {int} [iLevel]
+	 *            Same meaning as <code>mParameters.level</code>, legacy signature variant only
+	 * @param {int} [iNumberOfExpandedLevels=0]
+	 *            Same meaning as <code>mParameters.numberOfExpandedLevels</code>, legacy signature variant only
+	 * @returns {sap.ui.model.Context[]}
 	 *            Array containing the requested contexts of class sap.ui.model.Context, limited by the number of entries contained
 	 *            in the entity set at that aggregation level.
 	 *            The array will contain less than the requested number of contexts, if some are not locally available and an OData request is
@@ -1128,42 +1141,53 @@ sap.ui.define([
 	/**
 	 * Updates the binding's structure with new analytical information.
 	 *
-	 * Analytical information is the mapping of UI columns to properties in the bound OData entity set. Every column object contains
-	 * the name of the bound property and in addition:
+	 * Analytical information is the mapping of UI columns to properties in the bound OData entity
+	 * set. Every column object contains the <code>name</code> of the bound property and in
+	 * addition:
 	 * <ol>
 	 *   <li>A column bound to a dimension property has further boolean properties:
 	 *     <ul>
-	 *       <li>grouped: dimension will be used for building groups</li>
-	 *       <li>visible: if the column is visible, values for the related property will be fetched from the OData service</li>
-	 *       <li>inResult: if the column is not visible, but declared to be part of the result, values for the related property
-	 *       will also be fetched from the OData service</li>
+	 *       <li>grouped: dimension is used for building groups</li>
+	 *       <li>inResult: if the column is not visible, but declared to be part of the result,
+	 *         values for the related property are also fetched from the OData service</li>
+	 *       <li>visible: if the column is visible, values for the related property are fetched from
+	 *         the OData service</li>
 	 *     </ul>
 	 *   </li>
 	 *   <li>A column bound to a measure property has further boolean properties:
 	 *     <ul>
-	 *       <li>total: totals and sub-totals will be provided for the measure at all aggregation levels</li>
+	 *       <li>inResult: if the column is not visible, but declared to be part of the result,
+	 *         values for the related property are also fetched from the OData service</li>
+	 *       <li>total: totals and sub-totals are provided for the measure at all aggregation
+	 *         levels</li>
+	 *       <li>visible: if the column is visible, values for the related property are fetched from
+	 *         the OData service</li>
 	 *     </ul>
 	 *   </li>
 	 *   <li>A column bound to a hierarchy property has further properties:
 	 *     <ul>
-	 *       <li>grouped: boolean value; indicates whether the hierarchy will be used for building
+	 *       <li>grouped: boolean value; indicates whether the hierarchy is used for building
 	 *           groups</li>
 	 *       <li>level: integer value; the hierarchy level is mandatory for at least one of those
-	 *           columns that represent the same hierarchy.</li>
+	 *           columns that represent the same hierarchy</li>
 	 *     </ul>
 	 *   </li>
 	 * </ol>
 	 *
-	 * Invoking this function resets the state of the binding and subsequent data requests such as calls to getNodeContexts() will
-	 * need to trigger OData requests in order to fetch the data that are in line with this analytical information.
+	 * Invoking this function resets the state of the binding and subsequent data requests such as
+	 * calls to getNodeContexts() trigger OData requests in order to fetch the data that are in line
+	 * with this analytical information.
 	 *
-	 * Please be aware that a call of this function might lead to additional back-end requests, as well as a control re-rendering later on.
+	 * Be aware that a call of this function might lead to additional back-end requests, as well as
+	 * a control re-rendering later on.
 	 * Whenever possible use the API of the analytical control, instead of relying on the binding.
 	 *
 	 * @function
 	 * @name sap.ui.model.analytics.AnalyticalBinding.prototype.updateAnalyticalInfo
-	 * @param {array}
-	 *            aColumns an array with objects holding the analytical information for every column, from left to right.
+	 * @param {object[]} aColumns
+	 *   An array with objects holding the analytical information for every column
+	 * @param {boolean} bForceChange
+	 *   Whether to fire a change event asynchronously even if columns didn't change
 	 * @protected
 	 */
 	AnalyticalBinding.prototype.updateAnalyticalInfo = function(aColumns, bForceChange) {
@@ -2557,9 +2581,11 @@ sap.ui.define([
 	};
 
 	/**
+	 * @param {object} oAnalyticalQueryRequest
 	 * @param {boolean} bAddAdditionalSelects
 	 *   Whether additional selects, computed from select binding parameter, shall be added to the
 	 *   $select query option.
+	 * @param {object} mParameters
 	 * @private
 	 */
 	AnalyticalBinding.prototype._getQueryODataRequestOptions = function(oAnalyticalQueryRequest,
@@ -3788,6 +3814,7 @@ sap.ui.define([
 	};
 
 	/**
+	 * @param {string} sGroupId
 	 * @param {int} iNumLevels anchestors starting at the root if greater than 0, or starting at the parent of sGroupId if less than 0.
 	 * @private
 	 */
@@ -4624,8 +4651,7 @@ sap.ui.define([
 	/**
 	 * Check whether this Binding would provide new values and in case it changed, inform interested parties about this.
 	 *
-	 * @param {boolean}
-	 *            bForceUpdate
+	 * @param {boolean} [bForceUpdate]
 	 * @param {object} mChangedEntities
 	 * @private
 	 */