SAPUI5: UI Development Toolkit for HTML5

2060 Pages·2017·30.47 MB·English

DEVELOPER GUIDE | PUBLIC
Document Version: 1.58 – 2018-10-25
SAPUI5: UI Development Toolkit for HTML5
All rights reserved.
mpany.
ffiliate co
P a
A
S
E or an
S
P
A
S
8 THE BEST RUN
01
© 2
Content
SAPUI5: UI Development Toolkit for HTML5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6
What's New in SAPUI5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
What's New in SAPUI5 1.58. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
What's New in SAPUI5 1.56. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16
Read Me First. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26
Compatibility Rules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Browser and Platform Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30
Supported Library Combinations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37
Supported Combinations of Themes and Libraries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Versioning of SAPUI5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40
Upgrading. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42
Deprecated Themes and Libraries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45
SAPUI5 vs. OpenUI5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47
Get Started: Setup and Tutorials. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Development Environment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52
“Hello World!”. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .89
Walkthrough. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95
Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .214
Data Binding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .239
OData V4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
Navigation and Routing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
Testing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384
Mock Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449
Worklist App. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462
SAP Fiori 2.0 App. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .504
Rule Builder Control. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .551
3D Viewer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .568
Ice Cream Machine. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600
Demo Apps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 631
Essentials. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .641
Bootstrapping: Loading and Initializing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 642
Structuring: Components and Descriptor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .670
Model View Controller (MVC). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 732
Data Binding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 761
Reusing UI Parts: Fragments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .926
XML Templating. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .941
SAPUI5: UI Development Toolkit for HTML5
2 PUBLIC Content
Working with Controls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 963
Declarative Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .976
Managing UI and Server Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 982
Routing and Navigation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 988
Modules and Dependencies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1003
Optimizing Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1028
Adapting to Operating Systems And Devices. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1037
SAPUI5 Flexibility Services: Adapting UIs Made Easy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1052
Testing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1058
Theming. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1134
Localization. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1149
SAPUI5 Accessibility Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1156
Spreadsheet Export. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1161
Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1179
Developing Apps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1255
Continuous Integration: Ensure Code Quality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1257
App Templates: Kick Start Your App Development. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1258
App Overview: The Basic Files of Your App. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1285
App Initialization: What Happens When an App Is Started?. . . . . . . . . . . . . . . . . . . . . . . . . . .1287
Folder Structure: Where to Put Your Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1288
Device Adaptation: Using Device Models for Your App. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1292
Performance: Speed Up Your App. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1293
Stable IDs: All You Need to Know. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1297
Reacting on User Input Events. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1302
UI Adaptation at Runtime: Enable Your App. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1303
Coding Issues to Avoid. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1307
Securing Apps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1318
Right-to-Left Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1330
Accessibility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1332
The SAPUI5 ABAP Repository and the ABAP Back-End Infrastructure. . . . . . . . . . . . . . . . . . .1353
Developing Apps with SAP Fiori Elements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1386
How To Use SAP Fiori Elements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1388
List Report and Object Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1443
Worklist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1630
Analytical List Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1632
Overview Pages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1684
Developing Apps with Analysis Path Framework (APF). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1788
Analytical Applications Based on APF. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1790
Setting Up APF and the APF Configuration Modeler. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1792
Authorization Concept. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1796
Enhancing an APF-Based Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1797
SAPUI5: UI Development Toolkit for HTML5
Content PUBLIC 3
Creating Your Own Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1799
APF Configuration Modeler. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1801
Launching APF-Based Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1840
Data Protection and Privacy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1845
APF Modules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1847
Concepts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1854
Configuration Files and Their Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1867
API Reference. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1888
Extending Apps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1889
Using SAPUI5 Flexibility Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1889
Using Component Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1891
Localized Texts for Extended Apps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1900
Limitations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1900
Caveats Regarding Stability Across Application Upgrades. . . . . . . . . . . . . . . . . . . . . . . . . . . .1901
Supportability. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1902
Developing Controls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1903
Development Conventions and Guidelines. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1904
The library.js File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1929
Creating Control and Class Modules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1931
Defining the Control Metadata. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1932
Adding Method Implementations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1938
Device-specific Behavior of Controls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1950
Examples for Creating and Extending Controls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1951
Writing a Control Renderer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1955
Implementing Animation Modes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1958
Implementing Focus Handling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1959
Item Navigation - Supporting Keyboard Handling in List-like Controls. . . . . . . . . . . . . . . . . . . .1961
Right-to-Left Support in Controls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1962
Defining Groups for Fast Navigation (F6). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1966
Composite Controls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1970
Accessibility Aspects for SAPUI5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1981
Writing a Control: FAQ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1995
More About Controls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1996
Busy Indicators. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1997
Date and Time Related Controls: Data Binding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1998
Semantic Pages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2001
Tables: Which One Should I Choose?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2009
sap.f. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2011
sap.m. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2019
sap.suite.ui.commons. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2094
sap.suite.ui.microchart. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2113
SAPUI5: UI Development Toolkit for HTML5
4 PUBLIC Content
sap.tnt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2120
sap.ui.codeeditor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2121
sap.ui.comp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2123
sap.ui.core. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2184
sap.ui.richtexteditor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2187
sap.ui.table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2189
sap.ui.vk. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2190
sap.uxap. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2204
Glossary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2233
SAPUI5: UI Development Toolkit for HTML5
Content PUBLIC 5
SAPUI5: UI Development Toolkit for HTML5
Create apps with rich user interfaces for modern web business applications, responsive across browsers and
devices, based on HTML5. (Documentation version 1.58.8)
SAPUI5 offers powerful development concepts:
● One consistent user experience for your apps Check the SAPUI5 playlist in the SAP Technology
● Responsive across browsers and devices - YouTube channel for the latest highlights videos!
smartphones, tablets, desktops
● Built-in extensibility concepts at code and application
level
● Data binding types and Model-View-Controller (MVC)
● Feature-rich UI controls for handling complex UI
patterns and predefined layouts for typical use cases.
UI controls automatically adapt themselves to the
capabilities of each device.
● Full translation support
● Keyboard interaction support and accessibility features
And many more....

