How to Deploy Standard Fiori Applications(HCM) to Device using Fiori Mobile

www.sap.com

How to Deploy Standard

Fiori Applications(HCM) to
Device using Fiori Mobile

Yang Gang
-----------------------------------------------------------------------------------------------------------------------------------------------------
Document Version Authored By Description Date Created
1.0 Yang Gang Fiori Mobile White Paper May 10, 2017

-----------------------------------------------------------------------------------------------------------------------------------------------------

2
Table of Contents
ABSTRACT ................................................................................................................................................... 4
CHAPTER 1 INTRODUCTION ........................................................................................................................ 5
CHAPTER 2 INSTALLING AND CONFIGURING CLOUD CONNECTOR .............................................................. 6
Install the Cloud Connector ......................................................................................................................... 6
Configure the Cloud Connector to connect your SAP Cloud Platform ......................................................... 7
Configure the Cloud Connector to connect your Fiori server....................................................................... 9

CHAPTER 3 CONFIGURING ROLES FOR SAP FIORI MOBILE SERVICE ............................................................15

CHAPTER 4 CONFIGURING CLOUD PLATFORM DESTINATION ....................................................................22
CHAPTER 5 DEPLOYING APPLICATIONS USING FIORI MOBILE ....................................................................27
Access to Fiori Mobile service in SAP Cloud Platform.................................................................................27
Configure Fiori Mobile service connection .................................................................................................29
Create Signing Profiles ...............................................................................................................................31
Create Application deploying to mobile device ..........................................................................................36

3
Abstract
CHAPTER 1 -- INTRODUCTION
CHAPTER 2 -- INSTALLING AND CONFIGURING CLOUD CONNECTOR

2.1 Install the Cloud Connector

2.2 Configure the Cloud Connector to connect your SAP Cloud Platform
2.3 Configure the Cloud Connector to connect your Fiori server
CHAPTER 3 -- CONFIGURING ROLES FOR SAP FIORI MOBILE SERVICE

CHAPTER 4 -- CONFIGURING CLOUD PLATFORM DESTINATION

CHAPTER 5 -- DEPLOYING APPLICATIONS USING FIORI MOBILE

4.1 Access to Fiori Mobile service in SAP Cloud Platform
4.2 Configure Fiori Mobile service connection
4.3 Create Signing Profiles
4.4 Create Application deploying to mobile device

4
 Chapter 1
Introduction
Welcome to How to deploy standard Fiori applications(HCM) to device using Fiori Mobile. In this white paper,
you can find all the details that are needed to deploy existing Fiori applications(HCM) to mobile device using
Fiori Mobile on SAP Cloud Platform.
Please make sure your standard Fiori applications(HCM) works well in Fiori Launchpad and you have a SAP Cloud
platform account.
If the application does not work, please go through the white paper below to install and configure your
application first.
https://wiki.scn.sap.com/wiki/x/eZ-5Gg

Figure 1 HCM applications in Fiori Launchpad

If you don’t have a SAP Cloud Platform account, you can use the following way to get a trial account.
Trial account is used for testing only.
1. URL: https://account.hanatrial.ondemand.com/
2. Click on Register
3. Follow the registration process
4. You will be asked to provide your First, Last name and Email as well you set your password
5. Once you accept the Terms and Conditions, you will be sent the information that are needed for you to
access Cloud Platform
If you want to have an official account for production, please contact to your AE.

5
 Chapter 2
INSTALLING AND CONFIGURING CLOUD CONNECTOR
In this chapter, we will focus on how to install and configure Cloud Connector to build the connection between
SAP Cloud Platform and your Fiori server.
The Cloud Connector version is 2.9.0.2 in this white paper.

Install the Cloud Connector

1. Download SAP JVM 8 from the following URL:
https://tools.hana.ondemand.com/#cloud
2. Select the installation file for Windows x86_64 as shown below:

Figure 2 SAP JVM

3. Install SAP JVM 8 on your VM or physical machine

4. Download Cloud Connector version 2.10.1 from the following URL:
https://tools.hana.ondemand.com/#cloud
5. Select the installation file for Windows x86_64 as shown below:

Figure 3 SAP Cloud Connector binary

6. Install it on your VM or physical machine and check the option “Start Cloud Connector 2.10.1 after
Finishing the Setup”

7. Make sure the service has started as shown below:

Figure 4 Check SAP Cloud Connector service

6
Configure the Cloud Connector to connect your SAP Cloud Platform
1. Type the following URL to access the SAP Cloud Connector Administration. https://localhost:8443

Figure 5 SAP Cloud Connector Login

2. Default User ID is Administrator and password is manage.

