@openui5/sap.ui.fl 1.122.0 → 1.123.0

package/src/sap/ui/fl/write/_internal/connectors/BackendConnector.js

@@ -74,7 +74,7 @@ sap.ui.define([
 	 *
 	 * @namespace sap.ui.fl.write._internal.connectors.BackendConnector
 	 * @since 1.72
-	 * @version 1.122.0
+	 * @version 1.123.0
 	 * @private
 	 * @ui5-restricted sap.ui.fl.write._internal.connectors
 	 */

package/src/sap/ui/fl/write/_internal/connectors/BtpServiceConnector.js

@@ -21,7 +21,7 @@ sap.ui.define([
 	 * Connector for saving and deleting data from SAPUI5 Flexibility KeyUser service - including personalization.
 	 *
 	 * @namespace sap.ui.fl.write._internal.connectors.BtpServiceConnector
-	 * @version 1.122.0
+	 * @version 1.123.0
 	 * @private
 	 * @ui5-restricted sap.ui.fl.write._internal.Storage
 	 */

package/src/sap/ui/fl/write/_internal/connectors/KeyUserConnector.js

@@ -40,7 +40,7 @@ sap.ui.define([
 	 *
 	 * @namespace sap.ui.fl.write._internal.connectors.KeyUserConnector
 	 * @since 1.70
-	 * @version 1.122.0
+	 * @version 1.123.0
 	 * @private
 	 * @ui5-restricted sap.ui.fl.write._internal.Storage
 	 */

package/src/sap/ui/fl/write/_internal/connectors/LrepConnector.js

@@ -167,7 +167,7 @@ sap.ui.define([
 	 *
 	 * @namespace sap.ui.fl.write._internal.connectors.LrepConnector
 	 * @since 1.67
-	 * @version 1.122.0
+	 * @version 1.123.0
 	 * @private
 	 * @ui5-restricted sap.ui.fl.write._internal.Storage
 	 */

package/src/sap/ui/fl/write/_internal/connectors/NeoLrepConnector.js

@@ -20,7 +20,7 @@ sap.ui.define([
 	 *
 	 * @namespace sap.ui.fl.write._internal.connectors.NeoLrepConnector
 	 * @since 1.81
-	 * @version 1.122.0
+	 * @version 1.123.0
 	 * @private
 	 * @ui5-restricted sap.ui.fl.write._internal.Storage
 	 */

package/src/sap/ui/fl/write/_internal/connectors/ObjectPathConnector.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 *
 	 * @namespace sap.ui.fl.write._internal.connectors.ObjectPathConnector
 	 * @since 1.73
-	 * @version 1.122.0
+	 * @version 1.123.0
 	 * @private
 	 * @ui5-restricted sap.ui.fl.write._internal.Storage
 	 */

package/src/sap/ui/fl/write/_internal/connectors/PersonalizationConnector.js

@@ -23,7 +23,7 @@ sap.ui.define([
 	 *
 	 * @namespace sap.ui.fl.write._internal.connectors.PersonalizationConnector
 	 * @since 1.70
-	 * @version 1.122.0
+	 * @version 1.123.0
 	 * @private
 	 * @ui5-restricted sap.ui.fl.write._internal.Storage
 	 */

package/src/sap/ui/fl/write/_internal/connectors/Utils.js

@@ -16,7 +16,7 @@ sap.ui.define([
 	 *
 	 * @namespace sap.ui.fl.write._internal.connectors.Utils
 	 * @since 1.70
-	 * @version 1.122.0
+	 * @version 1.123.0
 	 * @private
 	 * @ui5-restricted sap.ui.fl.write._internal.connectors, sap.ui.fl.write._internal.transport
 	 */

package/src/sap/ui/fl/write/_internal/delegates/ODataV2ReadDelegate.js

@@ -0,0 +1,276 @@
+/*!
+ * 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/ui/model/ListBinding"], function(ListBinding) {
+	"use strict";
+
+	/**
+	 * Checks if the property is using a complex type.
+	 *
+	 * @param {Object} mProperty - The property object from the entity type.
+	 * @returns {boolean} - Returns true if the property is using a complex type, otherwise false.
+	 */
+	function isComplexType(mProperty) {
+		return !!(mProperty && mProperty.type && mProperty.type.toLowerCase().indexOf("edm") !== 0);
+	}
+
+	/**
+	 * Check for absolute aggregation binding.
+	 *
+	 * @param {Object} oElement - the element to check
+	 * @param {string} sAggregationName - the name of the aggregation
+	 * @return {boolean} whether the path starts with "/"
+	 */
+	function checkForAbsoluteAggregationBinding(oElement, sAggregationName) {
+		if (!oElement) {
+			return false;
+		}
+		const mBindingInfo = oElement.getBindingInfo(sAggregationName);
+		const sPath = mBindingInfo && mBindingInfo.path;
+		if (!sPath) {
+			return false;
+		}
+		return sPath.indexOf("/") === 0;
+	}
+
+	/**
+	 * Retrieves the default model binding data for the given element based on certain conditions.
+	 *
+	 * @param {Object} oElement - The element for which the binding data is retrieved.
+	 * @param {boolean} bAbsoluteAggregationBinding - Flag indicating whether to use absolute aggregation binding.
+	 * @param {string} sAggregationName - The name of the aggregation for which binding data is fetched.
+	 * @return {Object|undefined} The binding data for the element or undefined if not found.
+	 */
+	function getDefaultModelBindingData(oElement, bAbsoluteAggregationBinding, sAggregationName) {
+		let vBinding;
+		if (bAbsoluteAggregationBinding) {
+			vBinding = oElement.getBindingInfo(sAggregationName);
+			// check to be default model binding otherwise return undefined
+			if (typeof vBinding.model === "string" && vBinding.model !== "") {
+				vBinding = undefined;
+			}
+		} else {
+			// here we explicitly request the default models binding context
+			vBinding = oElement.getBindingContext();
+		}
+		return vBinding;
+	}
+
+	/**
+	 * Enriches a property with additional information such as label, tooltip, and visibility.
+	 *
+	 * @param {object} mProperty - The property object to be enriched
+	 * @param {object} mODataEntity - The OData entity object containing metadata
+	 * @param {object} oElement - The element to which the property belongs
+	 * @param {string} sAggregationName - The name of the aggregation
+	 * @return {object} The enriched property object
+	 */
+	function enrichProperty(mProperty, mODataEntity, oElement, sAggregationName) {
+		const mProp = {
+			name: mProperty.name,
+			bindingPath: mProperty.name,
+			entityType: mODataEntity.name
+		};
+		const mLabelAnnotation = mProperty["com.sap.vocabularies.Common.v1.Label"];
+		mProp.label = mLabelAnnotation && mLabelAnnotation.String;
+
+		const mQuickInfoAnnotation = mProperty["com.sap.vocabularies.Common.v1.QuickInfo"];
+		mProp.tooltip = mQuickInfoAnnotation && mQuickInfoAnnotation.String;
+
+		// CDS UI.Hidden new way also for sap:visible = false
+		const mHiddenAnnotation = mProperty["com.sap.vocabularies.UI.v1.Hidden"];
+		mProp.hideFromReveal = !!mHiddenAnnotation && mHiddenAnnotation.Bool === "true";
+
+		if (!mProp.hideFromReveal) {
+			// Old hidden annotation
+			const mFieldControlAnnotation = mProperty["com.sap.vocabularies.Common.v1.FieldControl"];
+			if (mFieldControlAnnotation && mFieldControlAnnotation.EnumMember) {
+				mProp.hideFromReveal = mFieldControlAnnotation.EnumMember === "com.sap.vocabularies.Common.v1.FieldControlType/Hidden";
+			} else {
+				// @runtime hidden by field control value = 0
+				const sFieldControlPath = mFieldControlAnnotation && mFieldControlAnnotation.Path;
+				if (sFieldControlPath) {
+					// if the binding is a list binding, we skip the check for field control
+					const bListBinding = oElement.getBinding(sAggregationName) instanceof ListBinding;
+					if (!bListBinding) {
+						const iFieldControlValue = oElement.getBindingContext().getProperty(sFieldControlPath);
+						mProp.hideFromReveal = iFieldControlValue === 0;
+					}
+				}
+			}
+		}
+		return mProp;
+	}
+
+	/**
+	 * Converts metadata to delegate format.
+	 *
+	 * @param {object} mODataEntity - The OData entity metadata object
+	 * @param {object} oMetaModel - The meta model object
+	 * @param {object} oElement - The element object
+	 * @param {string} sAggregationName - The name of the aggregation
+	 * @return {array} The properties in delegate format
+	 */
+	function convertMetadataToDelegateFormat(mODataEntity, oMetaModel, oElement, sAggregationName) {
+		const aFieldControlProperties = mODataEntity.property
+		.map((mProperty) => mProperty["sap:field-control"])
+		.filter(Boolean);
+
+		const fnFilterFieldControlProperties = (mProperty) => !aFieldControlProperties.includes(mProperty.name);
+
+		const aProperties = mODataEntity.property.map((mProperty) => {
+			const mProp = enrichProperty(mProperty, mODataEntity, oElement, sAggregationName);
+			if (isComplexType(mProperty)) {
+				const mComplexType = oMetaModel.getODataComplexType(mProperty.type);
+				if (mComplexType) {
+					// deep properties, could get multiple-level deep
+					mProp.properties = mComplexType.property
+					.map((mComplexProperty) => {
+						const mInnerProp = enrichProperty(mComplexProperty, mODataEntity, oElement, sAggregationName);
+						mInnerProp.bindingPath = `${mProperty.name}/${mComplexProperty.name}`;
+						mInnerProp.referencedComplexPropertyName = mProp.label || mProp.name;
+						return mInnerProp;
+					})
+					.filter(fnFilterFieldControlProperties);
+				}
+			}
+			return mProp;
+		});
+
+		if (mODataEntity.navigationProperty) {
+			const aNavigationProperties = mODataEntity.navigationProperty.map((mNavProp) => {
+				const sFullyQualifiedEntityName = oMetaModel.getODataAssociationEnd(mODataEntity, mNavProp.name)?.type;
+				return {
+					name: mNavProp.name,
+					// no labels or tooltips for navigation properties
+					entityType: sFullyQualifiedEntityName,
+					bindingPath: mNavProp.name,
+					unsupported: true // no support for navigation properties yet
+					// can have properties (like complex types in future)
+				};
+			});
+			aProperties.push(...aNavigationProperties);
+		}
+
+		return aProperties.filter(fnFilterFieldControlProperties);
+	}
+
+	/**
+	 * Retrieves the binding path based on the provided element, aggregation name, and payload.
+	 *
+	 * @param {Object} oElement - the element to get the binding path for
+	 * @param {string} sAggregationName - the name of the aggregation
+	 * @param {Object} mPayload - the payload containing the path
+	 * @return {string} the binding path
+	 */
+	function getBindingPath(oElement, sAggregationName, mPayload) {
+		if (mPayload.path) {
+			return mPayload.path;
+		}
+		return checkForAbsoluteAggregationBinding(oElement, sAggregationName)
+			? getDefaultModelBindingData(oElement, true, sAggregationName).path
+			: getDefaultModelBindingData(oElement, false, sAggregationName).getPath();
+	}
+
+	/**
+	 * Load the OData meta model for the given element.
+	 *
+	 * @param {object} oElement - The element to load the meta model for
+	 * @param {object} mPayload - The payload containing model information
+	 * @return {Promise} A Promise that resolves with the OData meta model or null if not found
+	 */
+	async function loadODataMetaModel(oElement, mPayload) {
+		const oModel = oElement.getModel(mPayload.modelName);
+		if (oModel && ["sap.ui.model.odata.ODataModel", "sap.ui.model.odata.v2.ODataModel"].includes(oModel.getMetadata().getName())) {
+			const oMetaModel = oModel.getMetaModel();
+			await oMetaModel.loaded();
+			return oMetaModel;
+		}
+		return null;
+	}
+
+	/**
+	 * Retrieve OData entity from meta model based on the binding context path.
+	 *
+	 * @param {object} oMetaModel - The meta model object
+	 * @param {string} sBindingContextPath - The binding context path
+	 * @returns {object} - The OData entity object
+	 */
+	function getODataEntityFromMetaModel(oMetaModel, sBindingContextPath) {
+		const oMetaModelContext = oMetaModel.getMetaContext(sBindingContextPath);
+		return oMetaModelContext.getObject();
+	}
+
+	/**
+	 * Adjusts the OData entity for list bindings based on the default aggregation of the given element.
+	 *
+	 * @param {sap.ui.core.Element} oElement - The UI5 element for which the OData entity needs to be adjusted.
+	 * @param {sap.ui.model.odata.ODataMetaModel} oMetaModel - The OData metamodel.
+	 * @param {object} mODataEntity - The OData entity to be adjusted.
+	 * @returns {object} The adjusted OData entity.
+	 */
+	function adjustODataEntityForListBindings(oElement, oMetaModel, mODataEntity) {
+		const oDefaultAggregation = oElement.getMetadata().getAggregation();
+		if (oDefaultAggregation) {
+			const oBinding = oElement.getBindingInfo(oDefaultAggregation.name);
+			const oTemplate = oBinding && oBinding.template;
+
+			if (oTemplate) {
+				const sPath = oElement.getBindingPath(oDefaultAggregation.name);
+				const oODataAssociationEnd = oMetaModel.getODataAssociationEnd(mODataEntity, sPath);
+				const sFullyQualifiedEntityName = oODataAssociationEnd && oODataAssociationEnd.type;
+				if (sFullyQualifiedEntityName) {
+					const oEntityType = oMetaModel.getODataEntityType(sFullyQualifiedEntityName);
+					mODataEntity = oEntityType;
+				}
+			}
+		}
+		return mODataEntity;
+	}
+
+	/**
+	 * Retrieve OData properties of a model based on the element, aggregation name, and payload.
+	 *
+	 * @param {Object} oElement - The element to retrieve OData properties from.
+	 * @param {string} sAggregationName - The name of the aggregation.
+	 * @param {Object} mPayload - The payload containing additional data.
+	 * @return {Array} The array of OData properties of the model.
+	 */
+	async function getODataPropertiesOfModel(oElement, sAggregationName, mPayload) {
+		const oMetaModel = await loadODataMetaModel(oElement, mPayload);
+		let aProperties = [];
+		if (oMetaModel) {
+			const sBindingContextPath = getBindingPath(oElement, sAggregationName, mPayload);
+			if (sBindingContextPath) {
+				let mODataEntity = getODataEntityFromMetaModel(oMetaModel, sBindingContextPath);
+				mODataEntity = adjustODataEntityForListBindings(oElement, oMetaModel, mODataEntity);
+				aProperties = convertMetadataToDelegateFormat(
+					mODataEntity,
+					oMetaModel,
+					oElement,
+					sAggregationName);
+			}
+		}
+		return aProperties;
+	}
+	/**
+	 * Default read delegate for ODataV2 protocoll.
+	 * @namespace sap.ui.fl.write._internal.delegate.ODataV2ReadDelegate
+	 * @implements {sap.ui.fl.interfaces.Delegate}
+	 * @experimental Since 1.123
+	 * @since 1.123
+	 * @private
+	 */
+	var ODataV2ReadDelegate = {}; /** @lends sap/ui/fl/write/_internal/delegates/oDataV2ReadDelegate */
+
+	/**
+	 *	@inheritdoc
+	 */
+	ODataV2ReadDelegate.getPropertyInfo = function(mPropertyBag) {
+		return getODataPropertiesOfModel(mPropertyBag.element, mPropertyBag.aggregationName, mPropertyBag.payload);
+	};
+
+	return ODataV2ReadDelegate;
+});

package/src/sap/ui/fl/write/_internal/extensionPoint/Processor.js

@@ -35,7 +35,7 @@ function(
 	 * @class
 	 * @constructor
 	 * @author SAP SE
-	 * @version 1.122.0
+	 * @version 1.123.0
 	 */
 	var Processor = {
 		applyExtensionPoint(oExtensionPoint) {

package/src/sap/ui/fl/write/_internal/fieldExtensibility/ABAPAccess.js

@@ -40,7 +40,7 @@ sap.ui.define([
 	 * @namespace sap.ui.fl.write._internal.fieldExtensibility.ABAPAccess
 	 * @since 1.87.0
 	 * @author SAP SE
-	 * @version 1.122.0
+	 * @version 1.123.0
 	 * @private
 	 */
 	var ABAPAccess = {};

package/src/sap/ui/fl/write/_internal/fieldExtensibility/ABAPExtensibilityVariant.js

@@ -17,7 +17,7 @@ sap.ui.define([
 	 * @class
 	 * @namespace sap.ui.fl.write._internal.fieldExtensibility.ABAPExtensibilityVariant
 	 * @since 1.87
-	 * @version 1.122.0
+	 * @version 1.123.0
 	 * @public
 	 * @param {sap.ui.base.ManagedObject} oControl - Control to add extensions
 	 */

package/src/sap/ui/fl/write/_internal/fieldExtensibility/ABAPExtensibilityVariantFactory.js

@@ -115,7 +115,7 @@ sap.ui.define([
 	 * @namespace sap.ui.fl.write._internal.fieldExtensibility.ABAPExtensibilityVariantFactory
 	 * @since 1.87.0
 	 * @author SAP SE
-	 * @version 1.122.0
+	 * @version 1.123.0
 	 * @private
 	 */
 	var ABAPExtensibilityVariantFactory = {};

package/src/sap/ui/fl/write/_internal/fieldExtensibility/MultiTenantABAPExtensibilityVariant.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 *
 	 * @namespace sap.ui.fl.write._internal.fieldExtensibility.MultiTenantABAPExtensibilityVariant
 	 * @since 1.87
-	 * @version 1.122.0
+	 * @version 1.123.0
 	 * @public
 	 */
 

package/src/sap/ui/fl/write/_internal/fieldExtensibility/ServiceValidation.js

@@ -19,7 +19,7 @@ sap.ui.define([
 	 * @namespace sap.ui.fl.write._internal.fieldExtensibility.ServiceValidation
 	 * @since 1.87.0
 	 * @author SAP SE
-	 * @version 1.122.0
+	 * @version 1.123.0
 	 * @private
 	 */
 	var ServiceValidation = {};

package/src/sap/ui/fl/write/_internal/fieldExtensibility/SingleTenantABAPExtensibilityVariant.js

@@ -43,7 +43,7 @@ sap.ui.define([
 	 *
 	 * @namespace sap.ui.fl.write._internal.fieldExtensibility.SingleTenantABAPExtensibilityVariant
 	 * @since 1.87
-	 * @version 1.122.0
+	 * @version 1.123.0
 	 * @public
 	 */
 

package/src/sap/ui/fl/write/_internal/fieldExtensibility/UriParser.js

@@ -134,7 +134,7 @@ sap.ui.define([
 	 * @namespace sap.ui.fl.write._internal.fieldExtensibility.UriParser
 	 * @since 1.87.0
 	 * @author SAP SE
-	 * @version 1.122.0
+	 * @version 1.123.0
 	 * @private
 	 */
 	var UriParser = {};

package/src/sap/ui/fl/write/_internal/fieldExtensibility/Utils.js

@@ -245,7 +245,7 @@ sap.ui.define([
 	 * @namespace sap.ui.fl.write._internal.fieldExtensibility.Utils
 	 * @since 1.87.0
 	 * @author SAP SE
-	 * @version 1.122.0
+	 * @version 1.123.0
 	 * @private
 	 */
 	var Utils = {};

package/src/sap/ui/fl/write/_internal/fieldExtensibility/cap/CAPAccess.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * @since 1.93
 	 * @private
 	 * @author SAP SE
-	 * @version 1.122.0
+	 * @version 1.123.0
 	 */
 	var CAPAccess = {};
 

package/src/sap/ui/fl/write/_internal/fieldExtensibility/cap/dialog/CustomFieldCAPDialog.js

@@ -82,7 +82,7 @@ sap.ui.define([
 	 * @extends sap.ui.base.ManagedObject
 	 * @alias sap.ui.fl.write._internal.fieldExtensibility.cap.dialog.CustomFieldCAPDialog
 	 * @author SAP SE
-	 * @version 1.122.0
+	 * @version 1.123.0
 	 * @since 1.93
 	 * @private
 	 * @ui5-restricted

package/src/sap/ui/fl/write/_internal/fieldExtensibility/cap/editor/propertyEditor/booleanEditor/BooleanEditor.js

@@ -18,7 +18,7 @@ sap.ui.define([
 	 * @alias sap.ui.fl.write._internal.fieldExtensibility.cap.editor.propertyEditor.booleanEditor.BooleanEditor
 	 * @author SAP SE
 	 * @since 1.93
-	 * @version 1.122.0
+	 * @version 1.123.0
 	 *
 	 * @private
 	 * @ui5-restricted sap.ui.fl

package/src/sap/ui/fl/write/_internal/fieldExtensibility/cap/editor/propertyEditor/rangeEditor/RangeEditor.js

@@ -20,7 +20,7 @@ sap.ui.define([
 	 * @alias sap.ui.fl.write._internal.fieldExtensibility.cap.editor.propertyEditor.rangeEditor.RangeEditor
 	 * @author SAP SE
 	 * @since 1.93
-	 * @version 1.122.0
+	 * @version 1.123.0
 	 *
 	 * @private
 	 * @ui5-restricted sap.ui.fl

package/src/sap/ui/fl/write/_internal/fieldExtensibility/cap/editor/propertyEditor/timeEditor/TimeEditor.js

@@ -22,7 +22,7 @@ sap.ui.define([
 	 * @alias sap.ui.fl.write._internal.fieldExtensibility.cap.editor.propertyEditor.timeEditor.TimeEditor
 	 * @author SAP SE
 	 * @since 1.93
-	 * @version 1.122.0
+	 * @version 1.123.0
 	 *
 	 * @private
 	 * @ui5-restricted sap.ui.fl

package/src/sap/ui/fl/write/_internal/flexState/FlexObjectState.js

@@ -39,7 +39,7 @@ sap.ui.define([
 	 * @namespace
 	 * @alias sap.ui.fl.write._internal.flexState.FlexObjectState
 	 * @since 1.83
-	 * @version 1.122.0
+	 * @version 1.123.0
 	 * @private
 	 * @ui5-restricted sap.ui.fl
 	 */

package/src/sap/ui/fl/write/_internal/flexState/UI2Personalization/UI2PersonalizationState.js

@@ -20,7 +20,7 @@ sap.ui.define([
 	 *
 	 * @namespace sap.ui.fl.write._internal.flexState.UI2Personalization.UI2PersonalizationState
 	 * @since 1.120
-	 * @version 1.122.0
+	 * @version 1.123.0
 	 * @private
 	 * @ui5-restricted
 	 */

package/src/sap/ui/fl/write/_internal/flexState/compVariants/CompVariantState.js

@@ -291,7 +291,7 @@ sap.ui.define([
 	 *
 	 * @namespace sap.ui.fl.write._internal.flexState.compVariants.CompVariantState
 	 * @since 1.83
-	 * @version 1.122.0
+	 * @version 1.123.0
 	 * @private
 	 * @ui5-restricted sap.ui.fl
 	 */

package/src/sap/ui/fl/write/_internal/transport/TransportSelection.js

@@ -26,7 +26,7 @@ sap.ui.define([
 	 * @private
 	 * @alias sap.ui.fl.write._internal.transport.TransportSelection
 	 * @author SAP SE
-	 * @version 1.122.0
+	 * @version 1.123.0
 	 * @since 1.74.0
 	 * Helper object to select an ABAP transport for an LREP object. This is not a generic utility to select a transport request, but part
 	 *        of the SmartVariant control.

package/src/sap/ui/fl/write/_internal/transport/Transports.js

@@ -27,7 +27,7 @@ sap.ui.define([
 	 * Entity that handles ABAP transport related information.
 	 * @alias sap.ui.fl.write._internal.transport.Transports
 	 * @author SAP SE
-	 * @version 1.122.0
+	 * @version 1.123.0
 	 * @since 1.74.0
 	 * @private
 	 * @ui5-restricted sap.ui.fl.write._internal.transport

package/src/sap/ui/fl/write/api/FieldExtensibility.js

@@ -22,7 +22,7 @@ sap.ui.define([
 	 *
 	 * @namespace sap.ui.fl.write.api.FieldExtensibility
 	 * @since 1.87
-	 * @version 1.122.0
+	 * @version 1.123.0
 	 * @private
 	 * @ui5-restricted sap.ui.fl, sap.ui.rta, sap.ui.mdc
 	 */
@@ -104,6 +104,29 @@ sap.ui.define([
 	/**
 	 * Retrieves the necessary texts.
 	 *
+	 * The result should have the following structure
+	 * Scenario 1 Legacy: Create Custom Field
+	 * {
+	 * 	headerText: string, // Header text for the business contexts
+	 * 	tooltip: string // Tooltip for the button
+	 * }
+	 *
+	 * Scenario 2: Potentially multiple options
+	 * {
+	 * 	headerText: string, // Header text for the business contexts
+	 * 	buttonText: string, // Text for the MenuButton
+	 * 	tooltip: string, // Tooltip for the MenuButton
+	 * 	options:
+	 * 	[
+	 * 		{
+	 * 			actionKey: string, // MenuItem unique key (e.g. for Uri assignment)
+	 * 			text: string, // Text for the MenuItem, for a single option this becomes the button text
+	 * 			tooltip: string // Tooltip for the MenuItem, for a single option this becomes the button tooltip
+	 * 		},
+	 * 		...
+	 * 	]
+	 * }
+	 *
 	 * @returns {Promise<object>} - Object with <code>tooltip</code> and <code>headerText</code>
 	 */
 	FieldExtensibility.getTexts = function() {
@@ -112,12 +135,18 @@ sap.ui.define([
 
 	/**
 	 * Retrieves the extension data.
-	 *
-	 * @returns {Promise<object>} All necessary information about the extension data. This will be passed to <code>FieldExtensibility.onTriggerCreateExtensionData</code>
+	 * The extension data should have the following format:
+	 * [
+	 * 	{
+	 * 		businessContext: "string",
+	 * 		description: "string",
+	 * 		...
+	 * 	},
+	 * 	...
+	 * ]
+	 * @returns {Promise<object>} An object containing the <code>extensionData</code> array. This will be passed to <code>FieldExtensibility.onTriggerCreateExtensionData</code>
 	 */
 	FieldExtensibility.getExtensionData = function() {
-		// TODO: currently the return value must be an object that includes .BusinessContexts in order to be shown in the Dialog.
-		// Will be changed in a follow up
 		return callFunctionInImplementation("getExtensionData");
 	};
 
@@ -126,10 +155,11 @@ sap.ui.define([
 	 *
 	 * @param {object} oExtensibilityInfo - Information about the extension data. Should be the return value of <code>FieldExtensibility.getExtensionData</code>
 	 * @param {string} sRtaStyleClassName - CSS style class that should be added to any dialogs
+	 * @param {string} sActionKey - Key for the mapping of specific actions (e.g. which URI to open for given extension data)
 	 * @returns {Promise} Resolves with the return value of the function in the implementation
 	 */
-	FieldExtensibility.onTriggerCreateExtensionData = function(oExtensibilityInfo, sRtaStyleClassName) {
-		return callFunctionInImplementation("onTriggerCreateExtensionData", oExtensibilityInfo, sRtaStyleClassName);
+	FieldExtensibility.onTriggerCreateExtensionData = function(oExtensibilityInfo, sRtaStyleClassName, sActionKey) {
+		return callFunctionInImplementation("onTriggerCreateExtensionData", oExtensibilityInfo, sRtaStyleClassName, sActionKey);
 	};
 
 	// Resets the current scenario for testing purposes

package/src/sap/ui/fl/write/api/ReloadInfoAPI.js

@@ -351,7 +351,6 @@ sap.ui.define([
 					oReloadInfo.reloadMethod = oRELOAD.VIA_HASH;
 				}
 			}
-			FlexInfoSession.removeByReference(sReference);
 			return oReloadInfo;
 		}
 	};