@sapui5/sap.fe.test 1.102.2 → 1.104.1

package/src/sap/fe/test/api/DialogActions.js

@@ -3,7 +3,7 @@
         (c) Copyright 2009-2021 SAP SE. All rights reserved
     
  */
-sap.ui.define(["./DialogAPI", "sap/fe/test/Utils", "sap/ui/test/OpaBuilder"], function(DialogAPI, Utils, OpaBuilder) {
+sap.ui.define(["./DialogAPI", "sap/fe/test/Utils", "sap/ui/test/OpaBuilder"], function (DialogAPI, Utils, OpaBuilder) {
 	"use strict";
 
 	/**
@@ -11,14 +11,14 @@ sap.ui.define(["./DialogAPI", "sap/fe/test/Utils", "sap/ui/test/OpaBuilder"], fu
 	 *
 	 * @param {sap.fe.test.builder.DialogBuilder} oDialogBuilder The {@link sap.fe.test.builder.DialogBuilder} instance used to interact with the UI
 	 * @param {string} [vDialogDescription] Description (optional) of the dialog to be used for logging messages
-	 * @param {int} [iConfirmButtonIndex] Index of the 'confirm' button in the button aggregation; the default setting is 0 (first button from the left)
+	 * @param {number} [iConfirmButtonIndex] Index of the 'confirm' button in the button aggregation; the default setting is 0 (first button from the left)
 	 * @returns {sap.fe.test.api.DialogActions} The new DialogActions instance
 	 * @alias sap.fe.test.api.DialogActions
 	 * @class
 	 * @hideconstructor
 	 * @public
 	 */
-	var DialogActions = function(oDialogBuilder, vDialogDescription, iConfirmButtonIndex) {
+	var DialogActions = function (oDialogBuilder, vDialogDescription, iConfirmButtonIndex) {
 		return DialogAPI.call(this, oDialogBuilder, vDialogDescription, iConfirmButtonIndex);
 	};
 	DialogActions.prototype = Object.create(DialogAPI.prototype);
@@ -31,7 +31,7 @@ sap.ui.define(["./DialogAPI", "sap/fe/test/Utils", "sap/ui/test/OpaBuilder"], fu
 	 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, to be used for chained statements
 	 * @public
 	 */
-	DialogActions.prototype.iConfirm = function() {
+	DialogActions.prototype.iConfirm = function () {
 		return this.prepareResult(
 			this.getBuilder()
 				.doPressFooterButton(this._getConfirmButtonMatcher())
@@ -46,7 +46,7 @@ sap.ui.define(["./DialogAPI", "sap/fe/test/Utils", "sap/ui/test/OpaBuilder"], fu
 	 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, to be used for chained statements
 	 * @public
 	 */
-	DialogActions.prototype.iCancel = function() {
+	DialogActions.prototype.iCancel = function () {
 		return this.prepareResult(
 			this.getBuilder()
 				.doPressFooterButton(this._getCancelButtonMatcher())
@@ -61,7 +61,7 @@ sap.ui.define(["./DialogAPI", "sap/fe/test/Utils", "sap/ui/test/OpaBuilder"], fu
 	 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, to be used for chained statements
 	 * @public
 	 */
-	DialogActions.prototype.iClose = function() {
+	DialogActions.prototype.iClose = function () {
 		return this.prepareResult(
 			this.getBuilder()
 				.doPressKeyboardShortcut("Escape")
@@ -79,7 +79,7 @@ sap.ui.define(["./DialogAPI", "sap/fe/test/Utils", "sap/ui/test/OpaBuilder"], fu
 	 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, that can be used for chaining statements
 	 * @public
 	 */
-	DialogActions.prototype.iChangeDialogField = function(vFieldIdentifier, vValue, bClearFirst) {
+	DialogActions.prototype.iChangeDialogField = function (vFieldIdentifier, vValue, bClearFirst) {
 		var aArguments = Utils.parseArguments([Object, String, Boolean], arguments);
 		return this.prepareResult(
 			this._createFieldBuilder(vFieldIdentifier, this.getIdentifier())
@@ -108,7 +108,7 @@ sap.ui.define(["./DialogAPI", "sap/fe/test/Utils", "sap/ui/test/OpaBuilder"], fu
 	 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, that can be used for chaining statements
 	 * @ui5-restricted
 	 */
-	DialogActions.prototype.iChangeActionParameterDialogField = function(vFieldIdentifier, vValue, bClearFirst) {
+	DialogActions.prototype.iChangeActionParameterDialogField = function (vFieldIdentifier, vValue, bClearFirst) {
 		return this.iChangeDialogField(vFieldIdentifier, vValue, bClearFirst);
 	};
 

package/src/sap/fe/test/api/DialogAssertions.js

@@ -3,7 +3,7 @@
         (c) Copyright 2009-2021 SAP SE. All rights reserved
     
  */
-sap.ui.define(["./DialogAPI", "sap/fe/test/Utils"], function(DialogAPI, Utils) {
+sap.ui.define(["./DialogAPI", "sap/fe/test/Utils"], function (DialogAPI, Utils) {
 	"use strict";
 
 	/**
@@ -11,14 +11,14 @@ sap.ui.define(["./DialogAPI", "sap/fe/test/Utils"], function(DialogAPI, Utils) {
 	 *
 	 * @param {sap.fe.test.builder.DialogBuilder} oDialogBuilder The {@link sap.fe.test.builder.DialogBuilder} instance used to interact with the UI
 	 * @param {string} [vDialogDescription] Description (optional) of the dialog to be used for logging messages
-	 * @param {int} [iConfirmButtonIndex] Index of the 'confirm' button in the button aggregation; the default setting is 0 (first button from the left)
+	 * @param {number} [iConfirmButtonIndex] Index of the 'confirm' button in the button aggregation; the default setting is 0 (first button from the left)
 	 * @returns {sap.fe.test.api.DialogAssertions} The new instance
 	 * @alias sap.fe.test.api.DialogAssertions
 	 * @class
 	 * @hideconstructor
 	 * @public
 	 */
-	var DialogAssertions = function(oDialogBuilder, vDialogDescription, iConfirmButtonIndex) {
+	var DialogAssertions = function (oDialogBuilder, vDialogDescription, iConfirmButtonIndex) {
 		return DialogAPI.call(this, oDialogBuilder, vDialogDescription, iConfirmButtonIndex);
 	};
 	DialogAssertions.prototype = Object.create(DialogAPI.prototype);
@@ -30,10 +30,9 @@ sap.ui.define(["./DialogAPI", "sap/fe/test/Utils"], function(DialogAPI, Utils) {
 	 *
 	 * @param {object} [mDialogState] Defines the expected state of the dialog
 	 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, to be used for chained statements
-	 *
 	 * @public
 	 */
-	DialogAssertions.prototype.iCheckState = function(mDialogState) {
+	DialogAssertions.prototype.iCheckState = function (mDialogState) {
 		return this.prepareResult(
 			this.getBuilder()
 				.hasState(mDialogState)
@@ -41,7 +40,7 @@ sap.ui.define(["./DialogAPI", "sap/fe/test/Utils"], function(DialogAPI, Utils) {
 				.execute()
 		);
 	};
-
+	
 	/**
 	 * Checks the confirmation button of the dialog.
 	 *
@@ -49,7 +48,7 @@ sap.ui.define(["./DialogAPI", "sap/fe/test/Utils"], function(DialogAPI, Utils) {
 	 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, to be used for chained statements
 	 * @public
 	 */
-	DialogAssertions.prototype.iCheckConfirm = function(mButtonState) {
+	DialogAssertions.prototype.iCheckConfirm = function (mButtonState) {
 		return this.prepareResult(
 			this.getBuilder()
 				.hasFooterButton(this._getConfirmButtonMatcher(), mButtonState)
@@ -71,7 +70,7 @@ sap.ui.define(["./DialogAPI", "sap/fe/test/Utils"], function(DialogAPI, Utils) {
 	 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, to be used for chained statements
 	 * @public
 	 */
-	DialogAssertions.prototype.iCheckCancel = function(mButtonState) {
+	DialogAssertions.prototype.iCheckCancel = function (mButtonState) {
 		return this.prepareResult(
 			this.getBuilder()
 				.hasFooterButton(this._getCancelButtonMatcher(), mButtonState)
@@ -101,7 +100,7 @@ sap.ui.define(["./DialogAPI", "sap/fe/test/Utils"], function(DialogAPI, Utils) {
 	 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, to be used for chained statements
 	 * @public
 	 */
-	DialogAssertions.prototype.iCheckDialogField = function(vFieldIdentifier, vValue, mState) {
+	DialogAssertions.prototype.iCheckDialogField = function (vFieldIdentifier, vValue, mState) {
 		var aArguments = Utils.parseArguments([Object, [String, Array, Object], Object], arguments);
 		return this.prepareResult(
 			this._createFieldBuilder(vFieldIdentifier, this.getIdentifier())
@@ -135,7 +134,7 @@ sap.ui.define(["./DialogAPI", "sap/fe/test/Utils"], function(DialogAPI, Utils) {
 	 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, to be used for chained statements
 	 * @public
 	 */
-	DialogAssertions.prototype.iCheckActionParameterDialogField = function(vFieldIdentifier, vValue, mState) {
+	DialogAssertions.prototype.iCheckActionParameterDialogField = function (vFieldIdentifier, vValue, mState) {
 		return this.iCheckDialogField(vFieldIdentifier, vValue, mState);
 	};
 

package/src/sap/fe/test/api/DialogHelper.js

@@ -0,0 +1,63 @@
+/*
+ * ! SAP UI development toolkit for HTML5 (SAPUI5)
+        (c) Copyright 2009-2021 SAP SE. All rights reserved
+    
+ */
+sap.ui.define(["./DialogAPI"], function (DialogAPI) {
+	"use strict";
+
+	return {
+		/**
+		 * A helper function that ensures that a draft is available and confirmed.
+		 *
+		 * @param {object} When The Opa5 When chain
+		 * @param {object} Then The Opa5 Then chain
+		 * @param {object} oParams The general object describing the parameters for this function
+		 * @param {boolean} oParams.secondPage Optional boolean to describe whether the test is executed on the second or detailpage
+		 * @param {string} oParams.formSection The form section on which the change shall be applied
+		 * @param {string} oParams.fieldGroup The optional field group on which the change shall be applied, defaulted to "OrderData"
+		 * @param {boolean} oParams.noFieldGroup The optional boolean parameter to remove the default fieldgroup again
+		 * @param {object} oParams.changeField The field to be changed in a key value relationship
+		 * @param {string} oParams.draftOption The draftOption that should be used in this helper, default "draftDataLossOptionKeep"
+		 */
+		iProcessDraftDataLossDialog: function (When, Then, oParams) {
+			var loParams = oParams || {};
+			var pageKey = loParams.secondPage ? "onTheSecondDetailPage" : "onTheDetailPage";
+			var formSection = loParams.formSection ? loParams.formSection : "GeneralInfo";
+			var changeField = loParams.changeField
+				? loParams.changeField
+				: {
+						"PurchaseOrderByCustomer": "CHANGED" //default field with "changed value"
+				  };
+
+			var draftOption = loParams.draftOption ? loParams.draftOption : "draftDataLossOptionKeep";
+			var sGoToSection = loParams.goToSection ? loParams.goToSection : false;
+
+			var aFields = Object.keys(changeField);
+			var sFieldProperty;
+			var sValue;
+			if (aFields.length === 1) {
+				var lsKey = aFields[0];
+				sFieldProperty = lsKey;
+				sValue = changeField[sFieldProperty];
+			} // TODO: potentially prepare more use cases with multi changing fields
+
+			var oFormSettings = { section: formSection };
+
+			oFormSettings.fieldGroup = loParams.fieldGroup ? oFormSettings.fieldGroup : "OrderData";
+			if (loParams.noFieldGroup) {
+				delete oFormSettings["fieldGroup"];
+			}
+
+			if (sGoToSection) {
+				When[pageKey].iGoToSection(sGoToSection);
+			}
+
+			When[pageKey].onForm(oFormSettings).iChangeField({ property: sFieldProperty }, sValue);
+			Then[pageKey].onFooter().iCheckDraftStateSaved();
+			When.onTheShell.iNavigateBack();
+			When[pageKey].onMessageDialog().iSelectDraftDataLossOption(draftOption);
+			When[pageKey].onMessageDialog().iConfirm();
+		}
+	};
+});

package/src/sap/fe/test/api/DialogMessageActions.js

@@ -58,8 +58,9 @@ sap.ui.define(
 		};
 
 		/**
-		 * Selects the specified entry in the draft data loss popup
+		 * Selects the specified entry in the draft data loss popup.
 		 *
+		 * @param {any} optionKey
 		 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, to be used for chained statements
 		 * @public
 		 */

package/src/sap/fe/test/api/DialogValueHelpActions.js

@@ -15,7 +15,7 @@ sap.ui.define(
 		"./FilterBarAPI",
 		"./TableAPI"
 	],
-	function(DialogActions, Utils, OpaBuilder, FEBuilder, FilterBarBuilder, TableBuilder, FieldBuilder, FilterBarAPI, TableAPI) {
+	function (DialogActions, Utils, OpaBuilder, FEBuilder, FilterBarBuilder, TableBuilder, FieldBuilder, FilterBarAPI, TableAPI) {
 		"use strict";
 
 		/**
@@ -24,14 +24,13 @@ sap.ui.define(
 		 * @param {sap.fe.test.builder.DialogBuilder} oDialogBuilder The {@link sap.fe.test.builder.DialogBuilder} instance used to interact with the UI
 		 * @param {string} [vDialogDescription] Description (optional) of the dialog to be used for logging messages
 		 * @returns {sap.fe.test.api.DialogValueHelpActions} The new instance
-		 *
 		 * @extends sap.fe.test.api.DialogActions
 		 * @alias sap.fe.test.api.DialogValueHelpActions
 		 * @hideconstructor
 		 * @class
 		 * @public
 		 */
-		var DialogValueHelpActions = function(oDialogBuilder, vDialogDescription) {
+		var DialogValueHelpActions = function (oDialogBuilder, vDialogDescription) {
 			return DialogActions.call(this, oDialogBuilder, vDialogDescription, 0);
 		};
 		DialogValueHelpActions.prototype = Object.create(DialogActions.prototype);
@@ -42,10 +41,9 @@ sap.ui.define(
 		 * Navigates to the <code>Search and Select</code> tab.
 		 *
 		 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, that can be used for chaining statements
-		 *
 		 * @public
 		 */
-		DialogValueHelpActions.prototype.iGoToSearchAndSelect = function() {
+		DialogValueHelpActions.prototype.iGoToSearchAndSelect = function () {
 			return this.prepareResult(
 				FEBuilder.create(this.getOpaInstance())
 					.isDialogElement()
@@ -61,10 +59,9 @@ sap.ui.define(
 		 * Navigates to the <code>Define Conditions</code> tab.
 		 *
 		 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, that can be used for chaining statements
-		 *
 		 * @public
 		 */
-		DialogValueHelpActions.prototype.iGoToDefineConditions = function() {
+		DialogValueHelpActions.prototype.iGoToDefineConditions = function () {
 			return this.prepareResult(
 				FEBuilder.create(this.getOpaInstance())
 					.isDialogElement()
@@ -80,10 +77,9 @@ sap.ui.define(
 		 * Clicks the <code>Hide/Show Filters</code> button.
 		 *
 		 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, that can be used for chaining statements
-		 *
 		 * @public
 		 */
-		DialogValueHelpActions.prototype.iExecuteShowHideFilters = function() {
+		DialogValueHelpActions.prototype.iExecuteShowHideFilters = function () {
 			return this.prepareResult(
 				FEBuilder.create(this.getOpaInstance())
 					.isDialogElement()
@@ -100,10 +96,9 @@ sap.ui.define(
 		 *
 		 * @param {string} [sSearchText] The new search value.
 		 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, that can be used for chaining statements
-		 *
 		 * @public
 		 */
-		DialogValueHelpActions.prototype.iChangeSearchField = function(sSearchText) {
+		DialogValueHelpActions.prototype.iChangeSearchField = function (sSearchText) {
 			var oFilterBarBuilder = FilterBarBuilder.create(this.getOpaInstance())
 				.isDialogElement()
 				.hasType("sap.ui.mdc.filterbar.vh.FilterBar");
@@ -120,40 +115,28 @@ sap.ui.define(
 		 * Starts the search.
 		 *
 		 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, that can be used for chaining statements
-		 *
 		 * @public
 		 */
-		DialogValueHelpActions.prototype.iExecuteSearch = function() {
+		DialogValueHelpActions.prototype.iExecuteSearch = function () {
 			var oFilterBarBuilder = FilterBarBuilder.create(this.getOpaInstance())
 				.isDialogElement()
 				.hasType("sap.ui.mdc.filterbar.vh.FilterBar");
 
-			return this.prepareResult(
-				oFilterBarBuilder
-					.doSearch()
-					.description("Starting value help search field search")
-					.execute()
-			);
+			return this.prepareResult(oFilterBarBuilder.doSearch().description("Starting value help search field search").execute());
 		};
 
 		/**
 		 * Resets the search field value.
 		 *
 		 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, that can be used for chaining statements
-		 *
 		 * @public
 		 */
-		DialogValueHelpActions.prototype.iResetSearchField = function() {
+		DialogValueHelpActions.prototype.iResetSearchField = function () {
 			var oFilterBarBuilder = FilterBarBuilder.create(this.getOpaInstance())
 				.isDialogElement()
 				.hasType("sap.ui.mdc.filterbar.vh.FilterBar");
 
-			return this.prepareResult(
-				oFilterBarBuilder
-					.doResetSearch()
-					.description("Resetting value help search field")
-					.execute()
-			);
+			return this.prepareResult(oFilterBarBuilder.doResetSearch().description("Resetting value help search field").execute());
 		};
 
 		/**
@@ -163,10 +146,9 @@ sap.ui.define(
 		 * @param {string} [vValue] The new target value.
 		 * @param {boolean} [bClearFirst] Set to <code>true</code> to clear previously set filters, otherwise all previously set values will be kept
 		 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, that can be used for chaining statements
-		 *
 		 * @public
 		 */
-		DialogValueHelpActions.prototype.iChangeFilterField = function(vFieldIdentifier, vValue, bClearFirst) {
+		DialogValueHelpActions.prototype.iChangeFilterField = function (vFieldIdentifier, vValue, bClearFirst) {
 			var aArguments = Utils.parseArguments([[String, Object], String, Boolean], arguments),
 				oFilterBarBuilder = FilterBarBuilder.create(this.getOpaInstance())
 					.isDialogElement()
@@ -201,10 +183,9 @@ sap.ui.define(
 		 * Alternatively, the 0-based row index can be used.
 		 * @param {object} [mState] Defines the expected state of the row
 		 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, that can be used for chaining statements
-		 *
 		 * @public
 		 */
-		DialogValueHelpActions.prototype.iSelectRows = function(vRowValues, mState) {
+		DialogValueHelpActions.prototype.iSelectRows = function (vRowValues, mState) {
 			var aArguments = Utils.parseArguments([[Object, Number], Object], arguments),
 				oTableBuilder = TableBuilder.createWrapper(this.getOpaInstance(), "sap.ui.table.Table").isDialogElement();
 			return this.prepareResult(
@@ -229,10 +210,9 @@ sap.ui.define(
 		 * @param {string | string[]} vValues The values to be set. If the operator requires more than one value, like BT (between),
 		 * an array with the two entries is expected
 		 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, that can be used for chaining statements
-		 *
 		 * @public
 		 */
-		DialogValueHelpActions.prototype.iAddCondition = function(sOperator, vValues) {
+		DialogValueHelpActions.prototype.iAddCondition = function (sOperator, vValues) {
 			return this.iChangeCondition(sOperator || "EQ", vValues, -1);
 		};
 
@@ -244,10 +224,9 @@ sap.ui.define(
 		 * an array with the two entries is expected
 		 * @param {number} [iConditionIndex] The index of the condition to be altered. If not set, the index 0 is used
 		 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, that can be used for chaining statements
-		 *
 		 * @public
 		 */
-		DialogValueHelpActions.prototype.iChangeCondition = function(sOperator, vValues, iConditionIndex) {
+		DialogValueHelpActions.prototype.iChangeCondition = function (sOperator, vValues, iConditionIndex) {
 			iConditionIndex = iConditionIndex || 0;
 			var bIsEmpty = vValues === undefined;
 			vValues = bIsEmpty || Array.isArray(vValues) ? vValues : [vValues];
@@ -261,7 +240,7 @@ sap.ui.define(
 				FEBuilder.create(this.getOpaInstance())
 					.isDialogElement()
 					.hasType("sap.ui.mdc.field.DefineConditionPanel")
-					.do(function(oConditionsPanel) {
+					.do(function (oConditionsPanel) {
 						var aConditions = [].concat(oConditionsPanel.getConditions());
 						if (iConditionIndex === -1) {
 							aConditions.push(oCondition);
@@ -287,16 +266,15 @@ sap.ui.define(
 		 *
 		 * @param {number} [iConditionIndex] The index of the condition to be removed. If not set, the index 0 is used
 		 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, that can be used for chaining statements
-		 *
 		 * @public
 		 */
-		DialogValueHelpActions.prototype.iRemoveCondition = function(iConditionIndex) {
+		DialogValueHelpActions.prototype.iRemoveCondition = function (iConditionIndex) {
 			iConditionIndex = iConditionIndex || 0;
 			return this.prepareResult(
 				FEBuilder.create(this.getOpaInstance())
 					.isDialogElement()
 					.hasType("sap.ui.mdc.field.DefineConditionPanel")
-					.do(function(oConditionsPanel) {
+					.do(function (oConditionsPanel) {
 						var aConditions = [].concat(oConditionsPanel.getConditions());
 						aConditions.splice(iConditionIndex, 1);
 						oConditionsPanel.setConditions(aConditions);

package/src/sap/fe/test/api/DialogValueHelpAssertions.js

@@ -14,7 +14,7 @@ sap.ui.define(
 		"sap/fe/test/builder/MdcTableBuilder",
 		"sap/fe/test/Utils"
 	],
-	function(DialogAssertions, FilterBarAPI, TableAPI, OpaBuilder, FEBuilder, FilterBarBuilder, TableBuilder, Utils) {
+	function (DialogAssertions, FilterBarAPI, TableAPI, OpaBuilder, FEBuilder, FilterBarBuilder, TableBuilder, Utils) {
 		"use strict";
 
 		/**
@@ -23,14 +23,13 @@ sap.ui.define(
 		 * @param {sap.fe.test.builder.DialogBuilder} oDialogBuilder The {@link sap.fe.test.builder.DialogBuilder} instance used to interact with the UI
 		 * @param {string} [vDialogDescription] Description (optional) of the dialog to be used for logging messages
 		 * @returns {sap.fe.test.api.DialogValueHelpAssertions} The new instance
-		 *
 		 * @extends sap.fe.test.api.DialogAssertions
 		 * @alias sap.fe.test.api.DialogValueHelpAssertions
 		 * @hideconstructor
 		 * @class
 		 * @public
 		 */
-		var DialogValueHelpAssertions = function(oDialogBuilder, vDialogDescription) {
+		var DialogValueHelpAssertions = function (oDialogBuilder, vDialogDescription) {
 			return DialogAssertions.call(this, oDialogBuilder, vDialogDescription, 0);
 		};
 		DialogValueHelpAssertions.prototype = Object.create(DialogAssertions.prototype);
@@ -42,10 +41,9 @@ sap.ui.define(
 		 *
 		 * @param {object} [mState] Defines the expected state of the filter bar
 		 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, that can be used for chaining statements
-		 *
 		 * @public
 		 */
-		DialogValueHelpAssertions.prototype.iCheckFilterBar = function(mState) {
+		DialogValueHelpAssertions.prototype.iCheckFilterBar = function (mState) {
 			return this.prepareResult(
 				FilterBarBuilder.create(this.getOpaInstance())
 					.isDialogElement()
@@ -71,10 +69,9 @@ sap.ui.define(
 		 * @param {string} [sOperator] The expected operator
 		 * @param {object} [mState] Defines the expected state of the filter field
 		 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, that can be used for chaining statements
-		 *
 		 * @public
 		 */
-		DialogValueHelpAssertions.prototype.iCheckFilterField = function(vFieldIdentifier, vConditionValues, sOperator, mState) {
+		DialogValueHelpAssertions.prototype.iCheckFilterField = function (vFieldIdentifier, vConditionValues, sOperator, mState) {
 			var aArguments = Utils.parseArguments([[String, Object], [String, Array, Object, Boolean], String, Object], arguments),
 				oFilterBarBuilder = FilterBarBuilder.create(this.getOpaInstance())
 					.isDialogElement()
@@ -107,10 +104,9 @@ sap.ui.define(
 		 * @param {string} [sSearchText] The expected text in the search field
 		 * @param {object} [mState] Defines the expected state of the search field
 		 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, that can be used for chaining statements
-		 *
 		 * @public
 		 */
-		DialogValueHelpAssertions.prototype.iCheckSearchField = function(sSearchText, mState) {
+		DialogValueHelpAssertions.prototype.iCheckSearchField = function (sSearchText, mState) {
 			var aArguments = Utils.parseArguments([String, Object], arguments),
 				oFilterBarBuilder = FilterBarBuilder.create(this.getOpaInstance())
 					.isDialogElement()
@@ -135,10 +131,9 @@ sap.ui.define(
 		 *
 		 * @param {object} [mState] Defines the expected state of the search field
 		 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, that can be used for chaining statements
-		 *
 		 * @public
 		 */
-		DialogValueHelpAssertions.prototype.iCheckTable = function(mState) {
+		DialogValueHelpAssertions.prototype.iCheckTable = function (mState) {
 			return this.prepareResult(
 				TableBuilder.createWrapper(this.getOpaInstance(), "sap.ui.table.Table")
 					.isDialogElement()
@@ -170,10 +165,9 @@ sap.ui.define(
 		 * @param {number} [iExpectedNumberOfRows] The expected number of rows considering <code>mRowValues</code> and <code>mRowState</code>
 		 * @param {object} [mState] Defines the expected state of the target row
 		 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, that can be used for chaining statements
-		 *
 		 * @public
 		 */
-		DialogValueHelpAssertions.prototype.iCheckRows = function(mRowValues, iExpectedNumberOfRows, mState) {
+		DialogValueHelpAssertions.prototype.iCheckRows = function (mRowValues, iExpectedNumberOfRows, mState) {
 			var aArguments = Utils.parseArguments([Object, Number, Object], arguments),
 				iNumberOfRows = aArguments[1],
 				aRowMatcher = TableAPI.createRowMatchers(aArguments[0], aArguments[2]),
@@ -182,7 +176,7 @@ sap.ui.define(
 			// the order of the matchers matters here
 			if (aRowMatcher.length) {
 				// if matchers are defined, first match rows then check number of results
-				oTableBuilder.hasRows(aRowMatcher, true).has(function(aRows) {
+				oTableBuilder.hasRows(aRowMatcher, true).has(function (aRows) {
 					return Utils.isOfType(iNumberOfRows, Number) ? aRows.length === iNumberOfRows : aRows.length > 0;
 				});
 			} else {
@@ -224,7 +218,7 @@ sap.ui.define(
 				oTabIdMatcher = FEBuilder.Matchers.id(RegExp(sIdSuffix + "$"));
 
 			if (mState && mState.visible === false) {
-				oBuilder.check(function(aIconTabFilters) {
+				oBuilder.check(function (aIconTabFilters) {
 					return OpaBuilder.Matchers.filter(oTabIdMatcher)(aIconTabFilters).length === 0;
 				});
 			} else {
@@ -239,10 +233,9 @@ sap.ui.define(
 		 *
 		 * @param {object} [mState] Defines the expected state of the filter bar
 		 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, that can be used for chaining statements
-		 *
 		 * @public
 		 */
-		DialogValueHelpAssertions.prototype.iCheckSearchAndSelect = function(mState) {
+		DialogValueHelpAssertions.prototype.iCheckSearchAndSelect = function (mState) {
 			return _checkTabBuilder(this, "-VHP--fromList", mState);
 		};
 
@@ -251,12 +244,47 @@ sap.ui.define(
 		 *
 		 * @param {object} [mState] Defines the expected state of the filter bar
 		 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, that can be used for chaining statements
-		 *
 		 * @public
 		 */
-		DialogValueHelpAssertions.prototype.iCheckDefineConditions = function(mState) {
+		DialogValueHelpAssertions.prototype.iCheckDefineConditions = function (mState) {
 			return _checkTabBuilder(this, "-VHP--defineCondition", mState);
 		};
+		/**
+		 * Checks the dialog.
+		 *
+		 * @param {object} [mDialogState] Defines the expected state of the dialog
+		 * @returns {object} The result of the {@link sap.ui.test.Opa5#waitFor} function, to be used for chained statements
+		 * @public
+		 */
+		DialogValueHelpAssertions.prototype.iCheckState = function (mDialogState) {
+			if (this.getIdentifier().type === "ValueHelp" && mDialogState && mDialogState.title && Object.keys(mDialogState).length === 1) {
+				//TODO: check VH Dialog title
+				return this.prepareResult(
+					this.getBuilder()
+						.has(function (oControl) {
+							var sTitle = oControl.getParent && oControl.getParent() && oControl.getParent().getProperty("title");
+							return sTitle && sTitle.indexOf(mDialogState.title) >= 0;
+						})
+						//.hasState(mDialogState)
+						.description(Utils.formatMessage("Checking dialog '{0}' in state '{1}'", this.getIdentifier(), mDialogState))
+						.execute()
+				);
+			} else {
+				return this.prepareResult(
+					this.getBuilder()
+						.has(function (oControl) {
+							var sTitle = oControl.getTitle && oControl.getTitle();
+							if (mDialogState && sTitle === "Select: " + mDialogState.title) {
+								oControl.setTitle(mDialogState.title); //TODO testing
+							}
+							return true;
+						})
+						.hasState(mDialogState)
+						.description(Utils.formatMessage("Checking dialog '{0}' in state '{1}'", this.getIdentifier(), mDialogState))
+						.execute()
+				);
+			}
+		};
 
 		return DialogValueHelpAssertions;
 	}