@openui5/sap.ui.core 1.96.2 → 1.97.0

package/src/sap/ui/model/odata/ODataUtils.js

@@ -73,7 +73,7 @@ sap.ui.define([
 	ODataUtils.createSortParams = function(aSorters) {
 		var sSortParam;
 		if (!aSorters || aSorters.length == 0) {
-			return;
+			return undefined;
 		}
 		sSortParam = "$orderby=";
 		for (var i = 0; i < aSorters.length; i++) {
@@ -122,7 +122,7 @@ sap.ui.define([
 		}
 
 		if (!oFilter) {
-			return;
+			return undefined;
 		}
 		return "$filter=" + this._createFilterParams(oFilter, oMetadata, oEntityType);
 	};
@@ -180,18 +180,20 @@ sap.ui.define([
 		}
 
 		if (!oFilter) {
-			return;
+			return undefined;
 		}
 
 		return create(oFilter, true);
 	};
 
 	/**
-	 * Converts a string or object-map with URL Parameters into an array.
-	 * If vParams is an object map, it will be also encoded properly.
+	 * Converts a string or object-map with URL parameters into an array.
+	 * If <code>vParams</code> is an object map, it will be also encoded properly.
+	 *
+	 * @param {string|object|array} vParams URL parameters
+	 * @returns {string[]} Encoded URL parameters
 	 *
 	 * @private
-	 * @param {string|object|array} vParams parameters
 	 */
 	ODataUtils._createUrlParamsArray = function(vParams) {
 		var aUrlParams, sType = typeof vParams, sParams;
@@ -387,7 +389,12 @@ sap.ui.define([
 
 
 	/**
-	 * convert multi filter to filter string
+	 * Convert multi filter to filter string.
+	 *
+	 * @param {object} oMultiFilter A multi filter
+	 * @param {sap.ui.model.odata.ODataMetadata} oMetadata The metadata
+	 * @param {object} oEntityType The entity type to filter
+	 * @returns {string} A filter string
 	 *
 	 * @private
 	 */
@@ -419,7 +426,16 @@ sap.ui.define([
 	};
 
 	/**
-	 * Create a single filter segment of the OData filter parameters
+	 * Create a single filter segment of the OData filter parameters.
+	 *
+	 * @param {string} sPath The path to the value
+	 * @param {sap.ui.model.odata.ODataMetadata} oMetadata The metadata
+	 * @param {object} oEntityType The value's entity type
+	 * @param {string} sOperator The filter operator
+	 * @param {object} oValue1 The first value
+	 * @param {object} oValue2 The second value
+	 * @param {boolean} [bCaseSensitive=true] Whether the case should be considered
+	 * @returns {string} The encoded string representation of the given filter
 	 *
 	 * @private
 	 */
@@ -455,7 +471,6 @@ sap.ui.define([
 			sPath =  "toupper(" + sPath + ")";
 		}
 
-		// TODO embed 2nd value
 		switch (sOperator) {
 			case "EQ":
 			case "NE":

package/src/sap/ui/model/odata/_AnnotationHelperBasics.js

@@ -419,7 +419,8 @@ sap.ui.define([
 				case "expression":
 					return bExpression ? vValue : "{=" + vValue + "}";
 
-				// no default
+				default:
+					return undefined;
 			}
 		},
 

package/src/sap/ui/model/odata/_AnnotationHelperExpression.js

@@ -187,11 +187,11 @@ sap.ui.define([
 		 * Handling of "14.5.3 Expression edm:Apply".
 		 *
 		 * @param {sap.ui.core.util.XMLPreprocessor.IContext|sap.ui.model.Context} oInterface
-		 *   the callback interface related to the current formatter call
+		 *   The callback interface related to the current formatter call
 		 * @param {object} oPathValue
-		 *   path and value information pointing to the apply (see Expression object)
-		 * @returns {object}
-		 *   the result object
+		 *   Path and value information pointing to the apply (see Expression object)
+		 * @returns {object|undefined}
+		 *   The result object or <code>undefined</code> in error cases
 		 */
 		apply : function (oInterface, oPathValue) {
 			var oName = Basics.descend(oPathValue, "Name", "string"),
@@ -206,6 +206,7 @@ sap.ui.define([
 					return Expression.uriEncode(oInterface, oParameters);
 				default:
 					Basics.error(oName, "unknown function: " + oName.value);
+					return undefined;
 			}
 		},
 
@@ -360,11 +361,11 @@ sap.ui.define([
 		 * Calculates an expression.
 		 *
 		 * @param {sap.ui.core.util.XMLPreprocessor.IContext|sap.ui.model.Context} oInterface
-		 *   the callback interface related to the current formatter call
+		 *   The callback interface related to the current formatter call
 		 * @param {object} oPathValue
-		 *   path and value information pointing to the parameters array (see Expression object)
-		 * @returns {object}
-		 *   the result object
+		 *   Path and value information pointing to the parameters array (see Expression object)
+		 * @returns {object|undefined}
+		 *   The result object or <code>undefined</code> in error cases
 		 */
 		expression : function (oInterface, oPathValue) {
 			var oRawValue = oPathValue.value,
@@ -428,6 +429,7 @@ sap.ui.define([
 					};
 				default:
 					Basics.error(oPathValue, "Unsupported OData expression");
+					return undefined;
 			}
 		},
 

package/src/sap/ui/model/odata/_ODataMetaModelUtils.js

@@ -702,11 +702,12 @@ sap.ui.define([
 			if (oSchema) {
 				aArray = oSchema[sArrayName];
 				if (aArray) {
-					aArray.forEach(function (oThing) {
+					aArray.some(function (oThing) {
 						if (oThing.name === sName) {
 							vResult = bAsPath ? oThing.$path : oThing;
-							return false; // break
+							return true;
 						}
+						return false;
 					});
 				}
 			}
@@ -731,11 +732,12 @@ sap.ui.define([
 					: vModel.getObject("/dataServices/schema");
 
 			if (aSchemas) {
-				aSchemas.forEach(function (o) {
+				aSchemas.some(function (o) {
 					if (o.namespace === sNamespace) {
 						oSchema = o;
-						return false; // break
+						return true;
 					}
+					return false;
 				});
 			}
 

package/src/sap/ui/model/odata/type/Boolean.js

@@ -87,7 +87,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @alias sap.ui.model.odata.type.Boolean
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/Byte.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.Int
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @alias sap.ui.model.odata.type.Byte
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/Currency.js

@@ -61,7 +61,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.type.Currency
 	 * @public
 	 * @since 1.63.0
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 */
 	var Currency = BaseCurrency.extend("sap.ui.model.odata.type.Currency", {
 		constructor : function (oFormatOptions, oConstraints) {

package/src/sap/ui/model/odata/type/Date.js

@@ -106,7 +106,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @alias sap.ui.model.odata.type.Date
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/DateTime.js

@@ -59,7 +59,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.DateTimeBase
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @alias sap.ui.model.odata.type.DateTime
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/DateTimeBase.js

@@ -132,7 +132,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 * @public
 	 * @since 1.27.0
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 */
 	var DateTimeBase = ODataType.extend("sap.ui.model.odata.type.DateTimeBase", {
 			constructor : function (oFormatOptions, oConstraints) {

package/src/sap/ui/model/odata/type/DateTimeOffset.js

@@ -28,7 +28,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.DateTimeBase
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @alias sap.ui.model.odata.type.DateTimeOffset
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/Decimal.js

@@ -135,6 +135,8 @@ sap.ui.define([
 				}
 				logWarning(sValue, sName);
 			}
+
+			return undefined;
 		}
 
 		function validateBoolean(vValue, sName) {
@@ -144,6 +146,8 @@ sap.ui.define([
 			if (vValue !== undefined && vValue !== false && vValue !== "false") {
 				logWarning(vValue, sName);
 			}
+
+			return undefined;
 		}
 
 		function setConstraint(sName, vValue, vDefault) {
@@ -197,7 +201,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @alias sap.ui.model.odata.type.Decimal
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/Double.js

@@ -95,7 +95,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @alias sap.ui.model.odata.type.Double
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/Guid.js

@@ -62,7 +62,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @alias sap.ui.model.odata.type.Guid
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/Int.js

@@ -80,7 +80,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @abstract
 	 * @alias sap.ui.model.odata.type.Int

package/src/sap/ui/model/odata/type/Int16.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.Int
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @alias sap.ui.model.odata.type.Int16
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/Int32.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.Int
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @alias sap.ui.model.odata.type.Int32
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/Int64.js

@@ -137,7 +137,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @alias sap.ui.model.odata.type.Int64
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/ODataType.js

@@ -115,7 +115,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.SimpleType
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @abstract
 	 * @alias sap.ui.model.odata.type.ODataType

package/src/sap/ui/model/odata/type/Raw.js

@@ -30,7 +30,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 * @public
 	 * @since 1.37.0
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 */
 	var Raw = ODataType.extend("sap.ui.model.odata.type.Raw", {
 			constructor : function (oFormatOptions, oConstraints) {

package/src/sap/ui/model/odata/type/SByte.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.Int
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @alias sap.ui.model.odata.type.SByte
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/Single.js

@@ -95,7 +95,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @alias sap.ui.model.odata.type.Single
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/Stream.js

@@ -60,7 +60,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 * @public
 	 * @since 1.51.0
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 */
 	var Stream = ODataType.extend("sap.ui.model.odata.type.Stream", {
 			constructor : function (oFormatOptions, oConstraints) {

package/src/sap/ui/model/odata/type/String.js

@@ -84,7 +84,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @alias sap.ui.model.odata.type.String
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/Time.js

@@ -154,7 +154,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @alias sap.ui.model.odata.type.Time
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/odata/type/TimeOfDay.js

@@ -110,7 +110,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 * @public
 	 * @since 1.37.0
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 */
 	var TimeOfDay = ODataType.extend("sap.ui.model.odata.type.TimeOfDay", {
 			constructor : function (oFormatOptions, oConstraints) {

package/src/sap/ui/model/odata/type/Unit.js

@@ -63,7 +63,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.type.Unit
 	 * @public
 	 * @since 1.63.0
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 */
 	var Unit = BaseUnit.extend("sap.ui.model.odata.type.Unit", {
 		constructor : function (oFormatOptions, oConstraints, aDynamicFormatOptionNames) {

package/src/sap/ui/model/odata/type/UnitMixin.js

@@ -11,7 +11,6 @@ sap.ui.define([
 	"sap/ui/model/ValidateException"
 ], function (ParseException, ValidateException) {
 	"use strict";
-	/*global Map */
 
 	var mCodeList2CustomUnits = new Map(),
 		rDecimals = /\.(\d+)$/,

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

@@ -21,7 +21,8 @@ sap.ui.define([
 	 *   The absolute deep path including all intermediate paths of the binding hierarchy
 	 * @param {sap.ui.base.SyncPromise} [oCreatePromise]
 	 *   A sync promise that is given when this context has been created by
-	 *   {@link sap.ui.model.odata.v2.ODataModel#createEntry}.
+	 *   {@link sap.ui.model.odata.v2.ODataModel#createEntry} or
+	 *   {@link sap.ui.model.odata.v2.ODataListBinding#create}.
 	 *
 	 *   When the entity represented by this context has been successfully persisted in the back
 	 *   end, the given promise resolves.
@@ -43,6 +44,7 @@ sap.ui.define([
 	 *   <ul>
 	 *     <li>an OData binding</li>
 	 *     <li>a view element</li>
+	 *     <li>{@link sap.ui.model.odata.v2.ODataListBinding#create}</li>
 	 *     <li>{@link sap.ui.model.odata.v2.ODataModel#callFunction}</li>
 	 *     <li>{@link sap.ui.model.odata.v2.ODataModel#createBindingContext}</li>
 	 *     <li>{@link sap.ui.model.odata.v2.ODataModel#createEntry}</li>
@@ -52,7 +54,7 @@ sap.ui.define([
 	 * @hideconstructor
 	 * @public
 	 * @since 1.93.0
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 */
 	var Context = BaseContext.extend("sap.ui.model.odata.v2.Context", {
 			constructor : function (oModel, sPath, sDeepPath, oCreatePromise) {
@@ -81,7 +83,8 @@ sap.ui.define([
 
 	/**
 	 * Returns a promise on the creation state of this context if it has been created via
-	 * {@link sap.ui.model.odata.v2.ODataModel#createEntry}; otherwise returns
+	 * {@link sap.ui.model.odata.v2.ODataModel#createEntry} or
+	 * {@link sap.ui.model.odata.v2.ODataListBinding#create}; otherwise returns
 	 * <code>undefined</code>.
 	 *
 	 * As long as the promise is not yet resolved or rejected, the entity represented by this
@@ -90,9 +93,18 @@ sap.ui.define([
 	 * Once the promise is resolved, the entity for this context is stored in the back end and
 	 * {@link #getPath} returns a path including the key predicate of the new entity.
 	 *
+	 * If the context has been created via {@link sap.ui.model.odata.v2.ODataListBinding#create} and
+	 * the entity for this context has been stored in the back end, {@link #created} returns
+	 * <code>undefined</code> after the data has been re-read from the back end and inserted at the
+	 * right position based on the list binding's filters and sorters.
+	 * If the context has been created via {@link sap.ui.model.odata.v2.ODataModel#createEntry} and
+	 * the entity for this context has been stored in the back end, {@link #created} returns
+	 * <code>undefined</code>.
+	 *
 	 * @returns {Promise}
 	 *   A promise for a context which has been created via
-	 *   {@link sap.ui.model.odata.v2.ODataModel#createEntry}, otherwise <code>undefined</code>.
+	 *   {@link sap.ui.model.odata.v2.ODataModel#createEntry} or
+	 *   {@link sap.ui.model.odata.v2.ODataListBinding#create}, otherwise <code>undefined</code>.
 	 *
 	 *   When the entity represented by this context has been persisted in the back end, the promise
 	 *   resolves without data.
@@ -164,15 +176,24 @@ sap.ui.define([
 	};
 
 	/**
-	 * For a context created using {@link sap.ui.model.odata.v2.ODataModel#createEntry}, the method
-	 * returns <code>true</code> if the context is transient or <code>false</code> if the context is
-	 * not transient. A transient context represents an entity created on the client which has not
-	 * been persisted in the back end.
+	 * For a context created using {@link sap.ui.model.odata.v2.ODataModel#createEntry} or
+	 * {@link sap.ui.model.odata.v2.ODataListBinding#create}, the method returns <code>true</code>
+	 * if the context is transient or <code>false</code> if the context is not transient. A
+	 * transient context represents an entity created on the client which has not been persisted in
+	 * the back end.
 	 *
 	 * @returns {boolean}
-	 *   Whether this context is transient if it has been created using
-	 *   {@link sap.ui.model.odata.v2.ODataModel#createEntry}; returns <code>undefined</code> if the
-	 *   context has not been created using {@link sap.ui.model.odata.v2.ODataModel#createEntry}
+	 *   <ul>
+	 *   <li><code>true</code>: if the context has been created via
+	 *     {@link sap.ui.model.odata.v2.ODataModel#createEntry} or
+	 *     {@link sap.ui.model.odata.v2.ODataListBinding#create} and is not yet persisted in the
+	 *     back end,</li>
+	 *   <li><code>false</code>: if the context has been created via
+	 *     {@link sap.ui.model.odata.v2.ODataListBinding#create}, data has been successfully
+	 *     persisted in the back end and the data is still displayed in the area of the inline
+	 *     creation rows, and</li>
+	 *   <li><code>undefined</code>: otherwise</li>
+	 *   </ul>
 	 *
 	 * @public
 	 * @since 1.94.0
@@ -192,6 +213,16 @@ sap.ui.define([
 		return this.bUpdated;
 	};
 
+	/**
+	 * Resets the created promise to indicate that the entity has been re-read from the back end.
+	 *
+	 * @private
+	 */
+	Context.prototype.resetCreatedPromise = function () {
+		this.oCreatePromise = undefined;
+		this.oSyncCreatePromise = undefined;
+	};
+
 	/**
 	 * Sets the absolute deep path; see {@link #getDeepPath} for details.
 	 *

package/src/sap/ui/model/odata/v2/ODataAnnotations.js

@@ -35,7 +35,7 @@ sap.ui.define([
 	 * @class Annotation loader for OData V2 services
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @public
 	 * @since 1.37.0