@openui5/sap.ui.fl 1.97.1 → 1.100.0

package/src/sap/ui/fl/Utils.js

@@ -5,48 +5,39 @@
  */
 
 sap.ui.define([
-	"sap/ui/thirdparty/jquery",
-	"sap/ui/core/Component",
-	"sap/ui/core/util/reflection/BaseTreeModifier",
-	"sap/ui/thirdparty/hasher",
-	"sap/base/Log",
-	"sap/base/util/UriParameters",
-	"sap/base/util/uid",
 	"sap/base/strings/formatMessage",
-	"sap/ui/base/ManagedObject",
-	"sap/ui/core/mvc/View",
 	"sap/base/util/isPlainObject",
-	"sap/ui/base/SyncPromise"
+	"sap/base/util/uid",
+	"sap/base/util/UriParameters",
+	"sap/base/Log",
+	"sap/ui/base/SyncPromise",
+	"sap/ui/base/ManagedObject",
+	"sap/ui/core/util/reflection/BaseTreeModifier",
+	"sap/ui/core/Component",
+	"sap/ui/thirdparty/hasher",
+	"sap/ui/thirdparty/jquery"
 ], function(
-	jQuery,
-	Component,
-	BaseTreeModifier,
-	hasher,
-	Log,
-	UriParameters,
-	uid,
 	formatMessage,
-	ManagedObject,
-	View,
 	isPlainObject,
-	SyncPromise
+	uid,
+	UriParameters,
+	Log,
+	SyncPromise,
+	ManagedObject,
+	BaseTreeModifier,
+	Component,
+	hasher,
+	jQuery
 ) {
 	"use strict";
 
-	function appendComponentToString(sComponentName) {
-		if (sComponentName.length > 0 && sComponentName.indexOf(".Component") < 0) {
-			sComponentName += ".Component";
-		}
-		return sComponentName;
-	}
-
 	/**
 	 * Provides utility functions for the SAPUI5 flexibility library
 	 *
 	 * @namespace
 	 * @alias sap.ui.fl.Utils
 	 * @author SAP SE
-	 * @version 1.97.1
+	 * @version 1.100.0
 	 * @experimental Since 1.25.0
 	 */
 	var Utils = {
@@ -67,85 +58,6 @@ sap.ui.define([
 			Log[sLogType](sLogMessage, sCallStack || "");
 		},
 
-		/**
-		 * Tries to retrieve the xsrf token from the controls OData Model. Returns empty string if retrieval failed.
-		 *
-		 * @param {sap.ui.core.Control} oControl - SAPUI5 control
-		 * @returns {String} XSRF Token
-		 * @public
-		 * @function
-		 * @name sap.ui.fl.Utils.getXSRFTokenFromControl
-		 */
-		getXSRFTokenFromControl: function(oControl) {
-			var oModel;
-			if (!oControl) {
-				return "";
-			}
-
-			// Get Model
-			if (oControl && typeof oControl.getModel === "function") {
-				oModel = oControl.getModel();
-				return Utils._getXSRFTokenFromModel(oModel);
-			}
-			return "";
-		},
-
-		/**
-		 * Returns XSRF Token from the Odata Model. Returns empty string if retrieval failed
-		 *
-		 * @param {sap.ui.model.odata.ODataModel} oModel - OData Model
-		 * @returns {String} XSRF Token
-		 * @private
-		 */
-		_getXSRFTokenFromModel: function(oModel) {
-			var mHeaders;
-			if (!oModel) {
-				return "";
-			}
-			if (typeof oModel.getHeaders === "function") {
-				mHeaders = oModel.getHeaders();
-				if (mHeaders) {
-					return mHeaders["x-csrf-token"];
-				}
-			}
-			return "";
-		},
-
-		/**
-		 * Returns the class name of the component the given control belongs to.
-		 *
-		 * @param {sap.ui.core.Control} oControl - SAPUI5 control
-		 *
-		 * @returns {String} The component class name, ending with ".Component"
-		 * @see sap.ui.core.Component.getOwnerIdFor
-		 * @public
-		 * @function
-		 * @name sap.ui.fl.Utils.getComponentClassName
-		 */
-		getComponentClassName: function(oControl) {
-			var oAppComponent;
-
-			// determine UI5 component out of given control
-			if (oControl) {
-				// always return the app component
-				oAppComponent = this.getAppComponentForControl(oControl);
-
-				// check if the component is an application variant and assigned an application descriptor then use this as reference
-				if (oAppComponent) {
-					var sVariantId = this._getComponentStartUpParameter(oAppComponent, "sap-app-id");
-					if (sVariantId) {
-						return sVariantId;
-					}
-
-					if (oAppComponent.getManifestEntry("sap.ui5") && oAppComponent.getManifestEntry("sap.ui5").appVariantId) {
-						return oAppComponent.getManifestEntry("sap.ui5").appVariantId;
-					}
-				}
-			}
-
-			return Utils.getComponentName(oAppComponent);
-		},
-
 		isVariantByStartupParameter: function(oControl) {
 			// determine UI5 component out of given control
 			if (oControl) {
@@ -158,22 +70,6 @@ sap.ui.define([
 			return false;
 		},
 
-		/**
-		 * Returns the class name of the application component owning the passed component or the component name itself if
-		 * this is already an application component.
-		 *
-		 * @param {sap.ui.core.Component} oComponent - SAPUI5 component
-		 * @returns {String} The component class name, ending with ".Component"
-		 * @see sap.ui.core.Component.getOwnerIdFor
-		 * @public
-		 * @since 1.40
-		 * @function
-		 * @name getAppComponentClassNameForComponent
-		 */
-		getAppComponentClassNameForComponent: function(oComponent) {
-			return Utils.getComponentClassName(oComponent);
-		},
-
 		/**
 		 * Returns the appDescriptor of the component for the given control
 		 *
@@ -204,37 +100,6 @@ sap.ui.define([
 			return oManifest;
 		},
 
-		/**
-		 * Returns the siteId of a component
-		 *
-		 * @param {sap.ui.core.Control} oControl - SAPUI5 control
-		 * @returns {string} siteId - that represent the found siteId
-		 * @public
-		 * @function
-		 * @name sap.ui.fl.Utils.getSiteId
-		 */
-		getSiteId: function(oControl) {
-			var sSiteId = null;
-			var oAppComponent = null;
-
-			// determine UI5 component out of given control
-			if (oControl) {
-				oAppComponent = this.getAppComponentForControl(oControl);
-
-				// determine siteId from ComponentData
-				if (oAppComponent) {
-					//Workaround for back-end check: isApplicationPermitted
-					//As long as FLP does not know about appDescriptorId we have to pass siteID and applicationID.
-					//With startUpParameter hcpApplicationId we will get a concatenation of “siteId:applicationId”
-
-					//sSiteId = this._getComponentStartUpParameter(oComponent, "scopeId");
-					sSiteId = this._getComponentStartUpParameter(oAppComponent, "hcpApplicationId");
-				}
-			}
-
-			return sSiteId;
-		},
-
 		/**
 		 * Returns the siteId of a component when you already have the component data.
 		 *
@@ -276,22 +141,6 @@ sap.ui.define([
 			);
 		},
 
-		/**
-		 * Indicates if the current application is a variant of an existing one
-		 *
-		 * @param {sap.ui.core.Control} oControl - SAPUI5 control
-		 * @returns {boolean} true if it's an application variant
-		 * @public
-		 * @function
-		 * @name sap.ui.fl.Utils.isApplicationVariant
-		 */
-		isApplicationVariant: function(oControl) {
-			var sFlexReference = Utils.getComponentClassName(oControl);
-			var oAppComponent = Utils.getAppComponentForControl(oControl);
-			var sComponentName = Utils.getComponentName(oAppComponent);
-			return sFlexReference !== sComponentName;
-		},
-
 		/**
 		 * Determines if the passed change is related to control variants.
 		 * @see sap.ui.fl.variants.VariantManagement
@@ -311,8 +160,8 @@ sap.ui.define([
 		 * Determines the content for a given startUpParameter name
 		 *
 		 * @param {sap.ui.core.Component} oComponent - component instance
-		 * @param {String} sParameterName - startUpParameterName that shall be determined
-		 * @returns {String} content of found startUpParameter
+		 * @param {string} sParameterName - startUpParameterName that shall be determined
+		 * @returns {string} content of found startUpParameter
 		 * @private
 		 */
 		_getComponentStartUpParameter: function(oComponent, sParameterName) {
@@ -335,25 +184,10 @@ sap.ui.define([
 			}
 		},
 
-		/**
-		 * Gets the component name for a component instance.
-		 *
-		 * @param {sap.ui.core.Component} oComponent component instance
-		 * @returns {String} component name
-		 * @public
-		 */
-		getComponentName: function(oComponent) {
-			var sComponentName = "";
-			if (oComponent) {
-				sComponentName = oComponent.getMetadata().getName();
-			}
-			return appendComponentToString(sComponentName);
-		},
-
 		/**
 		 * Gets the component instance for a component ID.
 		 *
-		 * @param {String} sComponentId component ID
+		 * @param {string} sComponentId component ID
 		 * @returns {sap.ui.core.Component} component for the component ID
 		 * @private
 		 */
@@ -369,7 +203,7 @@ sap.ui.define([
 		 * Returns ComponentId of the control. If the control has no component, it walks up the control tree in order to find a control having one
 		 *
 		 * @param {sap.ui.core.Control} oControl - SAPUI5 control
-		 * @returns {String} The component id or empty string if component id couldn't be found
+		 * @returns {string} The component id or empty string if component id couldn't be found
 		 * @see sap.ui.core.Component.getOwnerIdFor
 		 * @private
 		 */
@@ -510,46 +344,11 @@ sap.ui.define([
 			}
 		},
 
-		hasControlAncestorWithId: function(sControlId, sAncestorControlId) {
-			var oControl;
-
-			if (sControlId === sAncestorControlId) {
-				return true;
-			}
-
-			oControl = sap.ui.getCore().byId(sControlId);
-			while (oControl) {
-				if (oControl.getId() === sAncestorControlId) {
-					return true;
-				}
-
-				if (typeof oControl.getParent === "function") {
-					oControl = oControl.getParent();
-				} else {
-					return false;
-				}
-			}
-
-			return false;
-		},
-
-		/**
-		 * Checks whether the provided control is a view
-		 *
-		 * @param {sap.ui.core.Control} oControl - SAPUI5 control
-		 * @returns {boolean} Flag
-		 * @see sap.ui.core.Component.getOwnerIdFor
-		 * @private
-		 */
-		_isView: function(oControl) {
-			return oControl instanceof View;
-		},
-
 		/**
 		 * Returns OwnerId of the control
 		 *
 		 * @param {sap.ui.core.Control} oControl - SAPUI5 control
-		 * @returns {String} The owner id
+		 * @returns {string} The owner id
 		 * @see sap.ui.core.Component.getOwnerIdFor
 		 * @private
 		 */
@@ -595,8 +394,8 @@ sap.ui.define([
 		 * used: For example en-us will be converted to EN. If the browser language already is in ISO 639-1, it will be returned after an upper case
 		 * conversion: For example de will be converted to DE.
 		 *
-		 * @param {String} sBrowserLanguage - Language in RFC4646
-		 * @returns {String} Language in ISO 639-1. Empty string if conversion was not successful
+		 * @param {string} sBrowserLanguage - Language in RFC4646
+		 * @returns {string} Language in ISO 639-1. Empty string if conversion was not successful
 		 * @public
 		 * @function
 		 * @name sap.ui.fl.Utils.convertBrowserLanguageToISO639_1
@@ -629,7 +428,7 @@ sap.ui.define([
 		/**
 		 * Returns the current language in ISO 639-1 format.
 		 *
-		 * @returns {String} Language in ISO 639-1. Empty string if language cannot be determined
+		 * @returns {string} Language in ISO 639-1. Empty string if language cannot be determined
 		 * @public
 		 */
 		getCurrentLanguage: function() {
@@ -657,8 +456,8 @@ sap.ui.define([
 		/**
 		 * Converts ASCII coding into a string. Required for restoring stored code extensions
 		 *
-		 * @param {String} ascii string containing ascii code valid numbers separated by ','
-		 * @returns {String} parsedString parsed string
+		 * @param {string} ascii string containing ascii code valid numbers separated by ','
+		 * @returns {string} parsedString parsed string
 		 */
 		asciiToString: function(ascii) {
 			var asciiArray = ascii.split(",");
@@ -674,8 +473,8 @@ sap.ui.define([
 		/**
 		 * Converts a string into ASCII coding. Required for restoring stored code extensions
 		 *
-		 * @param {String} string string which has to be encoded
-		 * @returns {String} ascii imput parsed to ascii numbers separated by ','
+		 * @param {string} string string which has to be encoded
+		 * @returns {string} ascii imput parsed to ascii numbers separated by ','
 		 */
 		stringToAscii: function(string) {
 			var ascii = "";
@@ -716,19 +515,6 @@ sap.ui.define([
 			return window.location.search.substring(1);
 		},
 
-		/**
-		 * Returns a map of technical parameters for the passed component.
-		 *
-		 * @param  {object} oComponent - Component instance used to get the technical parameters
-		 * @returns {object|undefined} Returns the requested technical parameter object or undefined if unavailable
-		 */
-		getTechnicalParametersForComponent: function(oComponent) {
-			return oComponent
-				&& oComponent.getComponentData
-				&& oComponent.getComponentData()
-				&& oComponent.getComponentData().technicalParameters;
-		},
-
 		/**
 		 * Returns URL hash when ushell container is available synchronously.
 		 *
@@ -742,25 +528,6 @@ sap.ui.define([
 			return {};
 		},
 
-		/**
-		 * Checks the SAPUI5 debug settings to determine whether all or at least the <code>sap.ui.fl</code> library is debugged.
-		 *
-		 * @returns {boolean} Returns a flag if the flexibility library is debugged
-		 * @public
-		 */
-		isDebugEnabled: function() {
-			var oUriParams = this._getUriParameters();
-			var sDebugParameters = oUriParams.get("sap-ui-debug") || "";
-
-			// true if SAPUI5 is in complete debug mode
-			if (sap.ui.getCore().getConfiguration().getDebug() || sDebugParameters === "true") {
-				return true;
-			}
-
-			var aDebugParameters = sDebugParameters.split(",");
-			return aDebugParameters.indexOf("sap/ui/fl") !== -1 || aDebugParameters.indexOf("sap/ui/fl/") !== -1;
-		},
-
 		/**
 		 * Returns the value of the specified url parameter of the current url
 		 *
@@ -894,36 +661,10 @@ sap.ui.define([
 			return oComponent instanceof Component && Utils._getComponentTypeFromManifest(oComponent.getManifestObject()) === "component";
 		},
 
-		/**
-		 * Returns the reference of a component, according to the following logic:
-		 * First appVariantId, if not, componentName + ".Component", if not appId + ".Component" (unless they already have ".Component" at the end).
-		 *
-		 * @param {object} oManifest - Manifest of the component
-		 * @returns {string} flex reference
-		 * @public
-		 */
-		getFlexReference: function(oManifest) {
-			if (oManifest) {
-				if (oManifest.getEntry("sap.ui5")) {
-					if (oManifest.getEntry("sap.ui5").appVariantId) {
-						return oManifest.getEntry("sap.ui5").appVariantId;
-					}
-					if (oManifest.getEntry("sap.ui5").componentName) {
-						return appendComponentToString(oManifest.getEntry("sap.ui5").componentName);
-					}
-				}
-				if (oManifest.getEntry("sap.app") && oManifest.getEntry("sap.app").id) {
-					return appendComponentToString(Utils.getAppIdFromManifest(oManifest));
-				}
-			}
-			Log.warning("No Manifest received.");
-			return "";
-		},
-
 		/**
 		 * Returns the descriptor Id, which is always the reference for descriptor changes
 		 *
-		 * @param {object} oManifest - Manifest of the component
+		 * @param {object|sap.ui.core.Manifest} oManifest - Manifest of the component
 		 * @returns {string} Version of application if it is available in the manifest, otherwise an empty string
 		 * @public
 		 */
@@ -931,8 +672,13 @@ sap.ui.define([
 			if (oManifest) {
 				var oSapApp = (oManifest.getEntry) ? oManifest.getEntry("sap.app") : oManifest["sap.app"];
 				var sAppId = oSapApp && oSapApp.id;
-				if (sAppId === Utils.APP_ID_AT_DESIGN_TIME && oManifest.getComponentName) {
-					sAppId = oManifest.getComponentName();
+				if (sAppId === Utils.APP_ID_AT_DESIGN_TIME) {
+					if (oManifest.getComponentName) {
+						return oManifest.getComponentName();
+					}
+					if (oManifest.name) {
+						return oManifest.name;
+					}
 				}
 				return sAppId;
 			}
@@ -940,26 +686,6 @@ sap.ui.define([
 			throw new Error("No Manifest received, descriptor changes are not possible");
 		},
 
-		/**
-		 * Returns the uri of the main service specified in the app manifest
-		 *
-		 * @param {object} oManifest - Manifest of the component
-		 * @returns {string} Returns the uri if the manifest is available, otherwise an empty string
-		 * @public
-		 */
-		getODataServiceUriFromManifest: function(oManifest) {
-			var sUri = "";
-			if (oManifest) {
-				var oSapApp = (oManifest.getEntry) ? oManifest.getEntry("sap.app") : oManifest["sap.app"];
-				if (oSapApp && oSapApp.dataSources && oSapApp.dataSources.mainService && oSapApp.dataSources.mainService.uri) {
-					sUri = oSapApp.dataSources.mainService.uri;
-				}
-			} else {
-				Log.warning("No Manifest received.");
-			}
-			return sUri;
-		},
-
 		/**
 		 * Checks if an object is in an array or not and returns the index or -1
 		 *

package/src/sap/ui/fl/Variant.js

@@ -33,7 +33,7 @@ sap.ui.define([
 	 * @class Variant class.
 	 * @extends sap.ui.base.ManagedObject
 	 * @author SAP SE
-	 * @version 1.97.1
+	 * @version 1.100.0
 	 * @alias sap.ui.fl.Variant
 	 * @experimental Since 1.52.0
 	 */
@@ -157,7 +157,7 @@ sap.ui.define([
 	/**
 	 * Returns the title
 	 *
-	 * @returns {String} Title of the variant
+	 * @returns {string} Title of the variant
 	 * @public
 	 */
 	Variant.prototype.getTitle = function () {
@@ -169,7 +169,7 @@ sap.ui.define([
 	/**
 	 * Returns the file type
 	 *
-	 * @returns {String} fileType of the variant
+	 * @returns {string} fileType of the variant
 	 * @public
 	 */
 	Variant.prototype.getFileType = function () {
@@ -188,20 +188,6 @@ sap.ui.define([
 		return this._oDefinition.controlChanges;
 	};
 
-	/**
-	 * Returns the original language in ISO 639-1 format
-	 *
-	 * @returns {String} Original language
-	 *
-	 * @public
-	 */
-	Variant.prototype.getOriginalLanguage = function () {
-		if (this._oDefinition && this._oDefinition.content.originalLanguage) {
-			return this._oDefinition.content.originalLanguage;
-		}
-		return "";
-	};
-
 	/**
 	 * Returns the abap package name
 	 * @returns {string} ABAP package where the variant is assigned to
@@ -216,7 +202,7 @@ sap.ui.define([
 	 * Returns the namespace. The variants' namespace is
 	 * also the namespace of the change file in the repository.
 	 *
-	 * @returns {String} Namespace of the variants document
+	 * @returns {string} Namespace of the variants document
 	 *
 	 * @public
 	 */
@@ -287,16 +273,6 @@ sap.ui.define([
 		return this._oDefinition.content.variantReference;
 	};
 
-	/**
-	 * Returns the user ID of the owner
-	 * @returns {string} ID of the owner
-	 *
-	 * @public
-	 */
-	Variant.prototype.getOwnerId = function () {
-		return this._oDefinition.content.support ? this._oDefinition.content.support.user : "";
-	};
-
 	/**
 	 * Returns the text in the current language for a given id
 	 *
@@ -340,77 +316,6 @@ sap.ui.define([
 		}
 	};
 
-	/**
-	 * Returns true if the current layer is the same as the layer
-	 * in which the variant was created or the variant is from the
-	 * end-user layer and for this user created.
-	 * @returns {boolean} is the variant read only
-	 *
-	 * @public
-	 */
-	Variant.prototype.isReadOnly = function () {
-		return this._isReadOnlyDueToLayer() || this._isReadOnlyWhenNotKeyUser();
-	};
-
-	/**
-	 * Checks if the variant is read-only
-	 * because the current user is not a key user and the change is "shared"
-	 * @returns {boolean} Flag whether variant is read only
-	 *
-	 * @private
-	 */
-	Variant.prototype._isReadOnlyWhenNotKeyUser = function () {
-		if (this.isUserDependent()) {
-			return false; // the user always can edit its own variants
-		}
-
-		var sReference = this.getDefinition().reference;
-		if (!sReference) {
-			return true; // without a reference the right to edit or delete a variant cannot be determined
-		}
-
-		var oSettings = Settings.getInstanceOrUndef();
-		if (!oSettings) {
-			return true; // without settings the right to edit or delete a variant cannot be determined
-		}
-
-		return !oSettings.isKeyUser(); // a key user can edit changes
-	};
-
-	/**
-	 * Checks if the layer allows modifying the file
-	 * @returns {boolean} Flag whether variant is read only
-	 *
-	 * @private
-	 */
-	Variant.prototype._isReadOnlyDueToLayer = function () {
-		var sCurrentLayer;
-		sCurrentLayer = this._bUserDependent ? Layer.USER : LayerUtils.getCurrentLayer();
-		return (this._oDefinition.content.layer !== sCurrentLayer);
-	};
-
-	/**
-	 * A variant can only be modified if the current language equals the original language.
-	 * Returns false if the current language does not equal the original language of the variant's change file.
-	 * Returns false if the original language is initial.
-	 *
-	 * @returns {boolean} flag whether the current logon language differs from the original language of the variant's change document
-	 *
-	 * @private
-	 */
-	Variant.prototype._isReadOnlyDueToOriginalLanguage = function () {
-		var sCurrentLanguage;
-		var sOriginalLanguage;
-
-		sOriginalLanguage = this.getOriginalLanguage();
-		if (!sOriginalLanguage) {
-			return false;
-		}
-
-		sCurrentLanguage = Utils.getCurrentLanguage();
-		return (sCurrentLanguage !== sOriginalLanguage);
-	};
-
 	/**
 	 * Marks the current variant to be deleted persistently
 	 *
@@ -477,7 +382,7 @@ sap.ui.define([
 	/**
 	 * Gets the creation timestamp
 	 *
-	 * @returns {String} creation timestamp
+	 * @returns {string} creation timestamp
 	 *
 	 * @public
 	 */
@@ -485,16 +390,6 @@ sap.ui.define([
 		return this._oDefinition.content.creation;
 	};
 
-	/**
-	 * Returns true if the variant is user dependent
-	 * @returns {boolean} Variant is only relevant for the current user
-	 *
-	 * @public
-	 */
-	Variant.prototype.isUserDependent = function () {
-		return (this._bUserDependent);
-	};
-
 	/**
 	 * Gets the JSON definition of the variant
 	 * @returns {object} the content of the variant
@@ -520,15 +415,6 @@ sap.ui.define([
 		}
 	};
 
-	Variant.prototype.getFullFileIdentifier = function () {
-		var sLayer = this.getLayer();
-		var sNamespace = this.getNamespace();
-		var sFileName = this.getDefinition().content.fileName;
-		var sFileType = this.getDefinition().content.fileType;
-
-		return sLayer + "/" + sNamespace + "/" + sFileName + "." + sFileType;
-	};
-
 	/**
 	 * Returns the revert specific data
 	 *

package/src/sap/ui/fl/apply/_internal/DelegateMediator.js

@@ -25,7 +25,7 @@ sap.ui.define([
 	 *
 	 * @private
 	 * @author SAP SE
-	 * @version 1.97.1
+	 * @version 1.100.0
 	 *
 	 * @experimental Since 1.80 This class is experimental and provides only limited functionality. Also the API might be
 	 *               changed in future.
@@ -303,4 +303,4 @@ sap.ui.define([
 	};
 
 	return DelegateMediator;
-}, /* bExport= */false);
+});