@openui5/sap.ui.fl 1.103.1 → 1.106.0

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

@@ -1,5 +1,5 @@
-/*
- * ! OpenUI5
+/*!
+ * OpenUI5
  * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
@@ -9,23 +9,49 @@ sap.ui.define([
 	"sap/ui/fl/Layer",
 	"sap/ui/fl/Utils",
 	"sap/ui/fl/write/api/Version",
-	"sap/ui/fl/apply/_internal/flexState/ManifestUtils",
 	"sap/ui/fl/write/api/VersionsAPI",
 	"sap/ui/fl/write/api/FeaturesAPI",
 	"sap/ui/fl/write/api/PersistenceWriteAPI",
-	"sap/base/util/UriParameters"
+	"sap/ui/fl/write/_internal/FlexInfoSession"
 ], function(
 	LayerUtils,
 	Layer,
 	Utils,
 	Version,
-	ManifestUtils,
 	VersionsAPI,
 	FeaturesAPI,
-	PersistenceWriteAPI
+	PersistenceWriteAPI,
+	FlexInfoSession
 ) {
 	"use strict";
 
+	var oMutators = {
+		flp: {
+			set: function(vParams, sKey, sValue) {
+				vParams[sKey] = [sValue];
+				return vParams;
+			},
+			get: function(vParams, sKey) {
+				return vParams[sKey] && vParams[sKey][0];
+			},
+			remove: function(vParams, sKey) {
+				delete vParams[sKey];
+				return vParams;
+			}
+		},
+		standalone: {
+			set: function(vParams, sKey, sValue) {
+				return Utils.handleUrlParameters(vParams, sKey, sValue);
+			},
+			get: function(vParams, sKey) {
+				return Utils.getParameter(sKey);
+			},
+			remove: function(vParams, sKey, sValue) {
+				return Utils.handleUrlParameters(vParams, sKey, sValue);
+			}
+		}
+	};
+
 	function isDraftAvailable(oReloadInfo) {
 		var bUrlHasVersionParameter = !!Utils.getParameter(Version.UrlParameter, oReloadInfo.URLParsingService);
 		if (bUrlHasVersionParameter) {
@@ -56,35 +82,44 @@ sap.ui.define([
 		});
 	}
 
-	function isAllContextsAvailable(oReloadInfo) {
-		var sContextsFromSession = getInfoContextsSession(oReloadInfo.selector);
-		if (sContextsFromSession !== null) {
-			return false; //already call flex/info and do not retrigger reload again
+	/**
+	 * Should reload happen when starting RTA due to allContextsProvided flag.
+	 * allContextsProvided determines if the user has provided all nessesary roles to see the views.
+	 * If allContextsProvided=false, that means that EndUser hasn't some specific roles to see the views,
+	 * so the reload should happen in order to provide all views for a KeyUser.
+	 *
+	 * @param {sap.ui.core.Control} oReloadInfo.selector - Root control instance
+	 * @return {boolean} true if allContextsProvided false and RTA wasn't started yet, otherwise false.
+	 */
+	function needContextSpecificReload(oReloadInfo) {
+		var oFlexInfoSession = FlexInfoSession.get(oReloadInfo.selector);
+		if (oFlexInfoSession && oFlexInfoSession.initialAllContexts) {
+			return false; // if we are already in RTA mode, no reload needed again
 		}
-		var mPropertyBag = {
-			selector: oReloadInfo.selector,
-			layer: oReloadInfo.layer
-		};
-		return PersistenceWriteAPI.getResetAndPublishInfo(mPropertyBag)
-			.then(function (oResult) {
-				setInfoSessionStorage(oResult, oReloadInfo.selector);
-				return !oResult.allContextsProvided;
-			});
+		if (oFlexInfoSession === null || oFlexInfoSession.allContextsProvided === undefined) {
+			var mPropertyBag = {
+				selector: oReloadInfo.selector,
+				layer: oReloadInfo.layer
+			};
+			return PersistenceWriteAPI.getResetAndPublishInfo(mPropertyBag)
+				.then(function (oResult) {
+					if (oFlexInfoSession === null || !oFlexInfoSession.initialAllContexts) {
+						oResult.initialAllContexts = true;
+					}
+					FlexInfoSession.set(oResult, oReloadInfo.selector);
+					return !oResult.allContextsProvided;
+				});
+		}
+		oFlexInfoSession.initialAllContexts = true;
+		FlexInfoSession.set(oFlexInfoSession, oReloadInfo.selector);
+		return !oFlexInfoSession.allContextsProvided;
 	}
 