Note User ID and password are case sensitive.

3. You need to change the default password and select the Installation Type when login the connector the
first time. In this case, we use Master (Primary Installation)

Figure 6 Changing the default password and choose installation type

7
4. Click Save and you need to provide your SAP Cloud Platform Region Host and Subaccount information.
In this case, we use HANA Trial host.

Figure 7 Setting up the initial configuration of Cloud Connector

5. Input all needed information as below:

Region Host Select hanatrial.ondemand.com from the dropdownlist
Subaccount User ID including trial. (i.e myIDtrial)
Name
Display Name Same information as the Account Name
Subaccount Your userID without the word trial
User
Password Your password for SAP Cloud Platform
HTTPS Proxy If your environment requires to use proxy in order to access the internet, you need to
provide the information in this section

Figure 8 Filling in the Subaccount information

8
 6. Click SAVE button, you should see the following screen.

Figure 9 Cloud Connector connection status

Configure the Cloud Connector to connect your On-Premise Fiori server

1. In the Cloud Connector Administration Cockpit, click on Cloud To On-Premise as shown below:

Figure 10 Accessing Cloud To On-Premise

2. Click plus button “+” to add a Virtual mapping to the On-Premise NetWeaver Gateway system(Fiori
Server).

Figure 11 Adding Virtual server

9
3. From the System Mapping, select Back-end Type. In this case, we select ABAP System.

Figure 12 Selecting System Mapping type

4. Click Next.

5. Choose protocol type you want to use. In this case, we select HTTP protocol.

Figure 13 Selecting Protocol type

10
6. Input your Fiori server hostname and port and click Next.

Figure 14 Specifying internal system

7. Provide a virtual name to your server. This virtual name can be anything you like. But the port must be
the same as the internal one.

Figure 15 Assigning virtual host name

11
8. Accept the default if you are using HTTP as shown below and click Next.

Figure 16 Setting up Principal Type

9. You can put any description you like in this screen and click Next.

Figure 17 Providing description to your system mapping

12
10. Review the configuration on that screen and make sure everything is correct.

Figure 18 Verifying configuration

11. Click Finish and you should see the following below:

Figure 19 Virtual and Internal system configuration

12. Add Resources Accessible to this server by clicking “+”.

Figure 20 Adding Resources

13
13. Specify “/” under URL Path and select Path and all sub-paths for simplicity as shown below:

Figure 21 Adding path to Resource

14. Click Save, you should see the following:

Figure 22 Finalizing the configuration screen

Note State is green. It means the server can communicate with your Fiori server
now.

14
 Chapter 3
Configuring Roles for SAP Fiori mobile service

Fiori mobile service users require specific roles and permissions to be set up by IT or a system administrator in
the SAP Cloud Platform before being able to use the software.

1. In the SAP Cloud Platform Cockpit, set up the Trust configuration to use Enterprise IDP. See the Identity
Federation with a Corporate Identity Provider section of
https://help.sap.com/viewer/65de2977205c403bbc107264b8eccf4b/Cloud/en-
US/e6b196abbb5710148c8ec6a698441b1e.html#loioe6b196abbb5710148c8ec6a698441b1e__IdP

2. Assign roles to SAP Fiori Mobile Groups:

a. In the Services tab of the SAP Cloud Platform Cockpit, click the Fiori Mobile service tile.

Figure 23 Select Fiori Mobile service

b. In the Service Configuration section of the Fiori Mobile - Overview page, click Configure Fiori
Mobile.

15
Figure 24 Select Configure Fiori Mobile

c. On the Roles tab, select each role listed in the following table and assign it to the associated group
by selecting Assign in the Groups section.

Role Group
Account Admin Mobile Admin
App Catalog Admin Mobile App Administrator
App Catalog Publisher Mobile App Publisher
Reports User Mobile Reports User
Mobile Place User Mobile Place User

Figure 25 Assign Role to Group

16
 Figure 26 Specify group name or New Group

If the group you need to assign a role to is not listed, you can create it
by clicking New Group in the Assign role <role name> to group dialog
Note box that is displayed after you click Assign.

d. Click Fiori Mobile in the breadcrumb navigation to return to the Fiori Mobile - Overview page and
proceed to the next step.

3. Configure Mobile Packager:

a. In the Service Configuration section of the Fiori Mobile - Overview page, click Configure Mobile
Packager.

Figure 27 Select Configure Mobile Packager

17
 b. On the Roles tab, select each role listed in the following table and assign it to the associated group
by selecting Assign in the Groups section.

Role Group
Administrator Mobile Admin
Administrator Mobile App Administrator
Administrator Mobile App Publisher

