@openui5/sap.ui.core 1.141.1 → 1.142.0

package/src/sap/ui/model/odata/v4/AnnotationHelper.js

@@ -18,7 +18,7 @@ sap.ui.define([
 		/**
 		 * @classdesc
 		 * A collection of methods which help to consume <a href=
-		 * "https://docs.oasis-open.org/odata/odata/v4.0/odata-v4.0-part3-csdl.html#_Vocabulary_and_Annotation"
+		 * "https://docs.oasis-open.org/odata/odata-csdl-xml/v4.01/odata-csdl-xml-v4.01.html#_Toc38530401"
 		 * >OData V4 annotations</a> in XML template views. Every context argument must belong to an
 		 * {@link sap.ui.model.odata.v4.ODataMetaModel} instance.
 		 *
@@ -43,35 +43,35 @@ sap.ui.define([
 			 *
 			 * <h3>Supported Expressions</h3>
 			 * <ul>
-			 *   <li> "14.4 Constant Expressions" for "edm:Bool", "edm:Date", "edm:DateTimeOffset",
+			 *   <li> "14.3 Constant Expressions" for "edm:Bool", "edm:Date", "edm:DateTimeOffset",
 			 *     "edm:Decimal", "edm:Float", "edm:Guid", "edm:Int", "edm:TimeOfDay".
-			 *   <li> constant "14.4.11 Expression edm:String": This is turned into a fixed text
+			 *   <li> constant "14.3.11 Expression edm:String": This is turned into a fixed text
 			 *     (for example <code>"Width"</code>). String constants that contain a simple
 			 *     binding <code>"{@i18n>...}"</code> to the hard-coded model name "@i18n" with
 			 *     arbitrary path are not turned into a fixed text, but kept as a data binding
 			 *     expression; this allows local annotation files to refer to a resource bundle for
 			 *     internationalization.
-			 *   <li> dynamic "14.5.1 Comparison and Logical Operators": These are turned into
+			 *   <li> dynamic "14.4.2 Comparison and Logical Operators": These are turned into
 			 *     expression bindings to perform the operations at runtime.
-			 *   <li> dynamic "14.5.3 Expression edm:Apply":
+			 *   <li> dynamic "14.4.4 Expression edm:Apply":
 			 *     <ul>
-			 *       <li> "14.5.3.1.1 Function odata.concat": This is turned into a data binding
-			 *         expression relative to an entity.
-			 *       <li> "14.5.3.1.2 Function odata.fillUriTemplate": This is turned into an
+			 *       <li> "odata.concat" from "14.4.4.1 Canonical Functions": This is turned into a
+			 *         data binding expression relative to an entity.
+			 *       <li> "14.4.4.2 Function odata.fillUriTemplate": This is turned into an
 			 *         expression binding to fill the template at runtime.
-			 *       <li> "14.5.3.1.3 Function odata.uriEncode": This is turned into an expression
+			 *       <li> "14.4.4.4 Function odata.uriEncode": This is turned into an expression
 			 *         binding to encode the parameter at runtime.
 			 *       <li> Apply functions may be nested arbitrarily.
 			 *     </ul>
-			 *   <li> dynamic "14.5.5 Expression edm:Collection": This is turned into an expression
+			 *   <li> dynamic "14.4.6 Expression edm:Collection": This is turned into an expression
 			 *     binding to be evaluated at runtime. Elements can be conditionally added to the
-			 *     collection when using dynamic "14.5.6 Expression edm:If" as a direct child.
-			 *   <li> dynamic "14.5.6 Expression edm:If": This is turned into an expression
+			 *     collection when using dynamic "14.4.7 Expression edm:If" as a direct child.
+			 *   <li> dynamic "14.4.7 Expression edm:If": This is turned into an expression
 			 *     binding to be evaluated at runtime. The expression is a conditional expression
 			 *     like <code>"{=condition ? expression1 : expression2}"</code>.
-			 *   <li> dynamic "14.5.10 Expression edm:Null": This is turned into a
+			 *   <li> dynamic "14.4.11 Expression edm:Null": This is turned into a
 			 *     <code>null</code> value. It is ignored in <code>odata.concat</code>.
-			 *   <li> dynamic "14.5.12 Expression edm:Path" and "14.5.13 Expression
+			 *   <li> dynamic "14.4.1.7 Expression edm:Path" and "14.4.1.6 Expression
 			 *     edm:PropertyPath": These are turned into data bindings relative to an entity,
 			 *     including type information and constraints as available from metadata, for
 			 *     example
@@ -100,13 +100,13 @@ sap.ui.define([
 			 *     <code>vRawValue</code> is the path itself, and not the object wrapping it.
 			 * </ul>
 			 * <b>Note: Import the <code>sap/ui/model/odata/ODataExpressionAddons</code> module when
-			 * using 14.5.1 or 14.5.3</b>
+			 * using 14.4.2 or 14.4.4</b>
 			 *
 			 * <h3>$AnnotationPath and $Path</h3>
 			 * If <code>oDetails.context.getPath()</code> contains a single "$AnnotationPath" or
 			 * "$Path" segment, the value corresponding to that segment is considered as a data
-			 * binding path prefix whenever a dynamic "14.5.12 Expression edm:Path" or
-			 * "14.5.13 Expression edm:PropertyPath" is turned into a data binding. Use
+			 * binding path prefix whenever a dynamic "14.4.1.7 Expression edm:Path" or
+			 * "14.4.1.6 Expression edm:PropertyPath" is turned into a data binding. Use
 			 * {@link sap.ui.model.odata.v4.AnnotationHelper.resolve$Path} to avoid these prefixes
 			 * in cases where they are not applicable.
 			 *
@@ -155,8 +155,8 @@ sap.ui.define([
 			 *
 			 * <h3>Annotations on an Operation or a Parameter</h3>
 			 * Since 1.71.0, for annotations on an operation or a parameter, the binding parameter's
-			 * name is stripped off any dynamic "14.5.12 Expression edm:Path" and
-			 * "14.5.13 Expression edm:PropertyPath" where it might be used as a first segment.
+			 * name is stripped off any dynamic "14.4.1.7 Expression edm:Path" and
+			 * "14.4.1.6 Expression edm:PropertyPath" where it might be used as a first segment.
 			 * Since 1.76.0, this does not apply to annotations on a parameter.
 			 * In the former case, we assume that the resulting data binding is
 			 * relative to the parent context of the operation binding, that is, to the context
@@ -193,7 +193,7 @@ sap.ui.define([
 			 *
 			 * <h3>Operation Parameters</h3>
 			 * Since 1.73.0, this function can be used on action or function parameters and results
-			 * in a relative data binding, just like a "14.5.12 Expression edm:Path".
+			 * in a relative data binding, just like a "14.4.1.7 Expression edm:Path".
 			 *
 			 * Assume we have the following metadata for an unbound action "AcChangeTeamBudgetByID":
 			 * <pre>
@@ -225,7 +225,7 @@ sap.ui.define([
 			 *
 			 * <h3>Structural Properties</h3>
 			 * Since 1.78.0, this function can be used on a structural property and results in a
-			 * relative data binding, just like a "14.5.12 Expression edm:Path". The usage
+			 * relative data binding, just like a "14.4.1.7 Expression edm:Path". The usage
 			 * <pre>
 			 * &lt;Input value="{meta>/Department/Name@@sap.ui.model.odata.v4.AnnotationHelper.format}"/>
 			 * </pre>
@@ -247,7 +247,7 @@ sap.ui.define([
 			 * @param {object} [oDetails.overload]
 			 *   The single operation overload that was targeted by annotations on an operation or
 			 *   a parameter; needed to strip off the binding parameter's name from any dynamic
-			 *   "14.5.12 Expression edm:Path" and "14.5.13 Expression edm:PropertyPath" where it
+			 *   "14.4.1.7 Expression edm:Path" and "14.4.1.6 Expression edm:PropertyPath" where it
 			 *   might be used as a first segment (since 1.71.0). This does not apply to annotations
 			 *   on a parameter (since 1.76.0).
 			 * @returns {string|Promise<string>}
@@ -371,10 +371,10 @@ sap.ui.define([
 			 * A function that helps to interpret OData V4 annotations. It knows about the syntax
 			 * of the path value used by the following dynamic expressions:
 			 * <ul>
-			 *   <li> "14.5.2 Expression edm:AnnotationPath"
-			 *   <li> "14.5.11 Expression edm:NavigationPropertyPath"
-			 *   <li> "14.5.12 Expression edm:Path"
-			 *   <li> "14.5.13 Expression edm:PropertyPath"
+			 *   <li> "14.4.1.3 Expression edm:AnnotationPath"
+			 *   <li> "14.4.1.5 Expression edm:NavigationPropertyPath"
+			 *   <li> "14.4.1.7 Expression edm:Path"
+			 *   <li> "14.4.1.6 Expression edm:PropertyPath"
 			 * </ul>
 			 * It returns the path of structural and navigation properties from the given path
 			 * value, but removes "$count", types casts, term casts, and annotations on navigation
@@ -461,10 +461,10 @@ sap.ui.define([
 			 * A function that helps to interpret OData V4 annotations. It knows about the syntax
 			 * of the path value used by the following dynamic expressions:
 			 * <ul>
-			 *   <li> "14.5.2 Expression edm:AnnotationPath"
-			 *   <li> "14.5.11 Expression edm:NavigationPropertyPath"
-			 *   <li> "14.5.12 Expression edm:Path"
-			 *   <li> "14.5.13 Expression edm:PropertyPath"
+			 *   <li> "14.4.1.3 Expression edm:AnnotationPath"
+			 *   <li> "14.4.1.5 Expression edm:NavigationPropertyPath"
+			 *   <li> "14.4.1.7 Expression edm:Path"
+			 *   <li> "14.4.1.6 Expression edm:PropertyPath"
 			 * </ul>
 			 * It returns the information whether the given path ends with "$count" or with a
 			 * multi-valued structural or navigation property. Term casts and annotations on
@@ -657,35 +657,35 @@ sap.ui.define([
 			 *
 			 * <h3>Supported Expressions</h3>
 			 * <ul>
-			 *   <li> "14.4 Constant Expressions" for "edm:Bool", "edm:Date", "edm:DateTimeOffset",
+			 *   <li> "14.3 Constant Expressions" for "edm:Bool", "edm:Date", "edm:DateTimeOffset",
 			 *     "edm:Decimal", "edm:Float", "edm:Guid", "edm:Int", "edm:TimeOfDay".
-			 *   <li> constant "14.4.11 Expression edm:String": This is turned into a fixed text
+			 *   <li> constant "14.3.11 Expression edm:String": This is turned into a fixed text
 			 *     (for example <code>"Width"</code>). String constants that contain a simple
 			 *     binding <code>"{@i18n>...}"</code> to the hard-coded model name "@i18n" with
 			 *     arbitrary path are not turned into a fixed text, but kept as a data binding
 			 *     expression; this allows local annotation files to refer to a resource bundle for
 			 *     internationalization.
-			 *   <li> dynamic "14.5.1 Comparison and Logical Operators": These are turned into
+			 *   <li> dynamic "14.4.2 Comparison and Logical Operators": These are turned into
 			 *     expression bindings to perform the operations at runtime.
-			 *   <li> dynamic "14.5.3 Expression edm:Apply":
+			 *   <li> dynamic "14.4.4 Expression edm:Apply":
 			 *     <ul>
-			 *       <li> "14.5.3.1.1 Function odata.concat": This is turned into a data binding
-			 *         expression.
-			 *       <li> "14.5.3.1.2 Function odata.fillUriTemplate": This is turned into an
+			 *       <li> "odata.concat" from "14.4.4.1 Canonical Functions": This is turned into a
+			 *         data binding expression.
+			 *       <li> "14.4.4.2 Function odata.fillUriTemplate": This is turned into an
 			 *         expression binding to fill the template at runtime.
-			 *       <li> "14.5.3.1.3 Function odata.uriEncode": This is turned into an expression
+			 *       <li> "14.4.4.4 Function odata.uriEncode": This is turned into an expression
 			 *         binding to encode the parameter at runtime.
 			 *       <li> Apply functions may be nested arbitrarily.
 			 *     </ul>
-			 *   <li> dynamic "14.5.5 Expression edm:Collection": This is turned into an expression
+			 *   <li> dynamic "14.4.6 Expression edm:Collection": This is turned into an expression
 			 *     binding to be evaluated at runtime. Elements can be conditionally added to the
-			 *     collection when using dynamic "14.5.6 Expression edm:If" as a direct child.
-			 *   <li> dynamic "14.5.6 Expression edm:If": This is turned into an expression
+			 *     collection when using dynamic "14.4.7 Expression edm:If" as a direct child.
+			 *   <li> dynamic "14.4.7 Expression edm:If": This is turned into an expression
 			 *     binding to be evaluated at runtime. The expression is a conditional expression
 			 *     like <code>"{=condition ? expression1 : expression2}"</code>.
-			 *   <li> dynamic "14.5.10 Expression edm:Null": This is turned into a
+			 *   <li> dynamic "14.4.11 Expression edm:Null": This is turned into a
 			 *     <code>null</code> value. It is ignored in <code>odata.concat</code>.
-			 *   <li> dynamic "14.5.12 Expression edm:Path" and "14.5.13 Expression
+			 *   <li> dynamic "14.4.1.7 Expression edm:Path" and "14.4.1.6 Expression
 			 *     edm:PropertyPath": These are turned into simple data bindings, for example
 			 *     <code>"{Name}"</code>. Since 1.78.0, both are also supported if
 			 *     <code>vRawValue</code> is the path itself, and not the object wrapping it.
@@ -693,8 +693,8 @@ sap.ui.define([
 			 *
 			 * <h3>Annotations on an Operation or a Parameter</h3>
 			 * Since 1.71.0, for annotations on an operation or a parameter, the binding parameter's
-			 * name is stripped off any dynamic "14.5.12 Expression edm:Path" and
-			 * "14.5.13 Expression edm:PropertyPath" where it might be used as a first segment.
+			 * name is stripped off any dynamic "14.4.1.7 Expression edm:Path" and
+			 * "14.4.1.6 Expression edm:PropertyPath" where it might be used as a first segment.
 			 * Since 1.76.0, this does not apply to annotations on a parameter.
 			 * In the former case, we assume that the resulting data binding is
 			 * relative to the parent context of the operation binding, that is, to the context
@@ -731,7 +731,7 @@ sap.ui.define([
 			 *
 			 * <h3>Operation Parameters</h3>
 			 * Since 1.73.0, this function can be used on action or function parameters and results
-			 * in a relative data binding, just like a "14.5.12 Expression edm:Path".
+			 * in a relative data binding, just like a "14.4.1.7 Expression edm:Path".
 			 *
 			 * Assume we have the following metadata for an unbound action "AcChangeTeamBudgetByID":
 			 * <pre>
@@ -762,7 +762,7 @@ sap.ui.define([
 			 *
 			 * <h3>Structural Properties</h3>
 			 * Since 1.78.0, this function can be used on a structural property and results in a
-			 * relative data binding, just like a "14.5.12 Expression edm:Path". The usage
+			 * relative data binding, just like a "14.4.1.7 Expression edm:Path". The usage
 			 * <pre>
 			 * &lt;Input value="{meta>/Department/Name@@sap.ui.model.odata.v4.AnnotationHelper.value}"/>
 			 * </pre>
@@ -784,12 +784,12 @@ sap.ui.define([
 			 * @param {object} [oDetails.overload]
 			 *   The single operation overload that was targeted by annotations on an operation or
 			 *   a parameter; needed to strip off the binding parameter's name from any dynamic
-			 *   "14.5.12 Expression edm:Path" and "14.5.13 Expression edm:PropertyPath" where it
+			 *   "14.4.1.7 Expression edm:Path" and "14.4.1.6 Expression edm:PropertyPath" where it
 			 *   might be used as a first segment (since 1.72.0). This does not apply to annotations
 			 *   on a parameter (since 1.76.0).
 			 * @param {string} [oDetails.prefix=""]
-			 *   Optional prefix to be added to each dynamic "14.5.12 Expression edm:Path" and
-			 *   "14.5.13 Expression edm:PropertyPath"; is either an empty string or a path ending
+			 *   Optional prefix to be added to each dynamic "14.4.1.7 Expression edm:Path" and
+			 *   "14.4.1.6 Expression edm:PropertyPath"; is either an empty string or a path ending
 			 *   with a "/" (since 1.141.0)
 			 * @returns {string}
 			 *   A data binding or a fixed text or a sequence thereof

package/src/sap/ui/model/odata/v4/Context.js

@@ -42,7 +42,7 @@ sap.ui.define([
 		 * @hideconstructor
 		 * @public
 		 * @since 1.39.0
-		 * @version 1.141.1
+		 * @version 1.142.0
 		 */
 		Context = BaseContext.extend("sap.ui.model.odata.v4.Context", {
 				constructor : constructor
@@ -874,11 +874,12 @@ sap.ui.define([
 
 	/**
 	 * Returns the "canonical path" of the entity for this context. According to <a href=
-	 * "https://docs.oasis-open.org/odata/odata/v4.0/odata-v4.0-part2-url-conventions.html#canonical-urlurl4.1.1"
-	 * >"4.3.1 Canonical URL"</a> of the specification "OData Version 4.0 Part 2: URL Conventions",
-	 * this is the "name of the entity set associated with the entity followed by the key predicate
-	 * identifying the entity within the collection". Use the canonical path in
-	 * {@link sap.ui.core.Element#bindElement} to create an element binding.
+	 * "https://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part2-url-conventions.html#_Toc31360932"
+	 * >"4.3.1 Canonical URL"</a> of the specification
+	 * "OData Version 4.01. Part 2: URL Conventions", this is the "name of the entity set associated
+	 * with the entity followed by the key predicate identifying the entity within the collection".
+	 * Use the canonical path in {@link sap.ui.core.Element#bindElement} to create an element
+	 * binding.
 	 *
 	 * Note: For a transient context (see {@link #isTransient}) a wrong path is returned unless all
 	 * key properties are available within the initial data.
@@ -1028,8 +1029,8 @@ sap.ui.define([
 	 * Returns the value for the given path relative to this context. The function allows access to
 	 * the complete data the context points to (if <code>sPath</code> is "") or any part thereof.
 	 * The data is a JSON structure as described in
-	 * <a href="https://docs.oasis-open.org/odata/odata-json-format/v4.0/">
-	 * "OData JSON Format Version 4.0"</a>.
+	 * <a href="https://docs.oasis-open.org/odata/odata-json-format/v4.01/">
+	 * "OData JSON Format Version 4.01"</a>.
 	 * Note that the function clones the result. Modify values via
 	 * {@link sap.ui.model.odata.v4.ODataPropertyBinding#setValue}.
 	 *
@@ -1187,8 +1188,8 @@ sap.ui.define([
 	 * Returns the value for the given path. The function allows access to the complete data the
 	 * context points to (if <code>sPath</code> is "") or any part thereof. The data is a JSON
 	 * structure as described in
-	 * <a href="https://docs.oasis-open.org/odata/odata-json-format/v4.0/">
-	 * "OData JSON Format Version 4.0"</a>.
+	 * <a href="https://docs.oasis-open.org/odata/odata-json-format/v4.01/">
+	 * "OData JSON Format Version 4.01"</a>.
 	 * Note that the function returns the cache instance. Do not modify the result, use
 	 * {@link sap.ui.model.odata.v4.ODataPropertyBinding#setValue} instead.
 	 *
@@ -1583,18 +1584,27 @@ sap.ui.define([
 	 *   the context from the list binding's collection because the entity does not match the
 	 *   binding's filter anymore, see {@link sap.ui.model.odata.v4.ODataListBinding#filter};
 	 *   a removed context is destroyed, see {@link #destroy}. If the context belongs to a context
-	 *   binding, the parameter must not be used.
+	 *   binding or to a list binding with "$$aggregation", the parameter must not be used.
 	 *   Supported since 1.55.0
 	 *
 	 *   Since 1.84.0, if this context is {@link #isKeepAlive kept alive}, it is only destroyed if
 	 *   the corresponding entity does no longer exist in the back end. In this case, the
 	 *   <code>fnOnBeforeDestroy</code> callback passed with {@link #setKeepAlive}) is called.
-	 * @throws {Error}
-	 *   If the group ID is not valid, if this context has pending changes or does not represent a
-	 *   single entity (see {@link sap.ui.model.odata.v4.ODataListBinding#getHeaderContext}), if the
-	 *   binding is not refreshable or is a list binding with data aggregation, if its root binding
-	 *   is suspended, or if the parameter <code>bAllowRemoval</code> is set for a context belonging
-	 *   to a context binding.
+	 * @throws {Error} If
+	 *   <ul>
+	 *     <li> the group ID is not valid,
+	 *     <li> this context
+	 *       <ul>
+	 *         <li> {@link #isInactive is inactive},
+	 *         <li> {@link #hasPendingChanges has pending changes},
+	 *         <li> does not represent a single entity (see
+	 *           {@link sap.ui.model.odata.v4.ODataListBinding#getHeaderContext}),
+	 *       </ul>
+	 *     <li> the binding is a list binding with data aggregation,
+	 *     <li> the binding's root binding is suspended,
+	 *     <li> the <code>bAllowRemoval</code> parameter is set for a context belonging to a context
+	 *       binding or to a list binding with "$$aggregation".
+	 *   </ul>
 	 *
 	 * @public
 	 * @since 1.53.0
@@ -1679,11 +1689,12 @@ sap.ui.define([
 	/**
 	 * Returns a promise for the "canonical path" of the entity for this context. According to
 	 * <a href=
-	 * "https://docs.oasis-open.org/odata/odata/v4.0/odata-v4.0-part2-url-conventions.html#canonical-urlurl4.1.1"
-	 * >"4.3.1 Canonical URL"</a> of the specification "OData Version 4.0 Part 2: URL Conventions",
-	 * this is the "name of the entity set associated with the entity followed by the key predicate
-	 * identifying the entity within the collection". Use the canonical path in
-	 * {@link sap.ui.core.Element#bindElement} to create an element binding.
+	 * "https://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part2-url-conventions.html#_Toc31360932"
+	 * >"4.3.1 Canonical URL"</a> of the specification
+	 * "OData Version 4.01. Part 2: URL Conventions", this is the "name of the entity set associated
+	 * with the entity followed by the key predicate identifying the entity within the collection".
+	 * Use the canonical path in {@link sap.ui.core.Element#bindElement} to create an element
+	 * binding.
 	 *
 	 * Note: For a transient context (see {@link #isTransient}) a wrong path is returned unless all
 	 * key properties are available within the initial data.
@@ -1704,8 +1715,8 @@ sap.ui.define([
 	 * Returns a promise on the value for the given path relative to this context. The function
 	 * allows access to the complete data the context points to (if <code>sPath</code> is "") or
 	 * any part thereof. The data is a JSON structure as described in
-	 * <a href="https://docs.oasis-open.org/odata/odata-json-format/v4.0/">
-	 * "OData JSON Format Version 4.0"</a>.
+	 * <a href="https://docs.oasis-open.org/odata/odata-json-format/v4.01/">
+	 * "OData JSON Format Version 4.01"</a>.
 	 * Note that the function clones the result. Modify values via {@link #setProperty}.
 	 *
 	 * The header context of a list binding only delivers <code>$count</code> and
@@ -1830,7 +1841,7 @@ sap.ui.define([
 		var oPromise;
 
 		_Helper.checkGroupId(sGroupId);
-		if (this.oBinding.mParameters.$$aggregation) {
+		if (_Helper.isDataAggregation(this.oBinding.mParameters)) {
 			throw new Error("Cannot refresh " + this + " when using data aggregation");
 		}
 		this.oBinding.checkSuspended();
@@ -1839,8 +1850,7 @@ sap.ui.define([
 		}
 
 		if (this.oBinding.refreshSingle) {
-			oPromise = this.oBinding.refreshSingle(this, this.oBinding.lockGroup(sGroupId, true),
-				bAllowRemoval);
+			oPromise = this.oBinding.refreshSingle(this, sGroupId, true, bAllowRemoval);
 		} else {
 			if (arguments.length > 1) {
 				throw new Error("Unsupported parameter bAllowRemoval: " + bAllowRemoval);
@@ -1886,7 +1896,7 @@ sap.ui.define([
 
 	/**
 	 * Loads side effects for this context using the given
-	 * "14.5.11 Expression edm:NavigationPropertyPath" or "14.5.13 Expression edm:PropertyPath"
+	 * "14.4.1.5 Expression edm:NavigationPropertyPath" or "14.4.1.6 Expression edm:PropertyPath"
 	 * objects. Use this method to explicitly load side effects in case implicit loading is switched
 	 * off via the binding-specific parameter <code>$$patchWithoutSideEffects</code>. The method
 	 * can be called on
@@ -1928,8 +1938,8 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @param {Array<sap.ui.model.odata.v4.ts.NavigationPropertyPathExpression|sap.ui.model.odata.v4.ts.PropertyPathExpression|string>} aPathExpressions
-	 *   The "14.5.11 Expression edm:NavigationPropertyPath" or
-	 *   "14.5.13 Expression edm:PropertyPath" objects describing which properties need to be
+	 *   The "14.4.1.5 Expression edm:NavigationPropertyPath" or
+	 *   "14.4.1.6 Expression edm:PropertyPath" objects describing which properties need to be
 	 *   loaded because they may have changed due to side effects of a previous update, for example
 	 *   <code>[{$PropertyPath : "TEAM_ID"}, {$NavigationPropertyPath : "EMPLOYEE_2_MANAGER"},
 	 *   {$PropertyPath : "EMPLOYEE_2_TEAM/Team_Id"}]</code>. An empty navigation property path
@@ -1942,7 +1952,7 @@ sap.ui.define([
 	 *   Since 1.82.0, absolute paths are supported. Absolute paths must start with the entity
 	 *   container (example "/com.sap.gateway.default.iwbep.tea_busi.v0001.Container/TEAMS") of the
 	 *   service. All (navigation) properties in the complete model matching such an absolute path
-	 *   are updated. Since 1.85.0, "14.4.11 Expression edm:String" is accepted as well.
+	 *   are updated. Since 1.85.0, "14.3.11 Expression edm:String" is accepted as well.
 	 *
 	 *   Since 1.108.8, a property path matching the "com.sap.vocabularies.Common.v1.Messages"
 	 *   annotation of a list binding's entity type is treated specially for a row context of a list
@@ -1968,8 +1978,8 @@ sap.ui.define([
 	 *   <ul>
 	 *     <li> metadata has not yet been loaded
 	 *     <li> <code>aPathExpressions</code> contains objects other than
-	 *       "14.4.11 Expression edm:String", "14.5.11 Expression edm:NavigationPropertyPath" or
-	 *       "14.5.13 Expression edm:PropertyPath"
+	 *       "14.3.11 Expression edm:String", "14.4.1.5 Expression edm:NavigationPropertyPath" or
+	 *       "14.4.1.6 Expression edm:PropertyPath"
 	 *     <li> a path contains a "*", except for a property path as its sole or last segment
 	 *     <li> this context is not supported
 	 *     <li> the root binding of this context's binding is suspended (see {@link #getBinding} and

package/src/sap/ui/model/odata/v4/ODataBinding.js

@@ -1576,9 +1576,9 @@ sap.ui.define([
 	 * @param {string} sGroupId
 	 *   The group ID to be used for requesting side effects
 	 * @param {string[]} aPaths
-	 *   The "14.5.11 Expression edm:NavigationPropertyPath" or
-	 *   "14.5.13 Expression edm:PropertyPath" strings describing which properties need to be loaded
-	 *   because they may have changed due to side effects of a previous update
+	 *   The "14.4.1.5  Expression edm:NavigationPropertyPath" or
+	 *   "14.4.1.6 Expression edm:PropertyPath" strings describing which properties need to be
+	 *   loaded because they may have changed due to side effects of a previous update
 	 * @param {sap.ui.model.odata.v4.Context} [oContext]
 	 *   The context for which to request side effects; if missing, the whole binding is affected
 	 * @param {Promise[]} aPromises

package/src/sap/ui/model/odata/v4/ODataContextBinding.js

@@ -74,7 +74,7 @@ sap.ui.define([
 		 * @mixes sap.ui.model.odata.v4.ODataParentBinding
 		 * @public
 		 * @since 1.37.0
-		 * @version 1.141.1
+		 * @version 1.142.0
 		 *
 		 * @borrows sap.ui.model.odata.v4.ODataBinding#getGroupId as #getGroupId
 		 * @borrows sap.ui.model.odata.v4.ODataBinding#getRootBinding as #getRootBinding
@@ -1215,7 +1215,7 @@ sap.ui.define([
 	 * 1. Operation is bound.
 	 * 2. Operation has single entity return value. Note: existence of EntitySetPath
 	 *    implies the return value is an entity or a collection thereof;
-	 *    see OData V4 spec part 3, 12.1.3. It thus ensures the "entity" in this condition.
+	 *    see [OData-CSDL-XML-v4.01], 12.6. It thus ensures the "entity" in this condition.
 	 * 3. EntitySetPath of operation is the binding parameter.
 	 * 4. Operation binding has
 	 *    (a) a V4 parent context which
@@ -1454,7 +1454,7 @@ sap.ui.define([
 	 * 1. Operation is bound.
 	 * 2. Operation has single entity return value. Note: existence of EntitySetPath
 	 *    implies the return value is an entity or a collection thereof;
-	 *    see OData V4 spec part 3, 12.1.3. It thus ensures the "entity" in this condition.
+	 *    see [OData-CSDL-XML-v4.01], 12.6. It thus ensures the "entity" in this condition.
 	 * 3. EntitySetPath of operation is the binding parameter.
 	 * 4. Operation binding has
 	 *    (a) a V4 parent context.
@@ -1633,7 +1633,7 @@ sap.ui.define([
 	 *
 	 * @param {sap.ui.model.odata.v4.Context} oContext
 	 *   The context to refresh
-	 * @param {string} sGroupId
+	 * @param {string} [sGroupId]
 	 *   The group ID for the refresh
 	 * @param {boolean} [bKeepCacheOnError]
 	 *   If <code>true</code>, the binding data remains unchanged if the refresh fails
@@ -1685,8 +1685,8 @@ sap.ui.define([
 	 * Returns a promise on the value for the given path relative to this binding. The function
 	 * allows access to the complete data the binding points to (if <code>sPath</code> is "") or
 	 * any part thereof. The data is a JSON structure as described in
-	 * <a href="https://docs.oasis-open.org/odata/odata-json-format/v4.0/">
-	 * "OData JSON Format Version 4.0"</a>.
+	 * <a href="https://docs.oasis-open.org/odata/odata-json-format/v4.01/">
+	 * "OData JSON Format Version 4.01"</a>.
 	 * Note that the function clones the result. Modify values via
 	 * {@link sap.ui.model.odata.v4.Context#setProperty}.
 	 *