@openui5/sap.ui.mdc 1.130.1 → 1.131.0

package/src/sap/ui/mdc/Table.js

@@ -165,9 +165,9 @@ sap.ui.define([
 	 * @property {boolean} [isKey=false]
 	 *   Defines whether a property is a key or part of a key in the data.
 	 * @property {string} [unit]
-	 *   Key of the unit property that is related to this property.
+	 *   Key of the unit property that is related to this property. A property must not have both a unit and a text.
 	 * @property {string} [text]
-	 *   Key of the text property that is related to this property in a 1:1 relation.
+	 *   Key of the text property that is related to this property in a 1:1 relation. A property must not have both a unit and a text.
 	 * @property {object} [exportSettings]
 	 *   Object that contains information about the export settings, see {@link sap.ui.export.Spreadsheet}.
 	 * @property {object} [clipboardSettings]
@@ -201,6 +201,8 @@ sap.ui.define([
 	 * @public
 	 */
 
+	// TODO: The extension in PropertyInfo has been discarded as a general concept in MDC, therefore it might be justified to move this typedef to
+	// sap.ui.mdc.odata.v4.TableDelegate. They are tightly coupled and other MDC controls also won't contain multiple PropertyInfo definitions.
 	/**
 	 * @typedef {sap.ui.mdc.table.PropertyInfo} sap.ui.mdc.odata.v4.TablePropertyInfo
 	 *
@@ -235,6 +237,8 @@ sap.ui.define([
 	 *   <li><code>propertyInfos</code> (all referenced properties must be specified)</li>
 	 * </ul>
 	 *
+	 * @property {boolean} [isKey=false]
+	 *   Defines whether a property is a key or part of a key in the data. A key property must be technically groupable.
 	 * @property {boolean} [aggregatable=false]
 	 *   Defines whether the property is aggregatable. A property can only be declared aggregatable if there is a <code>CustomAggregate</code> whose
 	 *   <code>Qualifier</code> is equal to the property key.
@@ -250,7 +254,8 @@ sap.ui.define([
 	 *   <code>aggregatable</code>.
 	 * @property {string[]} [extension.additionalProperties]
 	 *   Properties that are loaded in addition if this property is loaded. These properties must be technically groupable, otherwise they can't be
-	 *   loaded.
+	 *   loaded. All nested additional properties must be listed at root level. For example, if property A references B and B references C, A must
+	 *   also reference C.
 	 *   This attribute is only taken into account if the <code>Aggregate</code> or <code>Group</code> <code>p13nMode</code> is enabled and the
 	 *   table type is {@link sap.ui.mdc.table.GridTableType GridTable}.
 	 *   These properties are not considered for any other functionality, such as export or column width calculation, for example.
@@ -994,7 +999,9 @@ sap.ui.define([
 		this._setPropertyHelperClass(PropertyHelper);
 		this._setupPropertyInfoStore("propertyInfo");
 
-		this._oManagedObjectModel = new ManagedObjectModel(this);
+		this._oManagedObjectModel = new ManagedObjectModel(this, {
+			hasGrandTotal: false
+		});
 		this._oManagedObjectModel.setDefaultBindingMode(BindingMode.OneWay);
 		this.setModel(this._oManagedObjectModel, "$sap.ui.mdc.Table");
 	};
@@ -2313,29 +2320,72 @@ sap.ui.define([
 		});
 	};
 
-	Table.prototype._isCollapseAllEnabled = function() {
-		return this.isControlDelegateInitialized() && this.getControlDelegate().getSupportedFeatures(this).collapseAllRows;
+	Table.prototype.setSelectionMode = function(sSelectionMode) {
+		const sOldSelectionMode = this.getSelectionMode();
+
+		this.setProperty("selectionMode", sSelectionMode, true);
+
+		if (sOldSelectionMode !== sSelectionMode) {
+			this._updateExpandAllButton(true);
+			this._updateCollapseAllButton(true);
+		}
+
+		return this;
+	};
+
+	/**
+	 * Checks if collapse capabilities are enabled.
+	 *
+	 * @returns {boolean} whether collapse capabilities are enabled
+	 */
+	Table.prototype._isCollapseEnabled = async function() {
+		if (!this.isControlDelegateInitialized()) {
+			return false;
+		}
+		const oConfig =  await this.getControlDelegate().fetchExpandAndCollapseConfiguration(this);
+		let bAvailable = false;
+
+		if ("collapseAll" in oConfig) {
+			if (typeof oConfig.collapseAll !== "function") {
+				throw new Error("TableDelegate#collapseAll: collapseAll needs to be a function");
+			}
+			bAvailable = true;
+		}
+
+		if ("collapseAllFromNode" in oConfig && "isNodeExpanded" in oConfig) {
+			if (typeof oConfig.collapseAllFromNode !== "function") {
+				throw new Error("TableDelegate#fetchExpandAndCollapseConfiguration: collapseAllFromNode needs to be a function");
+			}
+
+			if (typeof oConfig.isNodeExpanded !== "function") {
+				throw new Error("TableDelegate#isNodeExpanded: isNodeExpanded needs to be a function");
+			}
+
+			bAvailable = true;
+		}
+
+		return bAvailable;
 	};
 
 	/**
 	 * Retrieves the "Collapse All" button. Creates the button if necessary.
 	 *
-	 * @returns {sap.m.MenuButton} button for "Expand All"
+	 * @param {boolean} bRecreate Whether the button should be recreated
 	 * @private
 	 */
-	Table.prototype._updateCollapseAllButton = function() {
-		const bNeedCollapseAllButton = this._oToolbar != null && this._isCollapseAllEnabled();
+	Table.prototype._updateCollapseAllButton = async function(bRecreate) {
+		const bCollapseAllAvailable = await this._isCollapseEnabled();
+		const bNeedCollapseAllButton = this._oToolbar != null && bCollapseAllAvailable;
 
-		if (bNeedCollapseAllButton && !this._oCollapseAllButton) {
-			this._oCollapseAllButton = TableSettings.createExpandCollapseAllButton(this.getId(), [
-				function() {
-					try {
-						this.getControlDelegate().collapseAllRows(this);
-					} catch (oError) {
-						Log.error("CollapseAll could not be performed", oError, this);
-					}
-				}, this
-			], false);
+		if (bNeedCollapseAllButton && (!this._oCollapseAllButton || bRecreate)) {
+			if (this._oCollapseAllButton) {
+				if (this._oToolbar && this._oToolbar.getEnd().includes(this._oCollapseAllButton)) {
+					this._oToolbar.removeEnd(this._oCollapseAllButton);
+				}
+				this._oCollapseAllButton.destroy();
+				this._oCollapseAllButton = null;
+			}
+			this._oCollapseAllButton = await this._createCollapseButton();
 		}
 
 		if (!this._oCollapseAllButton) {
@@ -2347,32 +2397,62 @@ sap.ui.define([
 		}
 
 		this._oCollapseAllButton.setEnabled(!MTableUtil.isEmpty(this.getRowBinding()));
-		this._oCollapseAllButton.setVisible(this._isCollapseAllEnabled());
+		this._oCollapseAllButton.setVisible(bCollapseAllAvailable);
 	};
 
-	Table.prototype._isExpandAllEnabled = function() {
-		return this.isControlDelegateInitialized() && this.getControlDelegate().getSupportedFeatures(this).expandAllRows;
+	/**
+	 * Checks if expand capabilities are enabled.
+	 *
+	 * @returns {boolean} whether expand capabilities are enabled
+	 */
+	Table.prototype._isExpandEnabled = async function() {
+		if (!this.isControlDelegateInitialized()) {
+			return false;
+		}
+		const oConfig =  await this.getControlDelegate().fetchExpandAndCollapseConfiguration(this);
+		let bAvailable = false;
+
+		if ("expandAll" in oConfig) {
+			if (typeof oConfig.expandAll !== "function") {
+				throw new Error("TableDelegate#expandAll: expandAll needs to be a function");
+			}
+			bAvailable = true;
+		}
+
+		if ("expandAllFromNode" in oConfig && "isNodeExpanded" in oConfig) {
+			if (typeof oConfig.expandAllFromNode !== "function") {
+				throw new Error("TableDelegate#fetchExpandAndCollapseConfiguration: expandAllFromNode needs to be a function");
+			}
+
+			if (typeof oConfig.isNodeExpanded !== "function") {
+				throw new Error("TableDelegate#isNodeExpanded: isNodeExpanded needs to be a function");
+			}
+
+			bAvailable = true;
+		}
+
+		return bAvailable;
 	};
 
 	/**
 	 * Retrieves the "Collapse All" button. Creates the button if necessary.
 	 *
-	 * @returns {sap.m.MenuButton} button for "Expand All"
+	 * @param {boolean} bRecreate Whether the button should be recreated
 	 * @private
 	 */
-	Table.prototype._updateExpandAllButton = function() {
-		const bNeedExpandAllButton = this._oToolbar != null && this._isExpandAllEnabled();
+	Table.prototype._updateExpandAllButton = async function(bRecreate) {
+		const bExpandAllAvailable = await this._isExpandEnabled();
+		const bNeedExpandAllButton = this._oToolbar != null && bExpandAllAvailable;
 
-		if (bNeedExpandAllButton && !this._oExpandAllButton) {
-			this._oExpandAllButton = TableSettings.createExpandCollapseAllButton(this.getId(), [
-				function() {
-					try {
-						this.getControlDelegate().expandAllRows(this);
-					} catch (oError) {
-						Log.error("ExpandAll could not be performed", oError, this);
-					}
-				}, this
-			], true);
+		if (bNeedExpandAllButton && (!this._oExpandAllButton || bRecreate)) {
+			if (this._oExpandAllButton) {
+				if (this._oToolbar && this._oToolbar.getEnd().includes(this._oExpandAllButton)) {
+					this._oToolbar.removeEnd(this._oExpandAllButton);
+				}
+				this._oExpandAllButton.destroy();
+				this._oExpandAllButton = null;
+			}
+			this._oExpandAllButton = await this._createExpandButton();
 		}
 
 		if (!this._oExpandAllButton) {
@@ -2384,7 +2464,74 @@ sap.ui.define([
 		}
 
 		this._oExpandAllButton.setEnabled(!MTableUtil.isEmpty(this.getRowBinding()));
-		this._oExpandAllButton.setVisible(this._isExpandAllEnabled());
+		this._oExpandAllButton.setVisible(bExpandAllAvailable);
+	};
+
+	/**
+	 * Create an expand button for the toolbar.
+	 *
+	 * @returns {sap.m.Button|sap.m.MenuButton} either a button or a menu button
+	 */
+	Table.prototype._createExpandButton = async function() {
+		const oConfiguration = await this.getControlDelegate().fetchExpandAndCollapseConfiguration(this);
+		return this._createExpandCollapseButton(true, {
+			tree: oConfiguration.expandAll,
+			node: oConfiguration.expandAllFromNode,
+			isExpanded: oConfiguration.isNodeExpanded
+		});
+	};
+
+	/**
+	 * Create a collapse button for the toolbar.
+	 *
+	 * @returns {sap.m.Button|sap.m.MenuButton} either a button or a menu button
+	 */
+	Table.prototype._createCollapseButton = async function() {
+		const oConfiguration = await this.getControlDelegate().fetchExpandAndCollapseConfiguration(this);
+		return this._createExpandCollapseButton(false, {
+			tree: oConfiguration.collapseAll,
+			node: oConfiguration.collapseAllFromNode,
+			isExpanded: oConfiguration.isNodeExpanded
+		});
+	};
+
+	/**
+	 * Creates either an expand or collapse button as button or menu button.
+	 *
+	 * @param {*} bIsExpand whether the button should expand or collapse
+	 * @param {object} mConfig configuration map that contains the expand/collapse methods
+	 * @param {function} mConfig.tree method to expand/collapse the whole tree
+	 * @param {function} mConfig.node method to expand/collapse a single node
+	 * @param {function} mConfig.isExpanded method to check if a node is expanded
+	 *
+	 * @returns {sap.m.Button|sap.m.MenuButton} either a button or a menu button
+	 * @private
+	 */
+	Table.prototype._createExpandCollapseButton = function(bIsExpand, mConfig) {
+		const { tree: fnTree, node: fnNode, isExpanded: fnIsExpanded } = mConfig;
+
+		if (this.getSelectionMode() === "None" || typeof fnNode !== "function" || typeof fnIsExpanded !== "function") {
+			return TableSettings.createExpandCollapseButton(this.getId(), bIsExpand, () => fnTree(this));
+		}
+
+		const oMenuButton = TableSettings.createExpandCollapseMenuButton(this.getId(), bIsExpand, {
+			"tree": () => fnTree(this),
+			"node": () => {
+				const aContexts = this.getSelectedContexts();
+				return aContexts.length === 1 && fnNode(this, aContexts[0]);
+			}
+		});
+
+		oMenuButton.attachBeforeMenuOpen(() => {
+			const aContexts = this.getSelectedContexts();
+			// Node needs to be expanded to collapse it and vice versa
+			const bShowNodeOption = aContexts.length === 1 && fnIsExpanded(this, aContexts[0]) === !bIsExpand;
+
+			oMenuButton.getMenu().getItems()[0].setEnabled(fnTree != undefined);
+			oMenuButton.getMenu().getItems()[1].setEnabled(bShowNodeOption);
+		});
+
+		return oMenuButton;
 	};
 
 	/**

package/src/sap/ui/mdc/TableDelegate.js

@@ -113,6 +113,18 @@ sap.ui.define([
 	 * @protected
 	 */
 
+	/**
+	 * Represents the expand and collapse configuration object.
+	 *
+	 * @typedef {object} sap.ui.mdc.TableDelegate.ExpandAndCollapseConfiguration
+	 *
+	 * @property {function(sap.ui.mdc.Table): void} [expandAll] Function to expand all rows
+	 * @property {function(sap.ui.mdc.Table): void} [collapseAll] Function to collapse all rows
+	 * @property {function(sap.ui.mdc.Table, sap.ui.model.Context): void} [expandAllFromNode] Function to expand all rows from a specific node
+	 * @property {function(sap.ui.mdc.Table, sap.ui.model.Context): void} [collapseAllFromNode] Function to collapse all rows from a specific node
+	 * @property {function(sap.ui.mdc.Table, sap.ui.model.Context): void} [isNodeExpanded] Function to check if a specific node is expanded
+	 */
+
 	/**
 	 * Updates the binding info object that is used to bind the table in {@link module:sap/ui/mdc/TableDelegate.updateBinding updateBinding}.
 	 *
@@ -342,25 +354,37 @@ sap.ui.define([
 	};
 
 	/**
-	 * Expands all rows.
+	 * Returns the feature set for expanding or collapsing in the table.
 	 *
-	 * @param {sap.ui.mdc.Table} oTable Instance of the table
-	 * @throws {Error} If the delegate does not support this operation
-	 * @protected
-	 */
-	TableDelegate.expandAllRows = function(oTable) {
-		throw Error("Unsupported operation: TableDelegate.expandAllRows");
-	};
-
-	/**
-	 * Collapses all rows.
+	 * By default, this method returns an empty object.
 	 *
-	 * @param {sap.ui.mdc.Table} oTable Instance of the table
-	 * @throws {Error} If the delegate does not support this operation
+	 * The configuration object needs to contain the following functions to enable specific functionalities:
+	 * <ul>
+	 *   <li>To enable the <b>expand all</b> functionality, you need to implement the <code>expandAll</code> function in the configuration object.</li>
+	 *   <li>To enable the <b>collapse all</b> functionality, you need to implement the <code>collapseAll</code> function in the configuration object.</li>
+	 *   <li>To enable the <b>expand all from a specific node</b> functionality, you need to implement the <code>expandAllFromNode</code> and the <code>isNodeExpanded</code> function in the configuration object.</li>
+	 *   <li>To enable the <b>collapse all from a specific node</b> functionality, you need to implement the <code>collapseAllFromNode</code> and the <code>isNodeExpanded</code> function in the configuration object.</li>
+	 * <ul>
+	 *
+	 * <b>Note:</b> Expand and collapse all from a specific node is only supported, if the table rows are selectable.
+	 *
+	 * @example
+	 * TableDelegate.fetchExpandAndCollapseConfiguration = function(oTable) {
+	 * 		return Promise.resolve({
+	 * 			expandAll: function(oTable) {
+	 * 				// Implement expandAll functionality
+	 * 			},
+	 * 			collapseAll: function(oTable) {
+	 * 				// Implement collapseAll functionality
+	 * 			}
+	 * 		});
+	 * }
+	 * @param {sap.ui.mdc.Table} oTable table instance
+	 * @returns {Promise<sap.ui.mdc.TableDelegate.ExpandAndCollapseConfiguration>} A <code>Promise</code> that resolves with an object containing the expand and collapse functions
 	 * @protected
 	 */
-	TableDelegate.collapseAllRows = function(oTable) {
-		throw Error("Unsupported operation: TableDelegate.collapseAllRows");
+	TableDelegate.fetchExpandAndCollapseConfiguration = function(oTable) {
+		return Promise.resolve({});
 	};
 
 	/**
@@ -381,9 +405,7 @@ sap.ui.define([
 
 		return {
 			p13nModes: aSupportedP13nModes,
-			"export": true,
-			expandAllRows: false,
-			collapseAllRows: false
+			"export": true
 		};
 	};
 

package/src/sap/ui/mdc/ValueHelp.js

@@ -67,7 +67,7 @@ sap.ui.define([
 	 * and {@link sap.ui.mdc.FilterField FilterField} controls using the <code>valueHelp</code> association. One <code>ValueHelp</code> element instance can be
 	 * assigned to multiple fields (like in different table rows). It should be placed in the control tree on the container holding the fields.
 	 * @extends sap.ui.mdc.Element
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 * @constructor
 	 * @abstract
 	 * @public

package/src/sap/ui/mdc/actiontoolbar/ActionToolbarAction.js

@@ -20,11 +20,10 @@ sap.ui.define([
 	 * The action for an {@link sap.ui.mdc.ActionToolbar ActionToolbar} control with given layout information that determines where the wrapped control is displayed on the <code>ActionToolbar</code>.
 	 * @extends sap.ui.core.Control
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 * @constructor
 	 * @since 1.58
 	 * @private
-	 * @experimental
 	 * @alias sap.ui.mdc.actiontoolbar.ActionToolbarAction
 	 */
 	const ActionToolbarAction = Control.extend("sap.ui.mdc.actiontoolbar.ActionToolbarAction", {

package/src/sap/ui/mdc/chart/ChartImplementationContainer.js

@@ -21,7 +21,7 @@ sap.ui.define([
 		 * @class The <code>ChartImplementationContainer</code> creates a container for the <code>content</code> (chart) and <code>noDataContent</code>. Based on the <code>showNoDataStruct</code> the <code>content</code> or <code>noDataContent</code> will be shown.
 		 * @extends sap.ui.core.Control
 		 * @author SAP SE
-		 * @version 1.130.1
+		 * @version 1.131.0
 		 * @constructor
 		 *
 		 * @public

package/src/sap/ui/mdc/chart/ChartSelectionDetails.js

@@ -38,7 +38,7 @@ sap.ui.define([
 	 * @class The <code>ChartSelectionDetails</code> control creates a <code>sap.m.SelectionDetails</code> popover based on metadata and the configuration specified.
 	 * @extends sap.m.SelectionDetails
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 * @constructor
 	 * @public
 	 * @experimental As of version 1.88

package/src/sap/ui/mdc/chart/PropertyHelper.js

@@ -26,7 +26,7 @@ sap.ui.define([
 	 * @extends sap.ui.mdc.util.PropertyHelper
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 *
 	 * @private
 	 * @since 1.83

package/src/sap/ui/mdc/chart/ToolbarControlFactory.js

@@ -49,7 +49,7 @@ sap.ui.define([
 	 * @namespace
 	 * @alias sap.ui.mdc.chart.ToolbarControlFactory
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 * @since 1.123
 	 * @experimental
 	 * @private

package/src/sap/ui/mdc/condition/Condition.js

@@ -33,7 +33,7 @@ sap.ui.define([
 		 *
 		 * @namespace
 		 * @author SAP SE
-		 * @version 1.130.1
+		 * @version 1.131.0
 		 * @since 1.61.0
 		 * @alias sap.ui.mdc.condition.Condition
 		 *

package/src/sap/ui/mdc/condition/ConditionConverter.js

@@ -24,7 +24,7 @@ sap.ui.define([
 		 *
 		 * @namespace
 		 * @author SAP SE
-		 * @version 1.130.1
+		 * @version 1.131.0
 		 * @private
 		 * @ui5-restricted sap.ui.mdc
 		 * @since 1.74.0

package/src/sap/ui/mdc/condition/ConditionModel.js

@@ -33,7 +33,7 @@ sap.ui.define([
 		 * @extends sap.ui.model.json.JSONModel
 		 *
 		 * @author SAP SE
-		 * @version 1.130.1
+		 * @version 1.131.0
 		 * @since 1.48.0
 		 * @alias sap.ui.mdc.condition.ConditionModel
 		 *

package/src/sap/ui/mdc/condition/FilterConverter.js

@@ -24,7 +24,7 @@ sap.ui.define([
 		 *
 		 * @namespace
 		 * @author SAP SE
-		 * @version 1.130.1
+		 * @version 1.131.0
 		 * @since 1.78.0
 		 * @alias sap.ui.mdc.condition.FilterConverter
 		 *