Figure 28 Assign Role to Group

Figure 29 Specify group name or New Group

c. Click the name of your account in the breadcrumb navigation to return to the main page of the SAP
Cloud Platform Cockpit and proceed to the next step.

4. Configure roles in SAP Cloud Platform mobile service for development and operations:
a. In the Account Information section of the SAP Cloud Platform Cockpit, click Services.

18
b. Click the Development and Operations tile.

Figure 30 Select Development & Operations

c. In the Service Configuration section of the Development and Operations - Overview page, click
Configure Development & Operations.

Figure 31 Select Configure Development & Operations

d. Click the Roles icon in the left menu bar.

19
 Figure 32 Click Roles icon

e. On the Roles tab, select each role listed in the following table and assign it to the associated group
by selecting Assign in the Groups section.

Figure 33 Assign Role to Group

Role Group
Administrator Mobile Admin
Administrator Mobile App Administrator
Administrator Mobile App Publisher

5. Assign roles to users:

a. Click the name of your account in the breadcrumb navigation to return to the main page of the SAP
Cloud Platform Cockpit.

20
b. In the main menu on the left, click Security > Authorizations.

Figure 34 User Authorizations

c. Click the Groups tab. All the groups you have created are listed. Assign users as follows:
App Catalog Admin/IT Security Assign users of this type to the Mobile App Administrator
Personnel group. This group can perform the following tasks:

· Add new applications

· Manage applications
· Publish applications
App Owner/Publisher/Developer Assign users of this type to the Mobile App Publisher
group. This group can perform the following tasks:

· Add new applications

· Manage applications
Reports User/Analyst Assign users of this type to the Mobile Reports User
group. This group can view reports.

Figure 35 Assign roles to users

21
 Chapter 4
Configuring Cloud Platform Destination

After Cloud Connector is configured, you can login to SAP Cloud Platform Trial landscape to configure the
destination.

6. Open your browser.

7. Type the following URL: https://account.hanatrial.ondemand.com
8. Provide your user ID and password.
9. Click Account tile on this screen.

Figure 36 Home page of SAP Cloud Platform Cockpit

Figure 37 System Status of SAP Cloud Platform Cockpit

22
10. Verify if your SAP Cloud Connector is connecting to your Trial landscape account as shown below by
clicking on Cloud Connectors under Connectivity:

Figure 38 Successful connection from SCC to Cloud Platform Trial

11. Click Destinations under Connectivity:

Figure 39 Accessing Destinations

23
12. Click New Destination.

Figure 40 Adding a Destination

13. Input needed information as shown below:

Name Name of the Destination

Type Protocl type http or https, we choose HTTP here
Description Description of this destination
URL The virtual URL that you have created under SCC of form

Proxy Type OnPremise

Authentication Authentication to Fiori we selected BasicAuthentication

User & Password Provide your Fiori server user ID and password

Figure 41 Destination Configuration

14. Add a property for this destination, click New Property as shown below:

Figure 42 Adding Properties

24
15. From the Additional Properties, there are few we need to add, starts with the following,
WebIDEEnabled with the value true:

Figure 43 Add properties

Add three properties below:

WebIDEEnabled true
WebIDESystem System ID of NetWeaver: DEV
WebIDEUSage odata_abap,dev_abap,ui5_execute_abap,bsp_execute_abap

The result should look like that:

Figure 44 Properties result

16. Click Save to save your configuration, the system will take about 5 minutes before it is available.

Figure 45 Saving Destination

17. Once it is available, click Check Connection as shown below:

Figure 46 Check Connection

25
18. If everything is configured correctly, you should see the following:

Figure 47 connection successful

26
 Chapter 5
DEPLOYING APPLICATIONS USING FIORI MOBILE
In this chapter, we will talk about the configuration of Fiori Mobile service in SAP Cloud Platform and
deployment of standard Fiori applications.

Access to Fiori Mobile service in SAP Cloud Platform

1. Click on Services from the left menu as shown below:

Figure 48 Services of SAP Cloud Platform

2. Scroll down to Mobile Services and click Fiori Mobile tile.

Figure 49 Fiori Mobile

27
3. Click Go to Admin Console to open Fiori Mobile Administration window

Figure 50 Fiori Mobile overview

Figure 51 Administration window of Fiori Mobile

28
Configure Fiori Mobile service connection
1. Click Fiori Mobile under Account

Figure 52 Setting Fiori Mobile

2. Click New connections to create new Fiori Mobile enterprise connection.

Figure 53 New Connection

29
3. Type a unique name for the connection in the Fiori Server Name field. In the Virtual Host with URL
field, type the URL to your Fiori resources. It should match a system mapping and URL path defined in
the Cloud connector.

