@openui5/sap.ui.mdc 1.93.3 → 1.96.1

package/test/sap/ui/mdc/testutils/opa/chartNew/TestObjects.js

@@ -0,0 +1,289 @@
+/*!
+ * ${copyright}
+ */
+sap.ui.define([
+	"sap/ui/test/Opa5",
+	"./ActionsViz",
+	"./AssertionsViz",
+	"../p13n/Actions"
+], function(
+	Opa5,
+	chartActions,
+	chartAssertions,
+	p13nActions
+) {
+	"use strict";
+
+	Opa5.createPageObjects({
+		onTheMDCChart: {
+			actions: {
+                /**
+                 * @typedef {Object} ChartPersonalizationConfiguration
+                 * @property {string} key Key of the value that is the result of the personalization
+                 * @property {string} role Role of the given value
+                 */
+                /**
+                 * OPA5 test action
+                 * This only works with the new chart personalization
+                 * @param {sap.ui.core.Control | string} oChart Instance / ID of the <code>MDCChartNew</code> that is personalized
+                 * @param {string} sChartType String containing the type of chart that is displayed
+                 * @param {ChartPersonalizationConfiguration[]} aConfigurations Array containing the chart personalization configuration objects
+                 * @returns {Promise} OPA waitFor
+                 * 1. Opens the personalization dialog of a given chart.
+                 * 2. Selects a chart type given by <code>sChartType</code>.
+                 * 3. Executes the given ChartPersonalizationConfigurations.
+                 * 4. Closes the personalization dialog.
+                 */
+                iPersonalizeChart: function(oChart, sChartType, aConfigurations){
+                    return p13nActions.iPersonalizeChart.call(this, oChart, sChartType, aConfigurations);
+                },
+                /**
+                 * @typedef {Object} SortPersonalizationConfiguration
+                 * @property {string} key Key of the item that is the result of the personalization
+                 * @property {boolean} descending Determines whether the sort direction is descending
+                 */
+                /**
+                 * OPA5 test action
+                 * @param {sap.ui.core.Control | string} oChart Instance / ID of the <code>MDCChartNew</code> that is sorted
+                 * @param {SortPersonalizationConfiguration[]} aConfigurations Array containing the sort personalization configuration objects
+                 * @returns {Promise} OPA waitFor
+                 * 1. Opens the personalization dialog of a given chart.
+                 * 2. Executes the given SortPersonalizationConfiguration.
+                 * 3. Closes the personalization dialog.
+                 */
+                iPersonalizeSort: function(oChart, aConfigurations) {
+                    return p13nActions.iPersonalizeSort.call(this, oChart, aConfigurations);
+                },
+                /**
+                 * Opa5 test action
+                 * @param {sap.ui.core.Control | string} oChart Instance / ID of the <code>MDCChartNew</code> that is reset
+                 * @returns {Promise} OPA waitFor
+                 * 1. Opens the personalization dialog of a given chart.
+                 * 2. Clicks on the reset personalization button.
+                 * 3. Confirms the reset dialog.
+                 * 4. Closes the personalization dialog.
+                 */
+                iResetThePersonalization: function(oChart) {
+                    return p13nActions.iResetThePersonalization.call(this, oChart);
+                },
+
+                /**
+                 * OPA5 test action
+                 * Clicks on the "Zoom In" button in the toolbar of a mdc chart.
+                 * @param {string} sId The id of the mdc chart
+                 * @returns {Promise} OPA waitFor
+                 */
+                iClickOnZoomIn : function(sId){
+                    return chartActions.iClickOnZoomIn.call(this, sId);
+                },
+
+                /**
+                 * OPA5 test action
+                 * Clicks on the "Zoom Out" button in the toolbar of a mdc chart.
+                 * @param {string} sId The id of the mdc chart
+                 * @returns {Promise} OPA waitFor
+                 */
+                iClickOnZoomOut : function(sId){
+                    return chartActions.iClickOnZoomOut.call(this, sId);
+                },
+                /**
+                 * OPA5 test action
+                 * Clicks on the "Legend" toggle button in the toolbar of a mdc chart.
+                 * @param {string} sId The id of the mdc chart
+                 * @returns {Promise} OPA waitFor
+                 */
+                iClickOnTheLegendToggleButton : function(sId){
+                    return chartActions.iClickOnTheLegendToggleButton.call(this, sId);
+                },
+                /**
+                 * OPA5 test action
+                 * Clicks on the "Show Details" button in the toolbar of a mdc chart.
+                 * @param {*} sId The id of the mdc chart
+                 * @returns {Promise} OPA waitFor
+                 */
+                iClickOnTheSelectionDetailsButton: function(sId){
+                    return chartActions.iClickOnTheSelectionDetailsButton.call(this, sId);
+                },
+                /**
+                 * OPA5 test action
+                 * Clicks on the "Drilldown" button in the toolbar of a mdc chart.
+                 * @param {string} sId The id of the mdc chart.
+                 * @returns {Promise} OPA waitFor
+                 */
+                iClickOnTheDrillDownButton: function(sId){
+                    return chartActions.iClickOnTheDrillDownButton.call(this, sId);
+                },
+                /**
+                 * OPA5 test action
+                 * Clicks on the "Chart Type" button in the toolbar of a mdc chart.
+                 * @param {string} sId The id of the mdc chart.
+                 * @returns {Promise} OPA waitFor
+                 */
+                iClickOnTheChartTypeButton: function(sId){
+                    return chartActions.iClickOnTheChartTypeButton.apply(this, arguments);
+                },
+                /**
+                 * OPA5 test action
+                 * Clicks on the "Personalisation" button in the toolbar of a mdc chart.
+                 * @param {string} sId The id of the mdc chart.
+                 * @returns {Promise} OPA waitFor
+                 */
+                iClickOnThePersonalisationButton: function(sId){
+                    return chartActions.iClickOnThePersonalisationButton.call(this, sId);
+                },
+                /**
+                 * OPA5 test action
+                 * Selects a specific chart type for a mdc chart in an open chart type popover
+                 * @param {string} sChartTypeName The name of the chart type
+                 * @returns {Promise} OPA waitFor
+                 */
+                iSelectChartTypeInPopover: function(sChartTypeName){
+                   return chartActions.iSelectChartTypeInPopover.call(this, sChartTypeName);
+                },
+                /**
+                 * OPA5 test action
+                 * Clicks on an drill-down breadcrumb with given name for given mdc chart
+                 * @param {string} sName The name of the breadcrumbs
+                 * @param {string} sId Id of the mdc chart.
+                 * @returns {Promise} OPA waitFor
+                 */
+                iClickOnTheBreadcrumbWithName: function(sName, sId){
+                    return chartActions.iClickOnTheBreadcrumbWithName.call(this, sName, sId);
+                },
+                /**
+                 * OPA5 test action
+                 * Selects a specific dimension to drill-down for a mdc chart in an open chart drill-down popover
+                 * @param {string} sDrillName Name of the Dimension which should be drilled-down
+                 * @returns {Promise} OPA waitFor
+                 */
+                iSelectANewDrillDimensionInPopover: function(sDrillName){
+                    return chartActions.iSelectANewDrillDimensionInPopover.call(this, sDrillName);
+                },
+                /**
+                 * OPA5 test action
+                * Selects given datapoints on given chart.
+                * @param {array} aDataPoints Datapoint objects to select
+                * @param {string} sId Id of the mdc chart
+                * @returns {Promise} OPA waitFor
+                */
+               iSelectTheDatapoint: function (aDataPoints, sId){
+                    return chartActions.iSelectTheDatapoint.call(this, aDataPoints, sId);
+               },
+               /**
+                * OPA5 test action
+                * Selectes given categories (dimensions) for the given mdc chart
+                * @param {object} oCategories Categories to select
+                * @param {string} sId Id of the mdc chart
+                * @returns {Promise} OPA waitFor
+                */
+               iSelectTheCategories: function (oCategories, sId){
+                    return chartActions.iSelectTheDatapoint.call(this, oCategories, sId);
+               },
+               /**
+                * OPA5 test action
+                * Performs a drill-down on the MDC Chart
+                * @param {string} sId The id of the MDC Chart.
+                * @param {string} sDrillName Name of the Dimension which should be drilled-down.
+                * @returns {Promise} OPA waitFor
+                */
+                iDrillDownInDimension: function(sId, sDrillName) {
+                   return chartActions.iDrillDownInDimension.call(this, sId, sDrillName);
+               },
+               /**
+                * OPA5 test action
+                * Performs a drill-down on the MDC Chart
+                * @param {string} sId The id of the MDC Chart
+                * @param {string} sChartTypeName Name of the Dimension which should be drilled-down.
+                * @returns {Promise} OPA waitFor
+                */
+                iSelectAChartType: function(sId, sChartTypeName) {
+                    return chartActions.iSelectAChartType.call(this, sId, sChartTypeName);
+                }
+
+            },
+            assertions: {
+                /**
+                 * OPA5 assertion
+                 * Assertion to check that there is a mdc chart visible on the screen.
+                 * @returns {Promise} OPA waitFor
+                 */
+                iShouldSeeAChart: function() {
+                    return chartAssertions.iShouldSeeAChart.call(this);
+                },
+                /**
+                 * Assertion to check that there is a legend visible on the screen for given mdc chart.
+                 * @param {string} sId Id of the chart to be checked for a visible legend
+                 * @returns {Promise} OPA waitFor
+                 */
+                iShouldSeeALegend: function(sId) {
+                    return chartAssertions.iShouldSeeALegend.call(this, sId);
+                },
+                /**
+                 * Assertion to check that there is no legend visible on the screen for given mdc chart.
+                 * @param {string} sId Id of the chart to be checked for a visible legend
+                 * @returns {Promise} OPA waitFor
+                 */
+                iShouldSeeNoLegend: function(sId) {
+                    return chartAssertions.iShouldSeeNoLegend.call(this, sId);
+                },
+
+                /**
+                 * Assertion to check that there is a chart type popover visible on the screen.
+                 * @returns {Promise} OPA waitFor
+                 */
+                iShouldSeeAChartTypePopover: function() {
+                    return chartAssertions.iShouldSeeAChartTypePopover.call(this);
+                },
+                /**
+                 * Assertion to check that there is chart visible with given chart type.
+                 * @param {string} sChartId Id of the chart to be checked for a chart type
+                 * @param {string} sChartType Chart type which should be selected for the given chart
+                 * @returns {Promise} OPA waitFor
+                 */
+                iShouldSeeTheChartWithChartType: function(sChartId,  sChartType){
+                    return chartAssertions.iShouldSeeTheChartWithChartType.call(this, sChartId, sChartType);
+                },
+                /**
+                 * Assertion to check that there is a chart with given drillstack visible.
+                 * @param {array} aCheckDrillStack Drillstack to check for
+                 * @param {string} sChartId Id of the mdc chart
+                 * @returns {Promise} OPA waitFor
+                 */
+                iShouldSeeTheDrillStack: function(aCheckDrillStack, sChartId) {
+                    return chartAssertions.iShouldSeeTheDrillStack.call(this, aCheckDrillStack, sChartId);
+                },
+                /**
+                 * Assertion to check that there is a drilldown popover visible.
+                 * @returns {Promise} OPA waitFor
+                 */
+                iShouldSeeADrillDownPopover: function() {
+                    return chartAssertions.iShouldSeeADrillDownPopover.call(this);
+                },
+                /**
+                * Assertion to check that there is a drilldown popover visible.
+                * @returns {Promise} OPA waitFor
+                */
+               iShouldSeeADetailsPopover: function() {
+                 return chartAssertions.iShouldSeeADetailsPopover.call(this);
+                },
+                /**
+                 * Assertion to check visible dimensions on the MDC Chart
+                 * @param {string} sId Id of the MDC Chart
+                 * @returns {Promise} OPA waitFor
+                 */
+                iShouldSeeVisibleDimensionsInOrder: function(aDimensions, sId) {
+                    return chartAssertions.iShouldSeeVisibleDimensionsInOrder.call(this, aDimensions, sId);
+                },
+                /**
+                 * Assertion to check visible measures on the MDC Chart
+                 * @param {string} sId Id of the MDC Chart
+                 * @returns {Promise} OPA waitFor
+                */
+                iShouldSeeVisibleMeasuresInOrder: function(aMeasures, sId) {
+                    return chartAssertions.iShouldSeeVisibleMeasuresInOrder.call(this, aMeasures, sId);
+                }
+			}
+        }
+    });
+
+});

