@sapui5/sap.ui.export 1.136.2 → 1.138.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sapui5/sap.ui.export",
-	"version": "1.136.2",
+	"version": "1.138.0",
 	"description": "SAPUI5 Library sap.ui.export",
 	"homepage": "https://sap.github.io/ui5-tooling/pages/SAPUI5/",
 	"author": "SAP SE (https://www.sap.com)",

package/src/sap/ui/export/.library

@@ -5,7 +5,7 @@
 	<vendor>SAP SE</vendor>
 	<copyright>SAPUI5
  * (c) Copyright 2025 SAP SE. All rights reserved.</copyright>
-	<version>1.136.2</version>
+	<version>1.138.0</version>
 
 	<documentation>UI5 library: sap.ui.export</documentation>
 

package/src/sap/ui/export/ExportBase.js

@@ -27,7 +27,7 @@ sap.ui.define([
 	 * @class The <code>sap.ui.export.ExportBase</code> class allows you to export table data from a UI5 application to certain formats. This class is an abstract class that requires specific implementations for each file format.
 	 *
 	 * @author SAP SE
-	 * @version 1.136.2
+	 * @version 1.138.0
 	 *
 	 * @since 1.96
 	 * @alias sap.ui.export.ExportBase

package/src/sap/ui/export/ExportHandler.js

@@ -28,7 +28,7 @@ sap.ui.define([
 	 * @class The <code>sap.ui.export.ExportHandler</code> class allows you to export table data from an SAPUI5 application.
 	 *
 	 * @author SAP SE
-	 * @version 1.136.2
+	 * @version 1.138.0
 	 *
 	 * @since 1.102
 	 * @alias sap.ui.export.ExportHandler

package/src/sap/ui/export/ExportUtils.js

@@ -144,7 +144,7 @@ sap.ui.define([
 	 * @class Utilities related to export to enable reuse in integration scenarios (e.g. tables).
 	 *
 	 * @author SAP SE
-	 * @version 1.136.2
+	 * @version 1.138.0
 	 *
 	 * @since 1.59
 	 * @alias sap.ui.export.ExportUtils
@@ -295,6 +295,9 @@ sap.ui.define([
 						name: "sap.ui.export.fragments.SettingsDialog",
 						type: "XML",
 						controller: {
+							isSupported: function(sFileType, bFeatureEnabled) {
+								return sFileType !== FileType.PDF || bFeatureEnabled;
+							},
 							isPDF: function(sValue, bFeatureEnabled) {
 								return sValue === FileType.PDF && bFeatureEnabled !== false;
 							},
@@ -350,9 +353,12 @@ sap.ui.define([
 									return;
 								}
 
-								switch (oSelectedItem.getKey()) {
+								const sKey = oSelectedItem.getKey();
+								switch (sKey) {
 									case FileType.PDF:
-										oExportConfigModel.setProperty("/includeFilterSettings", false);
+										if (!oExportCapabilities?.PDF?.CoverPage) {
+											oExportConfigModel.setProperty("/includeFilterSettings", false);
+										}
 										fnSetSemanticStepName(oExportConfigModel, oExportSettingsDialog.getBeginButton());
 										break;
 									case FileType.GSHEET:
@@ -364,6 +370,7 @@ sap.ui.define([
 										Element.getElementById("exportSettingsDialog-signatureReasonLabel").setVisible(false);
 										fnSetSemanticStepName(oExportConfigModel, oExportSettingsDialog.getBeginButton());
 								}
+								oExportConfigModel.setProperty("/fileType", sKey);
 							},
 							onDestinationChange: function (oEvent) {
 								if (!oEvent.getParameter("selectedItem")) {
@@ -1208,7 +1215,7 @@ sap.ui.define([
 		 *
 		 * @param {object} oContext Context object
 		 * @param {string} [oContext.application] Name of the application (default: "SAP UI5")
-		 * @param {string} [oContext.version] Application version (default: "1.136.2")
+		 * @param {string} [oContext.version] Application version (default: "1.138.0")
 		 * @param {string} [oContext.title] Title that will be written to the file (NOT the filename)
 		 * @param {string} [oContext.modifiedBy] Optional user context that will be written to the file
 		 * @param {string} [oContext.sheetName] Name of the data sheet - Maximum length of 31 characters
@@ -1561,23 +1568,32 @@ sap.ui.define([
 
 		/**
 		 * Provides Office Open XML compliant default format settings
-		 * based on the UI5 Formatting facade.
+		 * based on the UI5 LocaleData facade.
 		 *
+		 * @param {"full"|"long"|"medium"|"short"} [sDateStyle="short"] Date style to be used for the date pattern
+		 * @param {"full"|"long"|"medium"|"short"} [sTimeStyle="medium"] Time style to be used for the time pattern
 		 * @returns {Object} Format settings
 		 *
 		 * @static
 		 * @private
 		 */
-		getFormatSettings: function() {
+		getFormatSettings: function(sDateStyle = "short", sTimeStyle = "medium") {
+			const aValidStyles = ["full", "long", "medium", "short"];
+			if (aValidStyles.includes(sDateStyle) === false || aValidStyles.includes(sTimeStyle) === false) {
+				throw new Error(`Invalid date or time style provided. Valid styles are: ${aValidStyles.join(", ")}`);
+			}
+
 			if (!oDefaultFormatSettings) {
 				const oSettings = {};
+				const oLocale = new Locale(Localization.getLanguageTag());
+				const oLocaleData = LocaleData.getInstance(oLocale);
 
 				/*
 				 * Load default format settings from UI5 Formatting facade
 				 */
 				oSettings.calendar = Formatting.getCalendarType();
-				oSettings.datePattern = Formatting.getDatePattern("medium");
-				oSettings.timePattern = Formatting.getTimePattern("medium");
+				oSettings.datePattern = oLocaleData.getDatePattern(sDateStyle, oSettings.calendar);
+				oSettings.timePattern = oLocaleData.getTimePattern(sTimeStyle, oSettings.calendar);
 				oSettings.delimiter = !!Formatting.getNumberSymbol("group");
 
 				/* Post processing: lower case, pattern specific replacement */
@@ -1590,11 +1606,11 @@ sap.ui.define([
 				 * https://unicode.org/reports/tr35/tr35-dates.html#dfst-period
 				 */
 				if (typeof oSettings.timePattern === "string") {
-					oSettings.timePattern = oSettings.timePattern.toLowerCase().replace(/ a+/, " AM/PM");
+					oSettings.timePattern = oSettings.timePattern.toLowerCase().replace(/\Wa/, " AM/PM");
 				}
 
 				if (oSettings.datePattern && oSettings.timePattern) {
-					oSettings.dateTimePattern = `${oSettings.datePattern} ${oSettings.timePattern}`;
+					oSettings.dateTimePattern = oLocaleData.getCombinedDateTimePattern(sDateStyle, sTimeStyle, oSettings.calendar).toLowerCase().replace(/\Wa/, " AM/PM");
 				}
 
 				oDefaultFormatSettings = oSettings;

package/src/sap/ui/export/PortableDocument.js

@@ -28,7 +28,7 @@ sap.ui.define([
 	 * @class The <code>sap.ui.export.PortableDocument</code> class allows you to export table data from a UI5 application to a Portable Document Format (*.PDF) file.
 	 *
 	 * @author SAP SE
-	 * @version 1.136.2
+	 * @version 1.138.0
 	 *
 	 * @since 1.96
 	 * @alias sap.ui.export.PortableDocument

package/src/sap/ui/export/Spreadsheet.js

@@ -4,22 +4,23 @@
  */
 
 sap.ui.define([
-		'./library',
-		'./ExportBase',
-		'./ExportDialog',
-		'./ExportUtils',
-		'./SpreadsheetExport',
-		'sap/base/Log',
-		"sap/base/i18n/Formatting",
-		'sap/ui/Device'
+		"./library",
+		"./ExportBase",
+		"./ExportDialog",
+		"./ExportUtils",
+		"./SpreadsheetExport",
+		"sap/base/Log",
+		"sap/base/i18n/Localization",
+		"sap/ui/Device",
+		"sap/ui/core/LocaleData"
 	],
-	function(Library, ExportBase, ExportDialog, ExportUtils, SpreadsheetExport, Log, Formatting, Device) {
-		'use strict';
+	function(Library, ExportBase, ExportDialog, ExportUtils, SpreadsheetExport, Log, Localization, Device, LocaleData) {
+		"use strict";
 
 		// eslint-disable-next-line
 		/* global Blob */
 
-		const CLASS_NAME = 'sap.ui.export.Spreadsheet';
+		const CLASS_NAME = "sap.ui.export.Spreadsheet";
 		const Status = Library.Status;
 
 		/**
@@ -45,85 +46,6 @@ sap.ui.define([
 		 *   <li>Configure the exported file name.</li>
 		 * </ul>
 		 *
-		 *
-		 * <h3>Export settings object</h3>
-		 * Export settings should be provided in the constructor as an <code>mSettings</code> property map with the following fields:
-		 * <ul>
-		 *   <li><code>workbook</code> - Spreadsheet properties object
-		 *   <ul>
-		 *       <li><code>workbook.columns</code> - Array of column configurations. Each column configuration is an object with the following fields:
-		 *       <ul>
-		 *         <li><code>label</code> (string) - Column header text</li>
-		 *         <li><code>property</code> (string) - Field name or Array of field names in the data source feed</li>
-		 *         <li><code>type</code> (string) - Optional data type of the field. See {@link sap.ui.export.EdmType} for the list of supported types.
-		 *             If this property is omitted, the property is processed as a string field.</li>
-		 *         <li><code>width</code> (number) - Optional width of the column in characters. There is no 1:1 correspondence between
-		 *           character widths in the exported spreadsheet and CSS units.The width of one character
-		 *           is approximately 0.5em in CSS units, depending on the fonts that are
-		 *           used in the table and in the resulting spreadsheet. The default value is 10 characters.</li>
-		 *         <li><code>textAlign</code> (string) - Horizontal alignment of cell contents. The following values of the CSS <code>text-align</code>
-		 *           property are accepted: <code>[left, right, center, begin, end]</code>. If not specified, the columns are
-		 *           horizontally aligned based on the property type.</li>
-		 *         <li><code>scale</code> (number) - Number of digits after decimal point for numeric values</li>
-		 *         <li><code>autoScale</code> (boolean) - Allows automatic scale assignment based on unit of measure</li>
-		 *         <li><code>delimiter</code> (boolean) - Set to <code>true</code> to display thousands separators in numeric values.
-		 *           The default value is <code>false</code>.</li>
-		 *         <li><code>unit</code> (string) - Text to display as the unit of measurement or currency next to the numeric value.
-		 *           It is treated as a string and has no influence on the value itself. For example, a value of 150 with the unit "%" is still 150
-		 *           and not 1.5, as a user may expect.</li>
-		 *         <li><code>unitProperty</code> (string) - Name of the data source field that contains the unit/currency text</li>
-		 *         <li><code>displayUnit</code> (boolean) - The property applies to currency values only and defines if the currency is shown in the column.
-		 *           The default value is <code>true</code>.</li>
-		 *         <li><code>trueValue</code> (string) - Textual representation of a boolean type that has the value <code>true</code></li>
-		 *         <li><code>falseValue</code> (string) - Textual representation of a boolean type that has the value <code>false</code></li>
-		 *         <li><code>template</code> (string) - Formatting template that supports indexed placeholders within curly brackets</li>
-		 *         <li><code>format</code> (string) - Output format for columns of type Date/DateTime/Time</li>
-		 *         <li><code>inputFormat</code> (string) - Formatting template for string formatted dates</li>
-		 *         <li><code>utc</code> (boolean) - Defines whether the <code>DateTime</code> is displayed as UTC or local time</li>
-		 *         <li><code>timezone</code> (string) - Defines a fixed IANA time zone</li>
-		 *         <li><code>timezoneProperty</code> (string) - References an OData property that contains the specific IANA time zone</li>
-		 *         <li><code>displayTimezone</code> (boolean) - Defines whether the IANA time zone is displayed within a cell</li>
-		 *         <li><code>valueMap</code> (string) - Mapping object or Map containing the values that should be mapped to a particular key</li>
-		 *         <li><code>wrap</code> (boolean) - Indicates if wrapping is enabled for this particular column</li>
-		 *      </ul>
-		 *      </li>
-		 *      <li><code>workbook.context</code> - Context object that will be applied to the generated file. It may contain the following fields:</li>
-		 *      <ul>
-		 *          <li><code>application</code> (string) - The application that creates the XLSX document (default: "SAP UI5")</li>
-		 *          <li><code>version</code> (string) - Application version that creates the XLSX document (default: "1.136.2")</li>
-		 *          <li><code>title</code> (string) - Title of the XLSX document (NOT the filename)</li>
-		 *          <li><code>modifiedBy</code> (string) - User context for the XLSX document</li>
-		 *          <li><code>sheetName</code> (string) - The label of the data sheet</li>
-		 *          <li><code>metaSheetName</code> (string) - The label of the metadata sheet. The sheet will not be shown unless metadata entries are provided</li>
-		 *          <li><code>metainfo</code> (Array) - An Array of metadata groups. Each group has a name property and an items Array which contains key/value pairs</li>
-		 *      </ul>
-		 *      <li><code>workbook.hierarchyLevel</code> - Name of the property that contains the hierarchy level information of each line item</li>
-		 *   </ul>
-		 *   <li><code>dataSource</code> - Source of spreadsheet data. It can be a JSON array with row data,
-		 *      an URL or an OData properties object with the following fields:
-		 *      <ul>
-		 *         <li><code>type</code> (string) - Type of the data source. Currently, only OData is supported and the value have to be set to <code>"odata"</code>.</li>
-		 *         <li><code>dataUrl</code> (string) - URL to table data on the server, including all select, filter, and search query parameters</li>
-		 *         <li><code>serviceUrl</code> (string) - URL to the OData service. The parameter is required for OData batch requests.</li>
-		 *         <li><code>count</code> (number) - Count of available records on the server</li>
-		 *         <li><code>useBatch</code> (boolean) - Set to <code>true</code> if OData batch requests are used to fetch the spreadsheet data.
-		 *            In this case, <code>serviceUrl</code> and <code>headers</code> have to be specified, too.</li>
-		 *         <li><code>headers</code> (object) - Map of HTTP request header properties. They should correspond to the HTTP request headers that are
-		 *            used to obtain table data for display in the browser.</li>
-		 *         <li><code>sizeLimit</code> (number) - Maximum allowed number of records that can be obtained from the service in a single request</li>
-		 * 		   <li><code>downloadLimit</code> (number) - Maximum allowed number of rows that can be exported. If not specified, all rows are exported.</li>
-		 *      </ul>
-		 *   </li>
-		 *   <li><code>count</code> (number) - The maximal number of records to export. If not specified, all data from the data source is fetched.</li>
-		 *   <li><code>worker</code> (boolean) - Run export process in a worker thread. Set to <code>false</code> to disable worker and run export
-		 *        in a main thread. This is needed, for example, if a mock server is used to provide spreadsheet data.<br>
-		 *        <b>Note:</b> In case of a strict content security policy, it is not always possible to create an export worker.
-		 *        In this case, export runs in a main thread disregarding the <code>worker</code> value.</li>
-		 *   <li><code>fileName</code> (string) - Optional file name for the exported file. If not specified, the spreadsheet is exported as <code>export.xlsx</code>.</li>
-		 *   <li><code>showProgress</code> (boolean) - Set to <code>false</code> to suppress the progress dialog</li>
-		 * </ul>
-		 *
-		 *
 		 * <h3>Usage</h3>
 		 * To start export, create a new <code>sap.ui.export.Spreadsheet</code> object and call the <code>build</code> method.
 		 * Column configuration, data source, and export settings must be provided in the constructor.
@@ -174,7 +96,7 @@ sap.ui.define([
 		 *       columns: aColumns,
 		 *       context: {
 		 *         application: 'Debug Test Application',
-		 *         version: '1.136.2',
+		 *         version: '1.138.0',
 		 *         title: 'Some random title',
 		 *         modifiedBy: 'John Doe',
 		 *         metaSheetName: 'Custom metadata',
@@ -256,37 +178,12 @@ sap.ui.define([
 		 * object are limited to 31 characters each. If their value exceeds
 		 * this maximum length, the value will be truncated.
 		 *
-		 * @param {object} mSettings - Export settings
-		 * @param {object} mSettings.workbook - Spreadsheet properties
-		 * @param {Array} mSettings.workbook.columns - Column configuration
-		 * @param {object} [mSettings.workbook.context] - Export context that will be applied to the exported file
-		 * @param {string} [mSettings.workbook.context.application] - Application that created this XLSX
-		 * @param {string} [mSettings.workbook.context.version] - Application version that was used to create this XLSX
-		 * @param {string} [mSettings.workbook.context.title] - Title of the XLSX document (NOT the file name)
-		 * @param {string} [mSettings.workbook.context.modifiedBy] - User context for the exported document
-		 * @param {string} [mSettings.workbook.context.sheetName] - The name of the data sheet that will be shown in Excel
-		 * @param {string} [mSettings.workbook.context.metaSheetName] - The name of the metadata sheet that will be shown in Excel
-		 * @param {Array} [mSettings.workbook.context.metainfo] - Optional Metadata that will be displayed in the additional Metadata Sheet
-		 * @param {string} [mSettings.workbook.hierarchyLevel] - Optional name of the property that contains hierarchy level information
-		 * @param {string | Object | Array | sap.ui.model.ListBinding | sap.ui.model.TreeBinding} mSettings.dataSource - Source of spreadsheet data.
-		 * 	      A JSON array, data source properties map, <code>sap.ui.model.ListBinding</code>, <code>sap.ui.model.TreeBinding</code> or
-		 *        URL to an OData source can be provided. For example, <code>"someUrl"</code> is an equivalent to
-		 *        <code>{dataUrl:"someUrl", type:"OData"}</code>. An instance of <code>sap.ui.model.ListBinding</code> or
-		 *        <code>sap.ui.model.TreeBinding</code> either has to implement a <code>#getDownloadUrl</code> function or needs to be a ClientListBinding.
-		 *        <b>Note:</b> <code>sap.ui.model.ClientTreeBinding</code> is not supported.
-		 * @param {int} mSettings.dataSource.sizeLimit - Maximal allowed number of records that can be obtained from the service in a single request
-		 * @param {int} [mSettings.count] - The maximal number of records to export
-		 * @param {boolean} [mSettings.worker=true] - Run export process in a worker thread. Set to <code>false</code> to disable worker and run export
-		 *        in a main thread. This is needed, for example, if a mock server is used to provide spreadsheet data.<br>
-		 *        <b>Note:</b> In case of a strict content security policy, it is not always possible to create an export worker.
-		 *        In this case, export runs in a main thread disregarding the <code>worker</code> value.
-		 * @param {string} [mSettings.fileName="export.xlsx"] - Optional file name for the exported file
-		 * @param {boolean} [mSettings.showProgress=true] - Set to <code>false</code> to suppress the progress dialog
+		 * @param {sap.ui.export.SpreadsheetSettings} mSettings - Export settings
 		 *
 		 * @class The <code>sap.ui.export.Spreadsheet</code> class allows you to export table data from a UI5 application to a spreadsheet file.
 		 *
 		 * @author SAP SE
-		 * @version 1.136.2
+		 * @version 1.138.0
 		 *
 		 * @since 1.50
 		 * @alias sap.ui.export.Spreadsheet
@@ -306,8 +203,8 @@ sap.ui.define([
 
 				/* Only apply supported properties */
 				// IMPORTANT: keep count before dataSource to ensure that the expected count can be used for dataSource string
-				['showProgress', 'worker'].forEach(function(sProperty) {
-					if (typeof mSettings[sProperty] !== 'undefined') {
+				["showProgress", "worker"].forEach(function(sProperty) {
+					if (typeof mSettings[sProperty] !== "undefined") {
 						this._mSettings[sProperty] = mSettings[sProperty];
 					}
 				}.bind(this));
@@ -321,8 +218,8 @@ sap.ui.define([
 				mCurrencies[sCurrencyCode] = {};
 			}
 
-			if (!isNaN(oCurrency.digits)) {
-				mCurrencies[sCurrencyCode].scale = oCurrency.digits;
+			if (!isNaN(oCurrency)) {
+				mCurrencies[sCurrencyCode].scale = oCurrency;
 			}
 
 			if (!isNaN(oCurrency.UnitSpecificScale)) {
@@ -359,21 +256,22 @@ sap.ui.define([
 				oWorkbookContext = mParameters.workbook.context = {};
 			}
 			if (!oWorkbookContext.title) {
-				oWorkbookContext.title = oResourceBundle.getText('XLSX_DEFAULT_TITLE');
+				oWorkbookContext.title = oResourceBundle.getText("XLSX_DEFAULT_TITLE");
 			}
 			if (!oWorkbookContext.sheetName) {
-				oWorkbookContext.sheetName = oResourceBundle.getText('XLSX_DEFAULT_SHEETNAME');
+				oWorkbookContext.sheetName = oResourceBundle.getText("XLSX_DEFAULT_SHEETNAME");
 			}
 
 			/* Initialize currency customizing for currencies and units of measure */
 			const mCurrencySettings = mParameters.customizing.currency = {};
 			const mUnitSettings = mParameters.customizing.unit = {};
-			const oCustomCurrencies = Formatting.getCustomCurrencies();
+			const oLocaleData = LocaleData.getInstance(Localization.getLanguageTag());
+			const oLocaleDataCurrencies = oLocaleData.getAllCurrencyDigits();
 
 			/* Attach custom currency configuration */
-			if (oCustomCurrencies) {
-				for (const sCurrencyCode in oCustomCurrencies) {
-					addUnit(sCurrencyCode, oCustomCurrencies[sCurrencyCode], mCurrencySettings);
+			if (oLocaleDataCurrencies) {
+				for (const sCurrencyCode in oLocaleDataCurrencies) {
+					addUnit(sCurrencyCode, oLocaleDataCurrencies[sCurrencyCode], mCurrencySettings);
 				}
 			}
 
@@ -401,7 +299,7 @@ sap.ui.define([
 		 * @private
 		 */
 		Spreadsheet.requestCodeLists = function(oMetaModel) {
-			if (!oMetaModel.isA(['sap.ui.model.odata.ODataMetaModel', 'sap.ui.model.odata.v4.ODataMetaModel'])) {
+			if (!oMetaModel.isA(["sap.ui.model.odata.ODataMetaModel", "sap.ui.model.odata.v4.ODataMetaModel"])) {
 				return Promise.resolve([null, null]);
 			}
 
@@ -409,7 +307,7 @@ sap.ui.define([
 				oMetaModel.requestCurrencyCodes(),
 				oMetaModel.requestUnitsOfMeasure()
 			]).catch(function(oError) {
-				Log.warning(CLASS_NAME + ': Code lists cannot be processed due to the following error - ' + oError);
+				Log.warning(CLASS_NAME + ": Code lists cannot be processed due to the following error - " + oError);
 				return Promise.resolve([null, null]);
 			});
 		};
@@ -449,7 +347,7 @@ sap.ui.define([
 		 * @public
 		 */
 		Spreadsheet.prototype.attachBeforeSave = function(oData, fnHandler, oListener) {
-			return this.attachEvent('beforeSave', oData, fnHandler, oListener);
+			return this.attachEvent("beforeSave", oData, fnHandler, oListener);
 		};
 
 		/**
@@ -465,7 +363,7 @@ sap.ui.define([
 		 * @public
 		 */
 		Spreadsheet.prototype.detachBeforeSave = function(fnHandler, oListener) {
-			return this.detachEvent('beforeSave', fnHandler, oListener);
+			return this.detachEvent("beforeSave", fnHandler, oListener);
 		};
 
 		/**
@@ -494,7 +392,7 @@ sap.ui.define([
 		 * @public
 		 */
 		Spreadsheet.prototype.getMimeType = function() {
-			return 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet';
+			return "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
 		};
 
 		/**
@@ -511,7 +409,7 @@ sap.ui.define([
 			}
 
 			const iProgress = Math.round(iFetched / iTotal * 100);
-			Log.debug('Spreadsheet export: ' + iProgress + '% loaded.');
+			Log.debug(`Spreadsheet export: ${iProgress}% loaded.`);
 		};
 
 		/**
@@ -532,7 +430,7 @@ sap.ui.define([
 			/**
 			 * If <code>ClientListBinding</code>, we use the binding path to receive the data from the underlying model
 			 */
-			if (oBinding.isA('sap.ui.model.ClientListBinding')) {
+			if (oBinding.isA("sap.ui.model.ClientListBinding")) {
 				const aData = [];
 
 				oBinding.getAllCurrentContexts().forEach(function(oContext) {
@@ -541,30 +439,30 @@ sap.ui.define([
 
 				oDataSource = {
 					data: aData,
-					type: 'array'
+					type: "array"
 				};
 			}
 
-			if (oBinding.isA('sap.ui.model.ClientTreeBinding')) {
-				Log.error('Unable to create dataSource configuration due to not supported Binding: ' + oBinding.getMetadata().getName());
+			if (oBinding.isA("sap.ui.model.ClientTreeBinding")) {
+				Log.error("Unable to create dataSource configuration due to not supported Binding: " + oBinding.getMetadata().getName());
 			}
 
 			/**
 			 * All other <code>Bindings</code> need to provide a downloadUrl
 			 */
-			if (typeof oBinding.getDownloadUrl === 'function') {
+			if (typeof oBinding.getDownloadUrl === "function") {
 				const oModel = oBinding.getModel();
-				const bV4ODataModel = oModel.isA('sap.ui.model.odata.v4.ODataModel');
-				let sDataUrl = oBinding.getDownloadUrl('json');
+				const bV4ODataModel = oModel.isA("sap.ui.model.odata.v4.ODataModel");
+				let sDataUrl = oBinding.getDownloadUrl("json");
 				let sServiceUrl = oModel.sServiceUrl;
 
 				sDataUrl = ExportUtils.interceptUrl(sDataUrl);
 				sServiceUrl = ExportUtils.interceptUrl(sServiceUrl);
 
-				const bIgnoreCount = sDataUrl.split(/[?&]/g).some((sQuery) => sQuery?.includes('$apply') && sQuery?.includes('com.sap.vocabularies.Hierarchy.v1.TopLevels'));
+				const bIgnoreCount = sDataUrl.split(/[?&]/g).some((sQuery) => sQuery?.includes("$apply") && sQuery?.includes("com.sap.vocabularies.Hierarchy.v1.TopLevels"));
 
 				oDataSource = {
-					type: 'odata',
+					type: "odata",
 					dataUrl: sDataUrl,
 					serviceUrl: sServiceUrl,
 					headers: bV4ODataModel ? oModel.getHttpHeaders(true) : oModel.getHeaders(),
@@ -575,8 +473,8 @@ sap.ui.define([
 
 				/* Obtain CodeLists from ODataMetaModel */
 				if (oModel.getMetaModel()
-					&& typeof oModel.getMetaModel().requestCurrencyCodes === 'function'
-					&& typeof oModel.getMetaModel().requestUnitsOfMeasure === 'function') {
+					&& typeof oModel.getMetaModel().requestCurrencyCodes === "function"
+					&& typeof oModel.getMetaModel().requestUnitsOfMeasure === "function") {
 
 					this.codeListsPromise = Spreadsheet.requestCodeLists(oModel.getMetaModel(), this._mSettings);
 				}
@@ -605,30 +503,30 @@ sap.ui.define([
 				return null;
 			}
 
-			if (sDataSourceType == 'string') {
+			if (sDataSourceType == "string") {
 				return {
 					count: this._mSettings.count,
 					dataUrl: oDataSource,
-					type: 'odata',
+					type: "odata",
 					useBatch: false
 				};
 			}
 
-			if (sDataSourceType != 'object') {
-				Log.error('Spreadsheet#processDataSource: Unable to apply data source of type ' + sDataSourceType);
+			if (sDataSourceType != "object") {
+				Log.error("Spreadsheet#processDataSource: Unable to apply data source of type " + sDataSourceType);
 
 				return null;
 			}
 
 			if (oDataSource instanceof Array ) {
-				mDataSource = {data: oDataSource, type: 'array'};
+				mDataSource = {data: oDataSource, type: "array"};
 			}
 
 			if (oDataSource.dataUrl) {
 				mDataSource = oDataSource;
 			}
 
-			if (oDataSource.isA && oDataSource.isA(['sap.ui.model.ListBinding', 'sap.ui.model.TreeBinding'])) {
+			if (oDataSource.isA && oDataSource.isA(["sap.ui.model.ListBinding", "sap.ui.model.TreeBinding"])) {
 				mDataSource = this.createDataSourceFromBinding(oDataSource);
 			}
 
@@ -653,7 +551,7 @@ sap.ui.define([
 				const iCount = mParameters.dataSource.count;
 				const iDownloadLimit = mParameters.dataSource.downloadLimit;
 				const nSizeLimit = Device.system.desktop ? 2_000_000 : 100_000; // 2.000.000 cells on desktop and 100.000 otherwise
-				const nRows = mParameters.dataSource.type == 'array' ? mParameters.dataSource.data.length : iDownloadLimit || iCount;
+				const nRows = mParameters.dataSource.type == "array" ? mParameters.dataSource.data.length : iDownloadLimit || iCount;
 				const nColumns = mParameters.workbook.columns.length;
 
 				function onmessage(oMessage) {
@@ -677,7 +575,7 @@ sap.ui.define([
 							return;
 						}
 
-						const executeDefaultAction = that.fireEvent('beforeSave', {
+						const executeDefaultAction = that.fireEvent("beforeSave", {
 							data: oMessage.spreadsheet,
 							exportDialog: progressDialog
 						}, true, false);
@@ -700,7 +598,7 @@ sap.ui.define([
 						fnResolve();
 					}
 
-					if (typeof oMessage.error != 'undefined') {
+					if (typeof oMessage.error != "undefined") {
 						const sError = oMessage.error.message || oMessage.error;
 						that.process = null;
 
@@ -721,7 +619,7 @@ sap.ui.define([
 				function startExport() {
 					if (!mParameters.showProgress) {
 						if (that.process) {
-							fnReject('Cannot start export: the process is already running');
+							fnReject("Cannot start export: the process is already running");
 							return;
 						}
 
@@ -734,7 +632,7 @@ sap.ui.define([
 						progressDialog = oDialogResolve;
 
 						if (that.process) {
-							fnReject('Cannot start export: the process is already running');
+							fnReject("Cannot start export: the process is already running");
 							return;
 						}
 
@@ -755,7 +653,7 @@ sap.ui.define([
 				// When there are no columns --> don't trigger the export
 				if (nColumns <= 0) {
 					// Consider showing a dialog to the end users instead of just this error!
-					fnReject('No columns to export.');
+					fnReject("No columns to export.");
 				} else if (nRows * nColumns > nSizeLimit || !nRows || nRows >= MAX_ROWS || isDownloadLimitLessThanCount(nRows, iCount)) { // Amount of rows need to be less than maximum amount because of column header
 					const oDialogSettings = {
 						rows: nRows,

package/src/sap/ui/export/SpreadsheetExport.js

@@ -21,7 +21,7 @@ sap.ui.define(['sap/base/Log', 'sap/ui/export/ExportUtils'], function(Log, Expor
 	 * Utility class to perform spreadsheet export.
 	 *
 	 * @author SAP SE
-	 * @version 1.136.2
+	 * @version 1.138.0
 	 *
 	 * @alias sap.ui.export.SpreadsheetExport
 	 * @private

package/src/sap/ui/export/fragments/SettingsDialog.fragment.xml

@@ -5,7 +5,7 @@
 			<Input id="exportSettingsDialog-fileName" value="{/fileName}" liveChange=".onFileNameChange" class="sapUiTinyMarginBottom"/>
 
 			<Label text="{i18n>SELECT_FORMAT}" labelFor="exportSettingsDialog-fileType"/>
-			<Select id="exportSettingsDialog-fileType" selectedKey="{/fileType}" items="{/fileTypeCollection}" change=".onFileTypeChange" width="100%" class="sapUiTinyMarginBottom">
+			<Select id="exportSettingsDialog-fileType" selectedKey="{path: '/fileType', mode: 'OneWay' }" items="{/fileTypeCollection}" change=".onFileTypeChange" width="100%" class="sapUiTinyMarginBottom">
 				<items>
 					<core:Item key="{key}" text="{text}"/>
 				</items>
@@ -18,8 +18,7 @@
 				</items>
 			</Select>
 
-			<CheckBox id="exportSettingsDialog-includeFilterSettings" selected="{/includeFilterSettings}" text="{i18n>INCLUDE_FILTER_SETTINGS}"  visible="{path:'/fileType', formatter: '.isSpreadsheet'}"/>
-			<CheckBox id="exportSettingsDialog-includeFilterSettings-PDF" selected="{/includeFilterSettings}" text="{i18n>INCLUDE_FILTER_SETTINGS}"  visible="{parts:['/fileType', '/capabilities/PDF/CoverPage'], formatter: '.isPDF'}" tooltip="{i18n>TOOLTIP_FILTER_SETTINGS}"/>
+			<CheckBox id="exportSettingsDialog-includeFilterSettings" selected="{/includeFilterSettings}" text="{i18n>INCLUDE_FILTER_SETTINGS}"  visible="{parts:['/fileType', '/capabilities/PDF/CoverPage'], formatter: '.isSupported'}" tooltip="{i18n>TOOLTIP_FILTER_SETTINGS}"/>
 			<CheckBox id="exportSettingsDialog-pdfArchive" selected="{/pdfArchive}" text="{i18n>ARCHIVE_FORMAT}"  visible="{parts:['/fileType', '/capabilities/PDF/ArchiveFormat'], formatter: '.isPDF'}" tooltip="{i18n>TOOLTIP_ARCHIVE_FORMAT}"/>
 			<CheckBox id="exportSettingsDialog-splitCells" selected="{/splitCells}" text="{i18n>SPLIT_CELLS}" visible="{path:'/fileType', formatter: '.isSpreadsheet'}"/> <!-- Will be hidden in case of PDF because it needs to be always true and is applied implicitly -->
 			<CheckBox id="exportSettingsDialog-addDateTime" selected="{/addDateTime}" text="{i18n>ADD_DATE_TIME}" visible="false"/>

package/src/sap/ui/export/library.js

@@ -15,7 +15,7 @@ sap.ui.define(["sap/ui/core/Lib"], function(Library) {
 	 * @namespace
 	 * @alias sap.ui.export
 	 * @author SAP SE
-	 * @version 1.136.2
+	 * @version 1.138.0
 	 * @public
 	 */
 
@@ -34,7 +34,7 @@ sap.ui.define(["sap/ui/core/Lib"], function(Library) {
 		interfaces: [],
 		controls: [],
 		elements: [],
-		version: "1.136.2"
+		version: "1.138.0"
 	});
 
 	/**
@@ -229,5 +229,73 @@ sap.ui.define(["sap/ui/core/Lib"], function(Library) {
 		}
 	});
 
+	/**
+	 * @typedef {object} sap.ui.export.SpreadsheetSettings
+	 * @property {object} workbook - Spreadsheet properties object.
+	 * @property {sap.ui.export.Column[]} workbook.columns - Column configurations.
+	 * @property {object} [workbook.context] - Export context that will be applied to the exported file.
+	 * @property {string} [workbook.context.application="SAP UI5"] - The application that creates the XLSX document.
+	 * @property {string} [workbook.context.version="1.138.0"] - Application version that creates the XLSX document.
+	 * @property {string} [workbook.context.title] - Title of the XLSX document (NOT the file name).
+	 * @property {string} [workbook.context.modifiedBy] - User context for the XLSX document.
+	 * @property {string} [workbook.context.sheetName] - The label of the data sheet.
+	 * @property {string} [workbook.context.metaSheetName] - The label of the metadata sheet. The sheet will not be shown unless metadata entries are provided
+	 * @property {Array.<{name: string, items: Array.<{key: string, value: string}>}>} [workbook.context.metainfo] - Metadata groups with key/value pairs.
+	 * @property {string} [workbook.hierarchyLevel] - Name of the property that contains hierarchy level information.
+	 * @property {string|object|Array|sap.ui.model.ListBinding|sap.ui.model.TreeBinding} dataSource
+	 *     Source of spreadsheet data. Can be an array with row data, an URL, a binding instance, or an OData properties object.
+	 * @property {"odata"} dataSource.type - Type of the data source. Currently, only OData is supported and the value has to be set to "odata".
+	 * @property {string} dataSource.dataUrl - URL to table data on the server, including all select, filter, and search query parameters.
+	 * @property {string} [dataSource.serviceUrl] - URL to the OData service. Required for OData batch requests.
+	 * @property {number} [dataSource.count] - Count of available records on the server.
+	 * @property {boolean} [dataSource.useBatch]
+	 *     Whether batch requests are used to fetch the spreadsheet data. In this case, <code>serviceUrl</code> and <code>headers</code> have to be
+	 *     specified, too.
+	 * @property {Object.<string, string>} [dataSource.headers] - Map of HTTP request header properties.
+	 * @property {number} [dataSource.sizeLimit] - Maximum allowed number of records that can be obtained from the service in a single request.
+	 * @property {number} [dataSource.downloadLimit] - Maximum allowed number of rows that can be exported. If not specified, all rows are exported.
+	 * @property {number} [count] - The maximal number of records to export. If not specified, all data from the data source is fetched.
+	 * @property {boolean} [worker=true] - Whether to run the export process in a worker or the main thread.
+	 * @property {string} [fileName="export.xlsx"] - File name for the exported file.
+	 * @property {boolean} [showProgress=true] - Whether to show the progress dialog.
+	 *
+	 * @public
+	 */
+
+	/**
+	 * @typedef {object} sap.ui.export.Column
+	 * @property {string} [label] - Column header text.
+	 * @property {string|string[]} [property] - Field name or array of field names in the data source feed.
+	 * @property {sap.ui.export.EdmType} [type=sap.ui.export.EdmType.String] - Data type of the field.
+	 * @property {number} [width=10]
+	 *     Width of the column in characters. There is no 1:1 correspondence between character widths in the exported spreadsheet and CSS units. The
+	 *     width of one character is approximately 0.5em in CSS units, depending on the fonts that are used in the table and in the resulting
+	 *     spreadsheet.
+	 * @property {string} [textAlign]
+	 *     Horizontal alignment of cell contents. Accepted values: `left`, `right`, `center`, `begin`, `end`. If not specified, the columns are
+	 *     aligned based on the type.</li>
+	 * @property {number} [scale] - Number of digits after the decimal point for numeric values.
+	 * @property {boolean} [autoScale] - Allows automatic scale assignment based on unit of measure.
+	 * @property {boolean} [delimiter=false] - Whether to display thousands separators in numeric values.
+	 * @property {string} [unit]
+	 *     Text to display as the unit of measurement or currency next to the numeric value. It is treated as a string and has no influence on the
+	 *     value itself. For example, a value of 150 with the unit "%" is still 150 and not 1.5, as a user may expect.
+	 * @property {string} [unitProperty] - Name of the data source field that contains the unit/currency text.
+	 * @property {boolean} [displayUnit=true] - Defines if the currency is shown in the column (applies to currency values only).
+	 * @property {string} [trueValue] - Textual representation of a boolean type that has the value <code>true</code>.
+	 * @property {string} [falseValue] - Textual representation of a boolean type that has the value <code>false</code>.
+	 * @property {string} [template] - Formatting template that supports indexed placeholders within curly brackets.
+	 * @property {string} [format] - Output format for columns of type Date/DateTime/Time.
+	 * @property {string} [inputFormat] - Formatting template for string-formatted dates.
+	 * @property {boolean} [utc] - Whether the <code>DateTime</code> is displayed as UTC or local time.
+	 * @property {string} [timezone] - Defines a fixed IANA time zone.
+	 * @property {string} [timezoneProperty] - References an OData property that contains the specific IANA time zone.
+	 * @property {boolean} [displayTimezone] - Whether the IANA time zone is displayed within a cell.
+	 * @property {object} [valueMap] - Mapping object or Map containing the values that should be mapped to a particular key.
+	 * @property {boolean} [wrap] - Indicates if wrapping is enabled for this particular column.
+	 *
+	 * @public
+	 */
+
 	return thisLib;
 });

package/src/sap/ui/export/provider/DataProviderBase.js

@@ -24,7 +24,7 @@
 	 * @param {object} mSettings Data service related part of the export configuration
 	 *
 	 * @author SAP SE
-	 * @version 1.136.2
+	 * @version 1.138.0
 	 *
 	 * @constructor
 	 * @class DataProviderBase

package/src/sap/ui/export/util/Filter.js

@@ -20,7 +20,7 @@ sap.ui.define(['sap/ui/base/Object'], function(BaseObject) {
 	 * convenience functions like <code>sap.ui.export.util.Filter#setType</code> to improve the result.
 	 *
 	 * @author SAP SE
-	 * @version 1.136.2
+	 * @version 1.138.0
 	 *
 	 * @since 1.110
 	 * @alias sap.ui.export.util.Filter