@openui5/sap.ui.core 1.124.1 → 1.125.0

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

@@ -0,0 +1,362 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+sap.ui.define([
+	"sap/base/Log",
+	"sap/ui/core/Element",
+	"sap/ui/core/ElementRegistry",
+	"sap/ui/core/LabelEnablement"
+], function (Log, Element, ElementRegistry, LabelEnablement) {
+	"use strict";
+
+	const sClassName = "sap/ui/model/FieldHelp";
+	const sDocumentationRef = "com.sap.vocabularies.Common.v1.DocumentationRef";
+	const sURNPrefix = "urn:sap-com:documentation:key?=";
+
+	/**
+	 * @typedef {object} module:sap/ui/model/BackendHelpKey
+	 * @description The back-end help key as used by the SAP Companion to retrieve the field help.
+	 * @property {string} id The ID of the back-end help key
+	 * @property {string} [origin] The origin of the back end
+	 * @property {string} type The type of the help key
+	 *
+	 * @private
+	 * @ui5-restricted sap.ui.core
+	 */
+
+	/**
+	 * @typedef {object} module:sap/ui/model/FieldHelpInfo
+	 * @description The label, the control ID and the back-end help key as required by the SAP Companion to display
+	 *   the field help for the control with the given ID.
+	 * @property {module:sap/ui/model/BackendHelpKey} backendHelpKey The back-end help key
+	 * @property {string} hotspotId The ID of the control
+	 * @property {string} labelText The label text of the control
+	 *
+	 * @private
+	 * @ui5-restricted sap.ui.core
+	 */
+
+	/**
+	 * @typedef {Object<string, module:sap/ui/model/BackendHelpKey[]>} module:sap/ui/model/PropertyBackendHelpKeys
+	 * @description
+	 *   Maps the control property to the array of back-end help keys.
+	 */
+
+	/**
+	 * The singleton instance.
+	 * @type {module:sap/ui/model/FieldHelp}
+	 */
+	let oFieldHelp;
+
+	/**
+	 * DO NOT call this private constructor for <code>FieldHelp</code>; use <code>FieldHelp.getInstance</code> instead.
+	 * Singleton class to provide field help support for controls as used by the SAP Companion.
+	 *
+	 * @alias module:sap/ui/model/FieldHelp
+	 * @author SAP SE
+	 * @class
+	 *
+	 * @hideconstructor
+	 * @private
+	 * @since 1.125.0
+	 */
+	class FieldHelp {
+		/**
+		 * Whether the field help support is active.
+		 *
+		 * @default false
+		 * @type {boolean}
+		 */
+		#bActive = false;
+
+		/**
+		 * The callback function that is called if the field help hotspots have changed.
+		 *
+		 * @default null
+		 * @type {function(module:sap/ui/model/FieldHelpInfo[])}
+		 */
+		#fnUpdateHotspotsCallback = null;
+
+		/**
+		 * Maps a control ID to an object mapping a control property to a back-end help key URNs.
+		 *
+		 * @default {}
+		 * @type {Object<string, Object<string, string[]>>}
+		 */
+		#mDocuRefControlToFieldHelp = {};
+
+		/**
+		 * A Promise that resolves when all hotspot updates are done.
+		 *
+		 * @default null
+		 * @type {Promise}
+		 */
+		#oUpdateHotspotsPromise = null;
+
+		/**
+		 * Requests the <code>String</code> value of the <code>com.sap.vocabularies.Common.v1.DocumentationRef</code>
+		 * annotation for the given binding.
+		 *
+		 * @param {sap.ui.model.Binding} oBinding The binding
+		 * @return {Promise<string>|undefined}
+		 *   If the binding is destroyed, or does not belong to an OData model, or the resolved path of the binding is a
+		 *   meta model path or referencing an annotation, then <code>undefined</code> is returned; if the binding
+		 *   belongs to an OData model the <code>com.sap.vocabularies.Common.v1.DocumentationRef</code> annotation value
+		 *   for the binding is asynchronously requested via the OData meta model and the resulting <code>Promise</code>
+		 *   either resolves with the <code>String</code> value of that annotation or with <code>undefined</code> if the
+		 *   annotation is not available; the <code>Promise</code> never rejects
+		 */
+		static _requestDocumentationRef(oBinding) {
+			if (oBinding.isDestroyed()) {
+				return undefined;
+			}
+			const sResolvedPath = oBinding.getResolvedPath();
+			if (!sResolvedPath || sResolvedPath.includes("#") /*meta model path*/
+					|| sResolvedPath.includes("@") /*annotation path*/) {
+				return undefined;
+			}
+			const oMetaModel = oBinding.getModel()?.getMetaModel();
+			if (!oMetaModel || !oMetaModel.getMetaContext) {
+				return undefined;
+			}
+
+			let oFieldHelpAnnotationPromise;
+			if (oMetaModel.isA("sap.ui.model.odata.ODataMetaModel")) {
+				oFieldHelpAnnotationPromise = oMetaModel.loaded().then(() => {
+					// first get the object for the meta context then get the annotation to avoid warnings that an
+					// invalid path is used; getMetaContext has to be called after the meta model is loaded.
+					return oMetaModel.getObject("", oMetaModel.getMetaContext(sResolvedPath))?.[sDocumentationRef];
+				});
+			} else { // V4 meta model
+				oFieldHelpAnnotationPromise = oMetaModel.requestObject("@" + sDocumentationRef,
+					oMetaModel.getMetaContext(sResolvedPath));
+			}
+			return oFieldHelpAnnotationPromise.then((oFieldHelpAnnotation) => oFieldHelpAnnotation?.String)
+				.catch((oReason) => {
+					Log.error(`Failed to request '${sDocumentationRef}' annotation for path '${sResolvedPath}'`,
+						oReason, sClassName);
+					return undefined;
+				});
+		}
+
+		/**
+		 * Gets an array of field help hotspots as required by the SAP Companion.
+		 *
+		 * @returns {module:sap/ui/model/FieldHelpInfo[]} The array of field help hotspots
+		 */
+		_getFieldHelpHotspots() {
+			const aFieldHelpHotspots = [];
+			Object.keys(this.#mDocuRefControlToFieldHelp).forEach((sControlID) => {
+				const oControl = Element.getElementById(sControlID);
+				if (!oControl) { // control has been destroyed, cleanup internal data structure
+					delete this.#mDocuRefControlToFieldHelp[sControlID];
+					return;
+				}
+				const sLabel = LabelEnablement._getLabelTexts(oControl)[0];
+				if (!sLabel) {
+					Log.error(`Cannot find a label for control '${sControlID}'; ignoring field help`,
+						JSON.stringify(this.#mDocuRefControlToFieldHelp[sControlID]), sClassName);
+
+					return;
+				}
+				const oURNSet = new Set();
+				Object.values(this.#mDocuRefControlToFieldHelp[sControlID]).forEach((aURNs) => {
+					// filter duplicates
+					aURNs.forEach(oURNSet.add.bind(oURNSet));
+				});
+				Array.from(oURNSet).forEach((sURN) => {
+					const oParameters = new URLSearchParams(sURN.slice(sURNPrefix.length));
+					aFieldHelpHotspots.push({
+						backendHelpKey: {
+							id: oParameters.get("id"),
+							origin: oParameters.get("origin"),
+							type: oParameters.get("type")
+						},
+						hotspotId: sControlID,
+						labelText: sLabel
+					});
+				});
+			});
+
+			return aFieldHelpHotspots;
+		}
+
+		/**
+		 * Sets the field help information, given as documentation reference URNs, for the given control and the given
+		 * control property and calls asynchronously the <code>fnUpdateHotspotsCallback</code> as given in
+		 * {@link #activate}.
+		 *
+		 * @param {sap.ui.core.Element} oElement
+		 *   The control
+		 * @param {string} [sControlProperty]
+		 *   The name of the control property
+		 * @param {Array<string>} aDocumentationRefs
+		 *   An array of documentation reference annotation URNs, e.g.
+		 *   <code>["urn:sap-com:documentation:key?=~key&type=~type&id=~id&origin=~origin"]</code>
+		 */
+		_setFieldHelpDocumentationRefs(oElement, sControlProperty, aDocumentationRefs) {
+			const sControlID = oElement.getId();
+			this.#mDocuRefControlToFieldHelp[sControlID] ||= {};
+			if (aDocumentationRefs.length > 0) {
+				this.#mDocuRefControlToFieldHelp[sControlID][sControlProperty] = aDocumentationRefs;
+			} else {
+				delete this.#mDocuRefControlToFieldHelp[sControlID][sControlProperty];
+				if (Object.keys(this.#mDocuRefControlToFieldHelp[sControlID]).length === 0) {
+					delete this.#mDocuRefControlToFieldHelp[sControlID];
+				}
+			}
+			this._updateHotspots().catch(() => {/* avoid uncaught in Promise; do nothing */});
+		}
+
+		/**
+		 * Calls the <code>fnUpdateHotspotsCallback</code> as given in {@link #activate} asynchronously with the latest
+		 * field help hotspots.
+		 *
+		 * @returns {Promise}
+		 *   A Promise that resolves when the <code>fnUpdateHotspotsCallback</code> as given in {@link #activate} has
+		 *   been called with the latest field help hotspots; rejects if the field help has been deactivated in between.
+		 */
+		_updateHotspots() {
+			if (this.#oUpdateHotspotsPromise) {
+				return this.#oUpdateHotspotsPromise;
+			}
+			let fnResolve, fnReject;
+			this.#oUpdateHotspotsPromise = new Promise((resolve, reject) => {
+				fnResolve = resolve;
+				fnReject = reject;
+			});
+
+			// gather and send field help info in task so that e.g. field help can be displayed at a column header
+			setTimeout(() => {
+				if (this.isActive()) {
+					this.#fnUpdateHotspotsCallback(this._getFieldHelpHotspots());
+					fnResolve();
+				} else {
+					fnReject();
+				}
+				this.#oUpdateHotspotsPromise = null;
+			}, 0);
+
+			return this.#oUpdateHotspotsPromise;
+		}
+
+		/**
+		 * Gets the singleton instance of <code>FieldHelp</code>.
+		 *
+		 * @returns {module:sap/ui/model/FieldHelp} The singleton instance
+		 *
+		 * @private
+		 * @ui5-restricted sap.ui.core
+		 * @since 1.125.0
+		 */
+		static getInstance() {
+			oFieldHelp ||= new FieldHelp();
+			return oFieldHelp;
+		}
+
+		/**
+		 * Activates the field help support. Determines the field help for all controls and calls the given update
+		 * callback with the currently available field help.
+		 *
+		 * @param {function(module:sap/ui/model/FieldHelpInfo[])} fnUpdateHotspotsCallback
+		 *   The callback function that is called with the currently available field help information if the hotspots
+		 *   for the field help have changed
+		 * @throws {Error}
+		 *   If the field help is already active and the update hotspots callback is different
+		 *
+		 * @private
+		 * @ui5-restricted sap.ui.core
+		 * @since 1.125.0
+		 */
+		activate(fnUpdateHotspotsCallback) {
+			if (this.#bActive) {
+				if (this.#fnUpdateHotspotsCallback !== fnUpdateHotspotsCallback) {
+					throw new Error("The field help is active for a different update hotspots callback handler");
+				}
+				return;
+			}
+
+			this.#bActive = true;
+			this.#fnUpdateHotspotsCallback = fnUpdateHotspotsCallback;
+			ElementRegistry.forEach((oElement) => {
+				const vDocumentationRef = oElement.data("sap-ui-DocumentationRef");
+				if (vDocumentationRef) {
+					this._setFieldHelpDocumentationRefs(oElement, undefined, Array.isArray(vDocumentationRef)
+						? vDocumentationRef
+						: [vDocumentationRef]);
+				} else {
+					Object.keys(oElement.getMetadata().getAllProperties()).forEach((sPropertyName) => {
+						this.update(oElement, sPropertyName);
+					});
+				}
+			});
+		}
+
+		/**
+		 * Deactivates the field help support and cleans up the internal data structures.
+		 *
+		 * @private
+		 * @ui5-restricted sap.ui.core
+		 * @since 1.125.0
+		 */
+		deactivate() {
+			this.#bActive = false;
+			this.#mDocuRefControlToFieldHelp = {};
+			this.#fnUpdateHotspotsCallback = null;
+		}
+
+		/**
+		 * Whether the field help is currently active.
+		 *
+		 * @returns {boolean} Whether the field help is active
+		 *
+		 * @private
+		 * @ui5-restricted sap.ui.core
+		 * @since 1.125.0
+		 */
+		isActive() {
+			return this.#bActive;
+		}
+
+		/**
+		 * Updates the field help information for the given property of the given control if the control property
+		 * belongs to the {@link sap.ui.base.ManagedObject.MetadataOptions.Property "Data" group} and is bound to an
+		 * OData model.
+		 *
+		 * @param {sap.ui.core.Element} oElement The control
+		 * @param {string} sControlProperty The name of the control property
+		 *
+		 * @private
+		 * @ui5-restricted sap.ui.core
+		 * @since 1.125.0
+		 */
+		update(oElement, sControlProperty) {
+			if (!this.#bActive || oElement.getMetadata().getProperty(sControlProperty)?.group !== "Data") {
+				return;
+			}
+
+			const oBinding = oElement.getBinding(sControlProperty);
+			if (!oBinding) {
+				return;
+			}
+
+			let aBindings;
+			if (oBinding.isA("sap.ui.model.CompositeBinding")) {
+				const aPartsToIgnore = oBinding.getType()?.getPartsIgnoringMessages() || [];
+				aBindings = oBinding.getBindings().filter((oPart, i) => !aPartsToIgnore.includes(i));
+			} else {
+				aBindings = [oBinding];
+			}
+			Promise.all(
+				aBindings.map((oBinding) => FieldHelp._requestDocumentationRef(oBinding))
+			).then((aDocumentationRefs) => {
+				aDocumentationRefs = aDocumentationRefs.filter((sDocumentationRef) => sDocumentationRef);
+				this._setFieldHelpDocumentationRefs(oElement, sControlProperty, aDocumentationRefs);
+			});
+		}
+	}
+
+	return FieldHelp;
+});

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.124.1
+	 * @version 1.125.0
 	 *
 	 * @public
 	 * @alias sap.ui.model.MetaModel

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

