@openui5/sap.ui.mdc 1.113.0 → 1.115.0

package/src/sap/ui/mdc/Field.js

@@ -6,8 +6,8 @@
 sap.ui.define([
 	'sap/ui/mdc/field/FieldBase',
 	'sap/ui/mdc/field/FieldBaseRenderer',
-	'sap/ui/mdc/enum/FieldDisplay',
-	'sap/ui/mdc/enum/BaseType',
+	'sap/ui/mdc/enums/FieldDisplay',
+	'sap/ui/mdc/enums/BaseType',
 	'sap/base/util/deepEqual',
 	'sap/base/util/merge',
 	'sap/ui/model/BindingMode',
@@ -34,24 +34,33 @@ sap.ui.define([
 	 *
 	 * @class
 	 * The <code>Field</code> control is used to bind its value to data of a certain data type. Based on the data type settings, a default
-	 * control is rendered by the <code>Field</code>. For example, if a date type is used, a {@link sap.m.DatePicker DatePicker} is rendered.
+	 * control is rendered by the <code>Field</code> as follows:
+	 *
+	 * <ul>
+	 * <li>In display mode, usually a {@link sap.m.Text Text} control is rendered.</li>
+	 * <li>If <code>multipleLines</code> is set, an {@link sap.m.ExpandableText ExpandableText} control is rendered.</li>
+	 * <li>If <code>fieldInfo</code> is set and it is configured to be triggerable, a {@link sap.m.Link Link} control is rendered.</li>
+	 * <li>In edit mode, usually an {@link sap.m.Input Input} control is rendered.</li>
+	 * <li>If <code>multipleLines</code> is set, a {@link sap.m.TextArea TextArea} control is rendered.</li>
+	 * <li>If a date type is used, a {@link sap.m.DatePicker DatePicker} control is rendered.</li>
+	 * <li>If a date/time type is used, a {@link sap.m.DateTimePicker DateTimePicker} control is rendered.</li>
+	 * <li>If a time type is used, a {@link sap.m.TimePicker TimePicker} control is rendered.</li>
+	 * <li>If a currency or unit type is used, two {@link sap.m.Input Input} controls are rendered, one for number and one for unit.</li>
+	 * </ul>
 	 *
 	 * @extends sap.ui.mdc.field.FieldBase
-	 * @implements sap.ui.core.IFormContent
+	 * @implements sap.ui.core.IFormContent, sap.ui.core.ISemanticFormContent, sap.m.IOverflowToolbarContent
 	 *
 	 * @author SAP SE
-	 * @version 1.113.0
+	 * @version 1.115.0
 	 *
 	 * @constructor
 	 * @alias sap.ui.mdc.Field
-	 * @author SAP SE
-	 * @version 1.113.0
+	 * @version 1.115.0
 	 * @since 1.54.0
-	 * @experimental As of version 1.54
 	 *
-	 * @private
-	 * @ui5-restricted sap.fe
-	 * @MDC_PUBLIC_CANDIDATE
+	 * @public
+  	 * @experimental As of version 1.54.0
 	 */
 	var Field = FieldBase.extend("sap.ui.mdc.Field", /* @lends sap.ui.mdc.Field.prototype */ {
 		metadata: {
@@ -94,7 +103,7 @@ sap.ui.define([
 						/**
 						 * The new value of the <code>Field</code>.
 						 *
-						 * If a <code>FieldHelp</code> is assigned to the <code>Field</code>, the <code>value</code> is used as key for the <code>FieldHelp</code> items.
+						 * If a <code>ValueHelp</code> is assigned to the <code>Field</code>, the <code>value</code> is used as key for the <code>ValueHelp</code> items.
 						 */
 						value: { type: "string" },
 
@@ -105,7 +114,7 @@ sap.ui.define([
 
 						/**
 						 * Returns a <code>Promise</code> for the change. The <code>Promise</code> returns the value if it is resolved.
-						 * If the <code>change</code> event is synchronous, the promise has already been already resolved. If it is asynchronous,
+						 * If the <code>change</code> event is synchronous, the <code>Promise</code> has already been already resolved. If it is asynchronous,
 						 * it will be resolved after the value has been updated.
 						 *
 						 * The <code>Field</code> should be set to busy during the parsing to prevent user input.
@@ -130,6 +139,7 @@ sap.ui.define([
 		FieldBase.prototype.init.apply(this, arguments);
 
 		this.setMaxConditions(1);
+		this.setProperty("_operators", ["EQ"], true);
 
 		this._oObserver.observe(this, {
 			properties: ["value", "additionalValue"]
@@ -155,24 +165,24 @@ sap.ui.define([
 
 		if (sName === "value" && !oBindingInfo.formatter) { // not if a formatter is used, as this needs to be executed
 			oBindingInfo.targetType = "raw"; // provide internal value to inner control
-			var oDataType = this._getContentFactory().getDataType();
+			var oDataType = this.getContentFactory().getDataType();
 			if (oBindingInfo.type && (!oDataType ||
 				oDataType.getMetadata().getName() !== oBindingInfo.type.getMetadata().getName() ||
 				!deepEqual(oDataType.getFormatOptions(), oBindingInfo.type.getFormatOptions()) ||
 				!deepEqual(oDataType.getConstraints(), oBindingInfo.type.getConstraints()) ||
 				oDataType._bCreatedByOperator !== oBindingInfo.type._bCreatedByOperator)) {
-				this._getContentFactory().setDataType(oBindingInfo.type);
-				this._getContentFactory().setDateOriginalType(undefined);
-				this._getContentFactory().setUnitOriginalType(undefined);
-				this._getContentFactory().setIsMeasure(false);
+				this.getContentFactory().setDataType(oBindingInfo.type);
+				this.getContentFactory().setDateOriginalType(undefined);
+				this.getContentFactory().setUnitOriginalType(undefined);
+				this.getContentFactory().setIsMeasure(false);
 				if (oBindingInfo.type.isA("sap.ui.model.CompositeType") && oBindingInfo.parts) {
 					var aTypes = [];
 					for (var i = 0; i < oBindingInfo.parts.length; i++) {
 						aTypes.push(oBindingInfo.parts[i].type);
 					}
-					this._getContentFactory().setCompositeTypes(aTypes);
+					this.getContentFactory().setCompositeTypes(aTypes);
 				}
-				this._getContentFactory().updateConditionType();
+				this.getContentFactory().updateConditionType();
 				this.invalidate(); // as new inner control might be needed
 			}
 		}
@@ -181,9 +191,9 @@ sap.ui.define([
 
 	};
 
-	Field.prototype._handleModelContextChange = function(oEvent) {
+	Field.prototype.handleModelContextChange = function(oEvent) {
 
-		FieldBase.prototype._handleModelContextChange.apply(this, arguments);
+		FieldBase.prototype.handleModelContextChange.apply(this, arguments);
 
 		var oBinding = this.getBinding("value");
 		if (oBinding) {
@@ -192,42 +202,42 @@ sap.ui.define([
 			if (Context.hasChanged(this._oBindingContext, oBindingContext)) {
 				// BindingContextChanged -> if parsing error trigger update to remove valueState and wrong input
 				this._oBindingContext = oBindingContext;
-				this._getContentFactory().updateConditionType();
-				if (this._isInvalidInput() || this.getFieldHelp()) { // In FieldHelp case InParameters might need an update
+				this.getContentFactory().updateConditionType();
+				if (this.isInvalidInput() || this._getValueHelp()) { // In ValueHelp case InParameters might need an update
 					if (this._oManagedObjectModel) {
 						this._oManagedObjectModel.checkUpdate(true, true); // async. to reduce updates
 					}
-					this._resetInvalidInput();
+					this.resetInvalidInput();
 				}
 			}
 
-			if (!this._getContentFactory().getDataType()) {
-				this._getContentFactory().setDataType(oBinding.getType());
+			if (!this.getContentFactory().getDataType()) {
+				this.getContentFactory().setDataType(oBinding.getType());
 				this.invalidate(); // as new inner control might be needed
 			}
 		}
 
 	};
 
-	Field.prototype._initDataType = function() {
+	Field.prototype.initDataType = function() {
 
-		FieldBase.prototype._initDataType.apply(this, arguments);
+		FieldBase.prototype.initDataType.apply(this, arguments);
 
 		var oBinding = this.getBinding("value");
 		if (oBinding) {
-			this._getContentFactory().setDataType(oBinding.getType());
+			this.getContentFactory().setDataType(oBinding.getType());
 		}
 
 	};
 
 	Field.prototype.setProperty = function(sPropertyName, oValue, bSuppressInvalidate) {
 
-		if (sPropertyName === "value" && this._isInvalidInput() && deepEqual(this.getValue(), this.validateProperty(sPropertyName, oValue))) {
+		if (sPropertyName === "value" && this.isInvalidInput() && deepEqual(this.getValue(), this.validateProperty(sPropertyName, oValue))) {
 			// in parse error and same value - no update on property - so remove error here
 			if (this._oManagedObjectModel) {
 				this._oManagedObjectModel.checkUpdate(true, true); // async. to reduce updates (additionalValue will follow)
 			}
-			this._resetInvalidInput();
+			this.resetInvalidInput();
 		}
 
 		return FieldBase.prototype.setProperty.apply(this, arguments);
@@ -241,7 +251,6 @@ sap.ui.define([
 	 * @returns {this} <code>this</code> to allow method chaining.
 	 * @private
 	 * @ui5-restricted sap.fe
-	 * @MDC_PUBLIC_CANDIDATE
 	 * @deprecated Not supported, this property is not supported for the <code>Field</code>.
 	 * @ui5-not-supported
 	 */
@@ -255,9 +264,9 @@ sap.ui.define([
 
 	};
 
-	Field.prototype._observeChanges = function(oChanges) {
+	Field.prototype.observeChanges = function(oChanges) {
 
-		FieldBase.prototype._observeChanges.apply(this, arguments);
+		FieldBase.prototype.observeChanges.apply(this, arguments);
 
 		if (oChanges.name === "value") {
 			var vValue = _adjustValue.call(this, oChanges.current, oChanges.old);
@@ -279,7 +288,7 @@ sap.ui.define([
 		if (oChanges.name === "conditions") {
 			// keep value/additionalValue and conditions in sync
 			// (value must be updated if conditions are changed in async parsing too, so not in change event)
-			if (this._getContent().length <= 1) {
+			if (this.getCurrentContent().length <= 1) {
 				// in unit/currency field update value with change event to prevent update by navigating from number to unit
 				_updateValue.call(this, oChanges.current);
 			}
@@ -308,7 +317,7 @@ sap.ui.define([
 		if (!this.bDelegateInitialized) {
 			// wait until delegate is loaded
 			this.awaitControlDelegate().then(function() {
-				if (!this.bIsDestroyed) {
+				if (!this.isFieldDestroyed()) {
 					_triggerConditionUpdate.call(this);
 				}
 			}.bind(this));
@@ -333,7 +342,7 @@ sap.ui.define([
 	function _updateCondition(vValue, vAdditionalValue) {
 
 		var aConditions = this.getConditions();
-		if (this._checkValueInitial(vValue) && !vAdditionalValue) {
+		if (this.checkValueInitial(vValue) && !vAdditionalValue) {
 			// if empty -> no condition
 			if (aConditions.length > 0) {
 				this.setConditions([]);
@@ -344,8 +353,7 @@ sap.ui.define([
 			var sOldAdditionalValue = oCurrentCondition && oCurrentCondition.values[1] ? oCurrentCondition.values[1] : null; // to compare with default value
 			if (!oCurrentCondition || oCurrentCondition.operator !== "EQ" || !_compareValues.call(this, vOldValue, vValue) || sOldAdditionalValue !== vAdditionalValue) {
 				var oDelegate = this.getControlDelegate();
-				var oDelegatePayload = this.getPayload();
-				var oNextCondition = oDelegate.createCondition(oDelegatePayload, this, [vValue, vAdditionalValue], oCurrentCondition);
+				var oNextCondition = oDelegate.createCondition(this, this, [vValue, vAdditionalValue], oCurrentCondition);
 				if (!Condition.compareConditions(oCurrentCondition, oNextCondition)) { // We do a full comparison here as FilterOperatorUtils.compareConditions may ignore text changes
 					this.setConditions(oNextCondition ? [oNextCondition] : []);
 				}
@@ -356,7 +364,7 @@ sap.ui.define([
 
 	function _adjustValue(vValue, vOldValue) {
 
-		var sDataType = this._getContentFactory().getDataType() ? this._getContentFactory().getDataType().getMetadata().getName() : this.getDataType(); // as type must not exist now
+		var sDataType = this.getContentFactory().getDataType() ? this.getContentFactory().getDataType().getMetadata().getName() : this.getDataType(); // as type must not exist now
 
 		if (vValue && vOldValue && (sDataType === "sap.ui.model.odata.type.Unit" || sDataType === "sap.ui.model.odata.type.Currency")
 			&& !vValue[2] && vOldValue[2] !== undefined) {
@@ -388,9 +396,9 @@ sap.ui.define([
 	function _compareValues(vValue1, vValue2, bUpdateCheck) {
 
 		var bEqual = vValue1 === vValue2;
-		var sDataType = this._getContentFactory().getDataType() ? this._getContentFactory().getDataType().getMetadata().getName() : this.getDataType(); // as type must not exist now
+		var sDataType = this.getContentFactory().getDataType() ? this.getContentFactory().getDataType().getMetadata().getName() : this.getDataType(); // as type must not exist now
 
-		if (!bEqual && this.getTypeUtil().getBaseType(sDataType) === BaseType.Unit && Array.isArray(vValue1) && Array.isArray(vValue2)) {
+		if (!bEqual && this.getTypeMap().getBaseType(sDataType) === BaseType.Unit && Array.isArray(vValue1) && Array.isArray(vValue2)) {
 			// in unit type the unit table is in there setting the value but not after parsing
 			// units must be set at least once. so if not set compare too
 			var vNumber1 = vValue1[0];
@@ -415,11 +423,11 @@ sap.ui.define([
 
 	function _initializeType(vValue) {
 
-		if (!this._bTypeInitialized) {
+		if (!this._oTypeInitialization) {
 			if (!this.bDelegateInitialized) {
 				// wait until delegate is loaded
 				this.awaitControlDelegate().then(function() {
-					if (!this.bIsDestroyed) {
+					if (!this.isFieldDestroyed()) {
 						_initializeType.call(this, vValue);
 					}
 				}.bind(this));
@@ -427,31 +435,32 @@ sap.ui.define([
 			}
 
 			var oBinding = this.getBinding("value");
-			var oDataType = oBinding ? oBinding.getType() : this._getContentFactory().getDataType(); // use type from binding, not internal (might be a different one)
-			this._oTypeInitialization = this.getControlDelegate().initializeTypeFromBinding(this.getPayload(), oDataType, vValue);
-			this._bTypeInitialized = this._oTypeInitialization.bTypeInitialized;
-			if (this._bTypeInitialized && this._getContentFactory().getUnitOriginalType()) {
-				// internal type already created, initialize it too
-				this.getControlDelegate().initializeInternalUnitType(this.getPayload(), this._getContentFactory().getDataType(), this._oTypeInitialization);
-				this.getControlDelegate().initializeInternalUnitType(this.getPayload(), this._getContentFactory().getUnitType(), this._oTypeInitialization);
+			var oDataType = oBinding ? oBinding.getType() : this.getContentFactory().getDataType(); // use type from binding, not internal (might be a different one)
+
+			if (oDataType) {
+				this._oTypeInitialization = this.getTypeMap().initializeTypeFromValue(oDataType, vValue);
+				if (this._oTypeInitialization && this.getContentFactory().getUnitOriginalType()) {
+					this.getTypeMap().initializeInternalType(this.getContentFactory().getDataType(), this._oTypeInitialization);
+					this.getTypeMap().initializeInternalType(this.getContentFactory().getUnitType(), this._oTypeInitialization);
+				}
 			}
 		}
 
 	}
 
-	Field.prototype._fireChange = function(aConditions, bValid, vWrongValue, oPromise) {
+	Field.prototype.fireChangeEvent = function(aConditions, bValid, vWrongValue, oPromise) {
 
 		var vValue;
 
 		if (aConditions) { // even if empty and error is returned, only in async case it is really empty
 			if (bValid) {
-				vValue = this._getResultForPromise(aConditions);
+				vValue = this.getResultForChangePromise(aConditions);
 			} else {
 				vValue = vWrongValue;
 			}
 		}
 
-		if (this._getContent().length > 1) {
+		if (this.getCurrentContent().length > 1) {
 			// in unit/currency field update value with change event to prevent update by navigating from number to unit
 			if (aConditions) {
 				_updateValue.call(this, this.getConditions());
@@ -468,12 +477,12 @@ sap.ui.define([
 
 	};
 
-	Field.prototype._getResultForPromise = function(aConditions) {
+	Field.prototype.getResultForChangePromise = function(aConditions) {
 
 		var vValue;
-		if (aConditions.length === 0 && this._getContentFactory().getDataType()) {
+		if (aConditions.length === 0 && this.getContentFactory().getDataType()) {
 			// parse "" to get type specific initial value
-			vValue = this._getContentFactory().getDataType().parseValue("", "string", []); // we need the empty array when the type is Unit
+			vValue = this.getContentFactory().getDataType().parseValue("", "string", []); // we need the empty array when the type is Unit
 		} else if (aConditions.length === 1) {
 			vValue = aConditions[0].values[0];
 		}
@@ -487,7 +496,7 @@ sap.ui.define([
 		if (!this.bDelegateInitialized) {
 			// wait until delegate is loaded
 			this.awaitControlDelegate().then(function() {
-				if (!this.bIsDestroyed) {
+				if (!this.isFieldDestroyed()) {
 					_updateValue.call(this, aConditions);
 				}
 			}.bind(this));
@@ -504,7 +513,7 @@ sap.ui.define([
 			return;
 		}
 
-		vValue = this._getResultForPromise(aConditions);
+		vValue = this.getResultForChangePromise(aConditions);
 		if (aConditions.length === 0 && !vOldAdditionalValue) {
 			vAdditionalValue = vOldAdditionalValue; // to not update old initial value
 		} else if (aConditions.length === 1 && aConditions[0].values.length > 1) {
@@ -527,9 +536,9 @@ sap.ui.define([
 
 	}
 
-	Field.prototype._getOperators = function() {
+	Field.prototype.getSupportedOperators = function() {
 
-		return ["EQ"];
+		return this.getProperty("_operators", []);
 
 	};
 
@@ -545,12 +554,12 @@ sap.ui.define([
 
 	}
 
-	Field.prototype._checkCreateInternalContent = function() {
+	Field.prototype.checkCreateInternalContent = function() {
 
-		if (!this.bIsDestroyed && this._getContentFactory().getDataType() && !this._isPropertyInitial("editMode") && !this._isPropertyInitial("multipleLines")) {
+		if (!this.isFieldDestroyed() && this.getContentFactory().getDataType() && !this.isFieldPropertyInitial("editMode") && !this.isFieldPropertyInitial("multipleLines")) {
 			// If DataType is provided via Binding and EditMode is set the internal control can be created
 			// TODO: no control needed if just template for cloning
-			FieldBase.prototype._checkCreateInternalContent.apply(this, arguments);
+			FieldBase.prototype.checkCreateInternalContent.apply(this, arguments);
 		}
 
 	};
@@ -562,17 +571,22 @@ sap.ui.define([
 		return oConfig;
 	};
 
+	Field.prototype.isSearchField = function() {
+
+		return false; // Field cannot be a searchField (not supported for the moment)
+
+	};
+
 	/**
-	 * Sets conditions to the property <code>conditions</code>.
+	 * Sets a new value for property {@link #getConditions conditions}.
 	 *
 	 * Do not use the <code>conditions</code> property,
 	 * use the <code>value</code> and <code>additionalValue</code> properties instead.
 	 *
-	 * @param {object[]} aConditions Conditions to be set
+	 * @param {object[]} aConditions Conditions that are set
 	 * @returns {this} Reference to <code>this</code> to allow method chaining
 	 * @private
 	 * @ui5-restricted sap.fe
-	 * @MDC_PUBLIC_CANDIDATE
 	 * @deprecated Not supported, use the <code>value</code> property and <code>additionalValue</code> property to bind the control.
 	 * @ui5-not-supported
 	 * @name sap.ui.mdc.Field#setConditions
@@ -580,15 +594,14 @@ sap.ui.define([
 	 */
 
 	/**
-	 * Gets conditions of the property <code>conditions</code>.
+	 * Gets current value of property {@link #getConditions conditions}.
 	 *
 	 * Do not use the <code>conditions</code> property,
 	 * use the <code>value</code> and <code>additionalValue</code> properties instead.
 	 *
-	 * @returns {object[]} conditions of the field
+	 * @returns {object[]} Conditions of the field
 	 * @private
 	 * @ui5-restricted sap.fe
-	 * @MDC_PUBLIC_CANDIDATE
 	 * @deprecated Not supported, use the <code>value</code> property and <code>additionalValue</code> property to bind the control.
 	 * @ui5-not-supported
 	 * @name sap.ui.mdc.Field#getConditions
@@ -596,7 +609,7 @@ sap.ui.define([
 	 */
 
 	/**
-	 * Binds property <code>conditions</code> to model data.
+	 * Binds property {@link #getConditions conditions} to model data.
 	 *
 	 * See {@link sap.ui.base.ManagedObject#bindProperty ManagedObject.bindProperty} for a detailed description of the possible properties of oBindingInfo
 	 *
@@ -607,7 +620,6 @@ sap.ui.define([
 	 * @returns {this} Reference to <code>this</code> to allow method chaining
 	 * @private
 	 * @ui5-restricted sap.fe
-	 * @MDC_PUBLIC_CANDIDATE
 	 * @deprecated Not supported, use the <code>value</code> property and <code>additionalValue</code> property to bind the control.
 	 * @ui5-not-supported
 	 * @name sap.ui.mdc.Field#bindConditions
@@ -615,7 +627,7 @@ sap.ui.define([
 	 */
 
 	/**
-	 * Unbinds property <code>conditions</code> from model data.
+	 * Unbinds property {@link #getConditions conditions} from model data.
 	 *
 	 * Do not use the <code>conditions</code> property,
 	 * use the <code>value</code> and <code>additionalValue</code> properties instead.
@@ -623,7 +635,6 @@ sap.ui.define([
 	 * @returns {this} Reference to <code>this</code> to allow method chaining
 	 * @private
 	 * @ui5-restricted sap.fe
-	 * @MDC_PUBLIC_CANDIDATE
 	 * @deprecated Not supported, use the <code>value</code> property and <code>additionalValue</code> property to bind the control.
 	 * @ui5-not-supported
 	 * @name sap.ui.mdc.Field#unbindConditions
@@ -631,18 +642,17 @@ sap.ui.define([
 	 */
 
 	/**
-	 * Sets a new value for property <code>dataType</code>.
+	 * Sets a new value for property {@link #getDataType dataType}.
 	 *
 	 * The type of data handled by the field. The type is used to parse, format, and validate the value.
 	 *
 	 * <b>Note:</b> If the <code>value</code> property is bound to a model using a type, this type is used.
 	 * In this case the value of the <code>dataType</code> property is ignored.
 	 *
-	 * @param {string} sDataType DataType to be set
+	 * @param {string} sDataType DataType that is set
 	 * @returns {this} Reference to <code>this</code> to allow method chaining
 	 * @private
 	 * @ui5-restricted sap.fe
-	 * @MDC_PUBLIC_CANDIDATE
 	 * @deprecated Not supported, the type in the binding to the <code>value</code> property is used.
 	 * @ui5-not-supported
 	 * @name sap.ui.mdc.Field#setDataType
@@ -650,18 +660,16 @@ sap.ui.define([
 	 */
 
 	/**
-	 * Gets a new value for property <code>dataType</code>.
+	 * Gets current value of property {@link #getDataType dataType}.
 	 *
 	 * The type of data handled by the field. The type is used to parse, format, and validate the value.
 	 *
 	 * <b>Note:</b> If the <code>value</code> property is bound to a model using a type, this type is used.
 	 * In this case the value of the <code>dataType</code> property is ignored.
 	 *
-	 * @param {string} sDataType DataType to be set
-	 * @returns {this} Reference to <code>this</code> to allow method chaining
+	 * @returns {this} Value of property <code>dataType</code>
 	 * @private
 	 * @ui5-restricted sap.fe
-	 * @MDC_PUBLIC_CANDIDATE
 	 * @deprecated Not supported, the type in the binding to the <code>value</code> property is used.
 	 * @ui5-not-supported
 	 * @name sap.ui.mdc.Field#getDataType
@@ -669,18 +677,17 @@ sap.ui.define([
 	 */
 
 	/**
-	 * Sets a new value for property <code>dataTypeConstraints</code>.
+	 * Sets a new value for property {@link #getDataTypeConstraints dataTypeConstraints}.
 	 *
 	 * The constraints of the type specified in <code>dataType</code>.
 	 *
 	 * <b>Note:</b> If the <code>value</code> property is bound to a model using a type, this type is used.
 	 * In this case the values of the <code>dataType</code> property and the <code>dataTypeConstraints</code> property are ignored.
 	 *
-	 * @param {string} oDataTypeConstraints Constraints to be set
+	 * @param {string} oDataTypeConstraints Constraints that are set
 	 * @returns {this} Reference to <code>this</code> to allow method chaining
 	 * @private
 	 * @ui5-restricted sap.fe
-	 * @MDC_PUBLIC_CANDIDATE
 	 * @deprecated Not supported, the <code>Constraints</code> of the type in the binding to the <code>value</code> property is used.
 	 * @ui5-not-supported
 	 * @name sap.ui.mdc.Field#setDataTypeConstraints
@@ -688,18 +695,16 @@ sap.ui.define([
 	 */
 
 	/**
-	 * Gets a new value for property <code>dataTypeConstraints</code>.
+	 * Gets current value of property {@link #getDataTypeConstraints dataTypeConstraints}.
 	 *
 	 * The constraints of the type specified in <code>dataType</code>.
 	 *
 	 * <b>Note:</b> If the <code>value</code> property is bound to a model using a type, this type is used.
 	 * In this case the values of the <code>dataType</code> property and the <code>dataTypeConstraints</code> property are ignored.
 	 *
-	 * @param {string} oDataTypeConstraints Constraints to be set
-	 * @returns {this} Reference to <code>this</code> to allow method chaining
+	 * @returns {this} Value of property <code>dataTypeConstraints</code>
 	 * @private
 	 * @ui5-restricted sap.fe
-	 * @MDC_PUBLIC_CANDIDATE
 	 * @deprecated Not supported, the <code>Constraints</code> of the type in the binding to the <code>value</code> property is used.
 	 * @ui5-not-supported
 	 * @name sap.ui.mdc.Field#getDataTypeConstraints
@@ -707,18 +712,17 @@ sap.ui.define([
 	 */
 
 	/**
-	 * Sets a new value for property <code>dataTypeFormatOptions</code>.
+	 * Sets a new value for property {@link #getDataTypeFormatOptions dataTypeFormatOptions}.
 	 *
 	 * The format options of the type specified in <code>dataType</code>.
 	 *
 	 * <b>Note:</b> If the <code>value</code> property is bound to a model using a type, this type is used.
 	 * In this case the values of the <code>dataType</code> property and the <code>dataTypeFormatOptions</code> property are ignored.
 	 *
-	 * @param {string} oDataTypeFormatOptions Format options to be set
+	 * @param {string} oDataTypeFormatOptions Format options that are set
 	 * @returns {this} Reference to <code>this</code> to allow method chaining
 	 * @private
 	 * @ui5-restricted sap.fe
-	 * @MDC_PUBLIC_CANDIDATE
 	 * @deprecated Not supported, the <code>FormatOptions</code> of the type in the binding to the <code>value</code> property is used.
 	 * @ui5-not-supported
 	 * @name sap.ui.mdc.Field#setDataTypeFormatOptions
@@ -726,18 +730,16 @@ sap.ui.define([
 	 */
 
 	/**
-	 * Gets a new value for property <code>dataTypeFormatOptions</code>.
+	 * Gets current value of property {@link #getDataTypeFormatOptions dataTypeFormatOptions}.
 	 *
 	 * The format options of the type specified in <code>dataType</code>.
 	 *
 	 * <b>Note:</b> If the <code>value</code> property is bound to a model using a type, this type is used.
 	 * In this case the values of the <code>dataType</code> property and the <code>dataTypeFormatOptions</code> property are ignored.
 	 *
-	 * @param {string} oDataTypeFormatOptions Format options to be set
-	 * @returns {this} Reference to <code>this</code> to allow method chaining
+	 * @returns {this} Value of property <code>dataTypeFormatOptions</code>
 	 * @private
 	 * @ui5-restricted sap.fe
-	 * @MDC_PUBLIC_CANDIDATE
 	 * @deprecated Not supported, the <code>FormatOptions</code> of the type in the binding to the <code>value</code> property is used.
 	 * @ui5-not-supported
 	 * @name sap.ui.mdc.Field#getDataTypeFormatOptions