@openui5/sap.ui.rta 1.143.1 → 1.145.0

package/src/sap/ui/rta/plugin/additionalElements/AdditionalElementsAnalyzer.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2025 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2026 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -123,7 +123,7 @@ sap.ui.define([
 	}
 
 	function oPropertyToAdditionalElementInfo(oProperty) {
-		return {
+		const oReturn = {
 			selected: false,
 			label: oProperty.label || oProperty.name,
 			parentPropertyName: oProperty.parentPropertyName ? oProperty.parentPropertyName : "",
@@ -136,6 +136,10 @@ sap.ui.define([
 			name: oProperty.name,
 			bindingPath: oProperty.bindingPath
 		};
+		if (oProperty.entityTypeDisplayName) {
+			oReturn.entityTypeDisplayName = oProperty.entityTypeDisplayName;
+		}
+		return oReturn;
 	}
 
 	function getLabel(oElement, mAction) {
@@ -152,7 +156,7 @@ sap.ui.define([
 	function elementToAdditionalElementInfo(mData) {
 		const oElement = mData.element;
 		const sLabel = getLabel(oElement, mData.action);
-		return {
+		const oReturn = {
 			selected: false,
 			label: oElement.__label || sLabel,
 			tooltip: oElement.__tooltip || sLabel || oElement.__bindingPath,
@@ -165,6 +169,10 @@ sap.ui.define([
 			elementId: oElement.getId(),
 			sourceAggregation: mData.sourceAggregation
 		};
+		if (oElement.__entityTypeDisplayName) {
+			oReturn.entityTypeDisplayName = oElement.__entityTypeDisplayName;
+		}
+		return oReturn;
 	}
 
 	/**
@@ -191,17 +199,36 @@ sap.ui.define([
 		return [oElement];
 	}
 
+	/**
+	 * Marks properties with duplicate labels within the same entity type display name.
+	 * The same entity can have different contexts (e.g. peer and manager both from Person entity),
+	 * that's why we use the display name and not the entity type itself.
+	 *
+	 * @param {object[]} aProperties - Array of property objects
+	 * @returns {object[]} - The same array with duplicateName flag set where applicable
+	 */
 	function checkForDuplicateProperties(aProperties) {
-		aProperties.forEach(function(oModelProperty, index, aProperties) {
-			if (oModelProperty.duplicateName !== true) {
-				for (let j = index + 1; j < aProperties.length - 1; j++) {
-					if (oModelProperty.label === aProperties[j].label) {
-						oModelProperty.duplicateName = true;
-						aProperties[j].duplicateName = true;
-					}
-				}
+		// Group properties by entityType and label to find duplicates
+		const mLabelsByEntityTypeDisplayName = {};
+
+		aProperties.forEach(function(oProperty) {
+			const sEntityTypeDisplayName = oProperty.entityTypeDisplayName || "";
+			const sLabel = oProperty.label || "";
+			const sKey = `${sEntityTypeDisplayName}|||${sLabel}`;
+
+			mLabelsByEntityTypeDisplayName[sKey] ||= [];
+			mLabelsByEntityTypeDisplayName[sKey].push(oProperty);
+		});
+
+		// Mark properties as duplicates if there are multiple with the same entityType display name and label
+		Object.values(mLabelsByEntityTypeDisplayName).forEach(function(aPropertiesWithSameLabel) {
+			if (aPropertiesWithSameLabel.length > 1) {
+				aPropertiesWithSameLabel.forEach(function(oProperty) {
+					oProperty.duplicateName = true;
+				});
 			}
 		});
+
 		return aProperties;
 	}
 
@@ -314,8 +341,10 @@ sap.ui.define([
 	 */
 	function enhanceInvisibleElement(oInvisibleElement, mSomeItem) {
 		oInvisibleElement.__originalLabel = mSomeItem.label;
-
 		oInvisibleElement.__tooltip = mSomeItem.tooltip;
+		if (mSomeItem.entityTypeDisplayName) {
+			oInvisibleElement.__entityTypeDisplayName = mSomeItem.entityTypeDisplayName;
+		}
 
 		// found element
 		oInvisibleElement.__bindingPath = mSomeItem.name;

package/src/sap/ui/rta/plugin/additionalElements/AdditionalElementsPlugin.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2025 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2026 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -12,6 +12,7 @@ sap.ui.define([
 	"sap/ui/core/Lib",
 	"sap/ui/dt/OverlayRegistry",
 	"sap/ui/dt/OverlayUtil",
+	"sap/ui/fl/util/CancelError",
 	"sap/ui/fl/write/api/FieldExtensibility",
 	"sap/ui/rta/plugin/additionalElements/ActionExtractor",
 	"sap/ui/rta/plugin/additionalElements/AddElementsDialog",
@@ -28,6 +29,7 @@ sap.ui.define([
 	Lib,
 	OverlayRegistry,
 	OverlayUtil,
+	CancelError,
 	FieldExtensibility,
 	ActionExtractor,
 	AddElementsDialog,
@@ -119,7 +121,7 @@ sap.ui.define([
 	 * @class The plugin allows to add additional elements that exist either hidden in the UI or in the OData service
 	 * @extends sap.ui.rta.plugin.Plugin
 	 * @author SAP SE
-	 * @version 1.143.1
+	 * @version 1.145.0
 	 * @constructor
 	 * @private
 	 * @since 1.44
@@ -323,8 +325,7 @@ sap.ui.define([
 				const oOverlayToFocus = OverlayRegistry.getOverlay(vSiblingElement) || oResponsibleElementOverlay;
 				oOverlayToFocus.focus();
 			} catch (oError) {
-				// no error means canceled dialog
-				if (oError instanceof Error) {
+				if (!(oError instanceof CancelError)) {
 					throw oError;
 				}
 			}

package/src/sap/ui/rta/plugin/additionalElements/AdditionalElementsUtils.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2025 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2026 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -17,7 +17,7 @@ sap.ui.define([
 	 * Helper object containing methods for the AdditionalElements plugin
 	 *
 	 * @author SAP SE
-	 * @version 1.143.1
+	 * @version 1.145.0
 	 * @private
 	 * @since 1.94
 	 */

package/src/sap/ui/rta/plugin/additionalElements/CommandBuilder.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2025 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2026 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -25,7 +25,7 @@ sap.ui.define([
 	 * Helper object to build the RTA commands resulting from the AdditionalElements Plugin
 	 *
 	 * @author SAP SE
-	 * @version 1.143.1
+	 * @version 1.145.0
 	 * @private
 	 * @since 1.94
 	 */

package/src/sap/ui/rta/plugin/annotations/AnnotationChangeDialog.fragment.xml

@@ -24,7 +24,7 @@
 					<link>
 						<Link text="{i18n>ANNOTATION_CHANGE_DIALOG_WARNING_MORE_INFO}"
 							target="_blank"
-							href=""/> <!-- TODO: Change link once the docs are available -->
+							href="{/documentationUrl}"/>
 					</link>
 				</MessageStrip>
 				<Label

package/src/sap/ui/rta/plugin/annotations/AnnotationChangeDialog.js

@@ -1,7 +1,7 @@
 
 /*!
  * OpenUI5
- * (c) Copyright 2025 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2026 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define([
@@ -12,6 +12,7 @@ sap.ui.define([
 	"sap/ui/model/json/JSONModel",
 	"sap/ui/model/resource/ResourceModel",
 	"sap/ui/rta/plugin/annotations/AnnotationChangeDialogController",
+	"sap/ui/rta/plugin/annotations/DocumentedAnnotationChanges",
 	"sap/ui/rta/Utils"
 ], function(
 	ManagedObject,
@@ -21,6 +22,7 @@ sap.ui.define([
 	JSONModel,
 	ResourceModel,
 	AnnotationChangeDialogController,
+	DocumentedAnnotationChanges,
 	RtaUtils
 ) {
 	"use strict";
@@ -29,7 +31,7 @@ sap.ui.define([
 	 * @class Constructor for a new sap.ui.rta.plugin.annotations.AnnotationChangeDialog.
 	 * @extends sap.ui.base.ManagedObject
 	 * @author SAP SE
-	 * @version 1.143.1
+	 * @version 1.145.0
 	 * @constructor
 	 * @since 1.132
 	 * @private
@@ -57,6 +59,25 @@ sap.ui.define([
 		});
 	}
 
+	function getDocumentationUrl(sFeatureKey) {
+		const oDocumentationUrls = {
+			btpUrl: "https://help.sap.com/docs/ui5-flexibility-for-key-users/ui5-flexibility-for-key-users/making-ui-changes",
+			s4HanaCloudUrl: "https://help.sap.com/docs/SAP_S4HANA_CLOUD/4fc8d03390c342da8a60f8ee387bca1a/54270a390b194c3e97be2424592c3352.html",
+			s4HanaOnPremUrl: "https://help.sap.com/docs/ABAP_PLATFORM_NEW/a7b390faab1140c087b8926571e942b7/54270a390b194c3e97be2424592c3352.html"
+		};
+		if (sFeatureKey === DocumentedAnnotationChanges.Rename) {
+			oDocumentationUrls.btpUrl += "#renaming-a-ui-element";
+			oDocumentationUrls.s4HanaCloudUrl += "#renaming-a-ui-element";
+			oDocumentationUrls.s4HanaOnPremUrl += "#renaming-a-ui-element";
+		} else if (sFeatureKey === DocumentedAnnotationChanges.TextArrangement) {
+			oDocumentationUrls.btpUrl += "#changing-the-text-arrangement";
+			oDocumentationUrls.s4HanaCloudUrl += "#changing-the-text-arrangement";
+			oDocumentationUrls.s4HanaOnPremUrl += "#changing-the-text-arrangement";
+		}
+
+		return RtaUtils.getSystemSpecificDocumentationUrl(oDocumentationUrls);
+	}
+
 	AnnotationChangeDialog.prototype._createDialog = async function() {
 		this._oController = new AnnotationChangeDialogController();
 		const oDialog = await Fragment.load({
@@ -140,7 +161,8 @@ sap.ui.define([
 			control: oControl,
 			annotation: sAnnotation,
 			description: sAnnotationDescription,
-			singleRename: bSingleRename
+			singleRename: bSingleRename,
+			featureKey: sFeatureKey
 		} = mPropertyBag;
 		const {
 			serviceUrl: sServiceUrl,
@@ -191,7 +213,9 @@ sap.ui.define([
 		}
 
 		// Once a change gets passed to the model during initialization, the property _appliedOnModel is set to true
-		replaceValuesWithValuesFromPendingChanges(aExistingChanges.filter((oChange) => !oChange._appliedOnModel), aProperties, bObjectAsKey);
+		replaceValuesWithValuesFromPendingChanges(
+			aExistingChanges.filter((oChange) => !oChange._appliedOnModel), aProperties, bObjectAsKey
+		);
 
 		this.oChangeAnnotationModel.setData({
 			objectAsKey: bObjectAsKey,
@@ -206,7 +230,8 @@ sap.ui.define([
 			singleRename: bSingleRename || false,
 			possibleValues: aPossibleValues,
 			valueType: sAnnotationValueType,
-			serviceUrl: sServiceUrl
+			serviceUrl: sServiceUrl,
+			documentationUrl: getDocumentationUrl(sFeatureKey)
 		});
 		if (sFilterText) {
 			this._oController.filterProperties(sFilterText, !!bSingleRename);

package/src/sap/ui/rta/plugin/annotations/AnnotationChangeDialogController.js

@@ -1,7 +1,7 @@
 
 /*!
  * OpenUI5
- * (c) Copyright 2025 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2026 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define([
@@ -35,7 +35,7 @@ sap.ui.define([
 	 * @class Controller for the AnnotationChangeDialog.
 	 * @extends sap.ui.core.mvc.Controller
 	 * @author SAP SE
-	 * @version 1.143.1
+	 * @version 1.145.0
 	 * @constructor
 	 * @since 1.132
 	 * @private
@@ -52,8 +52,14 @@ sap.ui.define([
 	AnnotationChangeDialogController.prototype.filterProperties = function(sQuery, bEquals) {
 		const aFilters = [];
 		if (sQuery && sQuery.length > 0) {
-			const filter = new Filter("label", bEquals ? FilterOperator.EQ : FilterOperator.Contains, sQuery);
-			aFilters.push(filter);
+			const sOperator = bEquals ? FilterOperator.EQ : FilterOperator.Contains;
+			const oLabelFilter = new Filter("label", sOperator, sQuery);
+			const oValueFilter = new Filter("currentValue", sOperator, sQuery);
+			const oCombinedFilter = new Filter({
+				filters: [oLabelFilter, oValueFilter],
+				and: false
+			});
+			aFilters.push(oCombinedFilter);
 		}
 
 		const oList = Element.getElementById("sapUiRtaChangeAnnotationDialog_propertyList");

package/src/sap/ui/rta/plugin/annotations/AnnotationPlugin.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2025 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2026 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -105,7 +105,7 @@ sap.ui.define([
 	 * @class
 	 * @extends sap.ui.rta.plugin.Plugin
 	 * @author SAP SE
-	 * @version 1.143.1
+	 * @version 1.145.0
 	 * @constructor
 	 * @private
 	 * @since 1.132
@@ -130,7 +130,7 @@ sap.ui.define([
 
 	/**
 	 * @param {sap.ui.dt.ElementOverlay} oElementOverlay - Overlay to be checked for editable
-	 * @returns {boolean} True if it's editable
+	 * @returns {boolean} <code>true</code> if it's editable
 	 * @private
 	 */
 	AnnotationPlugin.prototype._isEditable = function(oElementOverlay) {
@@ -159,7 +159,7 @@ sap.ui.define([
 	 * @public
 	 */
 	AnnotationPlugin.prototype.isEnabled = function(aElementOverlays) {
-		if (aElementOverlays.length !== 1) {
+		if (!this.isAvailable(aElementOverlays) || aElementOverlays.length !== 1) {
 			return false;
 		}
 
@@ -186,9 +186,10 @@ sap.ui.define([
 	 *
 	 * @param {sap.ui.dt.ElementOverlay[]} aElementOverlays - Target Overlays of the action
 	 * @param {object} oAction - The action object defined in the designtime
+	 * @param {string} sKey - Key of the action, used to display the specific documentation link
 	 * @return {Promise} Resolves with the creation of the commands
 	 */
-	AnnotationPlugin.prototype.handler = async function(aElementOverlays, oAction) {
+	AnnotationPlugin.prototype.handler = async function(aElementOverlays, oAction, sKey) {
 		const oElementOverlay = aElementOverlays[0];
 		const oElement = oElementOverlay.getElement();
 
@@ -201,7 +202,8 @@ sap.ui.define([
 				annotation: oAction.annotation,
 				description: oAction.description,
 				singleRename: oAction.singleRename,
-				controlBasedRenameChangeType: oAction.controlBasedRenameChangeType
+				controlBasedRenameChangeType: oAction.controlBasedRenameChangeType,
+				featureKey: sKey
 			});
 
 			if (aAnnotationChanges.length) {
@@ -272,7 +274,7 @@ sap.ui.define([
 							typeof oAction.isEnabled === "function" && oAction.isEnabled(aElementOverlays[0].getElement())
 							|| (oAction.isEnabled !== false) && this.isEnabled(aElementOverlays)
 						),
-						handler: this.handler.bind(this, aElementOverlays, oAction),
+						handler: this.handler.bind(this, aElementOverlays, oAction, sKey),
 						additionalInfo: this._getAdditionalInfo(oResponsibleElementOverlay, oAction)
 					});
 				}

package/src/sap/ui/rta/plugin/annotations/AnnotationTypes.js

@@ -1,7 +1,7 @@
 
 /*!
  * OpenUI5
- * (c) Copyright 2025 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2026 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define([], function() {

package/src/sap/ui/rta/plugin/annotations/DocumentedAnnotationChanges.js

@@ -0,0 +1,14 @@
+
+/*!
+ * OpenUI5
+ * (c) Copyright 2026 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+sap.ui.define([], function() {
+	"use strict";
+
+	return {
+		Rename: "rename",
+		TextArrangement: "textArrangement"
+	};
+});

package/src/sap/ui/rta/plugin/iframe/AddIFrame.js

@@ -1,25 +1,27 @@
 /*!
  * OpenUI5
- * (c) Copyright 2025 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2026 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
 sap.ui.define([
-	"sap/ui/core/Lib",
-	"sap/ui/rta/plugin/BaseCreate",
-	"sap/ui/fl/Utils",
-	"sap/ui/dt/Util",
 	"sap/base/util/uid",
 	"sap/ui/core/IconPool",
-	"sap/ui/rta/plugin/iframe/AddIFrameDialog"
+	"sap/ui/core/Lib",
+	"sap/ui/dt/Util",
+	"sap/ui/fl/util/CancelError",
+	"sap/ui/fl/Utils",
+	"sap/ui/rta/plugin/iframe/AddIFrameDialog",
+	"sap/ui/rta/plugin/BaseCreate"
 ], function(
-	Lib,
-	BaseCreate,
-	FlexUtils,
-	DtUtil,
 	uid,
 	IconPool,
-	AddIFrameDialog
+	Lib,
+	DtUtil,
+	CancelError,
+	FlexUtils,
+	AddIFrameDialog,
+	BaseCreate
 ) {
 	"use strict";
 
@@ -89,7 +91,7 @@ sap.ui.define([
 		})
 		.then(function(mSettings) {
 			if (!mSettings) {
-				return Promise.reject(); // Cancel
+				throw new CancelError();
 			}
 			mSettings.index = iIndex;
 			mSettings.aggregation = oAction.aggregation;
@@ -119,7 +121,7 @@ sap.ui.define([
 	 * @class The AddIFrame allows trigger AddIFrame operations on the overlay.
 	 * @extends sap.ui.rta.plugin.BaseCreate
 	 * @author SAP SE
-	 * @version 1.143.1
+	 * @version 1.145.0
 	 * @constructor
 	 * @private
 	 * @since 1.75

package/src/sap/ui/rta/plugin/iframe/AddIFrameDialog.fragment.xml

@@ -15,7 +15,6 @@
 		validationError="onValidationError"
 		parseError="onValidationError"
 		contentWidth="50rem"
-		contentHeight="44rem"
 		core:require="{ FloatType: 'sap/ui/model/type/Float' }"
 		beforeOpen="onBeforeOpen"
 	>
@@ -91,8 +90,13 @@
 							renderType="Bare"
 						>
 							<HBox id="sapUiRtaAddIFrameDialog_ParametersHeader" class="sapUiRtaAddIFrameParametersHeader" justifyContent="SpaceBetween" alignContent="Center">
-								<Label id="sapUiRtaAddIFrameDialog_ParametersLabel" text="{i18n>IFRAME_ADDIFRAME_DIALOG_PARAMETERS_LABEL}" labelFor="sapUiRtaAddIFrameDialog_ParameterTable"
-									class="sapUiRtaAddIFrameDialogParametersLabel" design="Bold"/>
+								<Label
+									id="sapUiRtaAddIFrameDialog_ParametersLabel"
+									text="{i18n>IFRAME_ADDIFRAME_DIALOG_PARAMETERS_LABEL}"
+									labelFor="sapUiRtaAddIFrameDialog_ParameterTable"
+									class="sapUiRtaAddIFrameDialogParametersLabel"
+									tooltip="{i18n>IFRAME_ADDIFRAME_DIALOG_PARAMETERS_LABEL}"
+									design="Bold"/>
 								<Button
 									id="sapUiRtaAddIFrameDialog_HideParametersButton"
 									icon="sap-icon://decline"
@@ -157,7 +161,7 @@
 						</VBox>
 					</VBox>
 				</layout:Grid>
-				<VBox id="sapUiRtaAddIFrameDialog_UrlWarningVBox" class="sapUiSmallMarginBegin" displayInline="true">
+				<VBox id="sapUiRtaAddIFrameDialog_UrlWarningVBox" class="sapUiSmallMarginBegin sapUiRtaAddIFrameDialogUrlWarningVBox" displayInline="true">
 					<MessageStrip
 						id="sapUiRtaAddIFrameDialog_UrlInfoMessageStrip"
 						text="{i18n>IFRAME_ADDIFRAME_DIALOG_URL_INFO_TEXT}"
@@ -167,7 +171,7 @@
 						<link>
 							<Link text="{i18n>IFRAME_ADDIFRAME_DIALOG_URL_INFO_LINKTEXT}"
 								target="_blank"
-								href="https://help.sap.com/docs/search?q=Embedding%20Content%20%28Object%20Pages%29"/>
+								href="{dialogInfo>/documentationUrl/value}"/>
 						</link>
 					</MessageStrip>
 				</VBox>
@@ -189,7 +193,7 @@
 							id="sapUiRtaAddIFrameDialog_PreviewButton"
 							class="sapUiRtaAddIFrameDialogPreviewButton"
 							press="onPreviewPress"
-							enabled="{= !${dialogInfo>/frameUrlError/value} &amp;&amp; (${dialogInfo>/previousFrameUrl/value} !== ${dialogInfo>/frameUrl/value} || ${dialogInfo>/settingsUpdate/value})}"
+							enabled="{= !${dialogInfo>/frameUrlError/value} &amp;&amp; ${dialogInfo>/frameUrl/value} !== '' &amp;&amp; (${dialogInfo>/previousFrameUrl/value} !== ${dialogInfo>/frameUrl/value} || ${dialogInfo>/settingsUpdate/value})}"
 							icon="{=${dialogInfo>/previousFrameUrl/value} ? 'sap-icon://refresh' : null }"
 							type="{= !${dialogInfo>/frameUrlError/value} &amp;&amp; (${dialogInfo>/previousFrameUrl/value} !== ${dialogInfo>/frameUrl/value} || ${dialogInfo>/settingsUpdate/value}) ? 'Emphasized' : 'Default' }"
 							/>
@@ -254,7 +258,7 @@
 								adjustLabelSpan="false"
 								singleContainerFullSize="false"
 								ariaLabelledBy="sapUiRtaAddIFrameDialog_WidthLabel"
-								columnsXL="2" columnsL="2" columnsM="2" columnsS="2"
+								columnsXL="2" columnsL="2" columnsM="2"
 								labelSpanXL="2" labelSpanL="2" labelSpanM="2" labelSpanS="4"
 								emptySpanXL="2" emptySpanL="2" emptySpanM="2" emptySpanS="0"
 						>
@@ -297,7 +301,7 @@
 							adjustLabelSpan="false"
 							singleContainerFullSize="false"
 							ariaLabelledBy="sapUiRtaAddIFrameDialog_HeightLabel"
-							columnsXL="2" columnsL="2" columnsM="2" columnsS="2"
+							columnsXL="2" columnsL="2" columnsM="2"
 							labelSpanXL="2" labelSpanL="2" labelSpanM="2" labelSpanS="4"
 							emptySpanXL="2" emptySpanL="2" emptySpanM="2" emptySpanS="0"
 						>
@@ -476,7 +480,7 @@
 				type="Emphasized"
 				text="{i18n>IFRAME_ADDIFRAME_DIALOG_BUTTON_SAVE}"
 				press="onSavePress"
-				enabled="{= !!${dialogInfo>/areAllFieldsValid}}"
+				enabled="{= !!${dialogInfo>/areAllFieldsValid} }"
 			/>
 		</beginButton>
 		<endButton>
@@ -489,4 +493,4 @@
 			/>
 		</endButton>
 	</Dialog>
-</core:FragmentDefinition>
+</core:FragmentDefinition>

package/src/sap/ui/rta/plugin/iframe/AddIFrameDialog.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2025 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2026 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define([
@@ -39,10 +39,19 @@ sap.ui.define([
 			? _oTextResources.getText("IFRAME_ADDIFRAME_DIALOG_SELECT_ADDITIONAL_TEXT_PERCENT_SECTION")
 			: _oTextResources.getText("IFRAME_ADDIFRAME_DIALOG_SELECT_ADDITIONAL_TEXT_PERCENT_HEADER");
 
+		const mDocumentationUrls = {
+			btpUrl: "https://help.sap.com/docs/ui5-flexibility-for-key-users/ui5-flexibility-for-key-users/embedding-content",
+			s4HanaCloudUrl: "https://help.sap.com/docs/SAP_S4HANA_CLOUD/4fc8d03390c342da8a60f8ee387bca1a/8db25610e91342919fcf63d4e5868ae9.html",
+			s4HanaOnPremUrl: "https://help.sap.com/docs/ABAP_PLATFORM_NEW/a7b390faab1140c087b8926571e942b7/8db25610e91342919fcf63d4e5868ae9.html"
+		};
+
 		return new JSONModel({
 			dialogTitle: bSetUpdateTitle ?
 				_oTextResources.getText("IFRAME_ADDIFRAME_DIALOG_UPDATE_TITLE") :
 				_oTextResources.getText("IFRAME_ADDIFRAME_DIALOG_TITLE"),
+			documentationUrl: {
+				value: RtaUtils.getSystemSpecificDocumentationUrl(mDocumentationUrls)
+			},
 			asContainer: {
 				value: bAsContainer
 			},
@@ -67,16 +76,23 @@ sap.ui.define([
 			frameHeightUnit: {
 				value: "vh"
 			},
+			// The URL entered by the user (without resolving bindings)
 			frameUrl: {
 				value: "",
 				valueState: ValueState.None
 			},
+			// URL value when the dialog was opened (without resolving bindings), to detect changes for update
+			initialFrameUrl: {
+				value: ""
+			},
+			// URL value when the last preview was generated (with resolved bindings), to control the preview button state
 			previousFrameUrl: {
 				value: ""
 			},
 			frameUrlError: {
 				value: undefined
 			},
+			// URL used for the iframe preview (with resolved bindings)
 			previewUrl: { value: "" },
 			parameters: { value: [] },
 			unitsOfWidthMeasure: [{
@@ -123,7 +139,7 @@ sap.ui.define([
 	 * @class Context - Dialog for IFrame settings in Runtime Authoring
 	 * @extends sap.ui.base.ManagedObject
 	 * @author SAP SE
-	 * @version 1.143.1
+	 * @version 1.145.0
 	 * @constructor
 	 * @private
 	 * @since 1.78