openSAP How-to Guide for Exercise – SAP Fiori UX launchpad Configuration (Week 3, Unit 6)

Table of Contents Introduction ...................................................................................................................................................... 2 Prerequisites .................................................................................................................................................... 2 Help.sap.com ..................................................................................................................................................... 2 SICF for App URL .............................................................................................................................................. 3 SAPUI5 Component for Additional Information ................................................................................................. 5 Create an Additional User for your Instance (Optional) ..................................................................................... 8 LPD_CUST: Creating a new launchpad and assigning navigation targets ............................................. 11 Login to the SAP Fiori launchpad Designer ............................................................................................... 13 Return to the SAP GUI ................................................................................................................................... 20 Login to the Fiori launchpad ........................................................................................................................ 23

2

INTRODUCTION

In this exercise we will configure the My Timesheet ERP SAP Fiori UX app end to end. First we will create a launchpad in the backend system, then we will configure target mapping and an app launcher tile in the Fiori launchpad Designer, we will return to the backend to assign roles to our new catalog and finally we will add our tile to the homepage. PREREQUISITES

Before we start configuring our launchpad there are some prerequisites that should be met. For learning purposes this is the best way to familiarize you with where some of the information we need for the exercise can be found. Help.sap.com The Configuring Navigation section of the User Interface Add-On for SAP NetWeaver in the SAP Help Guides details all the information that was covered in Week 3 and that will be covered in this exercise. It is recommended that you read this section and familiarize yourself with the processes.

3

In addition to the overall configuration information we need to navigate to the App Implementation section of the specific app we are planning to configure. For the purposes of this exercise, we will navigate to the My Timesheet app. Reference the Activate UI5 Application table and the Enable App for Access in SAP Fiori Launchpad.

SICF for App URL When we go to configure our launchpad in transaction LPD_CUST, we are going to need to enter a URL. SAP Fiori apps always use URL for the app type. You will notice in the Activate UI5 application from the help what the UI5 application name is for any specific app. In our case, the name is HCM_TS_CRE. This step will show you where you can obtain the URL from in the backend system. The URL will be the same for all fiori apps so you can save this for later use and grab the service name from the help for your specific app.

1. Login to the SAP GUI by choosing the SAP Logon icon

2. Choose the openSAP for Fiori SAP System by double clicking on it

4

3. Change your client to 120, enter the login credentials: Bpinst/Welcome1

4. Navigate to transaction SICF

5. Choose the Execute button

6. Use the following path: default_host sap bc --> UI5_UI5 sap hcm_ts_cre. Double Click the hcm_ts_cre service

5

7. You will want to copy the path and add the service name to it.

8. You can remove default_host from the path as we won’t need that part so your path should look like this: /sap/bc/ui5_ui5/sap/hcm_ts_cre Save this in a notepad for later use.

SAPUI5 Component for Additional Information We will need to enter a key value pair with the following syntax „SAPUI5.Component=<Your_App_Component_name>. We can find this name by doing the following:

1. Navigate to transaction SE80

2. In the dropdown choose BSP Application

6

3. Enter the UI5 application name in the field below, when you’re done choose the glasses icon

4. Choose the dropdown arrow next to Page Fragments and double click component.js

7

5. On the right hand side in the layout pane you’ll see ‚jQuery.sap.declare (xxxxx.xxx.xxx.Component) copy this out

6. In your note pad paste the key value pair in the following manner: SAPUI5.Component=hcm.emp.mytimesheet

8

Create an Additional User for your Instance (Optional) This step is optional and you can continue using the Bpinst/Welcome1 user. If you want an additional user in case you lock yourself out of an account you can create one using the steps below. Additionally, you can store this information for later reference should you need to create users in an SAP system.

1. Enter transaction SU01

2. In the User field enter Bpinst and choose the copy icon

3. In the Copy Users popup, enter a user name of your choice in the To Field, keep all default and choose the copy button

9

4. In the Maintain Users screen, enter a password. I suggest you enter a basic password such as Welcome1 because when you first log into the system using your new user you will be prompted immediately to change your password. When you are finished choose the save button.

5. Close out of the GUI session by choosing the x in the upper right hand corner

10

6. In the Log Off popup choose Yes

7. Login again by double clicking the openSAP for Fiori SAP System

8. Change the client to 120, enter your new user ID and the password we just chose

9. You will be prompted for a new password, enter a password of your choosing and choose the green checkbox

10. In the copyright popup choose the green check mark

c

c

11

11. You now have a new user in the system that you can use to login.

LPD_CUST: CREATING A NEW LAUNCHPAD AND ASSIGNING NAVIGATION TARGETS

1. Go to transaction LPD_CUST

2. Choose ‚New Launchpad‘

3. Enter the following details and choose the green checkmark a. Role: openSAP## (where ## is your initials) b. Instance: Transactional c. Description: openSAP launchpad of ## (where ## is your initials)

Note: You will notice in the Enable App for Access in the Fiori Launchpad table form the help that SAP provides you with a Role and Instance. Since the instance we are using is already configured, we can’t create a new launchpad with the delivered SAP role.

