@openui5/sap.ui.core 1.100.0 → 1.102.1

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

@@ -6,18 +6,16 @@
 
 sap.ui.define([
 	"sap/ui/core/format/DateFormat",
-	"sap/ui/core/format/DateFormatTimezoneDisplay",
 	"sap/ui/model/_Helper",
 	"sap/ui/model/CompositeType",
 	"sap/ui/model/FormatException",
 	"sap/ui/model/ParseException"
-], function (DateFormat, DateFormatTimezoneDisplay, _Helper, CompositeType, FormatException,
-		ParseException) {
+], function (DateFormat, _Helper, CompositeType, FormatException, ParseException) {
 	"use strict";
 
-	var oDemoDateTime = new Date(Date.UTC(new Date().getFullYear(), 11, 31, 23, 59, 58)),
-		sObjectNotOnly = "For type 'object', the format option 'showTimezone' must not be set to "
-			+ "sap.ui.core.format.DateFormatTimezoneDisplay.Only";
+	var sDateOrTimeRequired = "For type 'object', at least one of the format options 'showDate' or"
+			+ " 'showTime' must be enabled",
+		oDemoDateTime = new Date(Date.UTC(new Date().getFullYear(), 11, 31, 23, 59, 58));
 
 	/*
 	 * Returns the formatter. Creates it lazily.
@@ -62,8 +60,7 @@ sap.ui.define([
 	 * @public
 	 * @see {sap.ui.model.odata.v2.ODataModel#bindProperty}
 	 * @since 1.99.0
-	 * @experimental The behavior of this type may change in the future.
-	 * @version 1.100.0
+	 * @version 1.102.1
 	 */
 	var DateTimeWithTimezone = CompositeType.extend("sap.ui.model.odata.type.DateTimeWithTimezone",
 		{
@@ -77,6 +74,10 @@ sap.ui.define([
 				this.bParseWithValues = true;
 				this.bUseInternalValues = true;
 				this.vEmptyTimezoneValue = null;
+				this.bShowDate = oFormatOptions.showDate === undefined || oFormatOptions.showDate;
+				this.bShowTime = oFormatOptions.showTime === undefined || oFormatOptions.showTime;
+				this.bShowTimezone = oFormatOptions.showTimezone === undefined
+					|| oFormatOptions.showTimezone;
 
 				// must not overwrite setConstraints and setFormatOptions on prototype as they are
 				// called in SimpleType constructor
@@ -99,7 +100,7 @@ sap.ui.define([
 	 * @private
 	 */
 	DateTimeWithTimezone.prototype._getErrorMessage = function () {
-		var sMessageKey = this.oFormatOptions.showTimezone === DateFormatTimezoneDisplay.Only
+		var sMessageKey = !this.bShowDate && !this.bShowTime
 				? "EnterDateTimeTimezone"
 				: "EnterDateTime";
 
@@ -127,7 +128,7 @@ sap.ui.define([
 	 *     <li>if the time zone or timestamp in <code>aValues</code> is <code>undefined</code>, or
 	 *     </li>
 	 *     <li>if the timestamp in <code>aValues</code> is not set and the <code>showTimezone</code>
-	 *       format option is set to <code>sap.ui.core.format.DateFormatTimezoneDisplay.Hide</code>
+	 *       format option is set to <code>false</code>
 	 *     </li>
 	 *   </ul>
 	 * @throws {sap.ui.model.FormatException}
@@ -137,21 +138,20 @@ sap.ui.define([
 	 *     <li>a timestamp is given in <code>aValues</code> that is not an instance of
 	 *       <code>Date</code>,</li>
 	 *     <li>the <code>sTargetType</code> is "object" or an equivalent primitive type, and the
-	 *       <code>showTimezone</code> format option is
-	 *       <code>sap.ui.core.format.DateFormatTimezoneDisplay.Only</code></li>
+	 *       <code>showTimezone</code> format option is enabled, but <code>showDate</code> and
+	 *       <code>showTime</code> are both <code>false</code></li>
 	 *   </ul>
 	 * @public
 	 */
 	DateTimeWithTimezone.prototype.formatValue = function (aValues, sTargetType) {
-		var sShowTimezone = this.oFormatOptions.showTimezone,
-			oTimestamp = aValues && aValues[0],
+		var oTimestamp = aValues && aValues[0],
 			sTimezone = aValues && aValues[1];
 
 		if (!aValues
 				|| sTimezone === undefined // data is not yet available
 				|| oTimestamp === undefined // data is not yet available
 				// if time zone is not shown falsy timestamps cannot be formatted -> return null
-				|| (!oTimestamp && sShowTimezone === DateFormatTimezoneDisplay.Hide)) {
+				|| (!oTimestamp && !this.bShowTimezone)) {
 			return null;
 		}
 
@@ -162,8 +162,8 @@ sap.ui.define([
 
 		switch (this.getPrimitiveType(sTargetType)) {
 			case "object":
-				if (sShowTimezone === DateFormatTimezoneDisplay.Only) {
-					throw new FormatException(sObjectNotOnly);
+				if (!this.bShowDate && !this.bShowTime) {
+					throw new FormatException(sDateOrTimeRequired);
 				}
 
 				return oTimestamp;
@@ -192,13 +192,12 @@ sap.ui.define([
 	 * Gets an array of indices that determine which parts of this type shall not propagate their
 	 * model messages to the attached control. Prerequisite is that the corresponding binding
 	 * supports this feature, see {@link sap.ui.model.Binding#supportsIgnoreMessages}. If the
-	 * <code>showTimezone</code> format option is set to
-	 * <code>sap.ui.core.format.DateFormatTimezoneDisplay.Hide</code> and the time zone is not shown
-	 * in the control, the part for the time zone shall not propagate model messages to the control.
-	 * Analogously, if the format option <code>showTimezone</code> is set to
-	 * <code>sap.ui.core.format.DateFormatTimezoneDisplay.Only</code>, the date and time are not
-	 * shown in the control and the parts for the date and time shall not propagate model messages
-	 * to the control.
+	 * <code>showTimezone</code> format option is set to <code>false</code>, the time zone is not
+	 * shown in the control, and the part for the time zone shall not propagate model messages to
+	 * the control.
+	 * Analogously, if the format option <code>showDate</code> and <code>showTime</code> are both
+	 * set to <code>false</code>, the date and time are not shown in the control, and the parts for
+	 * the date and time shall not propagate model messages to the control.
 	 *
 	 * @return {number[]}
 	 *   An array of indices that determine which parts of this type shall not propagate their
@@ -209,11 +208,9 @@ sap.ui.define([
 	 */
 	// @override sap.ui.model.CompositeType#getPartsIgnoringMessages
 	DateTimeWithTimezone.prototype.getPartsIgnoringMessages = function () {
-		var sShowTimezone = this.oFormatOptions.showTimezone;
-
-		if (sShowTimezone === DateFormatTimezoneDisplay.Only) {
+		if (!this.bShowDate && !this.bShowTime) {
 			return [0];
-		} else if (sShowTimezone === DateFormatTimezoneDisplay.Hide) {
+		} else if (!this.bShowTimezone) {
 			return [1];
 		}
 
@@ -247,17 +244,18 @@ sap.ui.define([
 	 *     <li>the value is not parsable,</li>
 	 *     <li><code>aCurrentValues</code> is not given,</li>
 	 *     <li>the <code>sSourceType</code> is "object" or an equivalent primitive type, and the
-	 *       <code>showTimezone</code> format option is
-	 *       <code>sap.ui.core.format.DateFormatTimezoneDisplay.Only</code>,</li>
+	 *       <code>showTimezone</code> format option is enabled, but <code>showDate</code> and
+	 *       <code>showTime</code> are both <code>false</code>,</li>
 	 *     <li>the <code>sSourceType</code> is "object" or an equivalent primitive type, and the
-	 *       value is not an instance of <code>Date</code></li>
+	 *       value is not an instance of <code>Date</code>,</li>
+	 *     <li>the <code>sSourceType</code> is "string" or an equivalent primitive type, and either
+	 *       <code>showDate</code> or <code>showTime</code> format option is <code>false</code></li>
 	 *   </ul>
 	 *
 	 * @public
 	 */
 	DateTimeWithTimezone.prototype.parseValue = function (vValue, sSourceType, aCurrentValues) {
-		var aDateWithTimezone,
-			sShowTimezone = this.oFormatOptions.showTimezone;
+		var aDateWithTimezone;
 
 		if (!aCurrentValues) {
 			throw new ParseException("'aCurrentValues' is mandatory");
@@ -265,8 +263,8 @@ sap.ui.define([
 
 		switch (this.getPrimitiveType(sSourceType)) {
 			case "object":
-				if (sShowTimezone === DateFormatTimezoneDisplay.Only) {
-					throw new ParseException(sObjectNotOnly);
+				if (!this.bShowDate && !this.bShowTime) {
+					throw new ParseException(sDateOrTimeRequired);
 				}
 
 				if (!vValue) {
@@ -280,14 +278,18 @@ sap.ui.define([
 				return [vValue, undefined];
 			case "string":
 				if (!vValue) {
-					if (sShowTimezone === DateFormatTimezoneDisplay.Only) {
+					if (!this.bShowDate && !this.bShowTime) {
 						return [/*unchanged*/undefined, this.vEmptyTimezoneValue];
 					}
 
 					return [null, /*unchanged*/undefined];
 				}
 
-				aDateWithTimezone = getFormatter(this).parse(vValue, aCurrentValues[1]);
+				try {
+					aDateWithTimezone = getFormatter(this).parse(vValue, aCurrentValues[1]);
+				} catch (oError) { // wrap technical error to show the error at the control
+					throw new ParseException(oError.message);
+				}
 				if (!aDateWithTimezone) {
 					throw new ParseException(this._getErrorMessage());
 				}

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

@@ -201,7 +201,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 *
 	 * @author SAP SE
-	 * @version 1.100.0
+	 * @version 1.102.1
 	 *
 	 * @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.100.0
+	 * @version 1.102.1
 	 *
 	 * @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.100.0
+	 * @version 1.102.1
 	 *
 	 * @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.100.0
+	 * @version 1.102.1
 	 *
 	 * @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.100.0
+	 * @version 1.102.1
 	 *
 	 * @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.100.0
+	 * @version 1.102.1
 	 *
 	 * @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.100.0
+	 * @version 1.102.1
 	 *
 	 * @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.100.0
+	 * @version 1.102.1
 	 *
 	 * @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.100.0
+	 * @version 1.102.1
 	 */
 	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.100.0
+	 * @version 1.102.1
 	 *
 	 * @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.100.0
+	 * @version 1.102.1
 	 *
 	 * @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.100.0
+	 * @version 1.102.1
 	 */
 	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.100.0
+	 * @version 1.102.1
 	 *
 	 * @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.100.0
+	 * @version 1.102.1
 	 *
 	 * @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.100.0
+	 * @version 1.102.1
 	 */
 	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.100.0
+	 * @version 1.102.1
 	 */
 	var Unit = BaseUnit.extend("sap.ui.model.odata.type.Unit", {
 		constructor : function (oFormatOptions, oConstraints, aDynamicFormatOptionNames) {

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

@@ -262,7 +262,7 @@ sap.ui.define([
 			}
 
 			aMatches = rDecimals.exec(vNumber);
-			iFractionDigits = aMatches ? aMatches[1].length : 0;
+			iFractionDigits = aMatches ? aMatches[1].replace(rTrailingZeros, "").length : 0;
 			iDecimals = this.mCustomUnits[sUnit].decimals;
 			if (iFractionDigits > iDecimals) {
 				throw this.getValidateException(iDecimals);

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

@@ -7,10 +7,13 @@
 //Provides class sap.ui.model.odata.v2.Context
 sap.ui.define([
 	"sap/ui/base/SyncPromise",
-	"sap/ui/model/Context"
-], function (SyncPromise, BaseContext) {
+	"sap/ui/model/Context",
+	"sap/ui/model/_Helper"
+], function (SyncPromise, BaseContext, _Helper) {
 	"use strict";
 
+	var aDeleteParametersAllowList = ["changeSetId", "groupId", "refreshAfterChange"];
+
 	/**
 	 * Do <strong>NOT</strong> call this private constructor.
 	 *
@@ -57,7 +60,7 @@ sap.ui.define([
 	 * @hideconstructor
 	 * @public
 	 * @since 1.93.0
-	 * @version 1.100.0
+	 * @version 1.102.1
 	 */
 	var Context = BaseContext.extend("sap.ui.model.odata.v2.Context", {
 			constructor : function (oModel, sPath, sDeepPath, oCreatePromise, bInactive) {
@@ -152,6 +155,72 @@ sap.ui.define([
 		return this.oCreatePromise;
 	};
 
+	/**
+	 * Deletes the OData entity this context points to.
+	 * <b>Note:</b> The context must not be used anymore after successful deletion.
+	 *
+	 * @param {object} [mParameters]
+	 *   For a persistent context, a map of parameters as specified for
+	 *   {@link sap.ui.model.odata.v2.ODataModel#remove}, except that the <code>groupId</code> and
+	 *   <code>changeSetId</code> parameters default to the values set via
+	 *   {@link sap.ui.model.odata.v2.ODataModel#setChangeGroups} for the type of the entity to be
+	 *   deleted.
+	 * @param {string} [mParameters.groupId]
+	 *   ID of a request group; requests belonging to the same group will be bundled in one batch
+	 *   request. If not provided, the <code>groupId</code> defined for the type of the entity to be
+	 *   deleted is used.
+	 * @param {string} [mParameters.changeSetId]
+	 *   ID of the <code>ChangeSet</code> that this request should belong to. If not provided, the
+	 *   <code>changeSetId</code> defined for the type of the entity to be deleted is used.
+	 * @param {boolean} [mParameters.refreshAfterChange]
+	 *   Defines whether to update all bindings after submitting this change operation,
+	 *   see {@link #setRefreshAfterChange}. If given, this overrules the model-wide
+	 *   <code>refreshAfterChange</code> flag for this operation only.
+	 * @returns {Promise} A promise resolving with <code>undefined</code> in case of successful
+	 *   deletion or rejecting with an error in case the deletion failed
+	 * @throws {Error}
+	 *   If the given parameter map contains any other parameter than those documented above in case
+	 *   of a persistent context
+	 *
+	 * @public
+	 * @since 1.101
+	 */
+	Context.prototype.delete = function (mParameters) {
+		var sParameterKey,
+			oModel = this.getModel(),
+			that = this;
+
+		mParameters = mParameters || {};
+		for (sParameterKey in mParameters) {
+			if (!aDeleteParametersAllowList.includes(sParameterKey)) {
+				throw new Error("Parameter '" + sParameterKey + "' is not supported");
+			}
+		}
+
+		if (this.isInactive()) {
+			oModel._discardEntityChanges(oModel._getKey(this), true);
+			oModel.checkUpdate();
+
+			return Promise.resolve();
+		} else if (this.isTransient()) {
+			return oModel.resetChanges([this.getPath()], /*bAll=abort deferred requests*/false,
+				/*bDeleteCreatedEntities*/true);
+		}
+
+		return new Promise(function (resolve, reject) {
+			var oGroupInfo = oModel._resolveGroup(that.getPath());
+
+			oModel.remove("",
+				_Helper.merge({
+					changeSetId : oGroupInfo.changeSetId,
+					context : that,
+					error : reject,
+					groupId : oGroupInfo.groupId,
+					success : function () {resolve();}
+				}, mParameters));
+		});
+	};
+
 	/**
 	 * Returns the promise which resolves with <code>undefined</code> on activation of this context
 	 * or if this context is already active; the promise never rejects.

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.100.0
+	 * @version 1.102.1
 	 *
 	 * @public
 	 * @since 1.37.0