Building Block Configuration Guide

Document Version: 1.0 2016-03-07

SAP Fiori app Configuration and Onboarding (Fiori Cloud Edition)

CUSTOMER

Typographic Conventions
Type Style

Description

Example

Words or characters quoted from the screen. These include field names, screen titles,
pushbuttons labels, menu names, menu paths, and menu options.
Textual cross-references to other documents.

Example

Emphasized words or expressions.

EXAMPLE

Technical names of system objects. These include report names, program names,
transaction codes, table names, and key concepts of a programming language when they
are surrounded by body text, for example, SELECT and INCLUDE.

Example

Output on the screen. This includes file and directory names and their paths, messages,
names of variables and parameters, source text, and names of installation, upgrade and
database tools.

Example

Exact user entry. These are words or characters that you enter in the system exactly as
they appear in the documentation.

<Example>

Variable user entry. Angle brackets indicate that you replace these words and characters
with appropriate entries to make entries in the system.

EXAMPLE

Keys on the keyboard, for example, F 2 or E N T E R .

CUSTOMER
Error! Reference source not found.

SAP
Typographic Conventions

Document History
Version

Date

Change

1.0

2016-03-07

First version

SAP
Document History

CUSTOMER
Error! Reference source not found.

Table of Contents
1

Purpose

2
2.1

Configuration
Maintain Destination SAP_Gateway

6
6

3
3.1

3.2

Management and User Onboarding in SAP Fiori Cloud Edition

Settings on SAP HANA Cloud Platform
3.1.1
Required Subscriptions to access Theme Designer and SAP Web IDE
3.1.2
Required Roles for the Site Settings
SAP Fiori Launchpad Administration
3.2.1
Manage Catalogs
3.2.2
Manage Tile Groups
3.2.3
Manage Translations
3.2.4
Configure Site Settings
3.2.5
UI Theme Designer and Theme Manager
3.2.6
App Tile Wizard / Apps

CUSTOMER
Error! Reference source not found.

7
7
7
8
10
10
12
12
13
14
14

Error! No bookmark name given.

Table of Contents

Purpose

This guide describes the required configuration settings to connect a customer's on-premise SAP Gateway
System to the SAP HANA Cloud Platform using the SAP Fiori Cloud Edition. It describes the required settings on
SAP HANA Cloud Platform as well as the management of the Fiori Launchpad in cloud.

Note
The required configuration settings for the HANA Cloud Connector are described in the configuration
guide 'Deployment of SAP HANA Cloud Connector with Principal Propagation' (MP8) which is a
prerequisite to get a fully running system environment.

Configuration

2.1

Maintain Destination SAP_Gateway

Use
SAP Fiori Cloud Edition apps can be subscribed to an SAP HANA Cloud Platform account. They talk to the
backend through a pre-defined destination called SAP_Gateway.
Therefore, this destination must be maintained correctly pointing to the backend SAP_Gateway.

Procedure
1.

Open the SAP HANA Cloud Platform Cockpit.

2.

In the side panel, choose Destinations.

3.

In the Destinations are, the destination SAP_Gateway should be listed. If it does not exist, create a new
destination.

4.

Choose New Destination and make the following entries:

5.

6.

Property

Values

* Name

SAP_Gateway

Type

HTTP

Description

Insert a description of your choice.

* URL

The virtual host name specified in the access control of SAP HANA
Cloud Connector, e.g. http://mo-026968435.mo.sap.corp

Proxy Type

OnPremise

Authentication

PrincipalPropagation

Choose New Property and maintain the following values as Additional Properties:

Property

Value

WebIDEEnabled

True

WebIDESystem

SAP_Gateway

WebIDEUsage

odata_abap, ui5_execute_abap, dev_abap

Choose Save.

CUSTOMER
Error! Reference source not found.

Error! No bookmark name given.

Table of Contents

Management and User Onboarding in SAP

Fiori Cloud Edition

This chapter describes how to administrate your SAP Fiori apps in the SAP Fiori Cloud Edition.

Note
The SAP Fiori Cloud Edition also provides translations to the SAP Fiori apps. For more details, see chapter
Manage Translations.

3.1

Settings on SAP HANA Cloud Platform

A couple of settings in the SAP HANA Cloud Platform are required so that you can access the Fiori Administration
in the cloud and perform all actions required to manage your apps and users successfully.

3.1.1

Required Subscriptions to access Theme Designer and

SAP Web IDE

Use
If you want to apply your corporate branding to the SAP Fiori apps and you want to extend Fiori apps using SAP
Web IDE, you must subscribe the standard HTML5 applications such as SAP Web IDE and SAP Theme Designer.