package/test/sap/ui/mdc/testutils/opa/filterbar/Actions.js

@@ -0,0 +1,250 @@
+/*!
+ * ${copyright}
+ */
+
+sap.ui.define([
+	"sap/ui/test/Opa5",
+	"sap/ui/test/matchers/Matcher",
+	"sap/ui/test/matchers/Properties",
+	"sap/ui/test/matchers/Ancestor",
+	"sap/ui/test/matchers/Descendant",
+	"sap/ui/test/matchers/PropertyStrictEquals",
+	"sap/ui/test/actions/Press",
+	"sap/ui/test/actions/EnterText",
+	"./Util",
+	"../p13n/Actions",
+	"../p13n/Util"
+], function(
+	Opa5,
+	Matcher,
+	Properties,
+	Ancestor,
+	Descendant,
+	PropertyStrictEquals,
+	Press,
+	EnterText,
+	FilterBarUtil,
+	p13nActions,
+	p13nUtil
+) {
+	"use strict";
+
+	var iEnterFilterValue = function(oGroupViewItem, mSettings) {
+		// Get sap.m.Panel of GroupViewItem
+		this.waitFor({
+			controlType: "sap.m.Panel",
+			matchers: new Ancestor(oGroupViewItem, true),
+			success: function(aPanels) {
+				var oGroupPanel = aPanels[0];
+				// Get the expand button for the panel
+				this.waitFor({
+					controlType: "sap.m.Button",
+					matchers: new Ancestor(oGroupPanel, true),
+					success: function(aButtons) {
+						var oButton = aButtons[0];
+						// click on expand button
+						if (!oGroupPanel.getExpanded()) {
+							new Press().executeOn(oButton);
+						}
+						this.waitFor({
+							controlType: "sap.m.Toolbar",
+							matchers: new Ancestor(oGroupPanel, true),
+							success: function(aToolbars) {
+								var oToolbar = aToolbars[0];
+								// Get label of the GroupViewItem
+								this.waitFor({
+									controlType: "sap.m.Label",
+									matchers: new Ancestor(oToolbar, true),
+									success: function(aToolbarLabels) {
+										var oToolbarLabel = aToolbarLabels[0];
+										this.waitFor({
+											controlType: "sap.m.List",
+											matchers: new Ancestor(oGroupPanel, true),
+											success: function(aLists) {
+												var oList = aLists[0];
+												// Get CustomListItems inside the GroupViewItem panel
+												this.waitFor({
+													controlType: "sap.m.CustomListItem",
+													matchers: new Ancestor(oList, true),
+													actions: function(oFilterItem) {
+														this.waitFor({
+															controlType: "sap.m.Label",
+															matchers: new Ancestor(oFilterItem, false),
+															success: function(aFilterFieldLabels) {
+																var oFilterFieldLabel = aFilterFieldLabels[0];
+																var sLabelFor = oFilterFieldLabel.getLabelFor();
+																this.waitFor({
+																	controlType: "sap.ui.mdc.filterbar.p13n.FilterGroupLayout",
+																	id: sLabelFor,
+																	success: function(oFilterGroupLayout) {
+																		this.waitFor({
+																			controlType: "sap.ui.mdc.FilterField",
+																			matchers: function(oFilterField) {
+																				if (mSettings[oToolbarLabel.getText()]) {
+																					return oFilterField === oFilterGroupLayout._oFilterField;
+																				}
+																				return false;
+																			},
+																			actions: function (oFilterField) {
+																				var oSettings = mSettings[oToolbarLabel.getText()];
+																				if (oSettings.label === oFilterFieldLabel.getText()) {
+																					oSettings.values.forEach(function(oValue) {
+																						this.waitFor({
+																							controlType: "sap.ui.mdc.field.FieldMultiInput",
+																							matchers: new Ancestor(oFilterField),
+																							actions: new EnterText({
+																								text: oValue,
+																								clearTextFirst: false,
+																								pressEnterKey: true
+																							})
+																						});
+																					}.bind(this));
+																				}
+																			}.bind(this)
+																		});
+																	}
+																});
+															}
+														});
+													}.bind(this),
+													// close group panel
+													success: function() {
+														if (oGroupPanel.getExpanded()) {
+															new Press().executeOn(oButton);
+														}
+													}
+												});
+											}
+										});
+									}
+								});
+							}
+						});
+					}
+				});
+			}
+		});
+	};
+
+    return {
+		iExpectSearch: function(oFilterBar) {
+			var sFilterBarId = typeof oFilterBar === "string" ? oFilterBar : oFilterBar.getId();
+			var sText = FilterBarUtil.texts.go;
+			return this.waitFor({
+				id: sFilterBarId,
+				success: function(oFilterBarInstance) {
+					Opa5.assert.ok(oFilterBarInstance, "Found FilterBar.");
+					if (!oFilterBarInstance.getLiveMode()) {
+						this.waitFor({
+							controlType: "sap.m.Button",
+							matchers: [
+								new Ancestor(oFilterBarInstance, false),
+								new PropertyStrictEquals({
+									name: "text",
+									value: sText
+								})
+							],
+							actions: new Press(),
+							errorMessage: "No '" + sText + "' button found on the FilterBar."
+						});
+					}
+				}
+			});
+		},
+		iEnterFilterValue: function(oFilterBar, mSettings) {
+			var sIcon = p13nUtil.icons.group;
+			return p13nActions.iOpenThePersonalizationDialog.call(this, oFilterBar, {
+				success: function(oP13nDialog) {
+					this.waitFor({
+						controlType: "sap.m.Button",
+						matchers: [
+							new Ancestor(oP13nDialog, false),
+							new PropertyStrictEquals({
+								name: "icon",
+								value: sIcon
+							})
+						],
+						actions: new Press(),
+						success: function() {
+							this.waitFor({
+								controlType: "sap.ui.mdc.p13n.panels.GroupView",
+								matchers: new Ancestor(oP13nDialog, false),
+								success: function(aGroupViews) {
+									var oGroupView = aGroupViews[0];
+									this.waitFor({
+										controlType: "sap.m.VBox",
+										matchers: new Ancestor(oGroupView, true),
+										success: function(aVBoxes) {
+											var oVBox = aVBoxes[0];
+											this.waitFor({
+												controlType: "sap.m.List",
+												matchers: new Ancestor(oVBox, true),
+												success: function(aLists) {
+													var oList = aLists[0];
+													this.waitFor({
+														controlType: "sap.m.CustomListItem",
+														matchers: function(oCustomListItem) {
+															var bAncestor = new Ancestor(oList, true)(oCustomListItem);
+
+															return bAncestor && Object.keys(mSettings).includes(oCustomListItem.getContent()[0].getHeaderToolbar().getContent()[0].getText());
+														},
+														actions: function(oGroupViewItem) {
+															iEnterFilterValue.call(this, oGroupViewItem, mSettings);
+														}.bind(this),
+														success: function() {
+															p13nActions.iPressTheOKButtonOnTheDialog.call(this, oP13nDialog);
+														}
+													});
+												}
+											});
+										}
+									});
+								}
+							});
+						},
+						errorMessage: "No button with icon '" + sIcon + "' found on P13nDialog"
+					});
+				}
+			});
+		},
+		iClearFilterValue: function(oFilterBar, sFilterLabel) {
+			var sFilterBarId = typeof oFilterBar === "string" ? oFilterBar : oFilterBar.getId();
+			return this.waitFor({
+				id: sFilterBarId,
+				success: function(oFilterBarInstance) {
+					this.waitFor({
+						controlType: "sap.ui.mdc.FilterField",
+						matchers: [
+							new PropertyStrictEquals({
+								name: "label",
+								value: sFilterLabel
+							}),
+							new Ancestor(oFilterBarInstance, true)
+						],
+						success: function(aFilterFields) {
+							var oFilterField = aFilterFields[0];
+							this.waitFor({
+								controlType: "sap.m.Token",
+								matchers: new Ancestor(oFilterField, false),
+								actions: function(oToken) {
+									this.waitFor({
+										controlType: "sap.ui.core.Icon",
+										matchers: [
+											new Ancestor(oToken),
+											new PropertyStrictEquals({
+												name: "src",
+												value: FilterBarUtil.icons.decline
+											})
+										],
+										actions: new Press()
+									});
+								}.bind(this)
+							});
+						}
+					});
+				}
+			});
+		}
+    };
+
+});

