@openui5/sap.ui.mdc 1.102.2 → 1.104.0

package/src/sap/ui/mdc/valuehelp/base/Content.js

@@ -32,7 +32,7 @@ sap.ui.define([
 	 * @param {object} [mSettings] Initial settings for the new element
 	 * @class Content for the {@link sap.ui.mdc.valuehelp.base.Container Container} element.
 	 * @extends sap.ui.core.Element
-	 * @version 1.102.2
+	 * @version 1.104.0
 	 * @constructor
 	 * @abstract
 	 * @private
@@ -47,7 +47,7 @@ sap.ui.define([
 		metadata: {
 			library: "sap.ui.mdc",
 			properties: {
-                /**
+				/**
 				 * Title text that appears tab header.
 				 */
 				title: {
@@ -55,7 +55,7 @@ sap.ui.define([
 					group: "Appearance",
 					defaultValue: ""
 				},
-                /**
+				/**
 				 * Title text that appears in the dialog header.
 				 */
 				shortTitle: {
@@ -63,6 +63,14 @@ sap.ui.define([
 					group: "Appearance",
 					defaultValue: ""
 				},
+				/**
+				 * Title text that appears in the dialog tokenizer panel, when ony one content exist.
+				 */
+				tokenizerTitle: {
+					type: "string",
+					group: "Appearance",
+					defaultValue: ""
+				},
 				/**
 				 * Conditions of the value help
 				 *
@@ -243,7 +251,6 @@ sap.ui.define([
 	 * @returns {object|undefined} if available, a container configuration object is returned.
 	 * @private
 	 * @ui5-restricted sap.ui.mdc.valuehelp.base.Container
-	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
 	Content.prototype.getContainerConfig = function () {
 
@@ -308,7 +315,6 @@ sap.ui.define([
 	 *
 	 * @private
 	 * @ui5-restricted sap.ui.mdc.valuehelp.base.Container
-	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
 	Content.prototype.getItemForValue = function (oConfig) {
 
@@ -321,7 +327,6 @@ sap.ui.define([
 	 *
 	 * @private
 	 * @ui5-restricted sap.ui.mdc.valuehelp.base.Container
-	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
 	Content.prototype.isValidationSupported = function() { // TODO only for TypeAhead content
 		return false;
@@ -363,7 +368,6 @@ sap.ui.define([
 	 * @returns {sap.ui.mdc.condition.ConditionObject} The new condition object with the maintained operator along with <code>sKey</code> and <code>sDescription</code> as <code>aValues</code>
 	 * @private
 	 * @ui5-restricted ValueHelp subclasses
-	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
 	Content.prototype._createCondition = function(vValue, sDescription, oPayload) {
 
@@ -385,7 +389,6 @@ sap.ui.define([
 	 *
 	 * @private
 	 * @ui5-restricted sap.ui.mdc.valueHelp.base.Container
-	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
 	Content.prototype.removeFocus = function() {
 
@@ -403,7 +406,6 @@ sap.ui.define([
 	 *
 	 * @private
 	 * @ui5-restricted sap.ui.mdc.valueHelp.base.Container
-	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
 	Content.prototype.navigate = function(iStep) {
 
@@ -427,7 +429,6 @@ sap.ui.define([
 	 * @returns {boolean} True if used as typeahead
 	 *
 	 * @private
-	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
 	Content.prototype.isTypeahead = function () {
 		var oContainer = this.getParent();
@@ -443,7 +444,6 @@ sap.ui.define([
 	 *
 	 * @private
 	 * @ui5-restricted sap.ui.mdc.valueHelp.base.Container
-	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
 	Content.prototype.isSearchSupported = function () {
 		return false;
@@ -458,7 +458,6 @@ sap.ui.define([
 	 * @returns {boolean} True a scrolling mechanism is needed
 	 *
 	 * @private
-	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
 	Content.prototype.provideScrolling = function () {
 		var oContainer = this.getParent();
@@ -514,7 +513,6 @@ sap.ui.define([
 	 * @returns {string} Name of the icon
 	 * @private
 	 * @ui5-restricted sap.ui.mdc.valuehelp.base.Container
-	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
 	Content.prototype.getValueHelpIcon = function() {
 	};
@@ -531,7 +529,6 @@ sap.ui.define([
 	 * @returns {object} object with the aria-attibutes
 	 * @private
 	 * @ui5-restricted sap.ui.mdc.valuehelp.base.Container
-	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
 	Content.prototype.getAriaAttributes = function(iMaxConditions) {
 
@@ -553,7 +550,6 @@ sap.ui.define([
 	 * @returns {boolean} If <code>true</code>, the value help should open when user clicks into the connected field control
 	 * @private
 	 * @ui5-restricted sap.ui.mdc.valuehelp.base.Container
-	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
 	Content.prototype.shouldOpenOnClick = function() {
 		return false;
@@ -566,7 +562,6 @@ sap.ui.define([
 	 * @returns {boolean} If <code>true</code>, the value help should open when user used the arrow keys in the connected field control
 	 * @private
 	 * @ui5-restricted sap.ui.mdc.valuehelp.base.Container
-	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
 	Content.prototype.shouldOpenOnNavigate = function() {
 		return !this._isSingleSelect();
@@ -580,7 +575,6 @@ sap.ui.define([
 	 *
 	 * @private
 	 * @ui5-restricted sap.ui.mdc.valuehelp.base.Container
-	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
 	Content.prototype.isFocusInHelp = function() {
 
@@ -595,7 +589,6 @@ sap.ui.define([
 	 *
 	 * @private
 	 * @ui5-restricted sap.ui.mdc.valuehelp.base.Container
-	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
 	Content.prototype.isMultiSelect = function() {
 
@@ -610,7 +603,6 @@ sap.ui.define([
 	 *
 	 * @private
 	 * @ui5-restricted sap.ui.mdc.valuehelp.base.Container
-	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
 	Content.prototype.isQuickSelectSupported = function() {
 		return false;
@@ -652,7 +644,6 @@ sap.ui.define([
 	 *
 	 * @private
 	 * @ui5-restricted sap.ui.mdc.valuehelp.base.Container
-	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
 	Content.prototype.getFormattedTitle = function(iCount) {
 		var sTitle = this.getTitle();
@@ -671,12 +662,30 @@ sap.ui.define([
 	 *
 	 * @private
 	 * @ui5-restricted sap.ui.mdc.valuehelp.base.Container
-	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
 	Content.prototype.getFormattedShortTitle = function() {
 		return this.getShortTitle();
 	};
 
+	/**
+	 * Determines the title used in the header of the dialog for the bottom tokenizer.
+	 *
+	 * <b>Note:</b> This function is used by the container and must not be used from outside
+	 *
+	 * @param {int} iCount Number of selected items or conditions
+	 * @returns {string} title
+	 *
+	 * @private
+	 * @ui5-restricted sap.ui.mdc.valuehelp.base.Container
+	 */
+	Content.prototype.getFormattedTokenizerTitle = function(iCount) {
+		var sTitle = this.getTokenizerTitle();
+		if (sTitle) {
+			sTitle = formatMessage(sTitle, iCount ? iCount : "");
+		}
+		return sTitle;
+	};
+
 	Content.prototype._getMaxConditions = function() {
 
 		var oConfig = this.getConfig();
@@ -684,6 +693,15 @@ sap.ui.define([
 
 	};
 
+	Content.prototype.onContainerClose = function() {
+
+	};
+
+	Content.prototype.onContainerOpen = function() {
+
+	};
+
+
 	PromiseMixin.call(Content.prototype);
 
 

package/src/sap/ui/mdc/valuehelp/base/DialogTab.js

@@ -20,7 +20,7 @@ sap.ui.define([
 	 * @param {object} [mSettings] Initial settings for the new control
 	 * @class Content for the <code>sap.ui.mdc.valuehelp.content.Dialog</code> element.
 	 * @extends sap.ui.core.Control
-	 * @version 1.102.2
+	 * @version 1.104.0
 	 * @constructor
 	 * @abstract
 	 * @private
@@ -82,14 +82,14 @@ sap.ui.define([
 		renderer: {
 			apiVersion: 2,
 			render: function(oRm, oControl) {
-				//oRm.openStart("div", oControl);
-				//oRm.openEnd();
-//				var oContent = oControl._displayContent;
+				oRm.openStart("div", oControl);
+				oRm.class("sapUiMdcDialogTab");
+				oRm.openEnd();
 				var oContent = oControl.getContent();
 				if (oContent) {
 					oRm.renderControl(oContent);
 				}
-				//oRm.close("div");
+				oRm.close("div");
 			}
 		}
 	});

package/src/sap/ui/mdc/valuehelp/base/FilterableListContent.js

@@ -32,7 +32,7 @@ sap.ui.define([
 	 * @param {object} [mSettings] Initial settings for the new element
 	 * @class Content for the {@link sap.ui.mdc.valuehelp.base.Container Container} element.
 	 * @extends sap.ui.mdc.valuehelp.base.ListContent
-	 * @version 1.102.2
+	 * @version 1.104.0
 	 * @constructor
 	 * @abstract
 	 * @private
@@ -89,14 +89,6 @@ sap.ui.define([
 				}
 			},
 			aggregations: {
-				/**
-				 * Items used for collective search. If none assigned, no collective search is available.
-				 */
-				collectiveSearchItems: { // TODO: remove!
-					type: "sap.ui.core.Item",
-					multiple: true,
-					singularName : "collectiveSearchItem"
-				},
 				/**
 				 * FilterBar
 				 */
@@ -285,22 +277,29 @@ sap.ui.define([
 		}
 	}
 
+	FilterableListContent.prototype.onContainerOpen = function () {
+		this._bInitialConditionsApplied = false;
+	};
+
 	FilterableListContent.prototype.onShow = function () {
 		ListContent.prototype.onShow.apply(this, arguments);
 
-		var oListBinding = this.getListBinding();
-		var oListBindingInfo = this._getListBindingInfo();
 
-		var bBindingSuspended = oListBinding && oListBinding.isSuspended();
-		var bBindingWillBeSuspended = !oListBinding && oListBindingInfo && oListBindingInfo.suspended;
+		if (!this._bInitialConditionsApplied) {
+			this._applyInitialConditions(this._getPriorityFilterBar()); // to set incomming condition on FilterBar
+			this._bInitialConditionsApplied = true;
 
-		this._applyInitialConditions(this._getPriorityFilterBar()); // to set incomming condition on FilterBar
+			var oListBinding = this.getListBinding();
+			var oListBindingInfo = this._getListBindingInfo();
+			var bBindingSuspended = oListBinding && oListBinding.isSuspended();
+			var bBindingWillBeSuspended = !oListBinding && oListBindingInfo && oListBindingInfo.suspended;
 
-		if ((bBindingSuspended || bBindingWillBeSuspended) && !this.isTypeahead()) {
-			return; // in dialog case do not resume suspended table on opening
-		}
+			if ((bBindingSuspended || bBindingWillBeSuspended) && !this.isTypeahead()) {
+				return; // in dialog case do not resume suspended table on opening
+			}
 
-		this.applyFilters(this.getFilterValue());
+			this.applyFilters(this.getFilterValue());
+		}
 	};
 
 	FilterableListContent.prototype.onHide = function () {
@@ -313,11 +312,6 @@ sap.ui.define([
 
 	FilterableListContent.prototype._observeChanges = function (oChanges) {
 		if (oChanges.object == this) {
-
-			/* if (oChanges.name === "collectiveSearchItems") {
-				this._assignCollectiveSearch(true);
-			} */
-
 			var oFilterBar;
 
 			if (["_defaultFilterBar", "filterBar"].indexOf(oChanges.name) !== -1) {
@@ -413,6 +407,14 @@ sap.ui.define([
 		return sShortTitle;
 	};
 
+	FilterableListContent.prototype.getFormattedTokenizerTitle = function(iCount) {
+		var sTokenizerTitle = this.getTokenizerTitle();
+		if (!sTokenizerTitle) {
+			sTokenizerTitle = this._oResourceBundle.getText("valuehelp.SELECTFROMLIST.TokenizerTitle" + (iCount === 0 ? "NoCount" : ""), iCount);
+		}
+		return sTokenizerTitle;
+	};
+
 	FilterableListContent.prototype.isSearchSupported = function () {
 
 		var sFilterFields = this.getFilterFields();
@@ -427,15 +429,23 @@ sap.ui.define([
 		return bSearchSupported;
 	};
 
-	FilterableListContent.prototype.setCollectiveSearchSelect = function (oDropdown) {
-		this._oCollectiveSearchSelect = oDropdown;
+	/**
+	 * Sets the collective Search to the <code>FilterBar</code>
+	 *
+	 * @param {sap.ui.mdc.filterbar.vh.CollectiveSearchSelect} oCollectiveSearchSelect Collective search control
+	 *
+	 * @private
+	 * @ui5-restricted sap.ui.mdc.valuehelp.Dialog
+	 */
+	FilterableListContent.prototype.setCollectiveSearchSelect = function (oCollectiveSearchSelect) {
+		this._oCollectiveSearchSelect = oCollectiveSearchSelect;
 		this._assignCollectiveSearchSelect();
 	};
 
 	FilterableListContent.prototype._assignCollectiveSearchSelect = function () {
 		var oFilterBar = this._getPriorityFilterBar();
-		if (oFilterBar.setCollectiveSearch && this._oCollectiveSearchSelect) {
-			oFilterBar.setCollectiveSearch(this._oCollectiveSearchSelect);
+		if (oFilterBar.setCollectiveSearch) {
+			oFilterBar.setCollectiveSearch(this._oCollectiveSearchSelect); // remove it if empty
 		}
 	};
 
@@ -450,14 +460,11 @@ sap.ui.define([
 		if (oFilterBar) {
 			var sFilterFields =  this.getFilterFields();
 			var oNewConditions = merge({}, this._oInitialFilterConditions);
+			oFilterBar.setInternalConditions(oNewConditions);
 			if (!oNewConditions[sFilterFields]) { // not set from Delegate
-				// use existing search
-				var oConditions = oFilterBar.getInternalConditions();
-				if (oConditions[sFilterFields]) {
-					oNewConditions[sFilterFields] = oConditions[sFilterFields];
-				}
+				// add current FilterValue as search
+				_addFilterValueToFilterBar.call(this, oFilterBar, this.getFilterValue()); // as might set before a FilterBar exist
 			}
-			oFilterBar.setInternalConditions(oNewConditions);
 		}
 	};
 
@@ -475,7 +482,7 @@ sap.ui.define([
 		Engine.getInstance().defaultProviderRegistry.detach(this);
 
 		Common.cleanup(this, [
-			"_oCollectiveSearchSelect", "_oInitialFilterConditions"
+			"_oCollectiveSearchSelect", "_oInitialFilterConditions", "_bInitialConditionsApplied"
 		]);
 
 		if (this._oSearchField && !this._oSearchField.getParent()) {

package/src/sap/ui/mdc/valuehelp/base/ListContent.js

@@ -20,7 +20,7 @@ sap.ui.define([
 	 * @param {object} [mSettings] Initial settings for the new element
 	 * @class Content for the {@link sap.ui.mdc.valuehelp.base.Container Container} element.
 	 * @extends sap.ui.mdc.valuehelp.base.Content
-	 * @version 1.102.2
+	 * @version 1.104.0
 	 * @constructor
 	 * @abstract
 	 * @private

package/src/sap/ui/mdc/valuehelp/content/Bool.js

@@ -22,7 +22,7 @@ sap.ui.define([
 	 * @param {object} [mSettings] Initial settings for the new element
 	 * @class Content for the {@link sap.ui.mdc.valuehelp.base.Container Container} element to provide a value help for boolean fields.
 	 * @extends sap.ui.mdc.valuehelp.content.FixedList
-	 * @version 1.102.2
+	 * @version 1.104.0
 	 * @constructor
 	 * @abstract
 	 * @private
@@ -109,7 +109,7 @@ sap.ui.define([
 		return Promise.resolve().then(function () {
 			// don't need to create items for this, just use the type to check
 			var oGlobalConfig = this.getConfig();
-			var oType = oGlobalConfig && oGlobalConfig.dataType;
+			var oType = oConfig.dataType || (oGlobalConfig && oGlobalConfig.dataType);
 
 			if (oType) {
 				if (oConfig.checkKey) {
@@ -240,8 +240,8 @@ sap.ui.define([
 	 *
 	 * <b>Note:</b> Do not change items to the <code>Bool</code> content. The items will be filled by itself
 	 *
-	 * @param {int|string|sap.ui.mdc.field.ListFieldHelpItem} vItem The item to remove or its index or id
-	 * @returns {sap.ui.mdc.field.ListFieldHelpItem} The removed item or null
+	 * @param {int|string|sap.ui.mdc.field.ListFieldHelpItem} vItem The item to remove or its index or ID
+	 * @returns {sap.ui.mdc.field.ListFieldHelpItem|null} The removed item or <code>null</code>
 	 * @private
 	 * @ui5-restricted sap.fe
 	 * @MDC_PUBLIC_CANDIDATE

package/src/sap/ui/mdc/valuehelp/content/Conditions.js

@@ -25,7 +25,7 @@ sap.ui.define([
 	 * @param {object} [mSettings] Initial settings for the new element
 	 * @class Content for the {@link sap.ui.mdc.valuehelp.base.Container Container} element showing a condition panel.
 	 * @extends sap.ui.mdc.valuehelp.base.Content
-	 * @version 1.102.2
+	 * @version 1.104.0
 	 * @constructor
 	 * @abstract
 	 * @private
@@ -159,8 +159,8 @@ sap.ui.define([
 	};
 
 	Conditions.prototype.getRequiresTokenizer = function() {
-		// when only the conditions content is on the dialog the tokenizer should be hidden.
-		return false;
+		// when only the conditions content is on the dialog the tokenizer should be shown.
+		return true;
 	};
 
 	Conditions.prototype.getFormattedTitle = function(iCount) {
@@ -179,6 +179,14 @@ sap.ui.define([
 		return sShortTitle;
 	};
 
+	Conditions.prototype.getFormattedTokenizerTitle = function(iCount) {
+		var sTokenizerTitle = this.getTokenizerTitle();
+		if (!sTokenizerTitle) {
+			sTokenizerTitle = this._oResourceBundle.getText("valuehelp.DEFINECONDITIONS.TokenizerTitle" + (iCount === 0 ? "NoCount" : ""), iCount);
+		}
+		return sTokenizerTitle;
+	};
+
 	Conditions.prototype.getAriaAttributes = function(iMaxConditions) {
 
 		return { // return default values, but needs to be implemented by specific content

package/src/sap/ui/mdc/valuehelp/content/FixedList.js

@@ -26,7 +26,7 @@ sap.ui.define([
 	 * @param {object} [mSettings] Initial settings for the new element
 	 * @class Content for the {@link sap.ui.mdc.valuehelp.base.Container Container} element showing a list with fix values.
 	 * @extends sap.ui.mdc.valuehelp.base.ListContent
-	 * @version 1.102.2
+	 * @version 1.104.0
 	 * @constructor
 	 * @abstract
 	 * @private

package/src/sap/ui/mdc/valuehelp/content/MDCTable.js

@@ -16,7 +16,9 @@ sap.ui.define([
 	// "sap/ui/mdc/p13n/Engine",
 	// "sap/ui/mdc/enum/PersistenceMode",
 	'sap/ui/mdc/condition/FilterConverter',
-	'sap/base/util/restricted/_throttle'
+	'sap/base/util/restricted/_throttle',
+	'sap/ui/mdc/util/Common'
+
 ], function(
 	FilterableListContent,
 	loadModules,
@@ -29,7 +31,8 @@ sap.ui.define([
 	// Engine,
 	// PersistenceMode,
 	FilterConverter,
-	throttle
+	throttle,
+	Common
 ) {
 	"use strict";
 
@@ -276,7 +279,7 @@ sap.ui.define([
 	 * @param {object} [mSettings] Initial settings for the new element
 	 * @class Content for the {@link sap.ui.mdc.valuehelp.base.Container Container} element using a {@link sap.ui.mdc.Table}.
 	 * @extends sap.ui.mdc.valuehelp.base.FilterableListContent
-	 * @version 1.102.2
+	 * @version 1.104.0
 	 * @constructor
 	 * @abstract
 	 * @private
@@ -674,5 +677,24 @@ sap.ui.define([
 
 	};
 
+	MDCTable.prototype.exit = function name(params) {
+		Common.cleanup(this, [
+			"_oContentLayout",
+			"_oFilterBarVBox",
+			"_oTableBox",
+			"_oResourceBundle",
+			"_oScrollContainer",
+			"_oTableHelper",
+			"_bSelectionIsUpdating",
+			"_bScrolling",
+			"_bBusy",
+			"_sTableType",
+			"_oUITableSelectionPlugin",
+			"_oTable"
+		]);
+
+		FilterableListContent.prototype.exit.apply(this, arguments);
+	};
+
 	return MDCTable;
 });

package/src/sap/ui/mdc/valuehelp/content/MTable.js

@@ -51,7 +51,7 @@ sap.ui.define([
 	 * @param {object} [mSettings] Initial settings for the new element
 	 * @class Content for the {@link sap.ui.mdc.valuehelp.base.Container Container} element using a {@link sap.m.Table}.
 	 * @extends sap.ui.mdc.valuehelp.base.FilterableListContent
-	 * @version 1.102.2
+	 * @version 1.104.0
 	 * @constructor
 	 * @abstract
 	 * @private
@@ -121,7 +121,7 @@ sap.ui.define([
 		if (this._oTable) {
 			var aItems = this._oTable.getItems();
 			var aConditions = this.getConditions();
-			var bHideSelection = this._isSingleSelect() && !FilterableListContent.prototype._isSingleSelect.apply(this); // if table is in single selection but Fild allows multiple values, don'tr select items
+			var bHideSelection = this._isSingleSelect() && !FilterableListContent.prototype._isSingleSelect.apply(this); // if table is in single selection but Fild allows multiple values, don't select items
 
 			for (var iId in aItems) {
 				var oItem = aItems[iId];
@@ -852,7 +852,7 @@ sap.ui.define([
 	MTable.prototype.exit = function () {
 
 		Common.cleanup(this, [
-			"_sTableWidth", "_oTable", "_oScrollContainer", "_oContentLayout", "_oTablePanel", "_oFilterBarVBox", "_oMResourceBundle", "_oResourceBundle"
+			"_sTableWidth", "_oTable", "_oScrollContainer", "_oContentLayout", "_oTablePanel", "_oFilterBarVBox", "_oMResourceBundle", "_oResourceBundle", "_oTableDelegate"
 		]);
 
 		FilterableListContent.prototype.exit.apply(this, arguments);

package/test/sap/ui/mdc/testutils/opa/JSDocGeneration.md

@@ -0,0 +1,18 @@
+# How to generate the JSDoc for TestObjects
+
+## 1. Install jsdoc2md
+We use https://github.com/jsdoc2md/jsdoc-to-markdown to generate the Markdown files.<br>
+The GitHub mentiones the following command to install it:<br><br>
+<code>npm install --save-dev jsdoc-to-markdown</code><br><br>
+NOTE: I would not recommend doing it this way. As this did not work for on MacOS so I instead installed it globally. Also installing it with the above command will change the package.json of the openui5 lib<br><br>
+<code>npm install -g jsdoc-to-markdown</code>
+
+## 2. Generate JSDoc
+Use <code>jsdoc2md InputFile.js > OutPutFile.md</code>
+
+### Example 1:
+<code>jsdoc2md openui5/src/sap.ui.mdc/test/sap/ui/mdc/testutils/opa/link/TestObjects.js > openui5/src/sap.ui.mdc/test/sap/ui/mdc/testutils/opa/link/JSDoc.md</code>
+
+### Example 2:
+<code>cd openui5/src/sap.ui.mdc/test/sap/ui/mdc/testutils/opa</code><br>
+<code>jsdoc2md link/TestObjects.js > link/JSDoc.md</code>

package/test/sap/ui/mdc/testutils/opa/TestLibrary.js

@@ -7,7 +7,10 @@ sap.ui.define([
 	"test-resources/sap/ui/mdc/testutils/opa/filterbar/TestObjects",
 	"test-resources/sap/ui/mdc/testutils/opa/chart/TestObjects",
 	"test-resources/sap/ui/mdc/testutils/opa/link/TestObjects",
-	"test-resources/sap/ui/mdc/testutils/opa/valueHelp/TestObjects"
+	"test-resources/sap/ui/mdc/testutils/opa/valueHelp/TestObjects",
+	"test-resources/sap/ui/mdc/testutils/opa/field/TestObjects",
+	"test-resources/sap/ui/mdc/testutils/opa/filterfield/TestObjects",
+	"test-resources/sap/ui/mdc/testutils/opa/variant/TestObjects"
 ], function() {
 	"use strict";
 });

package/test/sap/ui/mdc/testutils/opa/Util.js

@@ -0,0 +1,42 @@
+/*!
+ * ${copyright}
+ */
+
+sap.ui.define([
+	"sap/ui/test/Opa5",
+	"sap/ui/test/matchers/PropertyStrictEquals",
+    "sap/ui/test/actions/Press"
+], function(
+	Opa5,
+	PropertyStrictEquals,
+	Press
+) {
+	"use strict";
+
+	// Util.getTextFromResourceBundle = function(sLibraryName, sTextKey) {
+	// 	var oCore = Opa5.getWindow().sap.ui.getCore();
+	// 	return oCore.getLibraryResourceBundle(sLibraryName).getText(sTextKey);
+	// };
+
+	Opa5.createPageObjects({
+		util: {
+			actions: {
+				iPressButton: function(sTitle){
+					return this.waitFor({
+						controlType: "sap.m.Button",
+						matchers: [
+							// new Ancestor(aVHDialogs[0], false),
+							new PropertyStrictEquals({
+								name: "text",
+								value: sTitle
+							})
+						],
+						actions: new Press()
+				   });
+				}
+
+			}
+		}
+	});
+
+});

package/test/sap/ui/mdc/testutils/opa/Utils.js

@@ -0,0 +1,22 @@
+/*!
+ * ${copyright}
+ */
+
+sap.ui.define([
+	"sap/ui/test/Opa5",
+	"sap/ui/base/Object"
+], function(
+	Opa5,
+	BaseObject
+) {
+	"use strict";
+
+	var Utils = BaseObject.extend("sap.ui.mdc.qunit.opa.test.Util", {});
+
+	Utils.getTextFromResourceBundle = function(sLibraryName, sTextKey) {
+		var oCore = Opa5.getWindow().sap.ui.getCore();
+		return oCore.getLibraryResourceBundle(sLibraryName).getText(sTextKey);
+	};
+
+	return Utils;
+});

package/test/sap/ui/mdc/testutils/opa/chart/ActionsBase.js

@@ -11,7 +11,7 @@ sap.ui.define([
 ], function (Opa5, Press, Log, Ancestor, PropertyStrictEquals, Properties, p13nUtil, waitForP13nButtonWithMatchers, waitForP13nDialog) {
 	"use strict";
 
-    var oCore = sap.ui.test.Opa5.getWindow().sap.ui.getCore();
+    var oCore = Opa5.getWindow().sap.ui.getCore();
     var oMDCBundle = oCore.getLibraryResourceBundle("sap.ui.mdc");
 
     var waitForMDCChartWithId = function(sId, oSettings) {