@@ -51,7 +51,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.message.MessageProcessor
 	 *
 	 * @author SAP SE
-	 * @version 1.124.1
+	 * @version 1.125.0
 	 *
 	 * @public
 	 * @alias sap.ui.model.Model

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.124.1
+	 * @version 1.125.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.124.1
+	 * @version 1.125.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.124.1
+	 * @version 1.125.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.124.1
+	 * @version 1.125.0
 	 */
 	var Type = BaseObject.extend("sap.ui.model.Type", /** @lends sap.ui.model.Type.prototype */ {
 

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

@@ -270,11 +270,10 @@ sap.ui.define([
 	 *   <code>select</code> parameter is ignored.
 	 *
 	 * @throws {Error}
-	 *   If no analytic query result object could be determined from the bound OData entity set,
-	 *   either from an explicitly given EntitySet (via optional mParameters.entitySet argument), or
-	 *   by default implicitly from the binding path (see mandatory sPath argument), or if the
-	 *   {@link sap.ui.model.Filter.NONE} filter instance is contained in <code>aFilters</code> together with other
-	 *   filters
+	 *   If no analytic query result object could be determined from the bound OData entity set, either from an
+	 *   explicitly given EntitySet (via optional mParameters.entitySet argument), or by default implicitly from the
+	 *   binding path (see mandatory sPath argument), or if the {@link sap.ui.model.Filter.NONE} filter instance is
+	 *   contained in <code>aFilters</code> together with other filters, or if the given model is not supported.
 	 *
 	 * @alias sap.ui.model.analytics.AnalyticalBinding
 	 * @extends sap.ui.model.TreeBinding
@@ -286,6 +285,10 @@ sap.ui.define([
 		constructor : function(oModel, sPath, oContext, aSorter, aFilters, mParameters) {
 			TreeBinding.call(this, oModel, sPath, oContext, aFilters, mParameters);
 
+			this.iModelVersion = AnalyticalBinding._getModelVersion(this.oModel);
+			if (this.iModelVersion === null) {
+				throw new Error("The AnalyticalBinding does not support the given model");
+			}
 			this.aAdditionalSelects = [];
 			// attribute members for addressing the requested entity set
 			this.sEntitySetName = mParameters.entitySet ? mParameters.entitySet : undefined;
@@ -360,13 +363,6 @@ sap.ui.define([
 					+ " $inlinecount options");
 			}
 
-			// detect ODataModel version
-			this.iModelVersion = AnalyticalBinding._getModelVersion(this.oModel);
-			if (this.iModelVersion === null) {
-				oLogger.error("The AnalyticalBinding does not support the given model");
-				return;
-			}
-
 			// list of sorted dimension names as basis for later calculations, initialized via "initialize" function
 			this.aAllDimensionSortedByName = null;
 

package/src/sap/ui/model/json/JSONModel.js

@@ -29,12 +29,13 @@ sap.ui.define([
 	/**
 	 * Constructor for a new JSONModel.
 	 *
-	 * The observation feature is experimental! When observation is activated, the application can directly change the
-	 * JS objects without the need to call setData, setProperty or refresh. Observation does only work for existing
-	 * properties in the JSON, it cannot detect new properties or new array entries.
+	 * When observation is activated, the application can directly change the JS objects without the need to call
+	 * {@link sap.ui.model.json.JSONModel#setData}, {@link sap.ui.model.json.JSONModel#setProperty} or
+	 * {@link sap.ui.model.Model#refresh}. <b>Note:</b> Observation only works for existing properties in the JSON
+	 * model. Newly added or removed properties and newly added or removed array entries, for example, are not detected.
 	 *
 	 * @param {object|string} [oData] Either the URL where to load the JSON from or a JS object
-	 * @param {boolean} [bObserve] Whether to observe the JSON data for property changes (experimental)
+	 * @param {boolean} [bObserve=false] Whether to observe the JSON data for property changes
 	 *
 	 * @class
 	 * Model implementation for the JSON format.
@@ -48,7 +49,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.ClientModel
 	 *
 	 * @author SAP SE
-	 * @version 1.124.1
+	 * @version 1.125.0
 	 * @public
 	 * @alias sap.ui.model.json.JSONModel
 	 */

package/src/sap/ui/model/message/MessageModel.js

@@ -29,7 +29,7 @@ sap.ui.define(['sap/ui/model/BindingMode', 'sap/ui/model/ClientModel', 'sap/ui/m
 	 * @extends sap.ui.model.ClientModel
 	 *
 	 * @author SAP SE
-	 * @version 1.124.1
+	 * @version 1.125.0
 	 *
 	 * @public
 	 * @alias sap.ui.model.message.MessageModel

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

@@ -27,7 +27,7 @@ sap.ui.define([
 	 *
 	 * @author SAP SE
 	 * @version
-	 * 1.124.1
+	 * 1.125.0
 	 *
 	 * @public
 	 * @deprecated As of version 1.66, please use {@link sap.ui.model.odata.v2.ODataAnnotations} instead.

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

@@ -84,7 +84,7 @@ var sClassName = "sap.ui.model.odata.ODataMessageParser",
  * @extends sap.ui.core.message.MessageParser
  *
  * @author SAP SE
- * @version 1.124.1
+ * @version 1.125.0
  * @public
  * @alias sap.ui.model.odata.ODataMessageParser
  */

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

@@ -880,7 +880,7 @@ sap.ui.define([
 	 * {@link #loaded loaded} has been resolved!
 	 *
 	 * @author SAP SE
-	 * @version 1.124.1
+	 * @version 1.125.0
 	 * @alias sap.ui.model.odata.ODataMetaModel
 	 * @extends sap.ui.model.MetaModel
 	 * @public

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

@@ -49,7 +49,7 @@ sap.ui.define([
 	 * Implementation to access OData metadata
 	 *
 	 * @author SAP SE
-	 * @version 1.124.1
+	 * @version 1.125.0
 	 *
 	 * @public
 	 * @alias sap.ui.model.odata.ODataMetadata

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

@@ -78,7 +78,7 @@ sap.ui.define([
 	 *
 	 *
 	 * @author SAP SE
-	 * @version 1.124.1
+	 * @version 1.125.0
 	 *
 	 * @public
 	 * @deprecated As of version 1.48, please use {@link sap.ui.model.odata.v2.ODataModel} instead.

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.124.1
+	 * @version 1.125.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.124.1
+	 * @version 1.125.0
 	 *
 	 * @alias sap.ui.model.odata.type.Byte
 	 * @param {object} [oFormatOptions]

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

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

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

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

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

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

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

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

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

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

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

@@ -46,7 +46,7 @@ sap.ui.define([
 	 * @public
 	 * @see {sap.ui.model.odata.v2.ODataModel#bindProperty}
 	 * @since 1.99.0
-	 * @version 1.124.1
+	 * @version 1.125.0
 	 */
 	var DateTimeWithTimezone = CompositeType.extend("sap.ui.model.odata.type.DateTimeWithTimezone",
 		{

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

@@ -171,7 +171,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.odata.type.ODataType
 	 *
 	 * @author SAP SE
-	 * @version 1.124.1
+	 * @version 1.125.0
 	 *
 	 * @alias sap.ui.model.odata.type.Decimal
 	 * @param {object} [oFormatOptions]

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

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

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

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

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

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