@sapui5/sap.ushell 1.115.1 → 1.117.0

package/src/main/js/sap/ushell/renderers/fiori2/resources/resources_zh_CN.properties

@@ -186,6 +186,7 @@ SaveAsTileDialog.MessageBox.Title.Discard=\u653E\u5F03
 SaveAsTileDialog.MessageBox.Message.Discard=\u662F\u5426\u786E\u5B9A\u8981\u653E\u5F03\u64CD\u4F5C\uFF1F
 SaveAsTileDialog.MessageBox.SinglePageError=\u65E0\u6CD5\u5C06\u8BE5\u78C1\u8D34\u6DFB\u52A0\u5230\u9875\u9762\u3002
 SaveAsTileDialog.MessageBox.OnePageError=\u65E0\u6CD5\u5C06\u8BE5\u78C1\u8D34\u6DFB\u52A0\u5230\u5176\u4E2D\u4E00\u4E2A\u6240\u9009\u9875\u9762\u3002
+SaveAsTileDialog.MessageToast.ValidationFailed=\u7F3A\u5C11\u5FC5\u8981\u7684\u8F93\u5165\u3002\u8BF7\u68C0\u67E5\u3002
 SaveAsTileDialog.MessageBox.PageErrorDetail=\u78C1\u8D34\uFF1A{0}\n\u53D7\u5F71\u54CD\u7684\u9875\u9762\uFF1A{1}
 SaveAsTileDialog.MessageBox.AllPagesError=\u65E0\u6CD5\u5C06\u8BE5\u78C1\u8D34\u6DFB\u52A0\u5230\u6240\u9009\u9875\u9762\u3002
 SaveAsTileDialog.MessageBox.SomePagesError=\u65E0\u6CD5\u5C06\u8BE5\u78C1\u8D34\u6DFB\u52A0\u5230\u67D0\u4E9B\u6240\u9009\u9875\u9762\u3002
@@ -271,7 +272,6 @@ subtitleFld=\u526F\u6807\u9898\uFF1A
 previewFld=\u9884\u89C8\uFF1A
 toggleSelectionModeBtn=\u542F\u7528\u6216\u7981\u7528\u9009\u62E9\u6A21\u5F0F
 languageRegionFld=\u8BED\u8A00
-languageRegionTit=\u8BED\u8A00\u548C\u5730\u533A
 languageAndRegionTit=\u8BED\u8A00\u548C\u5730\u533A
 dateFormatFld=\u65E5\u671F\u683C\u5F0F
 timeFormatFld=\u65F6\u95F4\u683C\u5F0F
@@ -732,6 +732,7 @@ UserAccountFld=\u7528\u6237\u8D26\u6237
 UserAccountServerFld=\u670D\u52A1\u5668
 UserAccountEmailFld=\u7535\u5B50\u90AE\u4EF6
 UserAccountNameFld=\u540D\u79F0
+UserAccountIdFld=\u7528\u6237\u6807\u8BC6
 userAccountPersonalizationLabel=\u4E2A\u6027\u5316\u8BBE\u7F6E
 userAccountResetPersonalizationButton=\u91CD\u7F6E\u6240\u6709\u4E2A\u6027\u5316\u8BBE\u7F6E
 userAccountResetPersonalizationDescriptionText=\u91CD\u7F6E\u5FEB\u901F\u542F\u52A8\u677F\uFF08\u5982\u4E3B\u9898\u3001\u8BED\u8A00\u3001\u7528\u6237\u6D3B\u52A8\u548C\u4E3B\u9875\u5185\u5BB9\uFF09\u7684\u4E2A\u6027\u5316\u8BBE\u7F6E\u3002
@@ -976,5 +977,6 @@ NavigationBarMenu.Button.UnpinAll.Tooltip=\u53D6\u6D88\u56FA\u5B9A\u6240\u6709\u
 NavigationBarMenu.PinnedSpaces.NoDataText=\u5C06\u6240\u6536\u85CF\u7684\u7A7A\u95F4\u56FA\u5B9A\u5230\u5BFC\u822A\u680F\u3002
 NavigationBarMenu.AllSpaces.NoDataText=\u6CA1\u6709\u7ED9\u60A8\u5206\u914D\u4EFB\u4F55\u7A7A\u95F4\u3002
 NavigationBarMenu.Button.OpenPopover=\u4E2A\u6027\u5316\u8BBE\u7F6E\u5BFC\u822A\u680F
+NavigationBarMenu.PinnedSpaces.Moved=Pinned Space moved
 
 SysInfoBarAriaLabel=\u7CFB\u7EDF\u4FE1\u606F\u680F - {0} {1}

