@openui5/sap.ui.integration 1.98.0 → 1.101.0

package/src/sap/ui/integration/widgets/Card.js

@@ -15,10 +15,8 @@ sap.ui.define([
 	"sap/base/Log",
 	"sap/base/util/merge",
 	"sap/base/util/deepEqual",
+	"sap/base/util/each",
 	"sap/ui/integration/util/DataProviderFactory",
-	"sap/m/HBox",
-	"sap/ui/core/Icon",
-	"sap/m/Text",
 	"sap/ui/model/json/JSONModel",
 	"sap/ui/integration/model/ObservableModel",
 	"sap/ui/model/resource/ResourceModel",
@@ -35,7 +33,13 @@ sap.ui.define([
 	"sap/ui/integration/formatters/IconFormatter",
 	"sap/ui/integration/cards/filters/FilterBarFactory",
 	"sap/ui/integration/cards/actions/CardActions",
-	"sap/ui/integration/util/CardObserver"
+	"sap/ui/integration/util/CardObserver",
+	"sap/m/IllustratedMessage",
+	"sap/m/IllustratedMessageType",
+	"sap/m/IllustratedMessageSize",
+	"sap/ui/integration/util/Utils",
+	"sap/m/HBox",
+	"sap/m/library"
 ], function (
 	CardRenderer,
 	Footer,
@@ -48,10 +52,8 @@ sap.ui.define([
 	Log,
 	merge,
 	deepEqual,
+	each,
 	DataProviderFactory,
-	HBox,
-	Icon,
-	Text,
 	JSONModel,
 	ObservableModel,
 	ResourceModel,
@@ -68,7 +70,13 @@ sap.ui.define([
 	IconFormatter,
 	FilterBarFactory,
 	CardActions,
-	CardObserver
+	CardObserver,
+	IllustratedMessage,
+	IllustratedMessageType,
+	IllustratedMessageSize,
+	Utils,
+	HBox,
+	mLibrary
 ) {
 	"use strict";
 
@@ -84,23 +92,33 @@ sap.ui.define([
 		PARAMS: "/sap.card/configuration/parameters",
 		DESTINATIONS: "/sap.card/configuration/destinations",
 		CSRF_TOKENS: "/sap.card/configuration/csrfTokens",
-		FILTERS: "/sap.card/configuration/filters"
+		FILTERS: "/sap.card/configuration/filters",
+		ERROR_MESSAGES: "/sap.card/configuration/messages"
 	};
 
 	/**
 	 * @const A list of model names which are used internally by the card.
 	 */
-	var RESERVED_MODEL_NAMES = ["parameters", "filters", "form", "context", "i18n"];
+	var RESERVED_MODEL_NAMES = ["parameters", "filters", "paginator", "form", "context", "i18n"];
 
 	var RESERVED_PARAMETER_NAMES = ["visibleItems", "allItems"];
 
 	var HeaderPosition = fLibrary.cards.HeaderPosition;
 
+	var CardArea = library.CardArea;
+
 	var CardDataMode = library.CardDataMode;
 
 	var CARD_DESTROYED_ERROR = "Card is destroyed!";
 
-	var CardArea = library.CardArea;
+	var FlexRendertype = mLibrary.FlexRendertype;
+
+	var FlexJustifyContent = mLibrary.FlexJustifyContent;
+
+	var FlexAlignItems = mLibrary.FlexAlignItems;
+
+	var MODULE_PREFIX = "module:";
+
 
 	/**
 	 * Constructor for a new <code>Card</code>.
@@ -159,7 +177,7 @@ sap.ui.define([
 	 * @extends sap.f.CardBase
 	 *
 	 * @author SAP SE
-	 * @version 1.98.0
+	 * @version 1.101.0
 	 * @public
 	 * @constructor
 	 * @see {@link topic:5b46b03f024542ba802d99d67bc1a3f4 Cards}
@@ -392,7 +410,14 @@ sap.ui.define([
 				/**
 				 * The host.
 				 */
-				host: {}
+				host: {},
+
+				/**
+				 * The opener card.
+				 * @private
+				 * @ui5-restricted
+				 */
+				openerReference: { visibility: "hidden" }
 			}
 		},
 		renderer: CardRenderer
@@ -410,6 +435,7 @@ sap.ui.define([
 		this.setModel(new JSONModel()); // always create a default model to isolate the card from a propagated default model
 		this.setModel(new JSONModel(), "parameters");
 		this.setModel(new JSONModel(), "filters");
+		this.setModel(new JSONModel(), "paginator");
 		this.setModel(new JSONModel(), "form");
 		// this.setModel(new JSONModel(), "csrfTokens");
 		this.setModel(new ContextModel(), "context");
@@ -428,7 +454,7 @@ sap.ui.define([
 		 * @experimental since 1.79
 		 * @public
 		 * @author SAP SE
-		 * @version 1.98.0
+		 * @version 1.101.0
 		 * @borrows sap.ui.integration.widgets.Card#getDomRef as getDomRef
 		 * @borrows sap.ui.integration.widgets.Card#setVisible as setVisible
 		 * @borrows sap.ui.integration.widgets.Card#getParameters as getParameters
@@ -452,6 +478,9 @@ sap.ui.define([
 		 * @borrows sap.ui.integration.widgets.Card#destroyActionDefinition as destroyActionDefinition
 		 * @borrows sap.ui.integration.widgets.Card#showLoadingPlaceholders as showLoadingPlaceholders
 		 * @borrows sap.ui.integration.widgets.Card#hideLoadingPlaceholders as hideLoadingPlaceholders
+		 * @borrows sap.ui.integration.widgets.Card#showCard as showCard
+		 * @borrows sap.ui.integration.widgets.Card#hide as hide
+		 * @borrows sap.ui.integration.widgets.Card#getOpener as getOpener
 		 */
 		this._oLimitedInterface = new Interface(this, [
 			"getDomRef",
@@ -476,7 +505,10 @@ sap.ui.define([
 			"indexOfActionDefinition",
 			"destroyActionDefinition",
 			"showLoadingPlaceholders",
-			"hideLoadingPlaceholders"
+			"hideLoadingPlaceholders",
+			"showCard",
+			"hide",
+			"getOpener"
 		]);
 	};
 
@@ -522,7 +554,6 @@ sap.ui.define([
 		this.startManifestProcessing();
 	};
 
-
 	/**
 	 * Called after rendering of the control.
 	 * @private
@@ -545,20 +576,23 @@ sap.ui.define([
 	 * @ui5-restricted
 	 */
 	Card.prototype.startManifestProcessing = function () {
+		if (!Utils.isBindingSyntaxComplex()) {
+			this._logFundamentalError(
+				"Cannot parse manifest. Complex binding syntax is not enabled - " +
+				"To enable it, set the 'compatVersion' configuration option to 'edge', e.g.: data-sap-ui-compatVersion='edge' - " +
+				"sap.ui.integration.widgets.Card"
+			);
+		}
+
 		if (this._bApplyManifest || this._bApplyParameters) {
 			this._clearReadyState();
 			this._initReadyState();
 		}
 
-		if (this._bApplyManifest) {
-			var vManifest = this.getManifest();
-
-			if (!vManifest) {
-				// Destroy the manifest when null/undefined/empty string are passed
-				this.destroyManifest();
-			} else {
-				this.createManifest(vManifest, this.getBaseUrl());
-			}
+		var vManifest = this.getManifest();
+		if (vManifest && this._bApplyManifest) {
+			this._cleanupOldManifest();
+			this.createManifest(vManifest, this.getBaseUrl());
 		}
 
 		if (!this._bApplyManifest && this._bApplyParameters) {
@@ -573,9 +607,17 @@ sap.ui.define([
 	};
 
 	Card.prototype.setManifest = function (vValue) {
-		this.setProperty("manifest", vValue);
-		this.destroyActionDefinitions();
+		if (!deepEqual(this.getProperty("manifest"), vValue)) {
+			this.destroyActionDefinitions();
+		}
+
+		if (!vValue) {
+			// Destroy the manifest when null/undefined/empty string is passed
+			this._destroyManifest();
+		}
+
 		this._bApplyManifest = true;
+		this.setProperty("manifest", vValue);
 		return this;
 	};
 
@@ -658,7 +700,6 @@ sap.ui.define([
 		if (this._oCardManifest) {
 			this._oCardManifest.destroy();
 		}
-		this.destroyAggregation("_extension");
 
 		this._oCardManifest = new CardManifest("sap.card", vManifest, sBaseUrl, this.getManifestChanges());
 
@@ -691,13 +732,18 @@ sap.ui.define([
 	 * @returns {Promise|null} Null if there is no need to load extension, else a promise.
 	 */
 	Card.prototype._loadExtension = function () {
-		var sExtensionPath = this._oCardManifest.get("/sap.card/extension");
+		var sExtensionPath = this._oCardManifest.get("/sap.card/extension"),
+			sFullExtensionPath;
 
 		if (!sExtensionPath) {
 			return null;
 		}
 
-		var sFullExtensionPath = this._oCardManifest.get("/sap.app/id").replace(/\./g, "/") + "/" + sExtensionPath;
+		if (sExtensionPath.startsWith(MODULE_PREFIX)) {
+			sFullExtensionPath = sExtensionPath.replace(MODULE_PREFIX, "");
+		} else {
+			sFullExtensionPath = this._oCardManifest.get("/sap.app/id").replace(/\./g, "/") + "/" + sExtensionPath;
+		}
 
 		return new Promise(function (resolve, reject) {
 			sap.ui.require([sFullExtensionPath], function (ExtensionSubclass) {
@@ -707,9 +753,9 @@ sap.ui.define([
 
 				resolve();
 			}.bind(this), function (vErr) {
-				this._logFundamentalError("Failed to load " + sExtensionPath + ". Check if the path is correct. Reason: " + vErr);
+				this._logFundamentalError("Failed to load " + sFullExtensionPath + ". Check if the path is correct. Reason: " + vErr);
 				reject(vErr);
-			});
+			}.bind(this));
 		}.bind(this));
 	};
 
@@ -921,6 +967,10 @@ sap.ui.define([
 	 * @since 1.95
 	 */
 	Card.prototype.refreshData = function () {
+		if (!this.isReady()) {
+			return;
+		}
+
 		var oHeader = this.getCardHeader(),
 			oContent = this.getCardContent(),
 			oFilterBar = this.getAggregation("_filterBar");
@@ -937,6 +987,7 @@ sap.ui.define([
 			oContent.refreshData();
 		} else {
 			this.destroyAggregation("_content");
+			this._destroyTemporaryContent();
 			this._applyContentManifestSettings();
 		}
 
@@ -979,7 +1030,7 @@ sap.ui.define([
 
 		CardBase.prototype.exit.call(this);
 
-		this.destroyManifest();
+		this._destroyManifest();
 		this._oCardObserver.destroy();
 		this._oCardObserver = null;
 		this._oContentFactory = null;
@@ -994,7 +1045,7 @@ sap.ui.define([
 	/**
 	 * Destroys everything configured by the manifest.
 	 */
-	Card.prototype.destroyManifest = function () {
+	Card.prototype._destroyManifest = function () {
 		if (this._oCardManifest) {
 			this._oCardManifest.destroy();
 			this._oCardManifest = null;
@@ -1004,18 +1055,6 @@ sap.ui.define([
 			this._oServiceManager = null;
 		}
 
-		// destroying the factory would also destroy the data provider
-		if (this._oDataProviderFactory) {
-			this._oDataProviderFactory.destroy();
-			this._oDataProviderFactory = null;
-			this._oDataProvider = null;
-		}
-
-		if (this._oTemporaryContent) {
-			this._oTemporaryContent.destroy();
-			this._oTemporaryContent = null;
-		}
-
 		if (this._oDestinations) {
 			this._oDestinations.destroy();
 			this._oDestinations = null;
@@ -1036,15 +1075,35 @@ sap.ui.define([
 		this.destroyAggregation("_content");
 		this.destroyAggregation("_footer");
 
+		this._cleanupOldManifest();
+	};
+
+	/**
+	 * Cleans up internal models and other before new manifest processing.
+	 */
+	Card.prototype._cleanupOldManifest = function() {
 		this._aReadyPromises = null;
 
 		this.getModel("filters").setData({});
 		this.getModel("parameters").setData({});
-		// this.getModel("csrfTokens").setData({});
+		this.getModel("paginator").setData({});
+
+		this.setModel(null, "i18n");
 
 		this._oContextParameters = null;
 
 		this._deregisterCustomModels();
+
+		this.destroyAggregation("_extension");
+
+		this._destroyTemporaryContent();
+
+		// destroying the factory would also destroy the data provider
+		if (this._oDataProviderFactory) {
+			this._oDataProviderFactory.destroy();
+			this._oDataProviderFactory = null;
+			this._oDataProvider = null;
+		}
 	};
 
 	/**
@@ -1179,24 +1238,23 @@ sap.ui.define([
 	};
 
 	/**
-	 * Displays a message strip on top of the content with the given text.
-	 *
-	 * <b>Note</b> Currently only available for an Adaptive Card.
+	 * Displays a message strip above the content with the given text.
+	 * There can be only 1 message displayed. If there is a previous message, it is removed.
+	 * Can be used only after the <code>manifestApplied</code> event is fired.
 	 *
 	 * @public
 	 * @experimental As of version 1.81
 	 * @param {string} sMessage The message.
 	 * @param {sap.ui.core.MessageType} sType Type of the message.
 	 */
-	Card.prototype.showMessage = function (sMessage, sType) {
-		var oContent = this.getCardContent();
-
-		if (!oContent || !oContent.showMessage) {
-			Log.error("The experimental feature 'showMessage' is currently available only for an Adaptive Card.");
-			return;
+	 Card.prototype.showMessage = function (sMessage, sType) {
+		if (this._createContentPromise) {
+			this._createContentPromise.then(function (oContent) {
+				oContent.showMessage(sMessage, sType);
+			});
+		} else {
+			Log.error("'showMessage' cannot be used before the card instance is ready. Consider using the event 'manifestApplied' event.", "sap.ui.integration.widgets.Card");
 		}
-
-		oContent.showMessage(sMessage, sType);
 	};
 
 	/**
@@ -1393,6 +1451,13 @@ sap.ui.define([
 		}
 
 		oModel.attachEvent("change", function () {
+			var oCardContent = this.getAggregation("_content");
+			if (oCardContent && !oCardContent.isA("sap.ui.integration.cards.BaseContent")) {
+				this.destroyAggregation("_content");
+				this._destroyTemporaryContent();
+				this._applyContentManifestSettings();
+			}
+
 			if (this._createContentPromise) {
 				this._createContentPromise.then(function (oContent) {
 					oContent.onDataChanged();
@@ -1671,7 +1736,7 @@ sap.ui.define([
 		}
 
 		oContent.attachEvent("_error", function (oEvent) {
-			this._handleError(oEvent.getParameter("logMessage"), oEvent.getParameter("displayMessage"));
+			this._handleError(oEvent.getParameter("logMessage"));
 		}.bind(this));
 
 		var oPreviousContent = this.getAggregation("_content");
@@ -1727,7 +1792,7 @@ sap.ui.define([
 					return;
 				}
 
-				sHeight = ContentClass.getMetadata().getRenderer().getMinHeight(oContentManifest, oError);
+				sHeight = ContentClass.getMetadata().getRenderer().getMinHeight(oContentManifest, oError, this);
 
 				if (this.getHeight() === "auto") { // if there is no height specified the default value is "auto"
 					oError.$().css({"min-height": sHeight});
@@ -1753,22 +1818,11 @@ sap.ui.define([
 		}
 	};
 
-	/**
-	 * Creates a control representation of an error.
-	 *
-	 * @param {string} sErrorMessage Error message
-	 * @private
-	 * @returns {sap.ui.core.Control} control instance
-	 */
-	Card.prototype._createError = function (sErrorMessage) {
-		return new HBox({
-			justifyContent: "Center",
-			alignItems: "Center",
-			items: [
-				new Icon({ src: "sap-icon://message-error", size: "1rem" }).addStyleClass("sapUiTinyMargin"),
-				new Text({ text: sErrorMessage })
-			]
-		}).addStyleClass("sapFCardErrorContent");
+	Card.prototype._destroyTemporaryContent = function () {
+		if (this._oTemporaryContent) {
+			this._oTemporaryContent.destroy();
+			this._oTemporaryContent = null;
+		}
 	};
 
 	/**
@@ -1777,20 +1831,24 @@ sap.ui.define([
 	 * If a message is not provided, a default message will be displayed.
 	 *
 	 * @param {string} sLogMessage Message that will be logged.
-	 * @param {string} [sDisplayMessage] Message that will be displayed as an error in the card.
+	 * @param {boolean} bNoItems No items are available after request.
 	 * @private
 	 */
-	Card.prototype._handleError = function (sLogMessage, sDisplayMessage) {
+	Card.prototype._handleError = function (sLogMessage, bNoItems) {
 		this._loadDefaultTranslations();
-		Log.error(sLogMessage, null, "sap.ui.integration.widgets.Card");
+		if (!bNoItems) {
+			Log.error(sLogMessage, null, "sap.ui.integration.widgets.Card");
+		}
 
 		this.fireEvent("_error", { message: sLogMessage });
 
-		var sErrorMessage = sDisplayMessage || this._oIntegrationRb.getText("CARD_DATA_LOAD_ERROR"),
-			oError = this._createError(sErrorMessage),
-			oContentSection = this._oCardManifest.get(MANIFEST_PATHS.CONTENT);
+		var oErrorConfiguration = this._oCardManifest.get(MANIFEST_PATHS.ERROR_MESSAGES),
+			oError = this._getIllustratedMessage(oErrorConfiguration, bNoItems),
+			oContentSection = this._oCardManifest.get(MANIFEST_PATHS.CONTENT),
+			oCardContent = merge({}, this.getCardContent());
 
 		if (oContentSection) {
+			this._handleNoDataItems(oCardContent, oError, bNoItems);
 			this._destroyPreviousContent(this.getCardContent());
 			this._preserveMinHeightInContent(oError);
 			this.setAggregation("_content", oError);
@@ -1801,11 +1859,83 @@ sap.ui.define([
 
 	};
 
+	/**
+	 * Get Illustrated message.
+	 *
+	 * @param {object} oErrorConfiguration Error settings from manifest.
+	 * @param {boolean} bNoItems No items are available after request.
+	 * @private
+	 */
+	Card.prototype._getIllustratedMessage = function (oErrorConfiguration, bNoItems) {
+		var sIllustratedMessageType = IllustratedMessageType.UnableToLoad,
+			sIllustratedMessageSize = IllustratedMessageSize.Spot,
+			sTitle,
+			sDescription;
+
+		//no item from request default messages, for some card types
+		if (bNoItems && !oErrorConfiguration) {
+			switch (this._oCardManifest.get(MANIFEST_PATHS.TYPE)) {
+				case "List":
+				case "Timeline":
+					sIllustratedMessageType = IllustratedMessageType.NoData;
+					sTitle = this._oIntegrationRb.getText("CARD_NO_ITEMS_ERROR_LISTS");
+					break;
+				case "Table":
+					sIllustratedMessageType = IllustratedMessageType.NoEntries;
+					sTitle = this._oIntegrationRb.getText("CARD_NO_ITEMS_ERROR_LISTS");
+					break;
+				case "Analytical":
+					sIllustratedMessageType = IllustratedMessageType.NoEntries;
+					sTitle = this._oIntegrationRb.getText("CARD_NO_ITEMS_ERROR_CHART");
+			}
+		}
+
+		//custom no data message
+		if (oErrorConfiguration && oErrorConfiguration.noData && bNoItems) {
+			var oErrorData = oErrorConfiguration.noData;
+				sIllustratedMessageType = IllustratedMessageType[oErrorData.type];
+				sIllustratedMessageSize = IllustratedMessageSize[oErrorData.size];
+				sTitle = oErrorData.title;
+				sDescription = oErrorData.description;
+		}
+
+
+		var oIllustratedMessage = new IllustratedMessage({
+			illustrationType: sIllustratedMessageType,
+			illustrationSize: sIllustratedMessageSize,
+			title: sTitle,
+			description: sDescription ? sDescription : " "
+		});
+
+		var oFlexBox = new HBox({
+			renderType: FlexRendertype.Bare,
+			justifyContent: FlexJustifyContent.Center,
+			alignItems: FlexAlignItems.Center,
+			width: "100%",
+			items: [oIllustratedMessage]
+		}).addStyleClass("sapFCardErrorContent");
+		return oFlexBox;
+	};
+
+	/**
+	 * Handle when there is no data in error cases for manifest resolver.
+	 *
+	 * @param {object} oCardContent clone of the original card content before it is destroyed.
+	 * @param {object} oError IllustratedMessage used for the error content.
+	 * @param {boolean} bNoItems No items are available after request.
+	 * @private
+	 */
+	Card.prototype._handleNoDataItems = function (oCardContent, oError, bNoItems) {
+		if (bNoItems && this._oCardManifest.get(MANIFEST_PATHS.TYPE) === "List") {
+			oError._oCardOriginalContent = oCardContent;
+		}
+	};
+
 	Card.prototype._getTemporaryContent = function (sCardType, oContentManifest) {
 		var oLoadingProvider = this.getAggregation("_loadingProvider");
 
 		if (!this._oTemporaryContent && oLoadingProvider) {
-			this._oTemporaryContent = oLoadingProvider.createContentPlaceholder(oContentManifest, sCardType);
+			this._oTemporaryContent = oLoadingProvider.createContentPlaceholder(oContentManifest, sCardType, this);
 
 			this._oTemporaryContent.addEventDelegate({
 				onAfterRendering: function () {
@@ -1813,7 +1943,7 @@ sap.ui.define([
 						return;
 					}
 
-					var sHeight = this._oContentFactory.getClass(sCardType).getMetadata().getRenderer().getMinHeight(oContentManifest, this._oTemporaryContent);
+					var sHeight = this._oContentFactory.getClass(sCardType).getMetadata().getRenderer().getMinHeight(oContentManifest, this._oTemporaryContent, this);
 
 					if (this.getHeight() === "auto") { // if there is no height specified the default value is "auto"
 						this._oTemporaryContent.$().css({ "min-height": sHeight });
@@ -2017,7 +2147,7 @@ sap.ui.define([
 	/**
 	 * Decides if the card needs a loading placeholder based on card level data provider
 	 *
-	 * @returns {Boolean} Should card has a loading placeholder based on card level data provider.
+	 * @returns {boolean} Should card has a loading placeholder based on card level data provider.
 	 */
 	Card.prototype.isLoading = function () {
 		var oLoadingProvider = this.getAggregation("_loadingProvider");
@@ -2046,7 +2176,8 @@ sap.ui.define([
 	};
 
 	Card.prototype.onDataRequestComplete = function () {
-		var oContent = this.getCardContent();
+		var oContent = this.getCardContent(),
+			oLoadingProvider = this.getAggregation("_loadingProvider");
 
 		this.fireEvent("_cardReady");
 		this.hideLoadingPlaceholders(CardArea.Header);
@@ -2056,7 +2187,11 @@ sap.ui.define([
 			this.hideLoadingPlaceholders(CardArea.Content);
 		}
 
-		this.getAggregation("_loadingProvider").setLoading(false);
+		if (oLoadingProvider) {
+			oLoadingProvider.setLoading(false);
+		}
+
+		this._fireContentDataChange();
 	};
 
 	/**
@@ -2069,7 +2204,7 @@ sap.ui.define([
 	 * @param {string} [oConfiguration.mode="cors"] The mode of the request. Possible values are "cors", "no-cors", "same-origin".
 	 * @param {string} [oConfiguration.method="GET"] The HTTP method. Possible values are "GET", "POST".
 	 * @param {Object} [oConfiguration.parameters] The request parameters. If the method is "POST" the parameters will be put as key/value pairs into the body of the request.
-	 * @param {Object} [oConfiguration.dataType="json"] The expected Content-Type of the response. Possible values are "xml", "json", "text", "script", "html", "jsonp". Note: Complex Binding is not supported when a dataType is provided. Serialization of the response to an object is up to the developer.
+	 * @param {string} [oConfiguration.dataType="json"] The expected Content-Type of the response. Possible values are "xml", "json", "text", "script", "html", "jsonp". Note: Complex Binding is not supported when a dataType is provided. Serialization of the response to an object is up to the developer.
 	 * @param {Object} [oConfiguration.headers] The HTTP headers of the request.
 	 * @param {boolean} [oConfiguration.withCredentials=false] Indicates whether cross-site requests should be made using credentials.
 	 * @returns {Promise} Resolves when the request is successful, rejects otherwise.
@@ -2226,6 +2361,10 @@ sap.ui.define([
 		}
 	};
 
+	Card.prototype._fireContentDataChange = function () {
+		this.fireEvent("_contentDataChange");
+	};
+
 	/**
 	 * @private
 	 */
@@ -2233,5 +2372,136 @@ sap.ui.define([
 		return false;
 	};
 
+	/**
+	 * @private
+	 */
+	Card.prototype.getContentPageSize = function (oContentConfig) {
+		var iMaxItems = parseInt(BindingResolver.resolveValue(oContentConfig, this).maxItems) || 0,
+			oFooter = this.getAggregation("_footer"),
+			oPaginator;
+
+		if (!oFooter) {
+			return iMaxItems;
+		}
+
+		oPaginator = oFooter.getAggregation("paginator");
+		if (!oPaginator) {
+			return iMaxItems;
+		}
+
+		if (oPaginator.getPageSize()) {
+			return oPaginator.getPageSize();
+		}
+
+		return iMaxItems;
+	};
+
+	Card.prototype.hasPaginator = function () {
+		var oManifestFooter = this._oCardManifest.get(MANIFEST_PATHS.FOOTER);
+		return oManifestFooter && oManifestFooter.paginator;
+	};
+
+	/**
+	 * Shows a child card. By default opens in a dialog.
+	 * @private
+	 * @ui5-restricted
+	 * @param {Object} oParameters The settings for showing the card.
+	 * @param {String|Object} oParameters.manifest Url to a manifest or the manifest itself.
+	 * @param {String} oParameters.baseUrl If manifest is an object - specify the base url to the card.
+	 * @param {Object} oParameters.parameters Parameters to be passed to the new card.
+	 * @param {Object} oParameters.data Data to be passed to the new card.
+	 * @returns {Promise} Promise which resolves with the created card.
+	 */
+	Card.prototype.showCard = function (oParameters) {
+		var oChildCard = this._createChildCard(oParameters);
+
+		oParameters._cardId = oChildCard.getId();
+
+		this.triggerAction({
+			type: "ShowCard",
+			parameters: oParameters
+		});
+
+		return Promise.resolve(oChildCard);
+	};
+
+	/**
+	 * Hides the card.
+	 * @private
+	 * @ui5-restricted
+	 */
+	Card.prototype.hide = function () {
+		this.triggerAction({
+			type: "HideCard"
+		});
+	};
+
+	/**
+	 * Gets the card which has opened this one if any.
+	 * @private
+	 * @ui5-restricted
+	 * @returns {sap.ui.integration.widgets.Card} The card which opened the current one.
+	 */
+	Card.prototype.getOpener = function () {
+		var oOpener = Core.byId(this.getAssociation("openerReference"));
+
+		if (!oOpener) {
+			return null;
+		}
+
+		return oOpener._oLimitedInterface;
+	};
+
+	/**
+	 * Creates the child card.
+	 *
+	 * @private
+	 * @ui5-restricted
+	 * @param {Object} oParameters The parameters for the card.
+	 * @returns {sap.ui.integration.widgets.Card} The result card.
+	 */
+	Card.prototype._createChildCard = function (oParameters) {
+		var vManifest = oParameters.manifest,
+			sBaseUrl = oParameters.baseUrl,
+			oData = oParameters.data,
+			oChildCard = this._createCard({
+				width: oParameters.width,
+				host: this.getHostInstance(),
+				parameters: oParameters.parameters
+			});
+
+		oChildCard.setAssociation("openerReference", this);
+
+		if (oData) {
+			each(oData, function (sModelName, oModelData) {
+				var oModel = new JSONModel(oModelData);
+				oChildCard.setModel(oModel, sModelName);
+			});
+		}
+
+		if (typeof vManifest === "string") {
+			oChildCard.setManifest(this.getRuntimeUrl(vManifest));
+			if (sBaseUrl) {
+				oChildCard.setBaseUrl(sBaseUrl);
+			}
+		} else {
+			oChildCard.setManifest(vManifest);
+			oChildCard.setBaseUrl(sBaseUrl || this.getRuntimeUrl("/"));
+		}
+
+		return oChildCard;
+	};
+
+	/**
+	 * Creates a card with the given settings.
+	 *
+	 * @private
+	 * @param {Object} oSettings The settings for the card.
+	 * @returns {sap.ui.integration.widgets.Card} The result card.
+	 */
+	Card.prototype._createCard = function (oSettings) {
+		return new Card(oSettings);
+	};
+
 	return Card;
 });