Figure 54 Information of the New connection

4. Enter the value of the sap-client query parameter in the SAP Client field. Specify the authentication
path (ping path) if necessary (you can also use the default path, /sap/bc/ping), The Basic Authentication
path is used for user authentication and to determine system availability. Then click Create.

Figure 55 Fill in Virtual Host information

30
 Mobile service for SAP Fiori connects to the Fiori server and authenticates
using one of the supported application authentication policies “ Basic
Note Authentication,Principal Propagation,SAP Assertion SSO“. When using
Basic Authentication, application developers simply specify the user
name and password of an account on the Fiori Enterprise Server. This
account must have already been configured on the Fiori server.

5. Check if Status of new connection shows “Available”.

Figure 56 Status of new connection

Create Signing Profiles

1. Click Manage Signing Profiles under Applications.

Figure 57 Manage Signing Profiles

31
2. Select Android Platform and click New Profile.

Figure 58 Create Android signing profile

3. If you don’t have an exist Android Key Store File, select Generate then click on OK.

Figure 59 Generate new profile

32
 4. Input all needed information then click Save.

Figure 60 Fill in necessary information for Android signing profile

5. If you have an existing Android Key Store File, select Upload in Step 3 and choose your file.

Figure 61 upload Key store file to create Android signing file

33
6. Select iOS Platform and click New Profile.

Figure 62 Create IOS signing profile

7. Create IOS profile can only select Upload then click on OK.

Figure 63 Add New Profile

8. Upload signing certificate with password and provisioning profile, make sure enabled “I have made SAP
a Team Member In my Enterprise Apple Developer Program”.

Figure 64 Uploading Signing Certificate and Provisioning Profile

34
9. You can click “Show Apple Signing requirement” for more information, make sure the certificate and
provisioning profile meet the requirement and click Save.

Figure 65 Apple Signing requirement

10. Now we have both Android and IOS profile.

Figure 66 Signing Profiles

35
Create Application deploying to mobile device
1. Click Manage Apps under Applications.

Figure 67 Manage Applications

2. Click New Application and choose Fiori Mobile as application type.

Figure 68 Select Application Type

36
3. Click Get Started.

Figure 69 Get started to add new application

4. If you want to mobilize all applications in Fiori Launchpad, you can choose “I want to mobilize an existing
lauchpad or Fiori application”.
In this case, as we are aiming to deploy specific applications, we choose the first option “I want to create
a local launchpad with only the apps I want to mobilize” then click Next.

Figure 70 choose Fiori App Scenario

37
5. Click Fiori Server we want to connect then click Next. In this case, we choose ‘MonsoonERP’.

Figure 71 Select Fiori Server

We created the Fiori Server connection “MonsoonERP“ at step

“ Configure Fiori Mobile service connection“ (page 29). We
Note choose “ Basic Authentication“ as authentication type at that
time，so we need to input the username and password of the
account have already been configured on the Fiori server.

6. Input the Username and password of the account have already been configured on the Fiori server,
Check Save Credentials then click Next.

Figure 72 Save Credentials

38
7. You should get a list of Available Applications.

Figure 73 Available application list

8. Choose the applications you want, click and drag to Selected Applications list box.
In this case, we choose two applications, “approve leave request” and “people profile” then click Next.

Figure 74 Two applications selected

39
9. Input all needed information and click Finish.

Application name HCMbyFM

Upload You can upload picture as application icon and splash

Build options
Are you ready to build the application
screen
Choose Android and IOS platform;
Select Signing profile we created before;
Select the minimum OS version Android 5.0 and iOS 8.1
We choose Yes
If choose No, you can do more custom settings to the
application

Figure 75 Build Fiori Application

40
10. It may cost 5-10 minutes to complete the building process.

Figure 76 Building Android and IOS application

11. Click Actions button and select Download Binary to get the application APK/IPA file.

Figure 77 Application Actions

You can install the APK/IPA file directly to mobile device. If

Note you click on ‘Set to production‘ button, an application policy
was created to push the application to devices by Mobile
Secure.

41
12. Click Save on the bottom right, you can see the application appears in Manage Apps page.

Figure 78 Application in Manage Apps page

13. Now we created the Fiori application successfully and customer can download and install it form Mobile
Place.

Figure 79 Install application from Mobile Place on Android/IOS device

42
14. We can also link application policy to device that managed by Mobile Secure, so the application will
push to customer.

Figure 68 application policy created at step 12

Figure 80 link application policy to group

Figure 81 application push to IOS device

43
15. Application screen shots.

Figure 82 Application screen shots

44