Show TOC

Extending ApplicationsLocate this document in the navigation structure

Extending SAPUI5 applications supports customers and partners in adapting the SAPUI5 standard application to their specific requirements.

The customization of SAPUI5 applications uses the component configuration: The customizing information is stored in a specific area of the component configuration. Such a customization can be performed on a custom application that extends a delivered standard application. A replacement or extension of views and custom controllers can also be part of a custom application, but may not always be required. If no replacement and no custom controller exists, the custom application project only contains the component definition with the customization configuration.

The standard application itself is not changed. The customized application becomes the start-up project and launches the standard application with the additional customizing configuration.

SAPUI5 supports the following adaptations of the standard:

  • View extensions by using extension points to insert custom content (views or fragments)
  • Replacing standard views with custom-developed views
  • Modifying views by changing specific properties of controls
  • Controller extensions by adding code or overriding existing code
  • Customizing i18N resource texts
  • Adding new views
  • Adding new navigation paths
  • Customizing navigation routes

In this section:
    Handling Localized Texts for Extended Applications
    If an application is copied, the texts stored in the SAPUI5 text repository of the original application are not copied and are, thus, not available in the copied SAPUI5 application. This also applies to applications using the extension concepts of SAPUI5.
    Example: Component Configuration
    The component configuration contains the information about the extension metadata and the objects that are replaced or extended in the custom view or control.
    View Extension
    SAPUI5 uses extension points for extending standard views with custom content. The assignment of a custom view to an extension point is done in component customizing.
    View Modification
    For modifying views, control properties of standard views can be changed.
    View Replacement
    Views of a delivered standard application can be replaced to adapt the application to the customer needs.
    Controller Extension
    SAPUI5 supports the extension of a base controller by merging the delivered standard controller with a custom controller on JavaScript object level.
    Controller Replacement
    Standard controller can be replaced by specifying a new controller name in a replacement View and implementing this Controller.
    I18n Resource Text Customization
    The resource model can be enhanced with custom resource bundles.
    Limitations
    Known limitations for extending SAPUI5 applications
    Caveats Regarding Stability Across Application Upgrades
    There are a few limitations in the compatibility of custom applications that have to be considered when extending SAPUI5 standard applications.
    Supportability
    In case of problems or errors in the custom application, several options exist that support you in resolving the issues.