SAP Fiori apps are built with SAPUI5 and follow the SAP Fiori design guidelines to ensure consistent design and
a high level of design quality. See SAP Fiori Design Guidelines .
What's New in SAPUI5
Find out what's new in the latest versions of SAPUI5.
 Note
To learn how the features and functional capabilities of SAPUI5 are planned to progress over time, see the
SAPUI5 Road Map .
Check the latest videos in the SAPUI5 playlist in the SAP Technology YouTube channel and the OpenUI5
YouTube channel.
SAPUI5: UI Development Toolkit for HTML5
6 PUBLIC SAPUI5: UI Development Toolkit for HTML5
What's New in SAPUI5 1.58
With this release, SAPUI5 is upgraded from version 1.56 to 1.58.
New Features
Support Assistant
Rule Presets
● A rule preset management feature has been introduced. It allows you to import, export, and switch
between multiple user-defined subsets of preselected rules. You can see all imported rule presets in a
dropdown menu and easily switch between them. Your current selection of rules is saved in My Selection.
 Note
To make sure that your last selection remains available for future use, choose I agree to use local
storage persistency in the Support Assistant Settings menu.
● An ID field has been added to the Export a Rule Preset dialog. The ID is a string of alphanumeric symbols
added manually by the user when creating a rule preset. It is useful in case you want to collect data and
generate reports on specific rule preset executions within your organization.
For more information, see Rules Management [page 1206].
Rules View Personalization
The Support Assistant now allows you to personalize the Rules View by:
● Choosing which columns to be visible and which to remain hidden
SAPUI5: UI Development Toolkit for HTML5
SAPUI5: UI Development Toolkit for HTML5 PUBLIC 7
● Sorting the information within a column or filtering it by keyword. To access these options, click on a
column header. A dropdown menu opens from which you can choose the desired action.
For more information, see Rules Management [page 1206].
UI5 Inspector
The latest version 0.9.5 of the UI5 Inspector includes two main features:
● Now it supports a dark theme, for when you use Google Development Tools in dark mode.
● In previous versions, the UI5 Inspector did not properly display composite binding structures. Now it shows
all parts of the bindings on the Bindings tab, including individual models, paths, and values. Clicking on the
model link displays the whole model with all values.
For more information, see UI5 Inspector [page 1233].
New Controls
● sap.suite.ui.commons.TAccount: A control that can be used to display individual line items from one
or more accounting documents affecting several general ledger accounts. In T accounts, the line items are
SAPUI5: UI Development Toolkit for HTML5
8 PUBLIC SAPUI5: UI Development Toolkit for HTML5
entered in two columns, debit and credit, and the account name is placed above those columns, resulting
in a T-shaped structure. T accounts can be grouped based on their type or a common attribute, such as
balance sheet T accounts and income statement T accounts. A T-account group is displayed as a
collapsible panel that provides additional information, such as the total balance of all accounts in the
group. On top of the T-account groups, you can add a toolbar that shows total balance across all accounts
included in the control and provides additional actions and details.
For more information, see T Account [page 2107], the API Reference, and the Samples.
Improved Features
Flexibility Panel in the Diagnostics Window
The Flexibility panel in the Diagnostics window now provides better ways to analyze changes. The new UI
Flexibility Diagnostics application visualizes dependencies between changes, and you can quickly spot which
changes have been applied by checking the color of icons that represent the changes.
For more information, see Diagnostics [page 1191].
SAPUI5 OData V4 Model
The new version of the SAPUI5 OData V4 model introduces the following features:
● Messages sent in the sap-messages header are evaluated by the model and transmitted to the message
model.
● Messages sent in the data response of success responses are processed by the OData V4 model and
forwarded to the message model. The message property needs to have the documented structure and its
SAPUI5: UI Development Toolkit for HTML5
SAPUI5: UI Development Toolkit for HTML5 PUBLIC 9
existence needs to be communicated using the dedicated metadata annotation
com.sap.vocabularies.Common.v1.Messages. For more information, see Server Messages [page
985].
● Batch groups whose names start with $auto. are handled like the predefined group $auto.
● Exclude filters NB (not between), NotContains, NotEndsWith, and NotStartsWith are supported.
 Restriction