package/src/main/js/sap/ushell/renderers/fiori2/resources/resources_zh_TW.properties

@@ -186,6 +186,7 @@ SaveAsTileDialog.MessageBox.Title.Discard=\u6368\u68C4
 SaveAsTileDialog.MessageBox.Message.Discard=\u60A8\u78BA\u5B9A\u8981\u6368\u68C4\u52D5\u4F5C\u55CE\uFF1F
 SaveAsTileDialog.MessageBox.SinglePageError=\u7121\u6CD5\u5C07\u529F\u80FD\u78DA\u65B0\u589E\u81F3\u9801\u9762\u3002
 SaveAsTileDialog.MessageBox.OnePageError=\u7121\u6CD5\u5C07\u529F\u80FD\u78DA\u65B0\u589E\u81F3\u60A8\u6240\u9078\u7684\u5176\u4E2D\u4E00\u500B\u9801\u9762\u3002
+SaveAsTileDialog.MessageToast.ValidationFailed=\u7F3A\u5C11\u6240\u9700\u8F38\u5165\u9805\uFF0C\u8ACB\u6AA2\u67E5\u3002
 SaveAsTileDialog.MessageBox.PageErrorDetail=\u529F\u80FD\u78DA\uFF1A{0}\n\u53D7\u5F71\u97FF\u7684\u9801\u9762\uFF1A{1}
 SaveAsTileDialog.MessageBox.AllPagesError=\u7121\u6CD5\u5C07\u529F\u80FD\u78DA\u65B0\u589E\u81F3\u60A8\u6240\u9078\u7684\u9801\u9762\u3002
 SaveAsTileDialog.MessageBox.SomePagesError=\u7121\u6CD5\u5C07\u529F\u80FD\u78DA\u65B0\u589E\u81F3\u60A8\u6240\u9078\u7684\u67D0\u4E9B\u9801\u9762\u3002
@@ -271,7 +272,6 @@ subtitleFld=\u5B50\u6A19\u984C\uFF1A
 previewFld=\u9810\u89BD\uFF1A
 toggleSelectionModeBtn=\u555F\u7528\u6216\u505C\u7528\u9078\u64C7\u6A21\u5F0F
 languageRegionFld=\u8A9E\u8A00
-languageRegionTit=\u8A9E\u8A00\u548C\u5730\u5340
 languageAndRegionTit=\u8A9E\u8A00\u548C\u5730\u5340
 dateFormatFld=\u65E5\u671F\u683C\u5F0F
 timeFormatFld=\u6642\u9593\u683C\u5F0F
@@ -732,6 +732,7 @@ UserAccountFld=\u4F7F\u7528\u8005\u5E33\u6236
 UserAccountServerFld=\u4F3A\u670D\u5668
 UserAccountEmailFld=\u96FB\u5B50\u90F5\u4EF6
 UserAccountNameFld=\u540D\u7A31
+UserAccountIdFld=\u4F7F\u7528\u8005 ID
 userAccountPersonalizationLabel=\u500B\u4EBA\u5316
 userAccountResetPersonalizationButton=\u91CD\u8A2D\u6240\u6709\u500B\u4EBA\u5316
 userAccountResetPersonalizationDescriptionText=\u91CD\u8A2D\u555F\u52D5\u53F0\u7684\u500B\u4EBA\u5316\u8A2D\u5B9A (\u4F8B\u5982\u4E3B\u984C\u3001\u8A9E\u8A00\u3001\u4F7F\u7528\u8005\u6D3B\u52D5\u548C\u9996\u9801\u5167\u5BB9)\u3002
@@ -976,5 +977,6 @@ NavigationBarMenu.Button.UnpinAll.Tooltip=\u53D6\u6D88\u56FA\u5B9A\u6240\u6709\u
 NavigationBarMenu.PinnedSpaces.NoDataText=\u5C07\u60A8\u7684\u6700\u611B\u7A7A\u9593\u56FA\u5B9A\u81F3\u700F\u89BD\u5217\u3002
 NavigationBarMenu.AllSpaces.NoDataText=\u672A\u5C07\u7A7A\u9593\u6307\u6D3E\u7D66\u60A8\u3002
 NavigationBarMenu.Button.OpenPopover=\u500B\u4EBA\u5316\u700F\u89BD\u5217
+NavigationBarMenu.PinnedSpaces.Moved=Pinned Space moved
 
 SysInfoBarAriaLabel=\u7CFB\u7D71\u8CC7\u8A0A\u5217 - {0} {1}

package/src/main/js/sap/ushell/renderers/fiori2/search/searchComponent/manifest.json