c

12

4. In the Namespace required popup choose ‚yes‘

5. In the Change Launchpad screen choose ‚New Application‘

6. Enter the following information, when you’re finished save your entries Note: All entries are Case sensitive – enter them exactly as you see them

a. Link Text: My Timesheet b. Application Type: URL c. URL: choose the pencil icon and paste in the URL we obtained in the prerequisite step

/sap/bc/ui5_ui5/hcm_ts_cre d. Choose ‚Show Advanced „Optional) parameters and enter

i. Application alias: MyTime ii. Additional Information: paste the key value pair we obtained in the prerequisite

SAPUI5.Component=hcm.emp.mytimesheet

13

LOGIN TO THE SAP FIORI LAUNCHPAD DESIGNER

1. Open internet explorer and go to

http://vhcalhdbdb.dummy.nodomain:50000/sap/bc/ui5_ui5/sap/arsrvc_upb_admn/main.html?sap-

client=120&sap-language=EN

Login

2. Choose the gear in the top right hand corner

3. In the assign transport request popup keep all defaults and choose ‘OK’

14

4. Make sure you are on the catalogs tab (it will be gray) and choose the plus icon

5. Enter the following and choose Save

a. Title: Z_## (Where ## is your initials)

b. ID: Z_## (Where ## is your initials)

15

6. You should see your catalog in the list of catalogs and you will have a blank catalog with a tile with a

plus sign in the middle, choose this tile

7. Choose the target mapping tile

16

8. You will now see an empty target mapping tile in your catalog, choose this tile

9. Refer to at help guide for the semantic object we want to use. Enter the following information and

save your entries when you’re finished

17

Note: All entries are Case sensitive!

a. Semantic object: TimeEntry

b. Action: createTimeEntry

c. Launchpad role: openSAP## (Where ## is your initials)

d. Instance: TRANSACTIONAL

e. Application alias: MyTime

10. On the confirmation popup choose ‘OK’

18

11. Choose the blank tile with the plus sign again

12. Choose Static Tile

19

13. Open the Static tile again

14. Enter the following information and choose ‘Save’

20

Note: All entries are Case sensitive!

a. Title: My Time

b. Choose an Icon of your choice using the pick list icon

c. Make sure Use semantic object navigation is checked (this is the default)

d. Semantic object: TimeEntry

e. Action: createTimeEntry

15. On the Confirmation popup choose ‘OK’

RETURN TO THE SAP GUI

16. Go to transaction PFCG

21

17. Enter Role## (Where ## is your initials) and choose single role

18. Save the role by choosing the save icon ( )at the top, then choose the Menu Tab

19. Where it says Transaction choose the drop down arrow

20. Choose ‘Catalog’ from the list

22

21. Enter your catalog ID: Z_## (Where ## is your initials) and choose the green check mark

22. You should have a green light on your menu tab, choose the ‘User’ tab

23. Enter the user ID you’re using for the launchpad (either Bpinst or the user you created). When you’re

done save your entries

23

LOGIN TO THE FIORI LAUNCHPAD

1. In internet explorer open a new tab and enter the following URL http://vhcalhdbdb.dummy.nodomain:50000/sap/bc/ui5_ui5/ui2/ushell/shells/abap/fiorilaunchpad.html?sap-client=120&sap-language=EN

If prompted, login

2. Choose the Show Groups icon in the upper left hand corner

24

3. Choose Open Catalog

4. Scroll to the bottom of the tile catalog and you should see your catalog and tile. Choose the plus sign

on the bottom of your tile

25

5. The plus sign will change to a checkmark. Choose the back arrow at the top

6. In your home catalog at the bottom you should see your My Time tile

26

7. Clicking on the tile will display the time entry details

Congratulations! You have successfully configured and SAP Fiori tile in your launchpad!

www.sap.com

© 2014 SAP SE or an SAP affiliate company. All rights reserved. No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP SE or an SAP affiliate company. SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP SE (or an SAP affiliate company) in Germany and other countries. Please see http://www.sap.com/corporate-en/legal/copyright/index.epx#trademark for additional trademark information and notices. Some software products marketed by SAP SE and its distributors contain proprietary software components of other software vendors. National product specifications may vary. These materials are provided by SAP SE or an SAP affiliate company for informational purposes only, without representation or warranty of any kind, and SAP SE or its affiliated companies shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP SE or SAP affiliate company products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty. In particular, SAP SE or its affiliated companies have no obligation to pursue any course of business outlined in this document or any related presentation, or to develop or release any functionality mentioned therein. This document, or any related presentation, and SAP SE’s or its affiliated companies’ strategy and possible future developments, products, and/or platform directions and functionality are all subject to change and may be changed by SAP SE or its affiliated companies at any time for any reason without notice. The information in this document is not a commitment, promise, or legal obligation to deliver any material, code, or functionality. All forward-looking statements are subject to various risks and uncertainties that could cause actual results to differ materially from expectations. Readers are cautioned not to place undue reliance on these forward-looking statements, which speak only as of their dates, and they should not be relied upon in making purchasing decisions.