Continuing my series on Fiori elements … you’ll find more blogs in the Fiori elements wiki.
A simple way to add a little emphasis and pizazz to your Fiori elements apps is to add status icons and semantic colors to a text field. Here we show how to do this using a List Report column as the example.
When you want to attract your business users’ attention, UI.Criticality is one of the easiest annotations you can use to add some visual bling to your Fiori elements apps. It’s a great option for adding a status icon and a little semantic colour to a simple text or date field.
In this example status icons and semantic colors have been added to the text property Overall Status. The original property text values Paid, Cancelled, New, and Delivered have been transformed with a status icon and semantic color.
Accessibility note: Notice that we automatically apply a different color *and* a different icon rather than relying on color alone. This means that even users with red-green color-blindness can easily distinguish the criticality of different statuses. You can find more background on this topic in the success criterion of the Web Content Accessibility Guidelines.
Tip: What do we mean by semantic color? Certain colors have intrinsic meaning in many countries and cultures. In business some of the most recognized colors are those often referred to as “traffic light” colors:
- Red meaning stop or negative
- Yellow meaning be careful or warning,
- Green meaning go or positive
And we add a 4th Grey meaning neutral.
There are 3 easy steps to using the criticality annotation:
- Know how the criticality value maps to status icons and semantic colours
- Map the criticality value to your target field
- Add the UI.Criticality annotation to your target field
Let’s get to it!
Understanding Criticality Values
There are 4 possible criticality values. These map to status icons and semantic colors as follows:
Map the Criticality Value to your Target Field
Often the simplest way to map your criticality value to your target field is to map it to a separate calculated field of the same OData Service entity.
For example, if you are using a ABAP CDS View exposed as an OData Service, you could map the values of a text property OverallStatus of the entity SalesOrder to a new field Criticality by adding a simple CASE statement in your CDS View such as this:
Tip: Always make sure you activate and test your OData Service before adding the new value to your Fiori elements app.
Add the Criticality Annotation to your Target Field
All you need to do now is to add the criticality annotation to your target field in your Fiori element app. You can do this:
- In a Metadata extension of your CDS View
- The recommended approach
- Inline in your CDS View
- Possible but not recommended – an easy option for sandpit scenarios
- In the local annotations file of your Fiori element app
- Possible & a useful option if you don’t have access to change the OData Service or you are reusing an existing OData Service in a new app and don’t want to impact any existing apps
For example if your Target Field is set up as a UI.DataField of a Fiori element List Report app, you can add your criticality annotation in a metadata extension of the CDS View like this:
Or in the SAP Cloud Platform Web IDE you can add the criticality to your local annotations file using the Annotation Modeler to assign the Criticality property as highlighted in this example:
Or directly using the XML editor of your local annotations XML file like this:
Now just run your app!
Take your Fiori elements app to the Next Level
If you are interested in Fiori elements you might also like to look at some of our videos on Youtube such as:
- Creating a List Report App with SAP Fiori Elements
- Adding Fields to a List Report Table with SAP Fiori Elements
- Adding a Default Filter to a List Report with SAP Fiori Elements
If you want to find out more on how to use the Annotation Modeler, you might like to look at some of our Annotation Modeler in SAP Web IDE videos on Youtube.
If you are going to SAP Teched 2017 and Interested in learning more about Fiori elements you might like to attend these sessions:
- DX201 What’s New with SAP Fiori Elements
- S4H276 Build a List Report SAP Fiori App: ABAP Programming Model for SAP S/4HANA
- S4H279 Build Transactional SAP Fiori App: ABAP Programming Model for SAP S/4 HANA
- DX264 Overview Page in SAP Fiori Elements
- DX266 SAP Fiori Elements – Analytical List Page
Screenshots shown on:
- ABAP Development Tools on Eclipse Neon
- Web IDE Version: 170720
- SAPUI5 version 1.46.11