package/test/sap/ui/mdc/testutils/opa/filterbar/Assertions.js

@@ -0,0 +1,91 @@
+/*!
+ * ${copyright}
+ */
+
+sap.ui.define([
+	"sap/ui/test/Opa5",
+	"sap/ui/test/matchers/Matcher",
+	"sap/ui/test/matchers/Properties",
+	"sap/ui/test/matchers/Ancestor",
+	"sap/ui/test/matchers/Descendant",
+	"sap/ui/test/matchers/PropertyStrictEquals"
+], function(
+	Opa5,
+	Matcher,
+	Properties,
+	Ancestor,
+	Descendant,
+	PropertyStrictEquals
+) {
+	"use strict";
+
+	//var oMDCBundle = sap.ui.getCore().getLibraryResourceBundle("sap.ui.mdc");
+
+    var iShouldSeeFilterField = function(oFilterBarInstance, sLabel, aExpectedConditions) {
+        var vMatchers;
+
+        if (aExpectedConditions) {
+            vMatchers = function(oFilterField) {
+                var bLabelCorrect = oFilterField.getLabel() === sLabel;
+                var bAncestor = new Ancestor(oFilterBarInstance, true)(oFilterField);
+                var aFilterFieldConditions = oFilterField.getConditions();
+                var bConditionsCorrect = aFilterFieldConditions.length === aExpectedConditions.length;
+
+                if (bConditionsCorrect) {
+                    bConditionsCorrect = aFilterFieldConditions.every(function(oFilterFieldCondition) {
+                        return aExpectedConditions.some(function(oExpectedCondition) {
+                            var bOperator = oFilterFieldCondition.operator === oExpectedCondition.operator;
+                            var bValues;
+
+                            bValues = oFilterFieldCondition.values.every(function(oFilterFieldConditionValue) {
+                                return oExpectedCondition.values.includes(oFilterFieldConditionValue);
+                            });
+
+                            return bOperator && bValues;
+                        });
+                    });
+                }
+
+                return bLabelCorrect && bAncestor && bConditionsCorrect;
+            };
+        } else {
+            vMatchers = [
+                new Ancestor(oFilterBarInstance, true),
+                new PropertyStrictEquals({
+                    name: "label",
+                    value: sLabel
+                })
+            ];
+        }
+
+
+        this.waitFor({
+            controlType: "sap.ui.mdc.FilterField",
+            matchers: vMatchers,
+            success: function(aFilterFields) {
+                Opa5.assert.ok(aFilterFields.length === 1, "The FilterField labeled as '" + sLabel + "' found");
+            }
+        });
+    };
+
+    return {
+        iShouldSeeFilters: function(oFilterBar, vSettings) {
+            var sFilterBarId = typeof oFilterBar === "string" ? oFilterBar : oFilterBar.getId();
+			return this.waitFor({
+				id: sFilterBarId,
+				success: function(oFilterBarInstance) {
+                    if (Array.isArray(vSettings)) {
+                        vSettings.forEach(function(sLabel) {
+                            iShouldSeeFilterField.call(this, oFilterBarInstance, sLabel);
+                        }.bind(this));
+                    } else {
+                        for (var sLabel in vSettings) {
+                            iShouldSeeFilterField.call(this, oFilterBarInstance, sLabel, vSettings[sLabel]);
+                        }
+                    }
+                }
+            });
+        }
+    };
+
+});