@sapui5/sap.ushell 1.134.1 → 1.136.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@sapui5/sap.ushell",
-    "version": "1.134.1",
+    "version": "1.136.0",
     "description": "SAPUI5 Library sap.ushell",
     "homepage": "https://sap.github.io/ui5-tooling/pages/SAPUI5/",
     "keywords": [

package/src/main/js/sap/ushell/.library

@@ -2,7 +2,7 @@
 <library xmlns="http://www.sap.com/sap.ui.library.xsd">
     <name>sap.ushell</name>
     <vendor>SAP SE</vendor>
-    <version>1.134.1</version>
+    <version>1.136.0</version>
     <copyright>Copyright (c) 2009-2025 SAP SE, All Rights Reserved</copyright>
     <documentation>SAP library: sap.ushell</documentation>
 
@@ -146,6 +146,7 @@
                     <module>sap/ushell/URLTemplateProcessor</module>
 
                     <module>sap/ushell/components/applicationIntegration/*</module>
+                    <module>sap/ushell/appIntegration/*</module>
 
                     <module>sap/ushell/ui5service/_AppIsolationService/*</module>
                     <module>sap/ushell/ui5service/AppIsolationService</module>

package/src/main/js/sap/ushell/AppInfoParameters.js

@@ -47,7 +47,8 @@ sap.ui.define([
         "title",
         "applicationParams",
         "shellFrameworkVersion",
-        "url"
+        "url",
+        "abap.transaction"
     ];
 
     /**
@@ -71,7 +72,8 @@ sap.ui.define([
             appVersion: this.#getAppVersion.bind(this),
             productName: _curry(this.#getSystemContextProperty.bind(this))("productName"),
             applicationParams: this.#getStartupParams.bind(this),
-            url: this.#getUrl.bind(this)
+            url: this.#getUrl.bind(this),
+            "abap.transaction": this.#getABAPTransaction.bind(this)
         };
 
         // overrides by the application for the standard app info parameters
@@ -105,7 +107,7 @@ sap.ui.define([
                 try {
                     const oVersionInfo = await VersionInfo.load();
 
-                    return `${oVersionInfo.version || "" } (${ oVersionInfo.buildTimestamp || "" })` || "";
+                    return `${oVersionInfo.version || ""} (${oVersionInfo.buildTimestamp || ""})` || "";
 
                 } catch (oError) {
                     Log.error("VersionInfo could not be loaded", oError);
@@ -131,7 +133,7 @@ sap.ui.define([
          */
         async #getSupportInfo (oCurrentApplication) {
             // 1. sap-ach
-            const [ sAch ] = await oCurrentApplication.getTechnicalParameter("sap-ach") || [];
+            const [sAch] = await oCurrentApplication.getTechnicalParameter("sap-ach") || [];
             if (sAch) {
                 return sAch;
             }
@@ -196,7 +198,7 @@ sap.ui.define([
          * @returns {Promise<string>} function that resolves to a promise with application id.
          */
         async #getAppId (oCurrentApplication) {
-            const [ sFioriId ] = await oCurrentApplication.getTechnicalParameter("sap-fiori-id") || [];
+            const [sFioriId] = await oCurrentApplication.getTechnicalParameter("sap-fiori-id") || [];
 
             // case home page
             if (oCurrentApplication.homePage) {
@@ -206,15 +208,15 @@ sap.ui.define([
                     // home app
                     if (sFioriId !== "") {
                         return `${LAUNCHPAD} (${sFioriId})`;
-                    // case fiori id is empty
-                    // This is relevant for app home error page
+                        // case fiori id is empty
+                        // This is relevant for app home error page
                     }
                     return LAUNCHPAD;
                 }
                 // no Fiori ID is provided
                 // This is shell home, no custom home app or appfinder
                 return LAUNCHPAD;
-            // case app
+                // case app
             } else if (sFioriId) {
                 // case fiori ID is a string
                 return sFioriId;
@@ -340,7 +342,7 @@ sap.ui.define([
          * A function to collect the values of the given parameters
          * @param {string[]} aParameters Array of requested parameters
          * @param {object} oCurrentApplication The current application
-         * @param {object} oApplicationContainer The application container
+         * @param {sap.ushell.components.container.ApplicationContainer} oApplicationContainer The application container
          * @returns {Promise} Promise that resolves to an object
          *    keeping the application info parameters with values
          */
@@ -357,8 +359,8 @@ sap.ui.define([
          * Internal central function to collect the values of the given parameters
          * @param {string[]} aParameters Array of requested parameters
          * @param {object} oCurrentApplication The current application
-         * @param {object} oApplicationContainer The application container
-         * @returns {Promise<Object<string, object>>} Promise that resolves to an object
+         * @param {sap.ushell.components.container.ApplicationContainer} oApplicationContainer The application container
+         * @returns {Promise<object<string, object>>} Promise that resolves to an object
          *    keeping the application info parameters with values
          */
         async #getInfo (aParameters, oCurrentApplication, oApplicationContainer) {
@@ -380,9 +382,8 @@ sap.ui.define([
                 if (Object.hasOwn(this.#oCustomAppParameters, sParameter)) {
                     /**
                      * Automated migration to customProperties will be removed in future.
-                     * @deprecated since 1.120.0
-                     */
-                    // eslint-disable-next-line no-constant-condition
+                     * @deprecated since 1.120
+                     */ // eslint-disable-next-line no-constant-condition
                     if (true) {
                         const oCustomValue = this.#oCustomAppParameters[sParameter];
                         if (oCustomValue.migrated) {
@@ -422,7 +423,7 @@ sap.ui.define([
 
             /**
              * Old interface
-             * @deprecated since 1.120.0
+             * @deprecated since 1.120
              */
             if (oAppInfoClone.info && Object.keys(oAppInfoClone).length === 1) {
                 Log.error("The old interface for setting custom attributes is deprecated and will be removed in future.");
@@ -431,7 +432,7 @@ sap.ui.define([
 
             /**
              * Automated migration to customProperties will be removed in future.
-             * @deprecated since 1.120.0
+             * @deprecated since 1.120
              */
             const oFallbackForCustomProperties = {};
             for (const sParameter in oAppInfoClone) {
@@ -446,12 +447,10 @@ sap.ui.define([
                 }
 
                 if (!aSupportedParameters.includes(sParameter)) {
-
                     /**
                      * Automated migration to customProperties will be removed in future.
-                     * @deprecated since 1.120.0
-                     */
-                    // eslint-disable-next-line no-constant-condition
+                     * @deprecated since 1.120
+                     */ // eslint-disable-next-line no-constant-condition
                     if (true) {
                         Log.error(`Attribute '${sParameter}' is not supported and will be moved to customProperties instead. This migration will be removed in future.`);
                         oFallbackForCustomProperties[sParameter] = {
@@ -479,7 +478,7 @@ sap.ui.define([
             const oCustomProperties = {
                 /**
                  * Automated migration to customProperties will be removed in future.
-                 * @deprecated since 1.120.0
+                 * @deprecated since 1.120
                  */
                 ...oFallbackForCustomProperties,
                 ...oAppInfoClone.customProperties
@@ -488,9 +487,16 @@ sap.ui.define([
             for (const sCustomProperty in oCustomProperties) {
                 let oValue = oCustomProperties[sCustomProperty];
 
+                // Move supported parameters out of custom properties to allow overriding of standard params by the app.
+                // e.g.: abap.transaction
+                if (aSupportedParameters.includes(sCustomProperty)) {
+                    this.#oAppParameters[sCustomProperty] = oValue;
+                    continue;
+                }
+
                 /**
                  * Automated migration to proper format will be removed in future.
-                 * @deprecated since 1.120.0
+                 * @deprecated since 1.120
                  */
                 if (!isPlainObject(oValue)) {
                     Log.error(`Custom attribute '${sCustomProperty}' does not have the correct format. This property will be ignored in future.`);
@@ -542,6 +548,20 @@ sap.ui.define([
             return Container.getFLPUrl(true);
         }
 
+        /**
+         * Retrieves the abap.transaction from the resolution result of the current application.
+         *
+         * @param {object} oCurrentApplication current application
+         * @param {sap.ushell.components.container.ApplicationContainer} oApplicationContainer application container
+         * @returns {string} The abap transaction
+         *
+         * @since 1.135.0
+         * @private
+         */
+        #getABAPTransaction (oCurrentApplication, oApplicationContainer) {
+            return oApplicationContainer?.getCurrentAppTargetResolution?.().appInfo?.["abap.transaction"];
+        }
+
         /**
          * Stores the custom app info parameters into the given storage entry.
          * @param {object} oStorageEntry The storage entry.

package/src/main/js/sap/ushell/ApplicationType/UrlPostProcessing.js

@@ -26,12 +26,8 @@ sap.ui.define([
 ) => {
     "use strict";
 
-    if (Config.last("/core/navigation/enableAppLifeCycleFallback")) {
-        return {};
-    }
-
-    // shortcut for sap.ushell.components.applicationIntegration.contracts.StatefulType
-    const StatefulType = ushellLibrary.components.applicationIntegration.contracts.StatefulType;
+    // shortcut for sap.ushell.appIntegration.contracts.StatefulType
+    const StatefulType = ushellLibrary.appIntegration.contracts.StatefulType;
 
     const UrlPostProcessing = {};
 
@@ -41,7 +37,7 @@ sap.ui.define([
      * @param {string} sUrl Url that needs to be adjusted
      * @param {sap.ushell.ApplicationType} sApplicationType Application type
      * @param {boolean} [bForFramelessWindow=false] whether the url is for a frameless window
-     * @param {sap.ushell.components.applicationIntegration.ApplicationContainer} [oApplicationContainer] Application Container the base URL
+     * @param {sap.ushell.appIntegration.ApplicationContainer} [oApplicationContainer] Application Container the base URL
      * @returns {string} The adjusted url.
      *
      * @since 1.134.0