-	function getInfoContextsSession(oControl) {
-		var sFlexReference = ManifestUtils.getFlexReferenceForControl(oControl);
-		var sParameter = sFlexReference || "true";
-		var oFlexInfoSession = JSON.parse(window.sessionStorage.getItem("sap.ui.fl.info." + sParameter));
+	function isAllContextsAvailable(oControl) {
+		var oFlexInfoSession = FlexInfoSession.get(oControl);
 		return oFlexInfoSession && !oFlexInfoSession.allContextsProvided;
 	}
 
-	function setInfoSessionStorage(oInfo, oControl) {
-		var sFlexReference = ManifestUtils.getFlexReferenceForControl(oControl);
-		var sParameter = sFlexReference || "true";
-		window.sessionStorage.setItem("sap.ui.fl.info." + sParameter, JSON.stringify(oInfo));
-	}
-
 	/**
 	 * Provides an API to get information about reload behavior in case of a draft and/or personalization changes.
 	 *
@@ -98,11 +133,11 @@ sap.ui.define([
 		/**
 		 * Checks if all contexts, personalization or drafts changes exist for controls.
 		 *
-		 * @param  {object} oReloadInfo - Contains the information needed to find a reason to reload
-		 * @param  {sap.ui.fl.Layer} oReloadInfo.layer - Current layer
-		 * @param  {sap.ui.core.Control} oReloadInfo.selector - Root control instance
-		 * @param  {boolean} [oReloadInfo.ignoreMaxLayerParameter] - Indicates that personalization is to be checked without max layer filtering
-		 * @param  {object} oReloadInfo.parsedHash - The parsed URL hash
+		 * @param {object} oReloadInfo - Contains the information needed to find a reason to reload
+		 * @param {sap.ui.fl.Layer} oReloadInfo.layer - Current layer
+		 * @param {sap.ui.core.Control} oReloadInfo.selector - Root control instance
+		 * @param {boolean} [oReloadInfo.ignoreMaxLayerParameter] - Indicates that personalization is to be checked without max layer filtering
+		 * @param {object} oReloadInfo.parsedHash - Parsed URL hash
 		 *
 		 * @returns {Promise<object>} Promise resolving to an object with the reload reasons
 		 */
@@ -110,7 +145,7 @@ sap.ui.define([
 			return Promise.all([
 				areHigherLayerChangesAvailable.call(this, oReloadInfo),
 				isDraftAvailable(oReloadInfo),
-				isAllContextsAvailable(oReloadInfo)
+				needContextSpecificReload(oReloadInfo)
 			]).then(function(aReasons) {
 				oReloadInfo.hasHigherLayerChanges = aReasons[0];
 				oReloadInfo.isDraftAvailable = aReasons[1];
@@ -120,34 +155,32 @@ sap.ui.define([
 		},
 
 		/**
-		 * Remove flex info form session storage.
+		 * Checks if the the <code>sap-ui-fl-version</code> parameter name with the given value is contained in the URL.
 		 *
-		 * @param  {object} oControl - Root control instance
+		 * @param {object} oParameter - Object containing the parameter value to be checked
+		 * @param {string} oParameter.value - Parameter value to be checked
+		 * @param {sap.ushell.services.URLParsing} oURLParsingService - Unified Shell's internal URL parsing service
+		 * @returns {boolean} True if the parameter with the given value is in the URL
 		 */
-		removeInfoSessionStorage: function(oControl) {
-			var sFlexReference = ManifestUtils.getFlexReferenceForControl(oControl);
-			var sParameter = sFlexReference || "true";
-			window.sessionStorage.removeItem("sap.ui.fl.info." + sParameter);
+		hasVersionParameterWithValue: function(oParameter, oURLParsingService) {
+			return Utils.hasParameterAndValue(Version.UrlParameter, oParameter.value, oURLParsingService);
 		},
 
 		/**
-		 * Checks if the the <code>sap-ui-fl-version</code> parameter name with the given value is contained in the URL.
+		 * Remove flex info form session storage.
 		 *
-		 * @param  {object} oParameter - Object containing the parameter value to be checked
-		 * @param  {string} oParameter.value - The parameter value to be checked
-		 * @param  {sap.ushell.services.URLParsing} oURLParsingService - The Unified Shell's internal URL parsing service
-		 * @returns {boolean} True if the parameter with the given value is in the URL
+		 * @param {object} oControl - Root control instance
 		 */
-		hasVersionParameterWithValue: function(oParameter, oURLParsingService) {
-			return Utils.hasParameterAndValue(Version.UrlParameter, oParameter.value, oURLParsingService);
+		removeInfoSessionStorage: function(oControl) {
+			FlexInfoSession.remove(oControl);
 		},
 
 		/**
 		 * Checks if the the <code>sap-ui-fl-max-layer</code> parameter name with the given value is contained in the URL.
 		 *
-		 * @param  {object} oParameter - Object containing the parameter value to be checked
-		 * @param  {string} oParameter.value - The parameter value to be checked
-		 * @param  {sap.ushell.services.URLParsing} oURLParsingService - The Unified Shell's internal URL parsing service
+		 * @param {object} oParameter - Object containing the parameter value to be checked
+		 * @param {string} oParameter.value - Parameter value to be checked
+		 * @param {sap.ushell.services.URLParsing} oURLParsingService - Unified Shell's internal URL parsing service
 		 *
 		 * @returns {boolean} <code>true</code> if the parameter with the given value is in the URL
 		 */
@@ -159,77 +192,77 @@ sap.ui.define([
 		/**
 		 * Standalone: Adds the <code>sap-ui-fl-version</code> parameter to the URL or removes it.
 		 *
-		 * @param  {object} oReloadInfo - Contains the information needed to add the correct URL parameters
-		 * @param  {sap.ui.fl.Layer} oReloadInfo.layer - Current layer
-		 * @param  {boolean} oReloadInfo.hasHigherLayerChanges - Indicates if higher layer changes exist
-		 * @param  {boolean} oReloadInfo.isDraftAvailable - Indicates if a draft is available
-		 * @param  {string} oReloadInfo.parameters - The URL parameters to be modified
-		 * @param  {string} oReloadInfo.versionSwitch - Indicates if we are in a version switch scenario
-		 * @param  {string} oReloadInfo.version - Version we want to switch to
-		 * @param  {sap.ushell.services.URLParsing} oReloadInfo.URLParsingService - The Unified Shell's internal URL parsing service
-		 * @param  {boolean} [oReloadInfo.onExit=false] - Indicates if we are in a save+exit case/flow to not add the version=0 parameter
+		 * @param {object} oReloadInfo - Contains the information needed to add the correct URL parameters
+		 * @param {sap.ui.fl.Layer} oReloadInfo.layer - Current layer
+		 * @param {boolean} oReloadInfo.hasHigherLayerChanges - Indicates if higher layer changes exist
+		 * @param {boolean} oReloadInfo.ignoreMaxLayerParameter - Indicates if the max layer parameter should be ignored
+		 * @param {string|object} oReloadInfo.parameters - The URL parameters to be modified
+		 * @param {string} oReloadInfo.versionSwitch - Indicates if we are in a version switch scenario
+		 * @param {string} oReloadInfo.version - Version we want to switch to
+		 * @param {string} oReloadInfo.removeVersionParameter - Indicates if the version parameter should be removed
+		 * @param {string} oReloadInfo.removeDraft - Indicates if the draft parameter should be removed
+		 * @param {string} sScenario - Current scenario. Can be 'flp' or 'standalone'
 		 *
-		 * @returns {string} The modified URL
+		 * @returns {boolean} Indicates if the parameters have changed
 		 */
-		handleUrlParametersForStandalone: function(oReloadInfo) {
-			if (oReloadInfo.hasHigherLayerChanges) {
-				oReloadInfo.parameters = Utils.handleUrlParameters(oReloadInfo.parameters, LayerUtils.FL_MAX_LAYER_PARAM, oReloadInfo.layer, oReloadInfo.URLParsingService);
+		handleUrlParameters: function(oReloadInfo, sScenario) {
+			var bParametersChanged = false;
+			if (!oReloadInfo.ignoreMaxLayerParameter && oReloadInfo.hasHigherLayerChanges) {
+				oReloadInfo.parameters = oMutators[sScenario].remove(oReloadInfo.parameters, LayerUtils.FL_MAX_LAYER_PARAM, oReloadInfo.layer);
+				bParametersChanged = true;
 			}
 
-			// removes any version number set (original, draft, inactive and active versions)
-			var oVersionRegExp = new RegExp("\&*" + Version.UrlParameter + "=-?\\d*\&?", "g");
-			oReloadInfo.parameters = oReloadInfo.parameters.replace(oVersionRegExp, "");
-
-			// startup reload due to draft
-			if (oReloadInfo.isDraftAvailable && !oReloadInfo.onExit) {
-				oReloadInfo.parameters = Utils.handleUrlParameters(oReloadInfo.parameters, Version.UrlParameter, Version.Number.Draft, oReloadInfo.URLParsingService);
+			var sCurrentVersionParameter = oMutators[sScenario].get(oReloadInfo.parameters, Version.UrlParameter);
+			if (oReloadInfo.versionSwitch && sCurrentVersionParameter !== oReloadInfo.version) {
+				oReloadInfo.parameters = oMutators[sScenario].remove(oReloadInfo.parameters, Version.UrlParameter, sCurrentVersionParameter);
+				oReloadInfo.parameters = oMutators[sScenario].set(oReloadInfo.parameters, Version.UrlParameter, oReloadInfo.version);
+				bParametersChanged = true;
 			}
 
-			if (oReloadInfo.versionSwitch) {
-				oReloadInfo.parameters = Utils.handleUrlParameters(oReloadInfo.parameters, Version.UrlParameter, oReloadInfo.version, oReloadInfo.URLParsingService);
-			}
-
-			// clean up if the last parameter was removed
-			if (oReloadInfo.parameters === "?") {
-				oReloadInfo.parameters = "";
+			if (
+				sCurrentVersionParameter && oReloadInfo.removeVersionParameter
+				|| sCurrentVersionParameter === Version.Number.Draft && oReloadInfo.removeDraft
+			) {
+				oReloadInfo.parameters = oMutators[sScenario].remove(oReloadInfo.parameters, Version.UrlParameter, sCurrentVersionParameter);
+				bParametersChanged = true;
 			}
 
-			return oReloadInfo.parameters;
+			return bParametersChanged;
 		},
 
 		/**
 		 * Adds parameters to the parsed hash to skip personalization changes and/or apply draft changes.
 		 *
-		 * @param  {object}  oReloadInfo - Contains the information needed to add the correct URL parameters
-		 * @param  {boolean} oReloadInfo.hasHigherLayerChanges - Indicates if higher layer changes exist
-		 * @param  {boolean} oReloadInfo.isDraftAvailable - Indicates if a draft is available
-		 * @param  {sap.ui.fl.Layer} oReloadInfo.layer - Current layer
-		 * @param  {sap.ui.fl.Selector} oReloadInfo.selector - Root control instance
-		 * @param  {sap.ushell.services.URLParsing} oReloadInfo.URLParsingService - The Unified Shell's internal URL parsing service
+		 * @param {object} oReloadInfo - Contains the information needed to add the correct URL parameters
+		 * @param {boolean} oReloadInfo.hasHigherLayerChanges - Indicates if higher layer changes exist
+		 * @param {boolean} oReloadInfo.isDraftAvailable - Indicates if a draft is available
+		 * @param {sap.ui.fl.Layer} oReloadInfo.layer - Current layer
+		 * @param {string} sScenario - Current scenario. Can be 'flp' or 'standalone'
 		 *
-		 * @returns {object} oParsedHash Adjusted parsed hash
+		 * @returns {boolean} <code>true</code> to indicate that the URL has been changed
 		 */
-		handleParametersOnStart: function(oReloadInfo) {
-			var mParsedHash = Utils.getParsedURLHash(oReloadInfo.URLParsingService);
-			mParsedHash.params = mParsedHash.params || {};
-
+		handleParametersOnStart: function(oReloadInfo, sScenario) {
+			var bParametersChanged = false;
 			if (oReloadInfo.hasHigherLayerChanges) {
-				mParsedHash.params[LayerUtils.FL_MAX_LAYER_PARAM] = [oReloadInfo.layer];
+				oReloadInfo.parameters = oMutators[sScenario].set(oReloadInfo.parameters, LayerUtils.FL_MAX_LAYER_PARAM, oReloadInfo.layer);
+				bParametersChanged = true;
 			}
+
 			if (oReloadInfo.isDraftAvailable) {
-				mParsedHash.params[Version.UrlParameter] = [Version.Number.Draft];
+				oReloadInfo.parameters = oMutators[sScenario].set(oReloadInfo.parameters, Version.UrlParameter, Version.Number.Draft);
+				bParametersChanged = true;
 			}
-			return mParsedHash;
+			return bParametersChanged;
 		},
 
 		/**
 		 * Checks if an initially available draft got activated during the current UI adaptation session.
 		 *
-		 * @param  {object}  oReloadInfo - Contains the information needed to check if the initial draft got activated
-		 * @param  {sap.ui.fl.Layer} oReloadInfo.layer - Current layer
-		 * @param  {sap.ui.fl.Selector} oReloadInfo.selector - Root control instance
-		 * @param  {boolean} oReloadInfo.versioningEnabled - Indicates if versioning is enabled by the backend
-		 * @param  {sap.ushell.services.URLParsing} oReloadInfo.URLParsingService - The Unified Shell's internal URL parsing service
+		 * @param {object} oReloadInfo - Contains the information needed to check if the initial draft got activated
+		 * @param {sap.ui.fl.Layer} oReloadInfo.layer - Current layer
+		 * @param {sap.ui.fl.Selector} oReloadInfo.selector - Root control instance
+		 * @param {boolean} oReloadInfo.versioningEnabled - Indicates if versioning is enabled by the back end
+		 * @param {sap.ushell.services.URLParsing} oReloadInfo.URLParsingService - Unified Shell's internal URL parsing service
 		 * @returns {boolean} <code>true</code> if a draft got activated and had a draft initially when entering UI adaptation
 		 */
 		initialDraftGotActivated: function(oReloadInfo) {
@@ -246,14 +279,14 @@ sap.ui.define([
 		/**
 		 * Determines if a reload on exit is needed and if yes - it returns what kind of reload should happen (CrossAppNavigation or hard reload).
 		 *
-		 * @param  {object} oReloadInfo - Contains the information needed to check if a reload on exit should happen
-		 * @param  {sap.ui.fl.Layer} oReloadInfo.layer - Current layer
-		 * @param  {boolean} oReloadInfo.isDraftAvailable - Indicates if a draft is available
-		 * @param  {boolean} oReloadInfo.hasHigherLayerChanges - Indicates if higher layer changes exist
-		 * @param  {boolean} oReloadInfo.changesNeedReload - Indicates if changes (e.g. app descriptor changes) need hard reload
-		 * @param  {boolean} oReloadInfo.initialDraftGotActivated - Indicates if a draft got activated and had a draft initially when entering UI adaptation
-		 * @param  {boolean} oReloadInfo.activeVersion - Indicates the current active version
-		 * @param  {sap.ushell.services.URLParsing} oReloadInfo.URLParsingService - The Unified Shell's internal URL parsing service
+		 * @param {object} oReloadInfo - Contains the information needed to check if a reload on exit should happen
+		 * @param {sap.ui.fl.Layer} oReloadInfo.layer - Current layer
+		 * @param {boolean} oReloadInfo.isDraftAvailable - Indicates if a draft is available
+		 * @param {boolean} oReloadInfo.hasHigherLayerChanges - Indicates if higher layer changes exist
+		 * @param {boolean} oReloadInfo.changesNeedReload - Indicates if changes (e.g. app descriptor changes) need a hard reload
+		 * @param {boolean} oReloadInfo.initialDraftGotActivated - Indicates if a draft got activated and had a draft initially when the key user entered UI adaptation
+		 * @param {boolean} oReloadInfo.activeVersion - Indicates the current active version
+		 * @param {sap.ushell.services.URLParsing} oReloadInfo.URLParsingService - Unified Shell's internal URL parsing service
 		 *
 		 * @returns {boolean} <code>true</code> if a draft got activated and had a draft initially when entering UI adaptation
 		 */
@@ -271,15 +304,20 @@ sap.ui.define([
 
 			oReloadInfo.hasVersionUrlParameter = !!Utils.getParameter(Version.UrlParameter, oReloadInfo.URLParsingService);
 
-			if (oReloadInfo.activeVersion !== Version.Number.Original) {
-				oReloadInfo.activeVersionNotSelected = oReloadInfo.activeVersion && !ReloadInfoAPI.hasVersionParameterWithValue({value: oReloadInfo.activeVersion}, oReloadInfo.URLParsingService);
+			if (
+				oReloadInfo.activeVersion
+				&& oReloadInfo.activeVersion !== Version.Number.Original
+				&& oReloadInfo.hasVersionUrlParameter
+			) {
+				oReloadInfo.activeVersionNotSelected = !ReloadInfoAPI.hasVersionParameterWithValue({value: oReloadInfo.activeVersion}, oReloadInfo.URLParsingService);
 			}
+
 			oReloadInfo.hasHigherLayerChanges = ReloadInfoAPI.hasMaxLayerParameterWithValue({value: oReloadInfo.layer}, oReloadInfo.URLParsingService);
 			oReloadInfo.initialDraftGotActivated = ReloadInfoAPI.initialDraftGotActivated(oReloadInfo);
 			if (oReloadInfo.initialDraftGotActivated) {
 				oReloadInfo.isDraftAvailable = false;
 			}
-			oReloadInfo.allContexts = getInfoContextsSession(oReloadInfo.selector);
+			oReloadInfo.allContexts = isAllContextsAvailable(oReloadInfo.selector);
 			if (oReloadInfo.changesNeedReload
 				|| oReloadInfo.isDraftAvailable
 				|| oReloadInfo.hasHigherLayerChanges
@@ -293,7 +331,7 @@ sap.ui.define([
 					oReloadInfo.reloadMethod = oRELOAD.VIA_HASH;
 				}
 			}
-			this.removeInfoSessionStorage(oReloadInfo.selector);
+			FlexInfoSession.remove(oReloadInfo.selector);
 			return oReloadInfo;
 		}
 	};

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

@@ -1,5 +1,5 @@
-/*
- * ! OpenUI5
+/*!
+ * OpenUI5
  * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */

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

@@ -1,5 +1,5 @@
-/*
- * ! OpenUI5
+/*!
+ * OpenUI5
  * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */

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

@@ -1,5 +1,5 @@
-/*
- * ! OpenUI5
+/*!
+ * OpenUI5
  * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */

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

@@ -1,5 +1,5 @@
-/*
- * ! OpenUI5
+/*!
+ * OpenUI5
  * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */

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

@@ -1,5 +1,5 @@
-/*
- * ! OpenUI5
+/*!
+ * OpenUI5
  * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
@@ -181,6 +181,7 @@ sap.ui.define([
 	 * @param {sap.ui.core.Control} mPropertyBag.control - Control for which the request is done
 	 * @param {string} mPropertyBag.layer - Layer for which the versions should be retrieved
 	 * @param {string} mPropertyBag.title - Title of the to be activated version
+	 * @param {string} mPropertyBag.displayedVersion - Id of the displayed version
 	 *
 	 * @ui5-restricted sap.ui.rta
 	 *
@@ -207,7 +208,8 @@ sap.ui.define([
 			reference: Utils.normalizeReference(sReference),
 			layer: mPropertyBag.layer,
 			title: mPropertyBag.title,
-			appComponent: Utils.getAppComponentForControl(mPropertyBag.control)
+			appComponent: Utils.getAppComponentForControl(mPropertyBag.control),
+			displayedVersion: mPropertyBag.displayedVersion
 		});
 	};
 

package/src/sap/ui/fl/write/api/connectors/FileListBaseConnector.js

@@ -1,5 +1,5 @@
-/*
- * ! OpenUI5
+/*!
+ * OpenUI5
  * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
@@ -19,7 +19,8 @@ sap.ui.define([
 	 * The inherited objects must implement the function <code>getFileList</code>.
 	 * The <code>loadFlexData</code> already ensures that all <code>sap.ui.fl</code>-internals are handled accordingly.
 	 *
-	 * @public
+	 * @private
+	 * @ui5-restricted sap.ui.fl, SAPUI5 Visual Editor, UX Tools
 	 * @abstract
 	 */
 	return {

package/src/sap/ui/fl/write/api/connectors/ObjectStorageConnector.js

@@ -1,5 +1,5 @@
-/*
- * ! OpenUI5
+/*!
+ * OpenUI5
  * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
@@ -72,7 +72,8 @@ sap.ui.define([
 	 * @namespace sap.ui.fl.write.api.connectors.ObjectStorageConnector
 	 * @extends sap.ui.fl.write.connectors.BaseConnector
 	 * @since 1.84
-	 * @public
+	 * @private
+	 * @ui5-restricted sap.ui.fl, SAPUI5 Visual Editor, UX Tools
 	 * @abstract
 	 */
 	var ObjectStorageConnector = merge({}, BaseConnector, /** @lends sap.ui.fl.write.api.connectors.ObjectStorageConnector */ {

package/src/sap/ui/fl/write/connectors/BaseConnector.js

@@ -1,5 +1,5 @@
-/*
- * ! OpenUI5
+/*!
+ * OpenUI5
  * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
@@ -13,9 +13,9 @@ sap.ui.define([
 	 * Base class for connectors.
 	 *
 	 * @namespace sap.ui.fl.write.connectors.BaseConnector
-	 * @experimental Since 1.67
 	 * @since 1.67
-	 * @public
+	 * @private
+	 * @ui5-restricted sap.ui.fl
 	 */
 	var BaseConnector = /** @lends sap.ui.fl.write.connectors.BaseConnector */{