Note
The service for SAP Web IDE needs to be activated. To check or activate the service navigate on the SAP
HANA Cloud Platform Cockpit in the side panel to Services.

Procedure
1.

Open the SAP HANA Cloud Platform Cockpit.

2.

In the side panel, choose Subscriptions.

3.

In the Subscribed HTML5 Applications area, choose New Subscription.

4.

Select themedesigner in the Provider Account column.

5.

Choose Save.

6.

Repeat these steps for Web IDE and choosing sapwebide as the provider account and Application webide as
the application.

Note
The Fiori apps you want to use need to be subscribed here as well. Find here a screenshot of the
subscription for the Fiori app 'my Inbox'.

Result
You have now subscribed the application Theme Designer and SAP Web IDE so that you can access these
applications in future.

3.1.2

Required Roles for the Site Settings

Use
The Site Settings provides you with a set of applications you need to manage your Fiori Launchpad settings. Only
users being maintained as tenant administrator can access the Site Settings.

Procedure
1.

Open your SAP HANA Cloud Platform Cockpit account and choose the following navigation path:
Navigation path

Services (from the left-hand navigation panel) tile "SAP HANA Cloud
Portal" link "Configure SAP HANA Cloud Portal" Roles (from the
left-hand navigation panel)

2.

Choose the role TENANT_ADMIN in the Roles area.

3.

Choose Assign in the lower left area and assign the USER IDs of all users which should access the Site
Settings.

CUSTOMER
Error! Reference source not found.

Error! No bookmark name given.

Table of Contents

Note
You can assign a Group of users as well. You then need to maintain the group. The group maintenance is
described in chapter 'Manage Assignment Package'.
You can now access the Site Settings using the following link to display the administration apps:

Navigation path

Subscriptions (from the left-hand navigation panel) flpsandbox

link "Application URL: " Fiori Launchpad shows up - in the upper
right corner choose the drop down Manage Site

Result
You have now maintained the users and can access the Site Settings.

3.2

SAP Fiori Launchpad Administration

With the Site Settings you can adapt the SAP Fiori Launchpad to your needs:
o

Group the apps and users to make the apps available to the users who need it.

Adapt your corporate branding using the Theme Designer.

Extend / Adapt the SAP delivered Fiori apps so it fits to your needs (adapt field labels, hide fields) using
SAP Web IDE.

Translate the user-facing texts in the language of the end users.

Check the adoption of the end user using the embedded analytics tool.

The intention of this chapter is not to describe each single feature but to explain the most important topics in
brief.
Find here some short introduction on the entities being used for grouping apps together and how to publish them
on the SAP Fiori Launchpad.
Catalogs:
A catalog clusters apps together. The assigned Roles define the authorization if a user can use the app on the
Launchpad. Additionally Tile Groups can be assigned to catalogs.
All apps in a catalog need to be selected from the user manually to show up on his Launchpad.
Tile Groups:
A Group is a cluster of one or more SAP Fiori apps. Tile Groups are displayed immediately on the Fiori Launchpad.
There is no user interaction required. If a user is not authorized to see an app in a group, the app is not displayed
in this group. The entire group does not show up for the user if he is not authorized for all apps.

3.2.1

Manage Catalogs

Use
Catalogs are a collector to assign SAP Fiori Apps to. Once a user is authorized to use an app (described in the next
chapter 'Manage Roles'), he can add the app to his SAP Fiori Launchpad. The apps assigned to a category must be
assigned to a group by the user. In doing so, the users personalize their SAP Fiori Launchpad.

Procedure
1.

Access the Site Settings page.

2.

Choose Catalogs.

3.

To create a new Catalog, choose the + icon in the bottom left area.

10

CUSTOMER
Error! Reference source not found.

Error! No bookmark name given.

Table of Contents

4.

Make entries in the following Icon Tabs:

- Properties: Name and Description of the Catalog
- Apps: Assign all apps you want to have in your catalog
- Roles: Is the 'user group' which can access the assigned apps.
- Tile Groups: You can assign Tile Groups as well.

5.

Save your entries.

Result
The end users can now add the apps to their Fiori Launchpad which are assigned in the Catalogs. Apps being
assigned via Tile Groups are displayed immediately on the Launchpad.

Note
The required roles are maintained as described in the chapter Required Roles for the Site Settings.

Example

Open the SAP Fiori Launchpad (you can choose Preview button in the upper right corner).

Choose the Personalize Home Page button (lower right corner).

Choose +Add Group to create your own group. Enter a Group Name.

Choose + to assign an app to this group.

The Tile Catalog is displayed. Your Categories created above including the assigned apps are displayed here.
Choose the + beyond the app to assign it to a group of your choice.