@@ -3,7 +3,7 @@
     "sap.app": {
         "id": "sap.ushell.renderers.fiori2.search.searchComponent",
         "applicationVersion": {
-            "version": "1.115.1"
+            "version": "1.117.0"
         },
         "type": "component"
     },

package/src/main/js/sap/ushell/renderers/fiori2/utils.js

@@ -0,0 +1,28 @@
+// Copyright (c) 2009-2023 SAP SE, All Rights Reserved
+
+sap.ui.define([
+    "sap/ushell/EventHub",
+    "sap/ui/core/Core"
+], function (
+    EventHub,
+    Core
+) {
+    "use strict";
+
+    function _init (oController) {
+        setTimeout(function () {
+            Core.getEventBus().publish("sap.ushell", "rendererLoaded", { rendererName: "fiori2" });
+        }, 0);
+        EventHub.emit("RendererLoaded", { rendererName: "fiori2" });
+    }
+    function _publishExternalEvent (sEventName, oData) {
+        setTimeout(function () {
+            Core.getEventBus().publish("sap.ushell.renderers.fiori2.Renderer", sEventName, oData);
+        }, 0);
+    }
+
+    return {
+        publishExternalEvent: _publishExternalEvent,
+        init: _init
+    };
+});

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

@@ -13,7 +13,8 @@ sap.ui.define([
     "sap/ushell/EventHub",
     "sap/ushell/resources",
     "sap/ushell/utils/UrlParsing",
-    "sap/ushell/utils"
+    "sap/ushell/utils",
+    "sap/ushell/Config"
 ], function (
     ResourceBundle,
     Log,
@@ -27,7 +28,8 @@ sap.ui.define([
     EventHub,
     resources,
     UrlParsing,
-    utils
+    utils,
+    Config
 ) {
     "use strict";
 
@@ -533,6 +535,7 @@ sap.ui.define([
                             }
                             oMetadata[sKey].version = oLocalMetadataComponent.getVersion();
                             oMetadata[sKey].technicalName = oLocalMetadataComponent.getComponentName();
+                            this._setTitleFromNavResult(oMetadata[sKey], oApplication);
                         } else if (utils.isApplicationTypeEmbeddedInIframe(oApplication.applicationType)) {
                             var sWdaApplicationUrlString = "/~canvas;window=app/wda/",
                                 iIndexOfWdaApplicationUrlString = oApplication.url.indexOf(sWdaApplicationUrlString),
@@ -617,6 +620,25 @@ sap.ui.define([
                 Log.warning("Application configuration could not be parsed");
             }
         };
+
+        /**
+         * Helper function to override the title of the manifest
+         * with the title from the navigation result (target mapping).
+         * This is done for "generic" UI5 apps which have a concrete specialization
+         * in the FLP content with a specific title.
+         *
+         * @param {object} oMetadataEntry - the metadata for a specific app
+         * @param {object} oApplication - the application data retrieved from the
+         *  navigation target resolution
+         */
+        this._setTitleFromNavResult = function (oMetadataEntry, oApplication) {
+            var sNavTargetResolutionTitle = oApplication && oApplication.text;
+            var sUi5ComponentName = oMetadataEntry.technicalName;
+            var aUseAppTitleFromNavTargetResolutionConfig = Config.last("/core/shell/useAppTitleFromNavTargetResolution") || [];
+            if (sNavTargetResolutionTitle && aUseAppTitleFromNavTargetResolutionConfig.includes(sUi5ComponentName)) {
+                oMetadataEntry.title = sNavTargetResolutionTitle;
+            }
+        };
     } // Metadata
 
     /**

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

@@ -3,7 +3,7 @@
  * @fileOverview The Unified Shell's AppLifeCycle service enables plug-ins to enquire the which
  *    application is currently displayed and listen to life cycle events.
  *
- * @version 1.115.1
+ * @version 1.117.0
  */
 sap.ui.define([
     "sap/base/Log",
@@ -15,7 +15,9 @@ sap.ui.define([
     "sap/ushell/TechnicalParameters",
     "sap/ui/core/Component",
     "sap/ushell/services/AppConfiguration",
-    "sap/ushell/utils/UrlParsing"
+    "sap/ushell/utils/UrlParsing",
+    "sap/ui/thirdparty/URI",
+    "sap/ushell/Config"
 ], function (
     Log,
     EventProvider,
@@ -26,7 +28,9 @@ sap.ui.define([
     TechnicalParameters,
     Component,
     AppConfiguration,
-    UrlParsing
+    UrlParsing,
+    URI,
+    Config
 ) {
     "use strict";
 
@@ -34,13 +38,13 @@ sap.ui.define([
 
     /**
      * @alias sap.ushell.services.AppLifeCycle
+     * @class
      * @classdesc The Unified Shell's AppLifeCycle service.
      *
      * <b>Please note:</b> To retrieve a valid instance of this service you must call
      * <code>sap.ushell.Container.getServiceAsync("AppLifeCycle")</code>. For details see
      * {@link sap.ushell.services.Container#getServiceAsync}.
      *
-     * @constructor
      * @hideconstructor
      *
      * @param {object} oAdapter not used
@@ -63,6 +67,9 @@ sap.ui.define([
          * The function returns an object with following parameters:
          * <ul>
          *   <li> applicationType: “UI5|WDA|NWBC|URL|TR” </li>
+         *   <li> applicationFramework: when applicationType is "URL", this parameter indicates which application framework
+         *        is running inside the iframe - “UI5|WDA|GUI|CRM”.
+         *        This attribute is for SAP internal usage only. </li>
          *   <li> componentInstance: reference to component (only for applicationType "UI5"). </li>
          *   <li> homePage: <code>true</code> when root intent (normally #Shell-home) or Appfinder (#Shell-appfinder) is currently displayed. </li>
          *   <li> getTechnicalParameter: <code>function</code> that returns the value of a technical parameter for the given application.
@@ -148,12 +155,13 @@ sap.ui.define([
          * @param {object} oComponentInstance The instance of the component.
          * @param {boolean} bHomePage Indicator for a home page.
          * @param {string} oApplicationContainer The application container.
+         * @param {string} sFramework The type of the current application running in iframe.
          *
          * @since 1.82
          * @private
          */
-        this.prepareCurrentAppObject = function (sApplicationType, oComponentInstance, bHomePage, oApplicationContainer) {
-            setCurrentApplicationObject(sApplicationType, oComponentInstance, bHomePage, oApplicationContainer);
+        this.prepareCurrentAppObject = function (sApplicationType, oComponentInstance, bHomePage, oApplicationContainer, sFramework) {
+            setCurrentApplicationObject(sApplicationType, oComponentInstance, bHomePage, oApplicationContainer, sFramework);
         };
 
         /**
@@ -173,13 +181,13 @@ sap.ui.define([
 
         this.setAppInfo = function (oAppInfo, bIsNewApp) {
             AppInfoParameters.setCustomAttributes(oAppInfo);
-            sap.ushell.Container.getServiceAsync("MessageBroker").then(function (oMessageBrokerService) {
-                if (oMessageBrokerService.isEnabled()) {
+            if (Config.last("/core/shell/enableMessageBroker")) {
+                sap.ushell.Container.getServiceAsync("MessageBroker").then(function (oMessageBrokerService) {
                     oCurrentApplication.getAllAppInfo(true).then(function (data) {
                         oMessageBrokerService.publish("flp-app-info", "FLP", Date.now().toString(), (bIsNewApp === true ? "new-app-info" : "app-info-update"), "*", data);
                     });
-                }
-            });
+                });
+            }
         };
 
         function handleMessageBrokerIncommingMessage (oMessageBrokerService, sClientId, sChannelId, sMessageName, data) {
@@ -192,8 +200,8 @@ sap.ui.define([
 
         // CONSTRUCTOR CODE //
         if (window.QUnit === undefined && sap.ushell.Container.inAppRuntime() === false) {
-            sap.ushell.Container.getServiceAsync("MessageBroker").then(function (oMessageBrokerService) {
-                if (oMessageBrokerService.isEnabled()) {
+            if (Config.last("/core/shell/enableMessageBroker")) {
+                sap.ushell.Container.getServiceAsync("MessageBroker").then(function (oMessageBrokerService) {
                     oMessageBrokerService.subscribe(
                         "FLP",
                         [{
@@ -203,11 +211,11 @@ sap.ui.define([
                         handleMessageBrokerIncommingMessage.bind(undefined, oMessageBrokerService),
                         function () {}
                     );
-                }
-            });
+                });
+            }
         }
         oEventProvider = new EventProvider();
-        if (sap.ushell.Container.inAppRuntime() === false) {
+        if (sap.ushell.Container && sap.ushell.Container.inAppRuntime() === false) {
             if (sap.ushell.Container.getRenderer()) {
                 registerToNavigationEvent();
             } else {
@@ -287,15 +295,29 @@ sap.ui.define([
             });
         }
 
-        function getAppIntent () {
-            var sHash = hasher.getHash();
+        function getAppIntent (bRealAppIntent) {
+            var sHash = hasher.getHash(),
+                oParsedHash;
             if (!sHash) {
                 return Promise.reject("Could not identify current application hash");
             }
 
             var oService = sap.ushell.Container.getServiceAsync("URLParsing");
             return oService.then(function (oParsingService) {
-                return oParsingService.parseShellHash(sHash);
+                oParsedHash = oParsingService.parseShellHash(sHash);
+                if (bRealAppIntent === true && oCurrentApplicationContainer && typeof oCurrentApplicationContainer.getCurrentAppUrl === "function") {
+                    var sAppUrl = oCurrentApplicationContainer.getCurrentAppUrl();
+                    if (sAppUrl) {
+                        var oUriParams = new URI(sAppUrl).search(true);
+                        if (oUriParams.hasOwnProperty("sap-remote-intent")) {
+                            oParsedHash.semanticObject = oUriParams["sap-remote-intent"].split("-")[0];
+                            oParsedHash.action = oUriParams["sap-remote-intent"].split("-")[1];
+                            delete oParsedHash.params["sap-shell-so"];
+                            delete oParsedHash.params["sap-shell-action"];
+                        }
+                    }
+                }
+                return oParsedHash;
             });
         }
 
@@ -306,11 +328,18 @@ sap.ui.define([
         }
 
 
-        function setCurrentApplicationObject (sApplicationType, oComponentInstance, bHomePage, oApplicationContainer) {
+        function setCurrentApplicationObject (sApplicationType, oComponentInstance, bHomePage, oApplicationContainer, sFramework) {
+            if (!sFramework) {
+                sFramework = oApplicationContainer &&
+                    typeof oApplicationContainer.getFrameworkId === "function" &&
+                    oApplicationContainer.getFrameworkId() || "";
+            }
+
             cleanAppInfo();
             oCurrentApplicationContainer = oApplicationContainer;
             oCurrentApplication = {
                 applicationType: sApplicationType,
+                applicationFramework: sFramework,
                 componentInstance: oComponentInstance,
                 homePage: bHomePage,
                 getTechnicalParameter: function (sParameterName) {
@@ -379,13 +408,13 @@ sap.ui.define([
             setTimeout(function () {
                 oEventProvider.fireEvent(S_APP_LOADED_EVENT, oCurrentApplication);
                 if (window.QUnit === undefined && sap.ushell.Container.inAppRuntime() === false) {
-                    sap.ushell.Container.getServiceAsync("MessageBroker").then(function (oMessageBrokerService) {
-                        if (oMessageBrokerService.isEnabled()) {
+                    if (Config.last("/core/shell/enableMessageBroker")) {
+                        sap.ushell.Container.getServiceAsync("MessageBroker").then(function (oMessageBrokerService) {
                             oCurrentApplication.getAllAppInfo(true).then(function (data) {
                                 oMessageBrokerService.publish("flp-app-info", "FLP", Date.now().toString(), "new-app-info", "*", data);
                             });
-                        }
-                    });
+                        });
+                    }
                 }
             }, 0);
 

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

@@ -6,16 +6,16 @@
  * This is *not* an application facing service, but for Shell Internal usage.
  * This service should be accessed by the application via the CrossApplicationNavigation service.
  *
- * @version 1.115.1
+ * @version 1.117.0
  */
 sap.ui.define([
     "sap/ui/base/Object",
     "sap/ui/thirdparty/jquery",
-    "sap/ushell/services/_AppState/AppState",
-    "sap/ushell/services/_AppState/AppStatePersistencyMethod",
-    "sap/ushell/services/_AppState/Sequentializer",
-    "sap/ushell/services/_AppState/SequentializingAdapter",
-    "sap/ushell/services/_AppState/WindowAdapter",
+    "sap/ushell/services/appstate/AppState",
+    "sap/ushell/services/appstate/AppStatePersistencyMethod",
+    "sap/ushell/services/appstate/Sequentializer",
+    "sap/ushell/services/appstate/SequentializingAdapter",
+    "sap/ushell/services/appstate/WindowAdapter",
     "sap/ushell/utils"
 ], function (
     BaseObject,
@@ -192,7 +192,7 @@ sap.ui.define([
      *
      * @param {object} oComponent A SAP UI5 Component, mandatory. An initial object is returned.
      * @param {boolean} bTransientEnforced If set to <code>true</code> the appstate is not persisted on the backend.
-     * @param {string} sPersistencyMethod See sap/ushell/services/_AppState/AppStatePersistencyMethod for possible values.
+     * @param {string} sPersistencyMethod See sap/ushell/services/appstate/AppStatePersistencyMethod for possible values.
      *        Support depends on the used platform.
      * @param {object} oPersistencySettings Persistency Settings.
      *   it is only used during generating a new internal appstate during target resolution
@@ -514,6 +514,18 @@ sap.ui.define([
 
         return oDeferred.promise();
     };
+    /**
+     * Method to check if app state need to be persistent regardless of the system default setting
+     *
+     * @returns {boolean} true if app state need to be persistent or through if not
+     * @since 1.71.0
+     * @private
+     *
+     */
+    AppState.prototype.getPersistentWhenShared = function () {
+        // eslint-disable-next-line no-unneeded-ternary
+        return (this._oConfig && (this._oConfig.persistentWhenShared === true)) ? true : false;
+    };
 
     AppState.WindowAdapter = WindowAdapter;
 

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

@@ -4,7 +4,7 @@
  * @fileOverview The Unified Shell's bookmark service, which allows you to create shortcuts on the
  * user's home page.
  *
- * @version 1.115.1
+ * @version 1.117.0
  */
 sap.ui.define([
     "sap/ui/thirdparty/jquery",
@@ -31,6 +31,7 @@ sap.ui.define([
 
     /**
      * @alias sap.ushell.services.Bookmark
+     * @class
      * @classdesc The Unified Shell's bookmark service, which allows you to create shortcuts on the
      * user's home page.
      *
@@ -38,7 +39,6 @@ sap.ui.define([
      * <code>sap.ushell.Container.getServiceAsync("Bookmark")</code>. For details see
      * {@link sap.ushell.services.Container#getServiceAsync}.
      *
-     * @constructor
      * @hideconstructor
      *
      * @since 1.15.0
@@ -95,10 +95,10 @@ sap.ui.define([
         };
 
         /**
-         * Adds a bookmark tile to one of the user's classic homepage groups or to multiple provided content nodes.
+         * Adds a bookmark tile to one of the user's classic home page groups or to multiple provided content nodes.
          *
          * @param {object} oParameters
-         *   Bookmark parameters. In addition to title and URL, a bookmark might allow additional
+         *   Bookmark parameters. In addition to title and URL, a bookmark might allow further
          *   settings, such as an icon or a subtitle. Which settings are supported depends
          *   on the environment in which the application is running. Unsupported parameters will be
          *   ignored.
@@ -106,8 +106,8 @@ sap.ui.define([
          * @param {string} oParameters.title
          *   The title of the bookmark.
          * @param {string} oParameters.url
-         *   The target URL or intent of the bookmark. If the target application shall run in the current shell, the URL has
-         *   to be a valid intent, i.e. in the format like <code>"#SO-Action?P1=a&P2=x&/route?RPV=1"</code>.
+         *   The target intent or URL of the bookmark. If the target app runs in the current shell, the URL has
+         *   to be a valid intent, i.e. in the format <code>"#SO-Action?P1=a&P2=x&/route?RPV=1"</code>.
          * @param {string} [oParameters.icon]
          *   The optional icon URL of the bookmark (e.g. <code>"sap-icon://home"</code>).
          * @param {string} [oParameters.info]
@@ -117,21 +117,55 @@ sap.ui.define([
          * @param {string} [oParameters.serviceUrl]
          *   The URL to a REST or OData service that provides some dynamic information for the
          *   bookmark.
+         *
+         *   <b>Semantic Date Ranges:</b>
+         *
+         *   You can use placeholders for dynamic dates in the query parameters of the service URL.
+         *   This can be used to create KPI tiles based on user entries in control {@link sap.m.DynamicDateRange},
+         *   where it is possible to specify dynamic dates like YESTERDAY or THISYEAR.
+         *
+         *   The placeholder format looks like this: {Edm.&lt;type&gt;%%DynamicDate.&lt;operator&gt;.&lt;value1&gt;.&lt;value2&gt;.&lt;position&gt;%%}
+         *
+         *   <ul>
+         *     <li>&lt;type&gt;: The Edm Type of the parameter. Supported types are String, DateTime and DateTimeOffset for OData V2
+         *         and Date and DateTimeOffset for OData V4.</li>
+         *     <li>&lt;operator&gt;, &lt;value1&gt;, &lt;value2&gt;: Possible values are the ones that can be used in {@link sap.m.DynamicDateRange#toDates} to create a date range.</li>
+         *     <li>&lt;position&gt;: Possible values are 'start' and 'end' which mark the start or end of the interval specified by the operator.</li>
+         *   </ul>
+         *
+         *   Examples:
+         *   <ul>
+         *     <li>/a/url/$count?$filter=(testDate ge {Edm.DateTimeOffset%DynamicDate.YESTERDAY.start%} and testDate le {Edm.DateTimeOffset%DynamicDate.YESTERDAY.end%})</li>
+         *     <li>/a/url/$count?$filter=(testDate ge {Edm.DateTime%DynamicDate.THISYEAR.start%} and testDate le {Edm.DateTime%DynamicDate.THISYEAR.end%})</li>
+         *     <li>/a/url/$count?$filter=(testDate ge {Edm.Date%DynamicDate.TODAYFROMTO.1.5.start%} and testDate le {Edm.Date%DynamicDate.TODAYFROMTO.1.5.end%})</li>
+         *   </ul>
+         *
+         *   Hint:
+         *   Check the debug log when displaying the resulting KPI tiles to get more information about the resolution of the placeholders.
          * @param {object} [oParameters.dataSource]
          *   Metadata for parameter serviceUrl. Mandatory to specify if parameter serviceURL contains semantic date ranges.
          *   This does not influence the data source of the app itself.
-         * @param {string} [oParameters.dataSource.type]
-         *   The type of the serviceURL's service. Only "OData" is supported.
-         * @param {object} [oParameters.dataSource.settings]
-         *   Additional settings for the data source.
-         * @param {object} [oParameters.dataSource.settings.odataVersion]
-         *   The OData version of parameter serviceURL. Valid values are "2.0" and "4.0".
+         *
+         *   Specify the data source as follows:
+         *   <pre>
+         *   {
+         *       type: "OData",
+         *       settings: {
+         *           odataVersion: "4.0"
+         *       }
+         *   }
+         *   </pre>
+         *
+         *   <ul>
+         *     <li>type: The type of the serviceURL's service. Only "OData" is supported.
+         *     <li>odataVersion: The OData version of parameter serviceURL. Valid values are "2.0" and "4.0".
+         *   </ul>
          * @param {string} [oParameters.serviceRefreshInterval]
          *   The refresh interval for the <code>serviceUrl</code> in seconds.
          * @param {string} [oParameters.numberUnit]
          *   The unit for the number retrieved from <code>serviceUrl</code>.
          * @param {object|sap.ushell.services.Bookmark.ContentNode|sap.ushell.services.Bookmark.ContentNode[]} [vContainer]
-         *   Either a legacy launchpad home page group, one content node or an array of content nodes. (See {@link #getContentNodes})
+         *   Either a legacy launchpad home page group, one content node or an array of content nodes (see {@link #getContentNodes}).
          *   If not provided, the bookmark will be added to the default group if spaces mode is not active
          *   or to the default page if spaces mode is active.
          * @param {string} [sContentProviderId] The contentProviderId or undefined outside the cFLP
@@ -271,7 +305,7 @@ sap.ui.define([
         };
 
         /**
-         * Adds a bookmark tile to one of the user's home page groups in the classic homepage mode.
+         * Adds a bookmark tile to one of the user's home page groups in the classic home page mode.
          *
          * @param {object} oParameters
          *   bookmark parameters. In addition to title and URL, a bookmark might allow additional
@@ -307,7 +341,7 @@ sap.ui.define([
          *
          * @returns {Promise}
          *   A promise which resolves on success, but rejects
-         *   with a reason-message on failure to add the bookmark to the specified homepage group.
+         *   with a reason-message on failure to add the bookmark to the specified home page group.
          *
          * @see sap.ushell.services.URLParsing#getShellHash
          * @since 1.81.0
@@ -388,9 +422,9 @@ sap.ui.define([
          * @alias sap.ushell.services.Bookmark#addBookmarkToPage
          */
         this.addBookmarkToPage = function (oParameters, sPageId, sContentProviderId) {
-            // Reject of in launchpad homepage mode
+            // Reject of in launchpad home page mode
             if (!Config.last("/core/spaces/enabled")) {
-                return Promise.reject("Bookmark Service: 'addBookmarkToPage' is not valid in launchpad homepage mode, use 'addBookmark' instead.");
+                return Promise.reject("Bookmark Service: 'addBookmarkToPage' is not valid in launchpad home page mode, use 'addBookmark' instead.");
             }
 
             // Reject if personalization is disabled
@@ -1083,7 +1117,7 @@ sap.ui.define([
         /**
          * @typedef {object} sap.ushell.services.Bookmark.ContentNode
          *  A content node may be:
-         *   - a classic homepage group
+         *   - a classic home page group
          *   - an unselectable node (space) or a selectable node (page) in spaces mode
          *   - or any other containers in the future
          *
@@ -1096,11 +1130,11 @@ sap.ui.define([
          */
 
         /**
-         * Returns available content nodes based on the current launchpad context. (Classic homepage, spaces mode)
+         * Returns available content nodes based on the current launchpad context. (Classic home page, spaces mode)
          *
          * A content node may be:
          * <ul>
-         * <li>a classic homepage group</li>
+         * <li>a classic home page group</li>
          * <li>an unselectable node (space) or a selectable node (page) in spaces mode</li>
          * <li>or any other containers in the future</li>
          * </ul>
@@ -1129,7 +1163,7 @@ sap.ui.define([
                     });
             }
 
-            // Classic homepage
+            // Classic home page
             return new Promise(function (resolve, reject) {
                 this._oLaunchPageServicePromise
                     .then(function (LaunchPageService) {

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

@@ -29,7 +29,7 @@
  * In the future, the custom resolver mechanism should be probably moved towards modifying (or only adding to the list of Inbounds),
  * this way a single data source has to be altered to support consistently getLinks, isIntentSupported.
  *
- * @version 1.115.1
+ * @version 1.117.0
  */
 sap.ui.define([
     "sap/base/Log",

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

@@ -2,7 +2,7 @@
 
 /**
  * @file Exposes a CommonDataModel based site document in a platform neutral format to it's clients
- * @version 1.115.1
+ * @version 1.117.0
  */
 sap.ui.define([
     "sap/ushell/services/_CommonDataModel/PersonalizationProcessor",

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

@@ -4,7 +4,7 @@
  * @fileOverview The Unified Shell's Configuration service enables Components of any kind to consume parts of Configuration
  * provided by the shell. It allows to attach on updates and receive the current values
  *
- * @version 1.115.1
+ * @version 1.117.0
  */
 sap.ui.define([
     "sap/ushell/Config",

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

@@ -3,7 +3,7 @@
 /**
  * @fileOverview The Unified Shell's Configuration Defaults service exposes default configurations set in the code base.
  *
- * @version 1.115.1
+ * @version 1.117.0
  */
 sap.ui.define([
     "sap/base/Log",

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

@@ -4,7 +4,7 @@
  * default adapter.
  * Once instantiated, returns a map of adapters to be used by the LaunchPage Service
  *
- * @version 1.115.1
+ * @version 1.117.0
  */
 sap.ui.define([
     "sap/ushell/Config",

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

@@ -5,7 +5,7 @@
  * This file exposes an API to perform (invoke) Cross Application Navigation for applications.
  * It exposes interfaces to perform a hash change and/or trigger an external navigation.
  *
- * @version 1.115.1
+ * @version 1.117.0
  */
 sap.ui.define([
     "sap/ushell/services/AppConfiguration",
@@ -48,6 +48,7 @@ sap.ui.define([
 
     /**
      * @alias sap.ushell.services.CrossApplicationNavigation
+     * @class
      * @classdesc The Unified Shell's CrossApplicationNavigation service allows to navigate to "external" targets outside of the currently running app (but still in scope
      * of the current Fiori launchpad) or create links to such external targets.
      *
@@ -106,7 +107,6 @@ sap.ui.define([
      * @param {string} sParameters The parameters.
      * @param {object} oServiceConf Service Configuration.
      *
-     * @constructor
      * @hideconstructor
      *
      * @see sap.ushell.services.Container#getServiceAsync
@@ -2005,7 +2005,7 @@ sap.ui.define([
          * @param {object} oAppComponent A UI5 component used as context for the app state.
          * @param {boolean} bTransientEnforced If set to <code>true</code> the appstate is not persisted on the backend. If set to
          *        <code>false</code> or <code>undefined</code> the persistency location is determined by the global ushell configuration.
-         * @param {string} sPersistencyMethod See sap/ushell/services/_AppState/AppStatePersistencyMethod for possible values.
+         * @param {string} sPersistencyMethod See sap/ushell/services/appstate/AppStatePersistencyMethod for possible values.
          *        Support depends on the used platform.
          * @param {object} oPersistencySettings Persistency settings.
          * @returns {object} App state container
@@ -2035,7 +2035,7 @@ sap.ui.define([
          * @param {object} oAppComponent A UI5 component used as context for the app state.
          * @param {boolean} bTransientEnforced If set to <code>true</code> the appstate is not persisted on the backend. If set to
          *        <code>false</code> or <code>undefined</code> the persistency location is determined by the global ushell configuration.
-         * @param {string} sPersistencyMethod See sap/ushell/services/_AppState/AppStatePersistencyMethod for possible values.
+         * @param {string} sPersistencyMethod See sap/ushell/services/appstate/AppStatePersistencyMethod for possible values.
          *        Support depends on the used platform.
          * @param {object} oPersistencySettings Persistency settings.
          * @returns {Promise<object>} A <code>Promise</code>, resolving the app state container.