navpopover/SemanticObjectController The <code>SemanticObjectController</code> control operates as a single entry point for <code>SmartLink</code> controls created automatically by {@link sap.ui.comp.smarttable.SmartTable SmartTable} control, {@link sap.ui.comp.smartchart.SmartChart SmartChart} control, {@link sap.ui.comp.smartform.SmartForm SmartForm} control and {@link sap.ui.comp.smartfield.SmartField SmartField} control based on OData metadata. Additionally, all events provided by the <code>SmartLink</code> control are registered by the SemanticObjectController and can be consumed there in a single place. As usual, the SemanticObjectController can be defined within the XML view as well as in the code. sap.ui.core/Element Comma-separated list of fields that must not be displayed as links. If set to <code>true</code>, the SemanticObjectController will retrieve all navigation targets once and will disable links for which no targets were found. Setting this value to <code>true</code> will trigger an additional roundtrip. The property <code>prefetchNavigationTargets</code> is obsolete as navigation targets are determined automatically. The SmartLink controls are re-rendered as soon as the asynchronous determination of navigation targets has been completed. Maps the fields to the related semantic objects. When accessing this property for the first time, the mapping will be calculated from the metadata within the provided model. The name of the entity set used. If <code>entitySet</code> has not been defined, the SemanticObjectController tries to retrieve the name from its parents. <b>Note:</b> This is not a dynamic UI5 property. Navigation property that points from the current to the related entity type where the <code>com.sap.vocabularies.Communication.v1.Contact</code> annotation is defined, for example, <code> '\{"Supplier":"to_Supplier", "CompanyName":"to_Company"\}' </code>. An empty string means that the related entity type is the current one. Determines whether the personalization link is shown inside the NavigationPopover control. For example, <code> '\{"Supplier":false, "CompanyName":true\}' </code>. If set to <code>false</code>, the SmartLink control will not replace its field name with the according <code>semanticObject</code> property during the calculation of the semantic attributes. Object containing fields for which the corresponding <code>SmartLink</code> control is rendered as a link even if <code>contactAnnotationPaths</code> is not set and navigation targets do not exist. Setting this property to <code>true</code> allows the application, for example, to modify the <code>SmartLink</code> control in the event handler, after the user has clicked on a link and the registered event handler has been called.\n <b>Note:</b> The <code>ignoredFields</code> property and the <code>ignoreLinkRendering</code> property of the <code>SmartLink</code> control take precedence over <code>forceLinkRendering</code>.\n Example of usage: <code> '\{"Supplier":"true", "CompanyName":"true"\}' </code> After the navigation targets have been retrieved, <code>navigationTargetsObtained</code> is fired and makes it possible you to change the targets. The main navigation object. Array of available navigation target objects. The navigation object for the own application. This navigation option is by default not visible on the popover. Array containing contact data. The semantic object for which the navigation targets have been retrieved. Map containing the semantic attributes. The ID of the control that fires this event. If <code>navigationTargetsObtained</code> is registered on the SmartLink, <code>originalId</code> is the same as the event's source ID which is also the SmartLink's ID. If <code>navigationTargetsObtained</code> is registered on the SemanticObjectController, <code>originalId</code> helps to identify the original SmartLink control which triggered the event. This callback function shows the actual navigation popover. If the <code>navigationTargetsObtained</code> has been registered, the <code>show</code> function has to be called manually in order to open the navigation popover. Signatures: <code>show()</code> <ul> <li><code>show(oMainNavigation, aAvailableActions, oAdditionalContent)</code> Parameters: <ul> <li>{sap.ui.comp.navpopover.LinkData | null | undefined} oMainNavigation The main navigation object. With <code>null</code> the main navigation object will be removed. With <code>undefined</code> the old object will remain.</li> <li>{sap.ui.comp.navpopover.LinkData[] | [] | undefined} aAvailableActions Array containing the cross-application navigation links. With empty array all available links will be removed. With <code>undefined</code> the old links will remain.</li> <li>{sap.ui.core.Control | null | undefined} oAdditionalContent Control that will be displayed in extra content section on the popover. With <code>null</code> the main extra content object will be removed. With <code>undefined</code> the old object still remains.</li> </ul> </li> <li><code>show(sMainNavigationId, oMainNavigation, aAvailableActions, oAdditionalContent)</code> Parameters: <ul> <li>{string | undefined} sMainNavigationId The visible description for the main navigation link. With <code>''</code>, both the description and subtitle will be removed. With <code>undefined</code>, the description is calculated using the binding context of a given source object (for example <code>SmartLink</code> control).</li> <li>{sap.ui.comp.navpopover.LinkData | null | undefined} oMainNavigation The main navigation object. With <code>null</code> the main navigation object will be removed. With <code>undefined</code> the old object will remain.</li> <li>{sap.ui.comp.navpopover.LinkData[] | [] | undefined} aAvailableActions Array containing the cross-application navigation links. With empty array all available links will be removed. With <code>undefined</code> the old links will remain.</li> <li>{sap.ui.core.Control | null | undefined} oAdditionalContent Control that will be displayed in extra content section on the popover. With <code>null</code> the main extra content object will be removed. With <code>undefined</code> the old object still remains.</li> </ul> </li> </ul> Event is fired before the navigation popover opens and before navigation target links are retrieved. Event can be used to change the parameters used to retrieve the navigation targets. In case of SmartLink, <code>beforePopoverOpens</code> is fired after the link has been clicked. The semantic object for which the navigation targets will be retrieved. Map containing the semantic attributes calculated from the binding that will be used to retrieve the navigation targets. The parameter <code>semanticAttributes</code> is obsolete. Instead use the parameter <code>semanticAttributesOfSemanticObjects</code>. A map of semantic objects for which the navigation targets will be retrieved and it's semantic attributes calculated from the binding context. The semantic attributes will be used as parameters in order to retrieve the navigation targets. This callback function enables you to define a changed semantic attributes map. Signatures: <code>setSemanticAttributes(oSemanticAttributesMap)</code> Parameter: <ul> <li>{object} oSemanticAttributesMap New map containing the semantic attributes</li> <li>{string} sSemanticObject Semantic Object for which the oSemanticAttributesMap belongs</li> </ul> This callback function sets an application state key that is used over the cross-application navigation. Signatures: <code>setAppStateKey(sAppStateKey)</code> Parameter: <ul> <li>{string} sAppStateKey</li> </ul> The ID of the control that fires this event. If <code>beforePopoverOpens</code> is registered on the SmartLink, <code>originalId</code> is the same as the event's source ID which is also the SmartLink's ID. If the <code>beforePopoverOpens</code> is registered on the SemanticObjectController, <code>originalId</code> helps to identify the original SmartLink control which triggered the event. This callback function triggers the retrieval of navigation targets and leads to the opening of the navigation popover. Signatures: <code>open()</code> If <code>beforePopoverOpens</code> has been registered, <code>open</code> function has to be called manually in order to open the navigation popover. This event is fired after a navigation link on the navigation popover has been clicked. This event is only fired, if the user left-clicks the link. Right-clicking the link and selecting 'Open in New Window' etc. in the context menu does not fire the event. The UI text shown in the clicked link. The navigation target of the clicked link. The semantic object used to retrieve this target. Map containing the semantic attributes used to retrieve this target. The ID of the control that fires this event. If <code>navigate</code> is registered on the SmartLink, <code>originalId</code> is the same as the event's source ID which is the SmartLink's ID. If <code>navigate</code> is registered on the SemanticObjectController, <code>originalId</code> helps to identify the original SmartLink control which triggered the event. If the property <code>prefetchNavigationTargets</code> is set to <code>true</code>, event <code>prefetchDone</code> is fired after all navigation targets have been retrieved. The event <code>prefetchDone</code> is obsolete because it depends on the property <code>prefetchNavigationTargets</code> which has been deprecated. A map containing all semantic objects as keys for which at least one navigation target has been found. The value for each semantic object key is an array containing the available actions found for this semantic object.