Assign it to a group and choose OK. The app then shows up on your Launchpad.

3.2.2

Manage Tile Groups

Use
Groups are a collector to assign SAP Fiori Apps to. Once a user is authorized to use an app (as described in the
previous chapter), the app assigned to a Tile Group shows up in the Launchpad directly. Depending of the group
settings, the user may add or remove apps to a group via personalization, or he is not allowed to change the group
at all.

Procedure
1.

Access the Site Settings page.

2.

Choose Tile Groups.

3.

To create a new Group, choose the + icon in the bottom left area.

4.

5.

Make entries in the icon tabs:

o

Properties: A Tile Group needs to be assigned to one or more Catalogs. Once the Locked group flag is
selected the end users cannot add or delete apps to this group.

Layout.

Save your entries.

Result
The end user sees the group directly on the SAP Fiori Launchpad.

Note
The personalization of a group can be reset by the users any time. They just need to open the
Personalization Home Page and then choose Reset in the upper right corner of the group.

3.2.3

Manage Translations

Use
Using the translation app, you can translate the created group, categories, and so on in the end users' languages.

Caution
The SAP Fiori Cloud Edition provides translations to the SAP Fiori apps.
Please be aware that if you upload your own translations, you will override the default translations for the
uploaded language.

12

CUSTOMER
Error! Reference source not found.

Error! No bookmark name given.

Table of Contents

Procedure
1.

Access the Site Settings page.

2.

Choose Services.

3.

Choose Translations tile.

4.

Choose Download to download the master language file.

5.

Extract the downloaded zip File.

6.

Follow the steps as described in the extracted readme.txt

7.

Upload the translated file after translation.

Result
You have translated your website to the required languages.

3.2.4

Configure Site Settings

Use
This app enables you to centrally configure your site.

Note
Since there are more parameters than described here, please check the product documentation for more
information.

Procedure
1.

Access the Site Settings.

2.

Choose Configure Site Settings.

3.

On the Settings tab, choose Edit in the footer and maintain your values.

4.

Save and Publish your settings.

Appearance:
You can choose a default Theme here. In case you want to allow the user to change the Theme the check box for
Theme Selection needs to be selected.
In the Assign Site Theme app, each created Theme needs to be enabled for User Selection. There choose the
Enable User Selection button. Only those Themes can be selected by the user.
The user can choose the Theme in the Fiori Launchpad in the upper right corner once he expands the dropdown
and chooses User Preferences. When choosing the Theme option all enabled Themes can be selected then.
Hide Groups:

The user can easily hide groups on his own. In the Fiori Launchpad in the upper right corner expand the dropdown.
An option Hide Groups shows up. Once the user chooses this option, he or she can choose quickly the groups to
hide.

Result
You can maintain parameters to adapt the system due to your needs.

3.2.5

UI Theme Designer and Theme Manager

Using the UI Theme Designer you can brand the look and feel of the Fiori Launchpad according to your needs. Find
details on the usage in the configuration guide 'SAP Fiori app theming (Fiori Cloud Edition)'.

3.2.6

App Tile Wizard / Apps

Use
The App Tile wizard enable you to maintain the central parameters for the Fiori apps to be used in the Fiori
Launchpad. The Apps view is intended to give you a quick overview on all configured apps so far. The Create App
Tile Wizard app is a wizard which helps you to create new app tiles (this is relevant if you, for example, extend an
app). Once configured in this wizard, the result shows up in the Apps area.

Note
Since there are more parameters than described here, please check the product documentation for more
information.

Procedure
1.

Access the Site Settings page.

2.

Choose Apps page.

3.

Choose an app of your choice from the list.

4.

Maintain the relevant information on the Icon Tab Bars Properties and Navigation by choosing Edit, Delete or
Save button.

Icon Tab Bars:

Properties:
Includes information such as App Name, Description, Devices And central information on App Type. The SAP
delivered apps are of type SAPUI5. The available parameters depend on the selected App Type.

14

CUSTOMER
Error! Reference source not found.

Error! No bookmark name given.

Table of Contents

Example
You can easily embed a URL of your choice, i.e. to your portal. Choose type URL in this case and maintain
the URL in the URL area.

Tile:
SAP delivered apps are usually of type Static App Launcher or Dynamic App Launcher. The only difference is that
Dynamic App Launcher displays a number in the tile - which is derived via an oData call in the backend system.
This is used for apps showing how many work items are there in the backend. Another example is the app
Configure Apps in the Site Settings where the number of available apps is displayed.

Example
To proceed with the URL example: choose Static App Launcher. Enter a Title and choose an Icon (if you
have your own icons available, you can upload your own ttf files).