@openui5/sap.ui.integration 1.142.0 → 1.143.0

package/src/sap/ui/integration/util/AnalyticsCloudHelper.js

@@ -21,7 +21,7 @@ sap.ui.define([
 	 * Utility class helping with analytics cloud widget.
 	 *
 	 * @author SAP SE
-	 * @version 1.142.0
+	 * @version 1.143.0
 	 *
 	 * @private
 	 * @alias sap.ui.integration.util.AnalyticsCloudHelper

package/src/sap/ui/integration/util/BaseFactory.js

@@ -22,7 +22,7 @@ sap.ui.define([
 	 * @extends sap.ui.base.Object
 	 *
 	 * @author SAP SE
-	 * @version 1.142.0
+	 * @version 1.143.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/util/BindingHelper.js

@@ -55,7 +55,7 @@ sap.ui.define([
 	 * Helper class for working with bindings.
 	 *
 	 * @author SAP SE
-	 * @version 1.142.0
+	 * @version 1.143.0
 	 *
 	 * @private
 	 * @alias sap.ui.integration.util.BindingHelper

package/src/sap/ui/integration/util/BindingResolver.js

@@ -34,7 +34,7 @@ sap.ui.define([
 		 * Resolves a binding syntax based on a provided model and path.
 		 *
 		 * @author SAP SE
-		 * @version 1.142.0
+		 * @version 1.143.0
 		 *
 		 * @private
 		 * @ui5-restricted sap.ushell

package/src/sap/ui/integration/util/CardObserver.js

@@ -18,7 +18,7 @@ sap.ui.define([
 	 * @extends sap.ui.base.Object
 	 *
 	 * @author SAP SE
-	 * @version 1.142.0
+	 * @version 1.143.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/util/ComboBoxHelper.js

@@ -11,7 +11,7 @@ sap.ui.define([], function () {
 	 * Utility class helping with sap.m.ComboBox control.
 	 *
 	 * @author SAP SE
-	 * @version 1.142.0
+	 * @version 1.143.0
 	 *
 	 * @private
 	 * @alias sap.ui.integration.util.ComboBoxHelper

package/src/sap/ui/integration/util/ContentFactory.js

@@ -50,7 +50,7 @@ sap.ui.define([
 	 * @extends sap.ui.integration.util.BaseFactory
 	 *
 	 * @author SAP SE
-	 * @version 1.142.0
+	 * @version 1.143.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/util/CsrfTokenHandler.js

@@ -32,7 +32,7 @@ sap.ui.define([
 	 * @extends sap.ui.base.Object
 	 *
 	 * @author SAP SE
-	 * @version 1.142.0
+	 * @version 1.143.0
 	 *
 	 * @constructor
 	 * @param {object} mSettings Token handler settings

package/src/sap/ui/integration/util/DataProvider.js

@@ -37,7 +37,7 @@ sap.ui.define([
 	 * @extends sap.ui.base.ManagedObject
 	 *
 	 * @author SAP SE
-	 * @version 1.142.0
+	 * @version 1.143.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/util/DataProviderFactory.js

@@ -40,7 +40,7 @@ sap.ui.define([
 	 * When destroyed, all data providers created by this class are also destroyed.
 	 *
 	 * @author SAP SE
-	 * @version 1.142.0
+	 * @version 1.143.0
 	 *
 	 * @private
 	 * @ui5-restricted sap.ui.integration, shell-toolkit
@@ -238,14 +238,14 @@ sap.ui.define([
 		const oEditor = this._oEditor;
 
 		if (oCard) {
-			oSettings.baseRuntimeUrl = oCard.getRuntimeUrl("/");
+			oSettings.baseRuntimeUrl = oCard.getRuntimeUrl();
 			oSettings.card = oCard;
 
 			if (!bConfigurationResolved) {
 				oSettings.configurationJson = JSONBindingHelper.createJsonWithBindingInfos(oDataConfiguration, oCard.getBindingNamespaces());
 			}
 		} else if (oEditor) {
-			oSettings.baseRuntimeUrl = oEditor.getRuntimeUrl("/");
+			oSettings.baseRuntimeUrl = oEditor.getRuntimeUrl("/"); // @todo should behave the same as card.getRuntimeUrl
 			oSettings.configurationJson = JSONBindingHelper.createJsonWithBindingInfos(oDataConfiguration, oEditor.getBindingNamespaces());
 		} else {
 			oSettings.configurationJson = JSONBindingHelper.createJsonWithBindingInfos(oDataConfiguration, {});

package/src/sap/ui/integration/util/Destinations.js

@@ -38,7 +38,7 @@ sap.ui.define([
 	 * @extends sap.ui.base.Object
 	 *
 	 * @author SAP SE
-	 * @version 1.142.0
+	 * @version 1.143.0
 	 *
 	 * @constructor
 	 * @param {sap.ui.integration.Host} oHost The Host which will be used for resolving destinations.

package/src/sap/ui/integration/util/DisplayVariants.js

@@ -52,7 +52,7 @@ sap.ui.define([
 	 * @extends sap.ui.base.Object
 	 *
 	 * @author SAP SE
-	 * @version 1.142.0
+	 * @version 1.143.0
 	 *
 	 * @constructor
 	 * @param {sap.ui.integration.widgets.Card} oCard The card.

package/src/sap/ui/integration/util/ErrorHandler.js

@@ -38,7 +38,7 @@ sap.ui.define([
 	 * Utility class for handling errors in the cards.
 	 *
 	 * @author SAP SE
-	 * @version 1.142.0
+	 * @version 1.143.0
 	 *
 	 * @private
 	 * @ui5-restricted

package/src/sap/ui/integration/util/ExtensionDataProvider.js

@@ -17,7 +17,7 @@ sap.ui.define(["sap/ui/integration/util/DataProvider"], function (DataProvider)
 	 * @extends sap.ui.integration.util.DataProvider
 	 *
 	 * @author SAP SE
-	 * @version 1.142.0
+	 * @version 1.143.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/util/Form.js

@@ -36,7 +36,7 @@ sap.ui.define([
 	 * Utility class for handling forms in the cards.
 	 *
 	 * @author SAP SE
-	 * @version 1.142.0
+	 * @version 1.143.0
 	 *
 	 * @private
 	 * @ui5-restricted

package/src/sap/ui/integration/util/HeaderFactory.js

@@ -52,7 +52,7 @@ sap.ui.define([
 	 * @extends sap.ui.integration.util.BaseFactory
 	 *
 	 * @author SAP SE
-	 * @version 1.142.0
+	 * @version 1.143.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/util/JSONBindingHelper.js

@@ -27,7 +27,7 @@ sap.ui.define([
 	 * Helper class for working with bindings for json objects.
 	 *
 	 * @author SAP SE
-	 * @version 1.142.0
+	 * @version 1.143.0
 	 *
 	 * @private
 	 * @ui5-restricted sap.ui.integration, shell-toolkit

package/src/sap/ui/integration/util/LoadingProvider.js

@@ -21,7 +21,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.142.0
+	 * @version 1.143.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/util/Manifest.js

@@ -68,7 +68,7 @@ sap.ui.define([
 	 * @extends sap.ui.base.Object
 	 *
 	 * @author SAP SE
-	 * @version 1.142.0
+	 * @version 1.143.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/util/OAuth3LOHelper.js

@@ -18,7 +18,7 @@ sap.ui.define([], function () {
 	 * Utility class helping with OAuth 3LO flow handling.
 	 *
 	 * @author SAP SE
-	 * @version 1.142.0
+	 * @version 1.143.0
 	 *
 	 * @private
 	 * @alias sap.ui.integration.util.OAuth3LOHelper

package/src/sap/ui/integration/util/ObjectStatusFactory.js

@@ -19,7 +19,7 @@ sap.ui.define([
 	 * Utility class for creating objects.
 	 *
 	 * @author SAP SE
-	 * @version 1.142.0
+	 * @version 1.143.0
 	 *
 	 * @private
 	 * @alias sap.ui.integration.util.ObjectFactory

package/src/sap/ui/integration/util/RequestDataProvider.js

@@ -74,7 +74,7 @@ sap.ui.define([
 	 * @extends sap.ui.integration.util.DataProvider
 	 *
 	 * @author SAP SE
-	 * @version 1.142.0
+	 * @version 1.143.0
 	 *
 	 * @constructor
 	 * @private
@@ -216,7 +216,7 @@ sap.ui.define([
 			vBody,
 			sMethod = oRequestConfig.method && oRequestConfig.method.toUpperCase() || "GET";
 
-		if ( !sUrl.startsWith("/")) {
+		if (!sUrl.startsWith("/")) {
 			sUrl = this._getRuntimeUrl(oRequestConfig.url);
 		}
 

package/src/sap/ui/integration/util/ServiceDataProvider.js

@@ -17,7 +17,7 @@ sap.ui.define(["sap/ui/integration/util/DataProvider"], function (DataProvider)
 	 * @extends sap.ui.integration.util.DataProvider
 	 *
 	 * @author SAP SE
-	 * @version 1.142.0
+	 * @version 1.143.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/util/ServiceManager.js

@@ -37,7 +37,7 @@ sap.ui.define([
 	 * @extends sap.ui.base.EventProvider
 	 *
 	 * @author SAP SE
-	 * @version 1.142.0
+	 * @version 1.143.0
 	 *
 	 * @constructor
 	 * @param {Object} mServiceFactoryReferences A map with service descriptions.

package/src/sap/ui/integration/util/SkeletonCard.js

@@ -23,7 +23,7 @@ sap.ui.define([
 	 * @extends sap.ui.integration.widgets.Card
 	 *
 	 * @author SAP SE
-	 * @version 1.142.0
+	 * @version 1.143.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/util/SorterHelper.js

@@ -17,7 +17,7 @@ sap.ui.define([
 	 * Utility class helping with sap.ui.model.Sorter control.
 	 *
 	 * @author SAP SE
-	 * @version 1.142.0
+	 * @version 1.143.0
 	 *
 	 * @private
 	 * @alias sap.ui.integration.util.SorterHelper

package/src/sap/ui/integration/util/Utils.js

@@ -31,7 +31,7 @@ sap.ui.define([
 	 * Utility class helping with JSON strings and formatters.
 	 *
 	 * @author SAP SE
-	 * @version 1.142.0
+	 * @version 1.143.0
 	 *
 	 * @private
 	 * @alias sap.ui.integration.util.Utils

package/src/sap/ui/integration/util/Validators.js

@@ -11,7 +11,7 @@ sap.ui.define([], function () {
 	 * Utility class helping with input validations.
 	 *
 	 * @author SAP SE
-	 * @version 1.142.0
+	 * @version 1.143.0
 	 *
 	 * @private
 	 * @alias sap.ui.integration.util.Validators

package/src/sap/ui/integration/util/openCardDialog.js

@@ -187,6 +187,10 @@ sap.ui.define([
 			oChildCard = oParentCard._createChildCard(oParameters);
 		}
 
+		if (oParameters.isPaginationCard) {
+			oParentCard.setAssociation("showMoreChildCard", oChildCard);
+		}
+
 		return _openDialog(oChildCard, oParentCard, oParameters);
 	}
 

package/src/sap/ui/integration/widgets/Card.js

@@ -191,7 +191,7 @@ sap.ui.define([
 	 * @extends sap.f.CardBase
 	 *
 	 * @author SAP SE
-	 * @version 1.142.0
+	 * @version 1.143.0
 	 * @public
 	 * @constructor
 	 * @see {@link topic:5b46b03f024542ba802d99d67bc1a3f4 Cards}
@@ -599,7 +599,14 @@ sap.ui.define([
 				 * @private
 				 * @ui5-private
 				 */
-				dialogHeader: { visibility: "hidden" }
+				dialogHeader: { visibility: "hidden" },
+
+				/**
+				 * The child card which is openned for pagination or different show more.
+				 * @private
+				 * @ui5-private
+				 */
+				showMoreChildCard: { visibility: "hidden" }
 			}
 		},
 		renderer: CardRenderer
@@ -632,16 +639,16 @@ sap.ui.define([
 
 		/**
 		 * Facade of the {@link sap.ui.integration.widgets.Card} control.
+		 *
+		 * This facade contains methods accessible within the card extension.
+		 * The available methods represent a limited subset of all card methods, since not all card methods function as expected when called from within the extension.
+		 *
 		 * @interface
 		 * @name sap.ui.integration.widgets.CardFacade
-		 * @experimental since 1.79
 		 * @public
 		 * @author SAP SE
-		 * @version 1.142.0
+		 * @version 1.143.0
 		 * @borrows sap.ui.integration.widgets.Card#getId as getId
-		 * @borrows sap.ui.integration.widgets.Card#getDomRef as getDomRef
-		 * @borrows sap.ui.integration.widgets.Card#setVisible as setVisible
-		 * @borrows sap.ui.integration.widgets.Card#getParameters as getParameters
 		 * @borrows sap.ui.integration.widgets.Card#getCombinedParameters as getCombinedParameters
 		 * @borrows sap.ui.integration.widgets.Card#getManifestEntry as getManifestEntry
 		 * @borrows sap.ui.integration.widgets.Card#resolveDestination as resolveDestination
@@ -653,14 +660,13 @@ sap.ui.define([
 		 * @borrows sap.ui.integration.widgets.Card#getBaseUrl as getBaseUrl
 		 * @borrows sap.ui.integration.widgets.Card#getRuntimeUrl as getRuntimeUrl
 		 * @borrows sap.ui.integration.widgets.Card#getTranslatedText as getTranslatedText
-		 * @borrows sap.ui.integration.widgets.Card#getModel as getModel
 		 * @borrows sap.ui.integration.widgets.Card#triggerAction as triggerAction
 		 * @borrows sap.ui.integration.widgets.Card#addActionDefinition as addActionDefinition
 		 * @borrows sap.ui.integration.widgets.Card#removeActionDefinition as removeActionDefinition
 		 * @borrows sap.ui.integration.widgets.Card#insertActionDefinition as insertActionDefinition
-		 * @borrows sap.ui.integration.widgets.Card#getActionDefinition as getActionDefinition
+		 * @borrows sap.ui.integration.widgets.Card#getActionDefinitions as getActionDefinitions
 		 * @borrows sap.ui.integration.widgets.Card#indexOfActionDefinition as indexOfActionDefinition
-		 * @borrows sap.ui.integration.widgets.Card#destroyActionDefinition as destroyActionDefinition
+		 * @borrows sap.ui.integration.widgets.Card#destroyActionDefinitions as destroyActionDefinitions
 		 * @borrows sap.ui.integration.widgets.Card#showLoadingPlaceholders as showLoadingPlaceholders
 		 * @borrows sap.ui.integration.widgets.Card#hideLoadingPlaceholders as hideLoadingPlaceholders
 		 * @borrows sap.ui.integration.widgets.Card#showCard as showCard
@@ -691,9 +697,9 @@ sap.ui.define([
 			"addActionDefinition",
 			"removeActionDefinition",
 			"insertActionDefinition",
-			"getActionDefinition",
+			"getActionDefinitions",
 			"indexOfActionDefinition",
-			"destroyActionDefinition",
+			"destroyActionDefinitions",
 			"showLoadingPlaceholders",
 			"hideLoadingPlaceholders",
 			"showCard",
@@ -706,6 +712,41 @@ sap.ui.define([
 		]);
 	};
 
+	/**
+	 * Gets current value of property {@link #getParameters parameters}.
+	 *
+	 * Overrides the default values of the parameters, which are defined in the manifest.
+	 * The returned value is an object containing parameters in format <code>{parameterKey: parameterValue}</code>.
+	 *
+	 * @public
+	 * @method
+	 * @name sap.ui.integration.widgets.CardFacade.getParameters
+	 * @deprecated Since 1.143. Use <code>getCombinedParameters()</code> instead.
+	 * @returns {object} Value of property <code>parameters<code>
+	 */
+
+	/**
+	 * @public
+	 * @method
+	 * @name sap.ui.integration.widgets.CardFacade.getDomRef
+	 * @deprecated Since 1.143. Do not access the card dom reference, as this is not supported in a mobile native environment.
+	 */
+
+	/**
+	 * @public
+	 * @method
+	 * @name sap.ui.integration.widgets.CardFacade.setVisible
+	 * @deprecated Since 1.143. Use <code>hide()</code> to hide a card opened by <code>showCard()</code>.
+	 * The card facade does not provide methods for showing or hiding the main card itself.
+	 */
+
+	/**
+	 * @public
+	 * @method
+	 * @name sap.ui.integration.widgets.CardFacade.getModel
+	 * @deprecated Since 1.143. Avoid accessing the models directly, use the binding syntax instead.
+	 */
+
 	/**
 	 * Initializes the internally used models.
 	 */
@@ -1370,6 +1411,11 @@ sap.ui.define([
 		if (oFilterBar) {
 			oFilterBar.refreshData();
 		}
+
+		const oShowMoreChildCard = Element.getElementById(this.getAssociation("showMoreChildCard"));
+		if (oShowMoreChildCard) {
+			oShowMoreChildCard.refreshData();
+		}
 	};
 
 	/**
@@ -1801,6 +1847,7 @@ sap.ui.define([
 	 *
 	 * @example
 	 * oCard.getRuntimeUrl("images/Avatar.png") === "{cardBaseUrl}/images/Avatar.png"
+	 * oCard.getRuntimeUrl("/images/Avatar.png") === "/images/Avatar.png" (remains relative to host root)
 	 * oCard.getRuntimeUrl("http://www.someurl.com/Avatar.png") === "http://www.someurl.com/Avatar.png"
 	 * oCard.getRuntimeUrl("https://www.someurl.com/Avatar.png") === "https://www.someurl.com/Avatar.png"
 	 *
@@ -1809,11 +1856,11 @@ sap.ui.define([
 	 * @returns {string} The resolved URL.
 	 */
 	Card.prototype.getRuntimeUrl = function (sUrl) {
+		if (!sUrl) {
+			sUrl = "";
+		}
 
-		var sAppId = this._oCardManifest ? this._oCardManifest.get("/sap.app/id") : null,
-			sAppName,
-			sSanitizedUrl = sUrl && sUrl.trim().replace(/^\//, "");
-
+		const sAppId = this._oCardManifest ? this._oCardManifest.get("/sap.app/id") : null;
 		if (sAppId === null) {
 			Log.error("The manifest is not ready so the URL can not be resolved. Consider using the 'manifestReady' event.", "sap.ui.integration.widgets.Card");
 			return null;
@@ -1826,7 +1873,13 @@ sap.ui.define([
 			return sUrl;
 		}
 
-		sAppName = sAppId.replace(/\./g, "/");
+		if (sUrl.startsWith("/")) {
+			// urls which are absolute to the server root are not changed
+			return sUrl;
+		}
+
+		const sSanitizedUrl = sUrl && sUrl.trim().replace(/^\//, "");
+		const sAppName = sAppId.replace(/\./g, "/");
 
 		// do not use sap.ui.require.toUrl(sAppName + "/" + sSanitizedUrl)
 		// because it doesn't work when the sSanitizedUrl starts with ".."
@@ -2106,7 +2159,7 @@ sap.ui.define([
 
 	/**
 	 * @private
-     * @returns {sap.f.cards.IHeader} The header of the card.
+	 * @returns {sap.f.cards.IHeader} The header of the card.
 	 */
 	Card.prototype._getHeaderAggregation = function () {
 		return this.getAggregation("_header");
@@ -3453,7 +3506,7 @@ sap.ui.define([
 			}
 		} else {
 			oChildCard.setManifest(vManifest);
-			oChildCard.setBaseUrl(sBaseUrl || this.getRuntimeUrl("/"));
+			oChildCard.setBaseUrl(sBaseUrl || this.getRuntimeUrl());
 		}
 
 		return oChildCard;