@openui5/sap.ui.integration 1.136.3 → 1.139.0

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.136.3
+	 * @version 1.139.0
 	 *
 	 * @private
 	 * @alias sap.ui.integration.util.ObjectFactory

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

@@ -9,14 +9,16 @@ sap.ui.define([
 	"sap/base/Log",
 	"sap/ui/model/odata/v4/ODataUtils",
 	"sap/base/util/fetch",
-	"sap/base/util/deepClone"
+	"sap/base/util/deepClone",
+	"sap/base/util/isPlainObject"
 ], function (
 	Element,
 	DataProvider,
 	Log,
 	ODataUtils,
 	fetch,
-	deepClone
+	deepClone,
+	isPlainObject
 ) {
 	"use strict";
 
@@ -72,7 +74,7 @@ sap.ui.define([
 	 * @extends sap.ui.integration.util.DataProvider
 	 *
 	 * @author SAP SE
-	 * @version 1.136.3
+	 * @version 1.139.0
 	 *
 	 * @constructor
 	 * @private
@@ -211,38 +213,26 @@ sap.ui.define([
 			sDataType = (this.getAllowCustomDataType() && oRequestConfig.dataType) || "json",
 			mHeaders = oRequestConfig.headers || {},
 			mBatchRequests = oRequestConfig.batch,
-			oBatchSerialized,
-			oRequest,
 			vBody,
-			sMethod = oRequestConfig.method && oRequestConfig.method.toUpperCase() || "GET",
-			bJsonRequest = this._hasHeader(oRequestConfig, "Content-Type", "application/json"),
-			bGetMethod = ["GET", "HEAD"].includes(sMethod);
+			sMethod = oRequestConfig.method && oRequestConfig.method.toUpperCase() || "GET";
 
 		if ( !sUrl.startsWith("/")) {
 			sUrl = this._getRuntimeUrl(oRequestConfig.url);
 		}
 
-		if (oParameters) {
-			if (bJsonRequest) {
-				// application/json
-				vBody = JSON.stringify(oParameters);
-			} else if (bGetMethod) {
-				sUrl = combineUrlAndParams(sUrl, oParameters);
-			} else if (oParameters instanceof FormData) {
-				vBody = oParameters;
-			} else {
-				// application/x-www-form-urlencoded
-				vBody = new URLSearchParams(oParameters);
-			}
+		if (oParameters && isPlainObject(oParameters) && ["GET", "HEAD"].includes(sMethod)) {
+			sUrl = combineUrlAndParams(sUrl, oParameters);
+		} else if (oParameters) {
+			vBody = this._encodeParameters(oParameters, oRequestConfig);
 		}
 
 		if (mBatchRequests) {
-			oBatchSerialized = ODataUtils.serializeBatchRequest(Object.values(mBatchRequests));
+			const oBatchSerialized = ODataUtils.serializeBatchRequest(Object.values(mBatchRequests));
 			vBody = oBatchSerialized.body;
 			mHeaders = Object.assign({}, mHeaders, oBatchSerialized.headers);
 		}
 
-		oRequest = {
+		let oRequest = {
 			url: sUrl,
 			options: {
 				mode: oRequestConfig.mode || "cors",
@@ -323,6 +313,23 @@ sap.ui.define([
 			});
 	};
 
+	RequestDataProvider.prototype._encodeParameters = function (oParameters, oRequestConfiguration) {
+		if (this._hasHeader(oRequestConfiguration, "Content-Type", /^application\/json$/)) {
+			return JSON.stringify(oParameters);
+		}
+
+		if (this._hasHeader(oRequestConfiguration, "Content-Type", /^text\/plain/)) {
+			return oParameters;
+		}
+
+		if (oParameters instanceof FormData) {
+			return oParameters;
+		}
+
+		// application/x-www-form-urlencoded
+		return new URLSearchParams(oParameters);
+	};
+
 	/**
 	 * Retries to send the given request if response status code allows it
 	 * and if a retry-after value is specified in response header or in the request settings.
@@ -431,21 +438,21 @@ sap.ui.define([
 
 	/**
 	 * Checks if header with given value is part of the request.
-	 * Header name is case-insensitive, but the value is case-sensitive (RFC7230 https://tools.ietf.org/html/rfc7230#section-3.2).
+	 * Header name is case-insensitive RFC7230 https://tools.ietf.org/html/rfc7230#section-3.2.
 	 *
 	 * @private
 	 * @param {*} oRequestConfig The request config.
 	 * @param {*} sHeader Searched header. For example "Content-Type"
-	 * @param {*} sValue Checked value. For example "application/json"
+	 * @param {*} rValue Regex to match the value. For example /application\/json/
 	 * @returns {boolean} Whether a header with given value is present.
 	 */
-	RequestDataProvider.prototype._hasHeader = function (oRequestConfig, sHeader, sValue) {
+	RequestDataProvider.prototype._hasHeader = function (oRequestConfig, sHeader, rValue) {
 		if (!oRequestConfig.headers) {
 			return false;
 		}
 
 		for (var sKey in oRequestConfig.headers) {
-			if (sKey.toLowerCase() === sHeader.toLowerCase() && oRequestConfig.headers[sKey] === sValue) {
+			if (sKey.toLowerCase() === sHeader.toLowerCase() && rValue.test(oRequestConfig.headers[sKey])) {
 				return true;
 			}
 		}

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.136.3
+	 * @version 1.139.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.136.3
+	 * @version 1.139.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.136.3
+	 * @version 1.139.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.136.3
+	 * @version 1.139.0
 	 *
 	 * @private
 	 * @alias sap.ui.integration.util.SorterHelper

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

@@ -29,7 +29,7 @@ sap.ui.define([
 	 * Utility class helping with JSON strings and formatters.
 	 *
 	 * @author SAP SE
-	 * @version 1.136.3
+	 * @version 1.139.0
 	 *
 	 * @private
 	 * @alias sap.ui.integration.util.Utils
@@ -337,6 +337,10 @@ sap.ui.define([
 					mFormat.parts[1].toString()
 				],
 				formatter: function (sText, vParam1, vParam2) {
+					if (!sText) {
+						return "";
+					}
+
 					var sParam1 = vParam1 || mFormat.parts[0];
 					var sParam2 = vParam2 || mFormat.parts[1];
 

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.136.3
+	 * @version 1.139.0
 	 *
 	 * @private
 	 * @alias sap.ui.integration.util.Validators

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

@@ -137,9 +137,13 @@ sap.ui.define([
 		oChildCard.attachEvent("_ready", () => {
 			_setDialogHeader(oDialog, oChildCard);
 			_setAriaAttributes(oDialog, oChildCard);
+
 			if (!oChildCard._isComponentCard()) {
 				oDialog.open();
 			}
+
+			oChildCard.getCardContent()?.onOpenInDialog();
+
 			_setFocus(oChildCard, oDialog);
 		});
 

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

@@ -0,0 +1,36 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2025 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+
+sap.ui.define([
+], (
+) => {
+	"use strict";
+
+	/**
+	 * Converts the subtitle and subtitleMaxLines properties in the configuration to subTitle and subTitleMaxLines.
+	 * This is necessary for consistency in the card header and image overlay configurations when resolving the manifest.
+	 *
+	 * @param {object} oConfiguration The card configuration object.
+	 * @returns {void}
+	 * @private
+	 * @ui5-restricted sap.ui.integration
+	 */
+	function subtitleToSubTitle(oConfiguration) {
+		if (oConfiguration?.hasOwnProperty("subtitle")) {
+			const sSubtitle = oConfiguration.subtitle;
+			delete oConfiguration.subtitle;
+			oConfiguration.subTitle = sSubtitle;
+		}
+
+		if (oConfiguration?.hasOwnProperty("subtitleMaxLines")) {
+			const sSubtitleMaxLines = oConfiguration.subtitleMaxLines;
+			delete oConfiguration.subtitleMaxLines;
+			oConfiguration.subTitleMaxLines = sSubtitleMaxLines;
+		}
+	}
+
+	return subtitleToSubTitle;
+});

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

@@ -131,6 +131,8 @@ sap.ui.define([
 
 	const DEFAULT_MODEL_SIZE_LIMIT = 1000;
 
+	const oResourceBundle = Library.getResourceBundleFor("sap.ui.integration");
+
 	/**
 	 * Constructor for a new <code>Card</code>.
 	 *
@@ -188,7 +190,7 @@ sap.ui.define([
 	 * @extends sap.f.CardBase
 	 *
 	 * @author SAP SE
-	 * @version 1.136.3
+	 * @version 1.139.0
 	 * @public
 	 * @constructor
 	 * @see {@link topic:5b46b03f024542ba802d99d67bc1a3f4 Cards}
@@ -624,7 +626,7 @@ sap.ui.define([
 		 * @experimental since 1.79
 		 * @public
 		 * @author SAP SE
-		 * @version 1.136.3
+		 * @version 1.139.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
@@ -735,13 +737,17 @@ sap.ui.define([
 			i18n: {
 				init: () => {
 					this.setModel(new ResourceModel({
-						bundle: this._oIntegrationRb,
+						bundleName: "sap.ui.integration.i18n.public.messagebundle",
 						async: true
 					}), "i18n");
-					this._oActiveRb = this._oIntegrationRb;
 				},
 				reset: () => {
-					this._oActiveRb = this._oIntegrationRb;
+					this._oActiveRb = null;
+					this.getModel("i18n").destroy();
+					this.setModel(new ResourceModel({
+						bundleName: "sap.ui.integration.i18n.public.messagebundle",
+						async: true
+					}), "i18n");
 				}
 			},
 			size: {
@@ -1126,10 +1132,11 @@ sap.ui.define([
 			this._logSevereError("There must be a 'sap.card' section in the manifest.");
 		}
 
-		if (oCardManifest && oCardManifest.getResourceBundle()) {
-			this._oActiveRb = await this._enhanceI18nModel(oCardManifest.getResourceBundle());
+		if (oCardManifest.getResourceBundle()) {
+			this._enhanceI18nModel(oCardManifest.getResourceBundle());
 		}
 
+		this._oActiveRb = await this.getModel("i18n").getResourceBundle();
 		this.getModel("context").resetHostProperties();
 
 		if (this._hasContextParams()) {
@@ -1143,30 +1150,13 @@ sap.ui.define([
 	};
 
 	/**
-	 * Enhances or creates the i18n model for the card.
+	 * Enhances the public resource bundle with the one of the card.
 	 *
-	 * @param {module:sap/base/i18n/ResourceBundle} oResourceBundle The resource bundle which will be enhanced.
-	 * @returns {Promise<module:sap/base/i18n/ResourceBundle>} The enhanced resource bundle.
+	 * @param {module:sap/base/i18n/ResourceBundle} oResourceBundle The resource bundle of the card.
 	 * @private
 	 */
 	Card.prototype._enhanceI18nModel = function (oResourceBundle) {
-		var oResourceModel = this.getModel("i18n"),
-			oNewResourceModel;
-
-		// the library resource bundle must not be enhanced
-		// so the card resource bundle should be first
-		oNewResourceModel = new ResourceModel({
-			async: true,
-			bundle: oResourceBundle,
-			enhanceWith: [
-				this._oIntegrationRb
-			]
-		});
-
-		this.setModel(oNewResourceModel, "i18n");
-		oResourceModel.destroy();
-
-		return oNewResourceModel.getResourceBundle();
+		this.getModel("i18n").enhance(oResourceBundle);
 	};
 
 	/**
@@ -1682,7 +1672,7 @@ sap.ui.define([
 	};
 
 	/**
-	 * Settings for blocking message that ocurred in a {@link sap.ui.integration.widgets.Card}
+	 * Settings for blocking message that occurred in a {@link sap.ui.integration.widgets.Card}
 	 *
 	 * @typedef {object} sap.ui.integration.BlockingMessageSettings
 	 * @property {sap.ui.integration.CardBlockingMessageType} type Blocking message type
@@ -1757,9 +1747,8 @@ sap.ui.define([
 	/**
 	 * Gets translated text from the i18n properties files configured for this card.
 	 *
-	 * For more details see {@link module:sap/base/i18n/ResourceBundle#getText}.
+	 * This method uses <code>ResourceBundle.getText()</code>. For more details see {@link module:sap/base/i18n/ResourceBundle#getText}.
 	 *
-	 * @experimental Since 1.83. The API might change.
 	 * @public
 	 * @param {string} sKey Key to retrieve the text for
 	 * @param {string[]} [aArgs] List of parameter values which should replace the placeholders "{<i>n</i>}"
@@ -1767,14 +1756,12 @@ sap.ui.define([
 	 *     whenever <code>aArgs</code> is given, no matter whether the text contains placeholders or not
 	 *     and no matter whether <code>aArgs</code> contains a value for <i>n</i> or not.
 	 * @param {boolean} [bIgnoreKeyFallback=false] If set, <code>undefined</code> is returned instead of the key string, when the key is not found in any bundle or fallback bundle.
-	 * @returns {string} The value belonging to the key, if found; otherwise the key itself or <code>undefined</code> depending on <code>bIgnoreKeyFallback</code>.
+	 * @returns {string|undefined} The value belonging to the key, if found; otherwise, it returns the key itself or <code>undefined</code> depending on <code>bIgnoreKeyFallback</code>.
 	 */
 	Card.prototype.getTranslatedText = function (sKey, aArgs, bIgnoreKeyFallback) {
-		var oModel = this.getModel("i18n");
-
-		if (!oModel || !this._oActiveRb) {
-			Log.warning("There are no translations available. Either the i18n configuration is missing or the method is called too early.");
-			return null;
+		if (!this._oActiveRb) {
+			Log.error("'getTranslatedText' cannot be used before the card instance is ready. Consider using the event 'manifestApplied'.", "sap.ui.integration.widgets.Card");
+			return bIgnoreKeyFallback ? undefined : sKey;
 		}
 
 		return this._oActiveRb.getText(sKey, aArgs, bIgnoreKeyFallback);
@@ -2280,9 +2267,9 @@ sap.ui.define([
 			});
 		} catch (e) {
 			this._handleError({
-				illustrationType: IllustratedMessageType.ErrorScreen,
-				title: this.getTranslatedText("CARD_ERROR_CONFIGURATION_TITLE"),
-				description: this.getTranslatedText("CARD_ERROR_CONFIGURATION_DESCRIPTION"),
+				illustrationType: IllustratedMessageType.UnableToLoad,
+				title: oResourceBundle.getText("CARD_ERROR_CONFIGURATION_TITLE"),
+				description: oResourceBundle.getText("CARD_ERROR_CONFIGURATION_DESCRIPTION"),
 				details: e.message,
 				originalError: e
 			});
@@ -2418,6 +2405,7 @@ sap.ui.define([
 			this._fireConfigurationChange({
 				[`/sap.card/configuration/filters/${oEvent.getParameter("key")}/value`]: oEvent.getParameter("value")
 			});
+			this.scheduleFireStateChanged();
 			this.resetPaginator();
 		});
 	};
@@ -2766,23 +2754,72 @@ sap.ui.define([
 		}
 
 		this._setLoadingProviderState(false);
+
+		this._fireDataChange();
 	};
 
 	/**
-	 * Performs an HTTP request using the given configuration.
+	 * Settings for card request error.
+	 *
+	 * <b>Note:</b> For backward compatibility, the object can also be accessed as an array
+	 * with the properties in the order - message, response, and responseText.
 	 *
+	 * @typedef {object} sap.ui.integration.CardRequestError
+	 * @property {string} message The error message
+	 * @property {object} response The response object
+	 * @property {string} responseText The response text
 	 * @public
-	 * @experimental since 1.79
+	 * @experimental As of version 1.139
+	 */
+
+	/**
+	 * Performs an asynchronous network request using the specified request settings,
+	 * enabling dynamic bindings to card configurations, such as CSRF tokens, destinations, and parameters.
+	 * If the request is successful, it returns a Promise that resolves with the response data.
+	 *
+	 * If an error occurs during the request, the Promise will reject with a {@link sap.ui.integration.CardRequestError}.
+	 *
+	 * For more details on card data handling and request settings see [Card Explorer Data Section]{@link https://ui5.sap.com/test-resources/sap/ui/integration/demokit/cardExplorer/webapp/index.html#/learn/features/data}.
+	 *
+	 * @public
+	 * @since 1.79
 	 * @param {object} oConfiguration The configuration of the request.
 	 * @param {string} oConfiguration.url The URL of the resource.
 	 * @param {string} [oConfiguration.mode="cors"] The mode of the request. Possible values are "cors", "no-cors", "same-origin".
 	 * @param {string} [oConfiguration.method="GET"] The HTTP method. Possible values are "GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS", and "HEAD".
-	 * @param {object|FormData} [oConfiguration.parameters] The request parameters. If the HTTP method is "POST", "PUT", "PATCH", or "DELETE" the parameters will be put into the body of the request.
-	 *
-	 *                                                      <b>Note:</b> If parameters are of type "FormData", the "FormData" will not be resolved for bindings, destinations and others. It will be sent as it is.
-	 * @param {string} [oConfiguration.dataType="json"] Deprecated. Use the correct Accept headers and correct Content-Type header in the response.
+	 * @param {object|FormData|string} [oConfiguration.parameters] The request parameters to be sent to the server. They are sent as follows:
+	 *<ul>
+	 *	<li>
+	 *		When the HTTP method is "GET" or "HEAD", and parameters are set as:
+	 *		<ul>
+	 *			<li>object - Sent as part of the URL, appended as key/value pairs in the query string</li>
+	 *			<li>FormData - Not sent</li>
+	 *			<li>string - Not sent</li>
+	 *		</ul>
+	 *	</li>
+	 *	<li>
+	 *		When the HTTP method is "POST", "PUT", "PATCH", or "DELETE", the parameters will be sent in the request body, encoded based on the <code>Content-Type</code> header and parameters type:
+	 *		<ul>
+	 *			<li>
+	 *				object - Supports the following encodings, decided based on the Content-Type header of the request:
+	 *				<ul>
+	 *					<li><code>application/x-www-form-urlencoded</code> - Default</li>
+	 *					<li><code>application/json</code></li>
+	 *				</ul>
+	 *			</li>
+	 *			<li>
+	 *				FormData - Encoded as <code>multipart/form-data</code>. The <code>Content-Type</code> header on the request must not be set explicitly.
+	 *				<b>Note:</b> FormData will not be resolved for bindings, destinations and others. It will be sent as it is.
+	 *				Added since version 1.130
+	 *			</li>
+	 *			<li>string - Must be used in combination with <code>Content-Type: text/plain</code>. Will be sent as is. Added since version 1.138</li>
+	 *		</ul>
+	 *	</li>
+	 *</ul>
+	 * @param {string} [oConfiguration.dataType="json"] Deprecated. Use the correct <code>Accept</code> headers and set correct <code>Content-Type</code> header in the response.
 	 * @param {object} [oConfiguration.headers] The HTTP headers of the request.
-	 * @param {boolean} [oConfiguration.withCredentials=false] Indicates whether cross-site requests should be made using credentials.
+	 * @param {boolean} [oConfiguration.withCredentials=false] Indicates whether
+	 * cross-site requests should be made using credentials. Same-origin requests are always made using credentials.
 	 * @returns {Promise<any>} Resolves when the request is successful, rejects otherwise.
 	 */
 	Card.prototype.request = function (oConfiguration) {
@@ -2796,7 +2833,19 @@ sap.ui.define([
 					true)
 				.setAllowCustomDataType(true)
 				.attachDataChanged((e) => { resolve(e.getParameter("data")); })
-				.attachError((e) => { reject([e.getParameter("message"), e.getParameter("response"), e.getParameter("responseText"), e.getParameter("settings")]); })
+				.attachError((e) => {
+					const oResult = [e.getParameter("message"),
+						e.getParameter("response"),
+						e.getParameter("responseText"),
+						e.getParameter("settings")];
+
+					oResult.message = e.getParameter("message");
+					oResult.response = e.getParameter("response");
+					oResult.responseText = e.getParameter("responseText");
+					oResult._requestSettings = e.getParameter("settings");
+
+					reject(oResult);
+				})
 				.triggerDataUpdate();
 			});
 		});