Due to the limited feature scope of this version of the SAPUI5 OData V4 model, check that all required
features are in place before developing applications. Check the detailed documentation of the features, as
certain parts of a feature may be missing. While we aim to be compatible with existing controls, some
controls might not work due to small incompatibilities compared to sap.ui.model.odata.
(v2.)ODataModel, or due to missing features in the model (such as tree binding). This also applies to
smart controls (sap.ui.comp library) and SAP Fiori elements that do not support the SAPUI5 OData V4
model, as well as controls such as TreeTable and AnalyticalTable, which are not supported together
with the SAPUI5 OData V4 model. The interface for applications has been changed for easier and more
efficient use of the model. For a summary of these changes, see Changes Compared to OData V2 Model
[page 903].
For more information, see OData V4 Model [page 859], the API Reference, and the Samples.
Spreadsheet Export
A new enumeration type is now available. It allows you to apply simple formatting to statuses, based for
example, on a value mapping, such as 1 for New, 2 for In Process, and 3 for Completed.
For more information, see the API Reference and the Sample.
XML Templating: No Preloading Required for Asynchronous Views
With the new version of XML templating, preloading of OData V4 metadata is no longer required if the view is
asynchronous.
For more information, see the API Reference: sap.ui.core.util.XMLPreprocessor and the API Reference:
sap.ui.core.mvc.XMLView.
Improved Controls
● sap.f.DynamicPage:
○ You can now use the sapUiContentPadding, sapUiNoContentPadding, and
sapUiResponsiveContentPadding CSS classes to adjust the content padding of the DynamicPage
control. For more information, see Using Container Content Padding CSS Classes [page 973] and the
API Reference.
○ The sap.f.DynamicPageHeader and sap.f.DynamicPageTitle classes now introduce a new
backgroundDesign property which has three background options - Solid, Transparent, or
Translucent. For the new property to be supported correctly when using the dynamic header in
sap.uxap.ObjectPageLayout, a new backgroundDesignAnchorBar property is added to
sap.uxap.ObjectPageLayout, which is used to control the background color of the
sap.uxap.AnchorBar through its own newly added backgroundDesign property. For more
SAPUI5: UI Development Toolkit for HTML5
10 PUBLIC SAPUI5: UI Development Toolkit for HTML5