@sapui5/sap.ushell 1.120.7 → 1.121.0

package/src/main/js/sap/ushell/services/SpaceContent.js

@@ -2,7 +2,7 @@
 
 /**
  * @fileOverview APIs for the S/4 MyHome
- * @version 1.120.7
+ * @version 1.121.0
  */
 sap.ui.define([
     "sap/ushell/Config",
@@ -34,7 +34,7 @@ sap.ui.define([
      *
      * <b>Note:</b> To retrieve a valid instance of this service, it is necessary to call
      * <code>sap.ushell.Container.getServiceAsync("SpaceContent")</code>. For details, see
-     * {@link sap.ushell.services.Container#getServiceAsync}.
+     * {@link sap.ushell.Container#getServiceAsync}.
      *
      * @hideconstructor
      *
@@ -237,7 +237,7 @@ sap.ui.define([
      *
      * @param {object} vizData Data for a visualization
      *
-     * @returns {sap.ushell.ui.launchpad.VizInstance} A VizInstance control
+     * @returns {sap.ushell.ui.launchpad.VizInstanceBase} A VizInstance control
      *
      * @since 1.103.0
      *
@@ -294,7 +294,7 @@ sap.ui.define([
                         url: url,
                         appId: url
                     };
-                    sap.ushell.Container.getRenderer("fiori2").logRecentActivity(oRecentEntry);
+                    sap.ushell.Container.getRendererInternal("fiori2").logRecentActivity(oRecentEntry);
                 }
             }
 

package/src/main/js/sap/ushell/services/SupportTicket.js

@@ -15,7 +15,7 @@ sap.ui.define([
      *
      * <b>Note:</b> To retrieve a valid instance of this service, it is necessary to call
      * <code>sap.ushell.Container.getServiceAsync("SupportTicket")</code>. For details, see
-     * {@link sap.ushell.services.Container#getServiceAsync}.
+     * {@link sap.ushell.Container#getServiceAsync}.
      *
      * @param {object} oAdapter
      *            the service adapter for the support ticket service,
@@ -47,6 +47,7 @@ sap.ui.define([
      * Platform implementations can also enable it dynamically by modification of the
      * bootstrap configuration during boot time.
      *
+     * @augments sap.ushell.services.Service
      * @hideconstructor
      *
      * @since 1.19.1
@@ -63,9 +64,8 @@ sap.ui.define([
          *
          * @returns {Promise<string>} Promise, that returns the ID of the generated message
          *
-         * @public
-         * @alias sap.ushell.services.SupportTicket#createTicket
          * @since 1.20.0
+         * @public
          */
         this.createTicket = function (oSupportTicketData) {
             return oAdapter.createTicket(oSupportTicketData);
@@ -78,9 +78,8 @@ sap.ui.define([
          *
          * @returns {boolean} <code>true</code> if the service is enabled; <code>false</code> otherwise
          *
-         * @public
-         * @alias sap.ushell.services.SupportTicket#isEnabled
          * @since 1.20.0
+         * @public
          */
         this.isEnabled = function () {
             return Config.last("/core/extension/SupportTicket");

package/src/main/js/sap/ushell/services/UITracer.js

@@ -3,7 +3,7 @@
 /**
  * @fileOverview The Unified Shell's UI tracing service.
  *
- * @version 1.120.7
+ * @version 1.121.0
  */
 sap.ui.define([
     "sap/ushell/EventHub",
@@ -35,7 +35,7 @@ sap.ui.define([
      *
      * <b>Note:</b> To retrieve a valid instance of this service, it is necessary to call
      * <code>sap.ushell.Container.getServiceAsync("UITracer")</code>. For details, see
-     * {@link sap.ushell.services.Container#getServiceAsync}.
+     * {@link sap.ushell.Container#getServiceAsync}.
      *
      * <p>
      * Besides the trace method the UITracer listens to the EventHub event "UITracerService.trace"

package/src/main/js/sap/ushell/services/URLParsing.js

@@ -37,7 +37,7 @@ sap.ui.define([
      *
      * <b>Note:</b> To retrieve a valid instance of this service, it is necessary to call
      * <code>sap.ushell.Container.getServiceAsync("URLParsing")</code>. For details, see
-     * {@link sap.ushell.services.Container#getServiceAsync}.
+     * {@link sap.ushell.Container#getServiceAsync}.
      *
      * Methods in this class allow to break down a shell compliant hash into it's respective parts
      * (SemanticObject,Action,Context, Parameters, appSpecificHash) or (ShellPart,appSpecificHash) respectively
@@ -54,6 +54,7 @@ sap.ui.define([
      * behavior for non-compliant hashes is undefined and subject to change,
      * notably we do not aim do "degrade" nicely or support partial parsing of corrupted urls.
      *
+     * @augments sap.ushell.services.Service
      * @hideconstructor
      *
      * @since 1.15.0
@@ -85,9 +86,9 @@ sap.ui.define([
          * @param {string} sShellHashString a valid (Shell) url, e.g. <br/>
          *   <code>http://xx.b.c#Object-name~AFE2==?PV1=PV2&PV4=V5&/display/detail/7?UU=HH</code>
          * @returns {object} the parsed result
+         *
          * @since 1.16.0
          * @public
-         * @alias sap.ushell.services.URLParsing#getShellHash
          */
         this.getShellHash = function (sShellHashString) {
             return UrlParsingUtil.getShellHash(sShellHashString);
@@ -98,9 +99,9 @@ sap.ui.define([
          *
          * @param {string} sURL any value
          * @returns {string} <code>extracted string</code> if and only if a hash is present, undefined otherwise
+         *
          * @since 1.16.0
          * @public
-         * @alias sap.ushell.services.URLParsing#getHash
          */
         this.getHash = function (sURL) {
             return UrlParsingUtil.getHash(sURL);
@@ -120,9 +121,9 @@ sap.ui.define([
          *
          * @param {string} sUrl the URL to test. Note: this url must be in internal format.
          * @returns {boolean} true if the conditions are fulfilled.
+         *
          * @since 1.30.0
          * @public
-         * @alias sap.ushell.services.URLParsing#isIntentUrl
          * @deprecated since 1.96. Please use {@link #isIntentUrlAsync} instead.
          */
         this.isIntentUrl = function (sUrl) {
@@ -148,9 +149,9 @@ sap.ui.define([
          *
          * @param {string} sUrl the URL to test. Note: this url must be in internal format.
          * @returns {Promise<boolean>} true if the conditions are fulfilled.
+         *
          * @since 1.96.0
          * @public
-         * @alias sap.ushell.services.URLParsing#isIntentUrlAsync
          */
         this.isIntentUrlAsync = function (sUrl) {
             return UrlParsingUtil.isIntentUrlAsync(sUrl);
@@ -161,9 +162,9 @@ sap.ui.define([
          *
          * @param {string} sParams Parameter string, e.g. <code>?ABC=1&ABC=1%202DEF=4</code>
          * @returns {object} oParams, any value { ABC : ["1", "1 2DEF=4"]}
+         *
          * @since 1.20.0
          * @public
-         * @alias sap.ushell.services.URLParsing#parseParameters
          */
         this.parseParameters = function (sParams) {
             return UrlParsingUtil.parseParameters(sParams);
@@ -176,9 +177,9 @@ sap.ui.define([
          * @param {object} oParams any value { ABC : [1,"1 2"], DEF : ["4"]}
          * @returns {string} <code>ABC=1&ABC=1%202DEF=4</code>
          *   Note that the result is *not* prefixed with a "?", parameter values are encodeURIComponent encoded.
+         *
          * @since 1.20.0
          * @public
-         * @alias sap.ushell.services.URLParsing#paramsToString
          */
         this.paramsToString = function (oParams) {
             return UrlParsingUtil.paramsToString(oParams);
@@ -191,6 +192,7 @@ sap.ui.define([
          * @param {string} sDelimiter string to use as parameter delimiter (e.g., "&")
          * @param {string} sAssign string to use for parameter assignment (e.g., "=")
          * @returns {string} the result parameters
+         *
          * @since 1.34.0
          * @private
          */
@@ -215,9 +217,9 @@ sap.ui.define([
          *   }
          * </pre>
          *   Note that params always has an Array for each parameter value!
+         *
          * @since 1.16.0
          * @public
-         * @alias sap.ushell.services.URLParsing#parseShellHash
          */
         this.parseShellHash = function (sHash) {
             return UrlParsingUtil.parseShellHash(sHash);
@@ -226,9 +228,9 @@ sap.ui.define([
         /**
          * Internal function
          *
-         * @name privstripLeadingHash
          * @param {string} sHash Shell hash
          * @returns {string} the string without a leading #
+         *
          * @since 1.16.0
          * @private
          */
@@ -253,9 +255,9 @@ sap.ui.define([
          *   }
          * </pre> otherwise
          *   Note that params always has an Array for each parameter value!
+         *
          * @since 1.16.0
          * @public
-         * @alias sap.ushell.services.URLParsing#splitHash
          */
         this.splitHash = function (sHash) {
             return UrlParsingUtil.splitHash(sHash);
@@ -288,7 +290,6 @@ sap.ui.define([
          *
          * @since 1.16.0
          * @public
-         * @alias sap.ushell.services.URLParsing#constructShellHash
          */
         this.constructShellHash = function (oShellHash) {
             return UrlParsingUtil.constructShellHash(oShellHash);
@@ -345,11 +346,11 @@ sap.ui.define([
          *   if undefined or falsy the system of the current application is used
          * @returns {string} the service URL pointing to the system specified in parameter <code>vComponentOrSystem</code> or
          *   to the system of the current application
+         * @throws Error if the URL is not server-relative (e.g. <code>./something</code>, <code>http://foo.bar/something</code>, ...)
+         *
+         * @since 1.19.1 (passing an SAPUI5 component instance as second parameter is supported since version 1.32.0)
          * @public
-         * @alias sap.ushell.services.URLParsing#addSystemToServiceUrl
          * @deprecated since 1.31. Please use {@link sap.ui.model.odata.ODataUtils#setOrigin} instead.
-         * @since 1.19.1 (passing an SAPUI5 component instance as second parameter is supported since version 1.32.0)
-         * @throws Error if the URL is not server-relative (e.g. <code>./something</code>, <code>http://foo.bar/something</code>, ...)
          */
         this.addSystemToServiceUrl = function (sServiceUrl, vComponentOrSystem) {
             var sSystem = vComponentOrSystem;

package/src/main/js/sap/ushell/services/URLShortening.js

@@ -6,7 +6,7 @@
  * Service wrapper for the sap/ushell/utils/UrlShortening module.
  * @deprecated since 1.118. Please use the UrlShortening module directly.
  *
- * @version 1.120.7
+ * @version 1.121.0
  */
  sap.ui.define(["sap/ushell/utils/UrlShortening"], function (UrlShortening) {
     "use strict";

package/src/main/js/sap/ushell/services/URLTemplate.js

@@ -1,7 +1,7 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
 /**
  * @fileOverview The URLTemplate service provides utilities when working with URL templates
- * @version 1.120.7
+ * @version 1.121.0
  */
 sap.ui.define([
     "sap/ushell/utils",
@@ -19,7 +19,7 @@ sap.ui.define([
      *
      * <b>Note:</b> To retrieve a valid instance of this service, it is necessary to call
      * <code>sap.ushell.Container.getServiceAsync("URLTemplate")</code>. For details, see
-     * {@link sap.ushell.services.Container#getServiceAsync}.
+     * {@link sap.ushell.Container#getServiceAsync}.
      *
      * @hideconstructor
      *

package/src/main/js/sap/ushell/services/Ui5ComponentLoader.js

@@ -4,16 +4,19 @@
  * @fileOverview The Unified Shell's UI5 component loader service.
  * This is a shell-internal service and no public or application facing API!
  *
- * @version 1.120.7
+ * @version 1.121.0
  */
 sap.ui.define([
+    "sap/base/Log",
+    "sap/ui/core/Lib",
     "sap/ushell/Config",
     "sap/ushell/utils",
     "sap/ushell/services/Ui5ComponentHandle",
     "sap/ushell/services/_Ui5ComponentLoader/utils",
     "sap/ushell/EventHub",
-    "sap/ui/thirdparty/jquery"
-], function (Config, oUshellUtils, Ui5ComponentHandle, oUtils, oEventHub, jQuery) {
+    "sap/ui/thirdparty/jquery",
+    "sap/ui/thirdparty/URI"
+], function (Log, Library, Config, oUshellUtils, Ui5ComponentHandle, oUtils, oEventHub, jQuery, URI) {
     "use strict";
 
     /**
@@ -23,7 +26,7 @@ sap.ui.define([
      *
      * <b>Note:</b> To retrieve a valid instance of this service, it is necessary to call
      * <code>sap.ushell.Container.getServiceAsync("Ui5ComponentLoader")</code>. For details, see
-     * {@link sap.ushell.services.Container#getServiceAsync}.
+     * {@link sap.ushell.Container#getServiceAsync}.
      *
      * Note: This loader adds some hardcoded libraries (scaffolding) for the standard fiori packaging.
      * This can be turned off explicitly by setting the <code>loadDefaultDependencies</code>
@@ -59,7 +62,7 @@ sap.ui.define([
         this._oAdapter = oAdapter;
 
         /**
-         * Logger adding a trace an propagates the eror
+         * Logger adding a trace an propagates the error
          * @param {object} oComponentProperties The component properties
          * @param {object} vError The error to be logged
          * @returns {Promise} Promise that resolves with vError
@@ -104,11 +107,11 @@ sap.ui.define([
          *   see (CrossApplicationNavigation.createComponentInstance)
          * @param {object} oParsedShellHash The shell hash of the application that is to be opened already parsed via
          *   <code>sap.ushell.services.URLParsing#parseShellHash</code><code>sap.ushell.services.URLParsing#parseShellHash</code>.
-         * @param {array} aWaitForBeforeInstantiation An array of promises which delays the instantiation of
+         * @param {Promise[]} aWaitForBeforeInstantiation An array of promises which delays the instantiation of
          *   the Component class until those Promises are resolved.
          * @param {string} sUI5ComponentType Type used to define the type of loading a ui5component by FLP
          *   as defined ushellLibrary
-         * @returns {jQuery.Deferred.promise} a jQuery promise which resolves with the application properties object which is enriched
+         * @returns {jQuery.Promise} Resolves with the application properties object which is enriched
          *   with an <code>componentHandle<code> object that encapsulates the loaded component.
          *   If the UI5 core resources have been loaded completely as a result of this call
          *   (either customPreload is disabled or the core-ext-light.js module is loaded as part of this call or was already loaded),
@@ -142,9 +145,9 @@ sap.ui.define([
          *   see (CrossApplicationNavigation.createComponentInstance)
          * @param {object} oParsedShellHash The shell hash of the application that is to be opened already parsed via
          *   <code>sap.ushell.services.URLParsing#parseShellHash</code><code>sap.ushell.services.URLParsing#parseShellHash</code>.
-         * @param {array} aWaitForBeforeInstantiation An array of promises which delays the instantiation of
+         * @param {Promise[]} aWaitForBeforeInstantiation An array of promises which delays the instantiation of
          *   the Component class until those Promises are resolved.
-         * @returns {object} promise (component data)
+         * @returns {Promise} Resolves component data.
          * @private
          */
         this.createComponentData = function (oAppProperties, oParsedShellHash, aWaitForBeforeInstantiation) {
@@ -210,6 +213,40 @@ sap.ui.define([
                 oData.appPropertiesSafe = oAppPropertiesSafe;
                 oData.loadCoreExt = bLoadCoreExt;
 
+                //This code is for the Flexible UI team, to allow loading appliction with a specific manifest version:
+                // 1. first, we need to check if the "sap.ui.fl" is loaded
+                // 2. then we need to call special api provided by the FL team to give us the manifest
+                //    version to load based on the app id
+                // 3. last, we concatinate the version to the manifest url
+                if (typeof oComponentProperties.manifest === "string" && oComponentProperties.manifest.length > 0 && "sap.ui.fl" in Library.all()) {
+                    sap.ui.require(["sap/ui/fl/apply/api/FlexRuntimeInfoAPI"], (FlexRuntimeInfoAPI) => {
+                        try {
+                            let sNewVersion = FlexRuntimeInfoAPI.getFlexVersion({ reference: oComponentProperties.name });
+                            if (typeof sNewVersion === "string" && sNewVersion.length > 0) {
+                                let oManifestUrl = new URI(oComponentProperties.manifest);
+                                oManifestUrl.addQuery("version", sNewVersion);
+                                oComponentProperties.manifest = oManifestUrl.toString();
+                            }
+                            fnResolve(oData);
+                        } catch (ex) {
+                            //if exception occured in the process of getting the manifest version, continue without it so the component
+                            //can be created
+                            Log.error("Error when trying to get manifest version from 'sap.ui.fl.apply.api.FlexRuntimeInfoAPI'",
+                                ex,
+                                "sap.ushell.services.Ui5ComponentLoader");
+                            fnResolve(oData);
+                        }
+                    }, (ex) => {
+                        //if the "sap.ui.require" fails, we simply resolve in order to continue as is, so the component
+                        //will be created without the manifest version (to avoid empty UI)
+                        Log.error("Error when trying to load 'sap/ui/fl/apply/api/FlexRuntimeInfoAPI'",
+                            ex,
+                            "sap.ushell.services.Ui5ComponentLoader");
+                        fnResolve(oData);
+                    });
+                    return;
+                }
+
                 fnResolve(oData);
             });
         };
@@ -219,7 +256,7 @@ sap.ui.define([
          * (the result of a navigation target resolution).
          *
          * @param {object} oData Contains all application & component properties and data
-         * @returns {jQuery.Deferred.promise} a jQuery promise which resolves with the application properties object which is enriched
+         * @returns {jQuery.Promise} Resolves with the application properties object which is enriched
          *   with an <code>componentHandle<code> object that encapsulates the loaded component.
          *   If the UI5 core resources have been loaded completely as a result of this call
          *   (either customPreload is disabled or the core-ext-light.js module is loaded as part of this call or was already loaded),

package/src/main/js/sap/ushell/services/UsageAnalytics.js

@@ -1,6 +1,6 @@
 // Copyright (c) 2009-2023 SAP SE, All Rights Reserved
 
-/*
+/**
  * @deprecated since 1.120.0. The corresponding cloud service "SAP Web Analytics" has been retired,
  *  therefore this client-side service API cannot be used any longer.
  */
@@ -23,6 +23,11 @@ sap.ui.define([
      * @alias sap.ushell.services.UsageAnalytics
      * @class
      * @classdesc A UShell service for tracking business flows and user actions.
+     *
+     * <b>Note:</b> To retrieve a valid instance of this service, it is necessary to call
+     * <code>sap.ushell.Container.getServiceAsync("ClientSideTargetResolution")</code>. For details, see
+     * {@link sap.ushell.Container#getServiceAsync}.
+     *
      * The UsageAnalytics service exposes API for logging custom events and setting custom field values in the logged events.<br>
      * The data is sent via http and recorded on a server, whose URL is defined by the <code>baseUrl</code> service configuration property.<br>
      * The service configuration must also include the site ID from the <code>pubToken</code> attribute.<br>
@@ -39,13 +44,14 @@ sap.ui.define([
      * Each tracked event (either automatic or custom) is represented by a database row, that includes 10 custom attributes named custom1...custom10.<br>
      * Some of these values can be set using UsageAnalytics service API.<br>
      *
-     * @hideconstructor
-     *
      * @param {object} oContainerInterface The interface provided by the container
      * @param {object} sParameter Not used in this service
      * @param {object} oServiceProperties Service configuration
      *
-     * @see sap.ushell.services.Container#getServiceAsync
+     * @augments sap.ushell.services.Service
+     * @hideconstructor
+     *
+     * @see sap.ushell.Container#getServiceAsync
      * @since 1.32.0
      * @public
      * @deprecated since 1.120.0. The corresponding cloud service "SAP Web Analytics" has been retired,
@@ -70,7 +76,6 @@ sap.ui.define([
          *
          * @since 1.32.0
          * @public
-         * @alias sap.ushell.services.UsageAnalytics#setLegalText
          */
         this.setLegalText = function (sText) {
             sLegalText = sText;
@@ -83,10 +88,21 @@ sap.ui.define([
             }
         };
 
+        /**
+         * @returns {string} the legal text
+         *
+         * @private
+         */
         this.getLegalText = function () {
             return sLegalText;
         };
 
+        /**
+         * @param {boolean} bState whether tracking is enabled
+         * @returns {jQuery.Promise} Resolves once the changes have been saved
+         *
+         * @private
+         */
         this.setTrackUsageAnalytics = function (bState) {
             var oDeferred = jQuery.Deferred();
             var oUser = sap.ushell.Container.getUser();
@@ -188,9 +204,9 @@ sap.ui.define([
          *   c) Agreement text exists or <code>setUsageAnalyticsPermitted</code> is set to <code>false</code><br>
          *
          * @returns {boolean} A boolean value indicating whether the UsageAnalytics service is enabled
+         *
          * @since 1.32.0
          * @public
-         * @alias sap.ushell.services.UsageAnalytics#systemEnabled
          */
         this.systemEnabled = function () {
             if (!oServiceConfig.enabled || !oServiceConfig.pubToken || (this.isSetUsageAnalyticsPermitted() && !sLegalText)) {
@@ -214,9 +230,9 @@ sap.ui.define([
          *   b) The user property <code>trackUsageAnalytics</code> is set to <code>true</code><br>
          *
          * @returns {boolean} A boolean value indicating whether the user has specified to track activities
+         *
          * @since 1.32.0
          * @public
-         * @alias sap.ushell.services.UsageAnalytics#userEnabled
          */
         this.userEnabled = function () {
             var oUser = sap.ushell.Container.getUser();
@@ -288,9 +304,9 @@ sap.ui.define([
          *   the custom field custom6 gets the function that returns the string "value4",<br>
          *   the custom field custom7 gets a string "55".<br>
          *   Any property of oCustomFieldValues which is not in the range of attribute1...attribute6 is ignored.
+         *
          * @since 1.32.0
          * @public
-         * @alias sap.ushell.services.UsageAnalytics#setCustomAttributes
          */
         this.setCustomAttributes = function (oCustomFieldValues) {
             var index,
@@ -343,7 +359,7 @@ sap.ui.define([
          *
          * @param {string} eventType - Type of the event
          * @param {string} customEventValue - Primary value of the event
-         * @param {array} aAdditionalValues An array of zero to 9 strings. Any item above the 9th is ignored.
+         * @param {string[]} aAdditionalValues An array of zero to 9 strings. Any item above the 9th is ignored.
          * @since 1.32.0
          * @private
          */

package/src/main/js/sap/ushell/services/UserDefaultParameterPersistence.js

@@ -14,7 +14,7 @@
  *
  * This is *not* an application facing service, but for Shell Internal usage.
  *
- * @version 1.120.7
+ * @version 1.121.0
  */
 sap.ui.define([
     "sap/base/Log",
@@ -45,7 +45,7 @@ sap.ui.define([
      *
      * <b>Note:</b> To retrieve a valid instance of this service, it is necessary to call
      * <code>sap.ushell.Container.getServiceAsync("UserDefaultParameterPersistence")</code>. For details, see
-     * {@link sap.ushell.services.Container#getServiceAsync}.
+     * {@link sap.ushell.Container#getServiceAsync}.
      *
      * @param {object} oAdapter The service adapter for the UserDefaultParameterPersistence service, as already provided by the container
      * @param {object} oContainerInterface interface
@@ -79,8 +79,8 @@ sap.ui.define([
      * @param {object} [oSystemContext] The systemContext or undefined
      * @returns {Promise<object>} A promise resolving to a systemContext
      *
-     * @private
      * @since 1.81.0
+     * @private
      */
     UserDefaultParameterPersistence.prototype._getSystemContextPromise = function (oSystemContext) {
         if (!oSystemContext) {
@@ -99,8 +99,9 @@ sap.ui.define([
      *
      * @param {string} sParameterName parameter name to be loaded
      * @param {object} [oSystemContext] the used system context
-     * @returns {object} A jQuery promise, whose done handler receives as first argument a rich parameter object containing a value,
+     * @returns {jQuery.Promise} Resolves a rich parameter object containing a value,
      *   e.g. <code>{ value : "value" }</code>. Its fail handler receives a message string as first argument.
+     *
      * @since 1.32.0
      * @private
      */
@@ -140,11 +141,10 @@ sap.ui.define([
      * @param {string} sParameterName Parameter name
      * @param {object} oValueObject Parameter value object, contains at least <code>{ value :... }</code>
      * @param {object} [oSystemContext] The used system context
-     * @returns {object} A jQuery promise, whose done handler receives no parameters.
-     *   Its fail handler receives a message string as first argument.
+     * @returns {jQuery.Promise} Resolves once the parameter was saved or rejects with an error message.
+     *
      * @since 1.32.0
      * @public
-     * @alias sap.ushell.services.UserDefaultParameterPersistence#saveParameterValue
      */
     UserDefaultParameterPersistence.prototype.saveParameterValue = function (sParameterName, oValueObject, oSystemContext) {
         var oDeferred = new jQuery.Deferred();
@@ -188,11 +188,10 @@ sap.ui.define([
      *
      * @param {string} sParameterName Parameter name to be deleted
      * @param {object} [oSystemContext] The system context to be used
-     * @returns {object} A jQuery promise, whose done handler receives no parameters.
-     *   Its fail handler receives a message string as first argument.
+     * @returns {jQuery.Promise} Resolves once the parameter was deleted or rejects with an error message.
+     *
      * @since 1.32.0
      * @public
-     * @alias sap.ushell.services.UserDefaultParameterPersistence#deleteParameter
      */
     UserDefaultParameterPersistence.prototype.deleteParameter = function (sParameterName, oSystemContext) {
         var oDeferred = new jQuery.Deferred();
@@ -215,7 +214,8 @@ sap.ui.define([
      * Method to obtain an array of string containing all Stored parameter names
      *
      * @param {object} oSystemContext the system context to be used
-     * @returns {promise} A jQuery.Deferred whose first argument of resolve is an array of strings. The strings are sorted.
+     * @returns {jQuery.Promise} Resolves an array of sorted strings.
+     *
      * @since 1.32.0
      * @private
      */